| Código | Significado | Solución |
|---|---|---|
200 | Éxito | — |
201 | Recurso creado | — |
400 | Petición inválida | Revisa el body, campos requeridos faltan |
401 | No autenticado | Verifica tu API Key |
403 | No autorizado | Revisa los scopes de tu token |
404 | No encontrado | El recurso no existe |
409 | Conflicto | Documento duplicado (mismo CUFE) |
422 | Validación fallida | Campos con formato inválido |
429 | Rate limit excedido | Espera y reintenta |
500 | Error interno | Contacta soporte |
503 | DIAN no disponible | Reintenta en unos minutos |
| Código DIAN | Descripción | Acción |
|---|---|---|
XML-001 | XML mal formado | Error interno, reportar |
XML-002 | Schema inválido | Revisa los datos enviados |
CERT-001 | Certificado inválido | Renueva el certificado |
CERT-002 | Certificado expirado | Renueva el certificado |
SIG-001 | Firma inválida | Error de firma, reintentar |
CUFE-001 | CUFE duplicado | El documento ya fue registrado |
RUT-001 | RUT no habilitado | Resuelve en el portal DIAN |
| Error | Causa | Solución |
|---|---|---|
SOFTWARE_ID_MISSING | No configuraste el Software ID | Ve a Settings → DIAN |
CERT_NOT_FOUND | No subiste el certificado .p12 | Sube el cert en Onboarding |
TECHNICAL_KEY_MISMATCH | PIN incorrecto | Verifica el PIN en Settings |
PARTY_NAME_MISSING | Falta razón social | Completa onboarding |