> ## Documentation Index
> Fetch the complete documentation index at: https://docs.factra.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Arquitectura del sistema

> Responsabilidades y comunicación entre los productos Factra.

# 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.

```mermaid theme={null}
flowchart LR
    Local[Factra Local · POS y administración] -->|HTTPS · licencia y servicios| Cloud[Factra Cloud · plataforma comercial]
    Local -->|HTTPS · documentos e-CF| API[FactrAPI · servicio fiscal]
    Local -->|localhost · impresión y gaveta| Link[FactraLink · hardware local]
    API <-->|OAuth2 M2M · eventos y permisos| Cloud
    API -->|HTTPS| DGII[DGII]
    API --> PG[(PostgreSQL)]
    API --> Redis[(Redis y colas)]
    Redis --> Worker[FactrAPI Worker]
    Scheduler[FactrAPI Scheduler] --> Redis
    Worker --> S3[(Archivo fiscal S3)]
```

## 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 procesos `worker` 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

| Datos | Responsable principal |
| - | - |
| Ventas, inventario y operación del comercio | Factra Local |
| Planes, licencias y estado comercial | Factra Cloud |
| Documentos e-CF, estados fiscales y artefactos | FactrAPI |
| Conexión con periféricos locales | FactraLink |

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.