Estructura de Respuestas

En esta página encontrarás los atributos / propiedades y su significado retornados en cada respuesta, los cuales especifican el estado de una emisión y su estado legal.

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).

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" 
    ]
}

Definiciones

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

Status

ValorDescripción
REGISTEREDIndica que el documento electrónico se encuentra registrado y listo para su emisión.
WAITING_RESPONSEIndica que el documento electrónico se encuentra en proceso. Es decir, el documento fue emitido pero se encuentra en espera de la respuesta final por parte de la DIAN. En este caso, se debe remitir únicamente a consultar nuevamente el estado final del documento por medio de los servicios de consulta, ya que el servicio automáticamente se encarga de consultar y gestionar la respuesta final de la entidad.
FAILEDIndica que la emisión del documento electrónico fue fallida. En este caso, el documento debe ser enviado nuevamente.
SENTIndica que el documento electrónico fue emitido y transmitido correctamente hacia la DIAN. Sin embargo, este estado no indica que el documento haya sido Aceptado por la entidad. Esto se indicará en la propiedad "legalStatus".

Legal Status

ValorDescripción
ACCEPTEDIndica que el documento fue validado, aceptado y autorizado por la DIAN.
ACCEPTED_WITH_OBSERVATIONSIndica que el documento fue validado, aceptado y autorizado por la DIAN, pero confirma un listado de advertencias en cuanto a reglas de validación.
REJECTEDIndica que el documento fue rechazado por la DIAN. confirmando cada una de las reglas de validación que presentaron error.

Government Response

ValorDescripción
codeIndica la codificación del estado de procesamiento:

- 00: Procesado Correctamente
- 66: NSU no encontrado
- 90: TrackId no encontrado
- 99: Validaciones contienen errores en campos mandatorios
messageIndica el mensaje o la descripción del estado de procesamiento:

- Procesado Correctamente
- NSU no encontrado
- TrackId no encontrado
- Validaciones contienen errores en campos mandatorios
errorMessagesIndica el listado de mensajes de rechazo o notificación correspondiente a cada regla de validación definida por la entidad.