Errores - emite.do

La forma estable es la de FastAPI:

{
  "detail": "El payload debe incluir Encabezado.IdDoc.eNCF."
}

No hay un campo error con códigos tipo missing_api_key. Si detail es una lista, es validación de Pydantic (campos faltantes o tipos).

HTTP

Status	Cuándo
200	Replay de la misma `idempotency_key`
201	Documento, ANECF o ACECF nuevo
401	Key inválida, expirada, revocada, o empresa `is_active=false`. Detail: `API key inválida, expirada o revocada`
404	`Documento no encontrado` (o artefacto / RNC+external_id)
409	`El eNCF ya fue usado para esta empresa y ambiente.`
422	Payload, e-NCF, certificado, rango o `scheduled_for`
422	Falta el header `X-API-Key` (validación de FastAPI)

Validación frecuente en detail (texto):

Detail	Causa
`El payload debe incluir Encabezado.IdDoc.eNCF.`	No vino `payload.Encabezado.IdDoc.eNCF`
`eNCF inválido. Debe tener el formato E + tipo e-CF + 10 dígitos.`	Forma `E31` + 10 dígitos
`El tipo del eNCF (…) no coincide con ecf_type (…)`	`TipoeCF` / prefijo vs `ecf_type`
`La empresa no tiene un certificado activo para este ambiente.`	P12 ausente, inactivo o vencido
`El eNCF no está dentro de un rango aprobado activo para esta empresa.`	Sin rango o fuera de secuencia

Rechazo DGII

El POST puede haber devuelto 201 con status=received. El rechazo fiscal llega después (rejected + webhook). No reutilices ese e-NCF. Consulta GET /api/v1/ecf/{public_id}: error_code / error_message y el historial de eventos traen el código DGII.

⌘I