Qué debe resolver una API fiscal en producción
Una integración estable necesita mucho más que generar un archivo: contexto fiscal, validaciones, secuencias, seguimiento, recuperación, recepción y una forma confiable de devolver el resultado al sistema que originó la operación. AFECR concentra esas responsabilidades detrás de una capa especializada.
Su aplicación
Conserva ventas, inventario, clientes, pagos, reservas, órdenes y reglas de negocio. Decide cuándo existe una operación que debe pasar por el flujo fiscal.
AFECR
Gestiona la capa fiscal, mantiene trazabilidad y devuelve estados, archivos o eventos para que su aplicación continúe trabajando.
Capacidades que puede incorporar
Emisión
Procesamiento y seguimiento de comprobantes electrónicos conforme al flujo correspondiente.
Recepción
Flujos para documentos recibidos y Mensaje Receptor cuando aplica.
Multiempresa
Estructuras con empresas, sucursales y terminales separadas por contexto.
Webhooks
Eventos para sincronizar su sistema sin depender de consultas manuales permanentes.
Idempotencia
Controles para trabajar con reintentos reduciendo el riesgo de duplicar una operación.
Toolkit fiscal
Catálogos y consultas auxiliares centralizados para facilitar integraciones consistentes.
Toolkit fiscal integrado
La API también reúne consultas que suelen terminar implementadas de forma distinta en cada proyecto. CAByS por código o descripción, contribuyentes, actividades económicas, tipo de cambio, ubicaciones, EXONET, PYMPA, TICA, impuestos, tarifas, unidades de medida y otros catálogos pueden formar parte de una misma integración.
Comprobantes y flujos fiscales
AFECR v2 está orientado a la estructura vigente de comprobantes electrónicos de Costa Rica y 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 recepción cuando corresponde.
Seguridad por diseño operativo
AFECR combina separación de ambientes, aislamiento por cuenta, acceso contextual y trazabilidad para que la integración pueda crecer con mayor control. Producción debe operar mediante HTTPS y las credenciales se manejan dentro del contexto que corresponde a cada integración.
Sandbox antes de Producción
Las pruebas se ejecutan en un contexto separado para evitar que documentos, secuencias, eventos o configuraciones de prueba se mezclen con la operación real. Cuando la integración está lista, Producción utiliza su propio contexto.
Continuidad y reintentos
AFECR contempla idempotencia, trazabilidad, webhooks y mecanismos de recuperación para que una pérdida de conexión o una respuesta diferida no obliguen a duplicar ventas ni a perder el control del estado fiscal.