# Modelo correcto de la API FE

Esta API no es el panel administrativo y no maneja login de usuarios del panel, dashboard, leads comerciales ni sesiones operativas del POS.

Su función es recibir payloads de documentos electrónicos, resolver el negocio por API key, generar/firma/enviar documentos y guardar el resultado técnico de facturación electrónica.

## Autenticación de payload

La API identifica el negocio, sucursal y terminal mediante:

```http
X-API-KEY: <api_key_de_la_terminal>
X-TERMINAL: <codigo_terminal_opcional>
X-DEVICE-HASH: <huella_equipo_opcional>
```

El panel administra usuarios, negocios, sucursales, cajas, terminales fiscales, credenciales MH, certificados y API keys. La API solo consume esa configuración para procesar el payload.

## Endpoints de la API FE

```txt
GET  /api/v1/tc
POST /api/v1/documentos/add
POST /api/v1/documentos/mensaje-receptor
POST /api/v1/documentos/mensaje-receptor/add
POST /api/v1/mensajes-receptor/add
GET  /api/v1/documentos/{clave}/estado
GET  /api/v1/documentos/{clave}/respuestaXml
GET  /api/v1/documentos/{clave}/firmadoXml
DELETE /api/v1/documentos/{clave}/anular
POST /api/v1/webhook/mh
```

Las rutas administrativas heredadas bajo `BasicAuthCliente` se conservan solo si ya existen en la API original. No son login del panel.
