Modelo de integración
Un límite claro entre su software y la infraestructura fiscal.
AFECR no pretende reemplazar la lógica de su ERP, POS, ecommerce o SaaS. Su sistema conserva ventas, clientes, inventario, cobros, reglas internas y referencias comerciales. La integración entrega la información fiscal necesaria y recibe el resultado que su aplicación necesita para continuar.
| Capacidad | Qué aporta al desarrollo |
|---|---|
| Emisión y seguimiento | Procesamiento de comprobantes y una referencia trazable para consultar o recuperar su resultado. |
| Recepción y mensajes | Flujos para comprobantes recibidos y confirmaciones cuando correspondan. |
| Multiempresa | Aislamiento de empresas, sucursales y terminales según el modelo autorizado. |
| Webhooks | Eventos para sincronizar estados con su sistema sin depender de consultas manuales permanentes. |
| Idempotencia y resiliencia | Controles para trabajar mejor con reintentos, respuestas diferidas y recuperación de operaciones. |
| Toolkit fiscal | CAByS, contribuyentes, tipo de cambio, ubicaciones, EXONET, PYMPA, TICA y otros catálogos desde una fuente central. |
| Diagnóstico | Trazabilidad y herramientas para comprender validaciones y errores de integración. |
| Complementos | Conectores administrados para plataformas que prefieren una integración ya preparada. |
Recursos de integración
El contrato y los ejemplos deben contar la misma historia.
OpenAPI
Contrato técnico versionado para nombres de campos, estructuras, métodos y respuestas.
JSON canónicos
Ejemplos alineados con el contrato para los principales comprobantes y escenarios de integración.
Postman
Colecciones que permiten probar flujos y consultas sin construir primero toda la capa cliente.
Starter Kits
Puntos de partida para tecnologías comunes y patrones de conexión frecuentes.
Connection Kit
Material de apoyo para preparar, validar y revisar una integración.
Asistente técnico
Orientación alineada con contrato, ejemplos canónicos y Anexos v4.4 para reducir contradicciones.
Pensado para producción
La versión v2 contempla el ciclo completo, no solo la primera solicitud.
Contratos versionados
La integración puede evolucionar de forma controlada manteniendo una referencia técnica consistente.
Sandbox real
Los recursos de prueba se mantienen separados de Producción para validar con mayor control.
Observabilidad
Las operaciones relevantes conservan trazabilidad para localizar una solicitud y comprender su estado.
Webhooks con respaldo
Los eventos reducen consultas repetitivas y pueden complementarse con recuperación cuando un callback no llega.
Secuencias protegidas
La plataforma contempla control de consecutivos y prevención de duplicidad por sucursal y terminal.
Capacidad contextual
Las funciones se resuelven de acuerdo con la cuenta, modalidad, permisos, plan y ambiente.
Elija el nivel de control que necesita su producto.
Integrador
Administra múltiples empresas desde AFECR y dispone de herramientas orientadas a integración, webhooks, Sandbox, trazabilidad, consumo y diagnóstico.
- Empresas independientes
- Sucursales y terminales
- Distribución de capacidad
- Toolkit y herramientas de integración
Integrador externo
Mantiene su propia interfaz, operación y marca mientras utiliza AFECR como infraestructura fiscal.
- Mayor control de experiencia
- Modelo apto para marca propia
- Conectividad fiscal desacoplada
- Gestión según alcance contratado
Seguridad integrada al proceso de desarrollo.
AFECR aplica separación de ambientes, aislamiento por cuenta, permisos contextuales, trazabilidad y manejo prudente de credenciales como parte de la operación normal de la plataforma. El objetivo es que una integración pueda crecer sin convertir la seguridad en una capa improvisada al final del proyecto.
La consola de asistencia analiza, no ejecuta.
Las herramientas de revisión de integración tratan cualquier archivo o fragmento recibido como texto no confiable. Su función es identificar problemas de conexión, contrato o mapeo y orientar la corrección sin ejecutar código cargado.
Una referencia coherente desde la evaluación hasta la implementación.
La documentación pública explica arquitectura, capacidades y modelo de uso. Cuando el proyecto entra en implementación, AFECR mantiene contrato, ejemplos, kits y asistencia técnica alineados con la versión vigente.