Arquitectura
AFECR separa la operación del negocio de la capa fiscal.
Su aplicación conserva ventas, inventario, clientes, cobros, reglas internas y experiencia de usuario. AFECR recibe la información fiscal que corresponde a la operación, procesa el flujo autorizado y devuelve estados, archivos o eventos para que su sistema continúe trabajando con su propia lógica.
Menor acoplamiento
La integración se concentra en una superficie fiscal definida y evita trasladar la operación comercial completa a otro sistema.
Responsabilidades separadas
Su software conserva el dominio del negocio y AFECR aporta la infraestructura fiscal, la trazabilidad y las herramientas de integración.
Multiempresa
Empresas, sucursales y terminales pueden mantenerse dentro de contextos independientes según la modalidad contratada.
Modular
La misma plataforma puede atender emisores, integradores, integradores externos y complementos sin duplicar la infraestructura base.
Capacidades
AFECR cubre el ciclo alrededor del comprobante, no solo su envío.
Emisión y seguimiento
Procesamiento de comprobantes, estados y referencias para seguimiento posterior.
Recepción
Gestión de comprobantes recibidos y Mensaje Receptor cuando corresponde.
Webhooks
Eventos para mantener sincronizado el sistema que origina o administra la operación.
Idempotencia y recuperación
Controles para reducir duplicidad y continuar ante reintentos o respuestas diferidas.
Consecutivos
Control por sucursal y terminal con validaciones orientadas a preservar la integridad de las secuencias.
Archivos fiscales
Acceso a XML, respuesta fiscal y representación gráfica cuando forman parte del flujo configurado.
Capacidad escalable
Volumen documental, empresas, sucursales, terminales, entrega y complementos pueden crecer según el alcance contratado.
Complementos
Conectores administrados para enlazar plataformas de terceros cuando el cliente prefiere una integración ya preparada.
Modelos de uso
Una plataforma, cuatro formas principales de operar.
| Modelo | Organización | Qué prioriza |
|---|---|---|
| Emisor | Una empresa con una o varias sucursales y terminales. | Operación fiscal, documentos, recepción, consumo y control interno. |
| Integrador | Múltiples empresas independientes. | API, webhooks, Sandbox, trazabilidad, diagnóstico y administración multiempresa. |
| Integrador externo | Proveedor de software o tercero con su propia experiencia. | Infraestructura fiscal desacoplada para conservar su propia interfaz y operación. |
| Complementos | Instancias de conectores administrados. | Configuración, sincronización, errores y documentos originados desde plataformas conectadas. |
Flujos documentales
Preparada para emisión, ajuste, compra, exportación, pago y recepción.
AFECR contempla Factura Electrónica, Tiquete Electrónico, Nota de Crédito, Nota de Débito, Factura Electrónica de Compra, Factura Electrónica de Exportación y Recibo Electrónico de Pago, además de los flujos de recepción y Mensaje Receptor cuando correspondan.
En emisión
- Validación de información fiscal
- Generación y procesamiento del comprobante
- Seguimiento del estado
- Referencias y trazabilidad
- Recuperación de resultados pendientes
En recepción
- Registro del documento recibido
- Relación con la empresa correspondiente
- Mensaje Receptor cuando aplica
- Trazabilidad del resultado
- Acceso a archivos según el flujo
Ciclo de integración
Un proyecto puede validarse por etapas antes de entrar a Producción.
- Defina la modalidad que corresponde a su operación.
- Modele empresas, sucursales y terminales de acuerdo con la estructura real.
- Valide la conexión en Sandbox.
- Implemente trazabilidad, idempotencia y manejo de estados.
- Configure webhooks o mecanismos de sincronización.
- Compruebe los flujos documentales y las consultas auxiliares que su sistema utilizará.
- Active Producción cuando la integración esté validada.
Recursos para desarrolladores
Una cadena de referencia pensada para reducir interpretación y retrabajo.
OpenAPI
Define el contrato HTTP/JSON y sirve como referencia técnica versionada.
Ejemplos canónicos
Estructuras de referencia alineadas con el contrato para los principales documentos.
Postman
Colecciones preparadas para facilitar pruebas y exploración del flujo de integración.
Starter Kits
Material inicial para acelerar la conexión en tecnologías y arquitecturas comunes.
Connection Kit
Guías y recursos para conectar, validar y diagnosticar la integración.
Asistencia técnica
El asistente se apoya en contrato, ejemplos canónicos y fuentes fiscales vigentes para reducir respuestas incompatibles.
Ambientes
Sandbox y Producción trabajan en contextos separados.
Las pruebas deben ser reproducibles sin contaminar la operación real. AFECR mantiene separados los recursos relevantes de cada ambiente para que una integración pueda validarse con mayor control antes de pasar a Producción.
Continuidad operativa
Una respuesta externa tardía no debería detener todo su negocio.
La arquitectura contempla idempotencia, trazabilidad, webhooks, sincronización y mecanismos de recuperación. Esto permite manejar reintentos y estados intermedios sin perder la relación con la operación original.
Evitar duplicados
La misma operación puede identificarse de forma consistente cuando una solicitud necesita reintentarse.
Recuperar contexto
Las referencias, estados y eventos permiten revisar una operación sin depender únicamente de lo que mostró una pantalla en un momento concreto.
Seguridad
Controles integrados a la forma en que AFECR opera.
Separación de ambientes
Pruebas y Producción se mantienen en contextos distintos para reducir errores operativos.
Aislamiento por cuenta
Empresas y recursos se gestionan dentro del contexto que corresponde a cada cuenta.
Acceso contextual
Las funciones se resuelven según rol, permisos, cuenta y modalidad de operación.
Trazabilidad
Las operaciones relevantes conservan referencias suficientes para revisión, soporte y seguimiento.
Toolkit fiscal
Una fuente central para consultas y catálogos auxiliares.
El Toolkit reúne recursos como CAByS, contribuyentes y actividades económicas, tipo de cambio, ubicaciones, tipos de identificación, condiciones de venta, medios de pago, impuestos, tarifas IVA, unidades de medida, formas farmacéuticas, catálogo arancelario TICA, EXONET, PYMPA y otros catálogos aplicables.
La finalidad es reducir copias divergentes de información y evitar que cada integración tenga que construir desde cero las mismas consultas auxiliares.
Integrador externo
AFECR también puede funcionar detrás de su propia experiencia de producto.
Para proveedores de software que desean conservar su interfaz, marca y operación, AFECR puede funcionar como infraestructura fiscal desacoplada. El alcance técnico se ajusta al modelo contratado para que la experiencia comercial permanezca bajo control del integrador.
Asistencia AFECR
La orientación comercial y técnica parte de las mismas fuentes de verdad.
El asistente público puede explicar capacidades, modelos de cuenta, Toolkit, planes e integración a nivel de producto. Cuando una consulta requiere precisión técnica o fiscal, los asistentes AFECR se alinean con el contrato vigente, los ejemplos canónicos y los Anexos y Estructuras aplicables.
Esto permite mantener coherencia entre la web, la documentación, los kits, el panel y la conversación con el usuario.