Documentación principal

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

  1. El integrador crea un plan de permisos con su Master Key o desde el panel.
  2. Asigna el plan al cliente desde el panel o lo envía como delegation_plan_id opcional al registrar un cliente nuevo; después puede definir excepciones individuales.
  3. El cliente consulta su perfil, ubicaciones del Toolkit y consecutivos con su Key hija.
  4. Si tiene permiso, corrige datos de su propia sucursal o propone un último consecutivo.
  5. 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étodoRuta (base /api/v2)Autorización
GET/external-client/me/fiscal-profileKey hija
GET/external-client/me/toolkit/locationsKey hija
PATCH/external-client/me/fiscal-locationKey hija con permiso
GET/external-client/me/sequencesKey hija
PATCH/external-client/me/sequences/{type}Key hija con permiso
PATCH/external-saas/clients/{id}/fiscal-locationMaster Key (edición administrativa)
POST/external-saas/onboardMaster Key; delegation_plan_id opcional en alta nueva
GET/external-saas/delegation-overviewMaster Key; búsqueda y paginación
GET/POST/PUT/external-saas/delegation-plansMaster Key
GET/PUT/external-saas/clients/{id}/delegationMaster 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