# dte-sv — Facturación Electrónica de El Salvador (API REST)

> Emití Documentos Tributarios Electrónicos (DTE) firmados ante el Ministerio
> de Hacienda de El Salvador con una sola llamada REST. Alineado a la Normativa
> de Cumplimiento DTE v2.0 (mayo 2026). Auth: `Authorization: Bearer tqo_...`.

## Documentación
- [Guía para developers](https://dte-sv.tequio.work/developers): quickstart, ejemplos, hand-off a IA.
- [OpenAPI 3.1 (JSON)](https://dte-sv.tequio.work/openapi.json): schema machine-readable de TODOS los endpoints.
- [Referencia interactiva](https://dte-sv.tequio.work/developers/reference): probá la API en el navegador.
- [Referencia completa para IA](https://dte-sv.tequio.work/llms-full.txt): todo en un archivo, para implementar al 100%.

## Endpoints principales
- `POST https://dte-sv.tequio.work/api/dte/factura` — Factura (01), consumidor final.
- `POST https://dte-sv.tequio.work/api/dte/ccf` — Comprobante de Crédito Fiscal (03), B2B.
- `POST https://dte-sv.tequio.work/api/dte/nota-credito` — Nota de Crédito (05).
- `POST https://dte-sv.tequio.work/api/dte/nota-debito` — Nota de Débito (06).
- `POST https://dte-sv.tequio.work/api/dte/factura-exportacion` — Factura de Exportación (11).
- `POST https://dte-sv.tequio.work/api/dte/ai` — emisión con IA: texto en lenguaje natural → DTE.
- `GET https://dte-sv.tequio.work/api/dte/{codigoGeneracion}` — consultar estado.
- `POST https://dte-sv.tequio.work/api/dte/{codigoGeneracion}/invalidar` — invalidar.
- `POST https://dte-sv.tequio.work/api/dte/{codigoGeneracion}/retorno` — reportar devolución.
- `POST https://dte-sv.tequio.work/api/dte/lote` — emisión masiva (hasta 100).

## Quickstart
```bash
curl -X POST https://dte-sv.tequio.work/api/dte/factura \
  -H "Authorization: Bearer tqo_xxx" -H "Content-Type: application/json" \
  -d '{"receptor":null,"items":[{"descripcion":"Servicio","precioUni":9.99,"tipoItem":2}],"notify":["email"]}'
```