Registra tu aplicación
Obtén la identidad OAuth de la aplicación de tu vertical.
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.
Crea la aplicación desde el panel
Según la V1, el camino recomendado para una vertical es Tus aplicaciones en el panel de desarrollador. Asocia el cliente OAuth a tu vertical y registra las URLs de retorno que utilizará tu aplicación.
Ejemplos de redirecciones —adáptalos a las rutas reales de tu aplicación—:
http://localhost:3000/oauth/callback
https://app.tudominio.es/oauth/callbackGuarda el client_id y, si es confidencial, el client_secret. El secreto se muestra una sola vez y debe permanecer en tu servidor. La V1 contempla editar las redirecciones y rotar el secreto desde la gestión del cliente.
Decide cómo se autentica tu aplicación
| Aplicación | Preparación |
|---|---|
| Con backend propio | Cliente confidencial; conserva el secreto en el servidor. |
| Pública, sin backend capaz de guardar secretos | Cliente público y PKCE S256 obligatorio. |
Solicita los scopes mínimos que exige tu recorrido. Por ejemplo, consultar clientes requiere customers:read; escribirlos requiere el permiso de escritura correspondiente. En la V1 los scopes se fijan al registrar el cliente: pedir más durante la autorización no amplía ese registro.
No confundas registro y autorización
El cliente OAuth de tu vertical identifica tu aplicación. Cada cliente de tu ERP deberá autorizarla en su tenant: tener el client_id no te da acceso a todas las instancias.
El registro dinámico RFC 7591 sigue descrito para otras integraciones. Esta ruta de aprendizaje utiliza el cliente asociado a la vertical desde el panel; no requiere repetir ambos mecanismos.
Resultado: identidad OAuth registrada, redirecciones exactas y permisos previstos para la primera prueba.
Continúa con la explicación compartida de OAuth para una app.
Anterior: Prepara tu cuenta y vertical · Siguiente: Prepara tu entorno