Prepara tu entorno
Arranca una aplicación y una instancia de desarrollo separadas.
Guía V1 en evolución
Recorrido basado en la guía de integradores V1 facilitada el 12 de septiembre de 2026. Se actualizará con Pimia; no constituye una verificación del despliegue actual.
Prepara la instancia
Utiliza una instancia de desarrollo de tu vertical y anota su tenant y la empresa con la que vas a trabajar. Según la V1, el entorno de integración utiliza dominios {tenant}.taskai.work; las instancias de producción utilizan {tenant}.pimia.es.
La aplicación que ejecutas en local y la instancia de Pimia son piezas distintas. Tu servidor local consume la API de esa instancia.
Elige el punto de partida
- Starter vertical: aplicación de referencia Next.js del repositorio de SDKs, con conexión OAuth del lado servidor.
- Aplicación propia: instala un SDK oficial o implementa el cliente REST en tu lenguaje.
Sigue Starter vertical o SDKs oficiales para preparar el proyecto. Consulta el README del ejemplo para los comandos y variables de su versión.
Prepara la configuración
| Dato | Para qué sirve |
|---|---|
| URL del tenant | Selecciona la instancia contra la que trabaja tu aplicación. |
client_id | Identifica la aplicación registrada. |
client_secret, si corresponde | Autentica el backend; no se entrega al navegador. |
redirect_uri | Recibe el callback y debe coincidir con una URL registrada. |
| Almacén de tokens | Conserva el conjunto completo de tokens después de cada cambio. |
Coordina el refresco entre los procesos que compartan un grant. Un almacén compartido por sí solo no impide dos refrescos simultáneos.
Resultado: aplicación local arrancada, instancia de desarrollo identificada y callback configurado. Todavía falta el consentimiento del usuario.
Anterior: Registra tu aplicación · Siguiente: Conecta tu ERP