Arquitectura del sistema
El ecosistema distribuye sus responsabilidades entre un servicio local de punto de venta, servicios de plataforma y una API fiscal. Los productos se comunican por contratos HTTP; cada uno mantiene sus propios datos y responsabilidades.Responsabilidad de cada producto
Factra Local
Factra Local es el punto de venta y sistema administrativo que se ejecuta en la computadora del comercio. Conserva la operación local y puede seguir trabajando sin conexión. La emisión electrónica se envía de forma asíncrona a FactrAPI.Factra Cloud
Factra Cloud administra empresas, planes, licencias y la relación comercial del ecosistema. También coordina la emisión y revocación de API keys y entrega a FactrAPI eventos de aprovisionamiento y permisos. No es la fuente de verdad de los documentos fiscales.FactrAPI
FactrAPI es la fuente de verdad fiscal: valida documentos, administra rangos e-NCF, gestiona la comunicación con la DGII y conserva artefactos fiscales. Su API HTTP se complementa con procesosworker y scheduler para las tareas asíncronas.
FactraLink
FactraLink es un servicio local opcional para impresión y control de gaveta. Factra Local guarda la venta antes de pedir una impresión; una falla de impresora no debe deshacer la venta.Datos e integraciones
Los sistemas se integran con HTTPS. FactrAPI usa API keys con permisos limitados para las integraciones de negocio y OAuth2 con JWKS para su comunicación de máquina a máquina con Factra Cloud.