# CukPOS FE API — payloads por API key

Esta entrega deja la API como corresponde: una API de facturación electrónica basada en payloads.

## No pertenece a esta API

```txt
login del panel
sesiones de usuarios del panel
leads comerciales
dashboard operativo
POS interno
```

## Sí pertenece a esta API

```txt
recibir payloads de documentos
resolver negocio por X-API-KEY
usar credenciales/certificado configurados desde el panel
firmar XML
enviar a Hacienda
guardar XML firmado, respuesta, PDF/rutas y estado
procesar mensajes receptor
consultar estado por clave
```

## Endpoint principal

```txt
POST /api/v1/documentos/add
```

Headers mínimos:

```http
X-API-KEY: <api_key>
X-TERMINAL: <codigo_terminal>
```

El panel administrativo es quien crea ventas, usuarios, credenciales, certificados, sucursales, terminales y API keys.
