# Emitir una factura con Ecuafact

Guardar como `SKILL.md` en la carpeta de skills del asistente.

## Contrato

- Base de pruebas: `https://api-sandbox.mynexusapi.com`
- Cabecera: `X-Api-Key`
- Emision: `POST /v1/contribuyentes/{identificacion}/facturas`
- Validacion sin emitir: `POST /v1/contribuyentes/{identificacion}/facturas/validar` (sin `Idempotency-Key`; `200` con `valido` y `errores`)
- Cabecera obligatoria: `Idempotency-Key` (ASCII, maximo 128). La misma key y el mismo cuerpo devuelven el mismo `202`.
- La respuesta `202` no es autorizacion. Seguir con `GET /v1/operaciones/{id}` mientras `estado` sea `recibido` (`codEstado` 1001, sin `claveAcceso`, o 1002, ya con ella; el `202` puede traer cualquiera de los dos). Si el resultado ya se conoce, el `202` trae directamente el estado final (`autorizado` 2001, `rechazado` 3xxx o `rechazo_configuracion` 4xxx): decide por `estado` y `codEstado`, no asumas `recibido`. Los demas valores (`autorizado`, `rechazado`, `rechazo_configuracion`, `error`, `cancelado`) son finales y, salvo `autorizado`, traen `codEstado`, `msgError` y el detalle en `errores`.
- PDF: `GET /v1/contribuyentes/{identificacion}/comprobantes/{claveAcceso}/ride`
- No hay `DELETE` del rechazo. Un rechazo no bloquea el siguiente secuencial.

## Minimo

`identificacion` de la ruta es la identificacion completa del contribuyente autorizado en `GET /v1/contexto` (para un RUC, sus 13 digitos), la misma que va en `infoTributaria.ruc`. El cuerpo lleva `infoTributaria` (`ruc`, `estab`, `ptoEmi`, `secuencial`) y el detalle de la factura. La ruta fija el tipo `01`: no envies `infoTributaria.tipoDocumento`; si lo envias, la API responde `422` (`codEstado` 3002) con `$.infoTributaria.tipoDocumento: Campo no soportado en este contrato.` El ejemplo completo esta en la guia `emision-01`.
