Operación fiscal
Más que emitir un comprobante.
AFECR registra los datos de seguimiento del comprobante, como su referencia, clave, consecutivo, estado y respuesta fiscal. Así, su sistema puede consultar cada operación y continuar sus procesos habituales.
Emisión v4.4
Factura electrónica, tiquete, notas de crédito y débito, factura de compra, exportación y recibo electrónico de pago.
Recepción
Gestión de comprobantes recibidos y Mensaje Receptor cuando corresponde a la operación.
Estados y trazabilidad
Seguimiento técnico y fiscal para saber qué ocurrió con cada documento y recuperar su contexto.
Archivos fiscales
Acceso al XML, respuesta fiscal y representación gráfica cuando forman parte del flujo configurado.
Consecutivos
Control por sucursal y terminal con validaciones orientadas a preservar la integridad de las secuencias.
Entrega documental
La entrega puede mantenerse en su propio sistema o formar parte del flujo AFECR según la modalidad configurada.
Continuidad
Diseñada para sistemas que no pueden detenerse esperando una respuesta externa.
Idempotencia
Permite identificar una operación de forma consistente cuando necesita reintentarse, reduciendo el riesgo de duplicidad.
Webhooks
Los cambios de estado pueden volver a su sistema mediante eventos, evitando depender de consultas manuales permanentes.
Consulta de respaldo
La integración puede recuperar estados pendientes cuando un evento no llega o una respuesta externa se demora.
Sandbox y Producción
Los contextos de prueba y operación real se mantienen separados para reducir errores de configuración.
Toolkit fiscal
Consultas y catálogos fiscales desde un solo lugar
El Toolkit centraliza recursos auxiliares para que integradores y emisores trabajen con una fuente consistente. Esto reduce la necesidad de mantener copias independientes de catálogos o construir consultas repetidas en cada sistema.
CAByS
Búsqueda por código o descripción mediante un catálogo indexado para consultas rápidas, con respaldo de fuente oficial.
Contribuyentes y actividades
Consultas auxiliares para apoyar la validación y configuración de la información fiscal.
Tipo de cambio
Acceso a información de referencia para operaciones que requieren moneda distinta de CRC.
Ubicaciones
Catálogos de provincia, cantón, distrito y otros datos territoriales aplicables.
EXONET
Consulta integrada de autorizaciones de exoneración mediante la fuente oficial disponible en AFECR.
PYMPA
Consulta integrada del registro agropecuario para apoyar procesos que requieren verificar esa condición.
TICA y aranceles
Consulta del catálogo arancelario para escenarios donde la clasificación correspondiente forma parte del documento.
Catálogos v4.4
Tipos de identificación, condiciones de venta, medios de pago, impuestos, tarifas, unidades de medida y otros catálogos aplicables.
Arquitecturas de uso
Una misma infraestructura para distintas formas de operar.
Emisor
Una empresa que necesita operar una o varias sucursales y terminales con control fiscal centralizado.
Integrador
Equipos que administran varias empresas y necesitan separar configuración, consumo y operación por cliente.
Integrador externo
Proveedores de software que conservan su propia experiencia de usuario y utilizan AFECR como infraestructura fiscal.
Complementos
Conectores administrados para terceros en desarrollo. Su disponibilidad comercial se confirmará individualmente.
Para desarrolladores
Empiece a integrar con ejemplos claros y herramientas preparadas
Consulte ejemplos y guías de integración desde su panel para conectar su software con la versión de API habilitada para su cuenta.
Contrato versionado
OpenAPI y contratos de integración definen la estructura técnica que debe respetar cada implementación.
Ejemplos de comprobantes
Ejemplos JSON para preparar solicitudes y comprobar qué datos necesita cada documento.
Postman y Starter Kits
Recursos preparados para acelerar pruebas, conexión y adopción en tecnologías comunes.
Kit de conexión
Prepare su primera conexión, revise el resultado de cada prueba y avance a producción de forma controlada.
Asistencia técnica
Encuentre orientación para entender errores y preparar sus solicitudes sin compartir datos sensibles.
Diagnóstico guiado
Herramientas para localizar problemas de integración y entender qué debe corregirse antes de pasar a Producción.
Escalamiento
La capacidad puede crecer con la operación.
AFECR permite iniciar con una configuración de apertura y ampliar después volumen documental, empresas, sucursales, terminales, servicios de entrega y complementos según la modalidad contratada. El objetivo es que la infraestructura acompañe el crecimiento sin obligar a rehacer la integración.
Seguridad
Controles integrados al diseño operativo.
Separación de ambientes
Pruebas y Producción trabajan en contextos distintos para disminuir errores operativos.
Aislamiento de cuentas
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 e información suficiente para revisión y soporte.