Conecta tu ERP
Completa el consentimiento y verifica una primera lectura.
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.
Completa OAuth
- Genera
statey el material PKCE, y consérvalos asociados a la sesión que inicia la conexión. - Envía al usuario a la autorización del tenant correcto con los scopes registrados.
- En el callback, valida
statey canjea el código usando la misma redirección. - Guarda el conjunto completo de tokens y su contexto de tenant, usuario y grant en un almacén duradero.
- Realiza una lectura permitida y comprueba que devuelve datos de la instancia y empresa esperadas.
Consulta Primera conexión y OAuth para una app para la configuración compartida.
Verifica también los errores
| Respuesta | Cómo debe reaccionar tu aplicación |
|---|---|
401 | Distinguir caducidad de revocación; refrescar cuando proceda o solicitar autorización otra vez. |
403 | Explicar que falta permiso, sin repetir indefinidamente la petición. |
422 | Mostrar la validación del recurso o los campos que deben corregirse. |
429 | Respetar Retry-After. |
Conserva la conexión
El refresh token rota: persiste siempre la respuesta completa y coordina el refresco por grant. Reutilizar uno ya rotado puede revocar toda la autorización. Si el usuario desconecta la aplicación, deja de utilizar ese acceso y permite reconectarla mediante consentimiento.
Resultado: primera lectura autenticada correcta y conexión conservada después de reiniciar tu aplicación.
Consulta Gestiona tokens con seguridad y Diseña para varios tenants.
Anterior: Prepara tu entorno · Siguiente: Implementa tu vertical