Gestión de Respuestas

Cada respuesta retornada por la API, contendrá tres atributos que son esenciales para conocer tanto el estado final de una emisión como el estado legal o estado de validación por parte de la DIAN y su respectivo reporte (Mensaje y Listado de errores según sea el caso).

📘

Nota

Si desea conocer la estructura completa de una respuesta, puede visitar la sección EXAMPLES del apartado RESPONSE visible en la definición de cada endpoint. La estructura puede tener variaciones según el servicio / endpoint utilizado.

Estos atributos / propiedades son:

status

Este valor indica el estado final de la emisión. Los posibles valores retornados en esta propiedad son:

• REGISTERED
• WAITING_RESPONSE
• FAILED
• SENT

legalStatus

Este valor indica el estado legal o estado de validación por parte de la DIAN de la emisión. Los posibles valores retornados en esta propiedad son:

• ACCEPTED
• ACCEPTED_WITH_OBSERVATIONS
• REJECTED

governmentResponse

Este objeto contendrá el código, mensaje y el listado de errores (Si es el caso) que componen la respuesta final y oficial de la entidad. Es decir, son códigos y mensajes estandarizados directamente por la DIAN.

Ejemplos:

• Emisión Aceptada:

"governmentResponse": {
  	"code": "00",
    "message": "Procesado Correctamente.",
    "errorMessages": []
}

• Emisión Rechazada

"governmentResponse": {
  	"code": "99",
    "message": "Validación contiene errores en campos mandatorios.",
    "errorMessages": [
       	Regla: FAU02, Rechazo: El Valor Bruto antes de tributos no es igual a la suma de los valores de las 
           líneas de la factura que contienen el valor comercial" 
    ]
}

errors

Este campo lista los errores ocurridos en el procesamiento asíncrono de los documentos para dar contexto de por qué el documento quedó fallido. Similar a los errores obtenido en la respuestas sincronas de la API
Ejemplo:

"errors": [
  {
    "code": "EPR504",
    "message": "Resend Error. Signature date is different from shipping date."
  }
]

Definiciones

A continuación encontrará la definición detallada de cada posible valor retornado.

Status

Legal Status

Government Response

Error Item