API V2 · Integrador Externo · Anexo de autoservicio fiscal
Consulta y corrección fiscal bajo control de tu integrador
Los clientes vinculados por un Integrador Externo pueden consultar los datos de su propia sucursal y terminal desde el backend del integrador. La edición requiere un permiso del integrador, por plan o específico para cada cliente.
Qué puede ver tu cliente
La ubicación fiscal guardada (provincia, cantón, distrito, barrio y otras señas), el último número de cada tipo de comprobante, el mínimo seguro y el siguiente disponible. Los nombres de ubicaciones se obtienen del Toolkit central de AFECR.
Quién autoriza cambios
El administrador de la cuenta Integrador Externo habilita por separado Editar ubicación y Editar consecutivos mediante un plan o una excepción por cliente. La Key hija no permite editar los datos de otros clientes.
Cómo funciona
- El integrador crea un plan de permisos con su Master Key o desde el panel.
- Asigna el plan al cliente desde el panel o lo envía como
delegation_plan_idopcional al registrar un cliente nuevo; después puede definir excepciones individuales. - El cliente consulta su perfil, ubicaciones del Toolkit y consecutivos con su Key hija.
- Si tiene permiso, corrige datos de su propia sucursal o propone un último consecutivo.
- AFECR valida la solicitud, conserva trazabilidad y deniega cualquier retroceso que reutilice números emitidos o reservados, incluso si Hacienda rechazó el documento.
Buscar y administrar todos los clientes
El integrador puede buscar por referencia, identificación o razón social. La lista de permisos está paginada: 25 clientes por página inicialmente, y hasta 100 por consulta. La consulta API acepta q, page y per_page; no existe un límite total de 500 clientes visibles.
Al dar de alta un cliente nuevo, su software puede enviar el identificador de un plan de permisos activo mediante delegation_plan_id. Si se omite, las ediciones siguen deshabilitadas hasta que las autorice. El plan comercial del software del integrador se vincula explícitamente a este identificador, no automáticamente.
Rutas de referencia
| Método | Ruta (base /api/v2) | Autorización |
|---|---|---|
| GET | /external-client/me/fiscal-profile | Key hija |
| GET | /external-client/me/toolkit/locations | Key hija |
| PATCH | /external-client/me/fiscal-location | Key hija con permiso |
| GET | /external-client/me/sequences | Key hija |
| PATCH | /external-client/me/sequences/{type} | Key hija con permiso |
| PATCH | /external-saas/clients/{id}/fiscal-location | Master Key (edición administrativa) |
| POST | /external-saas/onboard | Master Key; delegation_plan_id opcional en alta nueva |
| GET | /external-saas/delegation-overview | Master Key; búsqueda y paginación |
| GET/POST/PUT | /external-saas/delegation-plans | Master Key |
| GET/PUT | /external-saas/clients/{id}/delegation | Master Key |
Las rutas se incorporan con la ampliación API V2 del 10/11/2026 y requieren instalación y autorización comercial. La referencia técnica definitiva está en el contrato OpenAPI descargable del panel.
Abrir panel Integrador Externo