MODO 4 | XML de un documento por CUFE

POST 
/api/ubl2.1/xml/document/:cufe

4. XML de un documento por CUFE

POST {{base_url}}/api/ubl2.1/xml/document/{{cufe}}

Consulta en la DIAN el XML de un documento por su CUFE, usando el certificado
de la empresa. Devuelve el XML en base64.

Headers

Authorization: Bearer {{token}}
Content-Type: application/json

Body

{ "is_event": true }

Campo	Tipo	Obligatorio	Descripción
is_event	boolean	❌	true para consultar por el endpoint de eventos (documentos recibidos)

Respuesta 200

{
  "success": true,
  "message": "Consulta generada con éxito",
  "ResponseDian": {
    "Envelope": {
      "Body": {
        "GetXmlByDocumentKeyResponse": {
          "GetXmlByDocumentKeyResult": {
            "Code": "100",
            "XmlBytesBase64": "PD94bWwgdmVyc2lvbj0iMS4w..."
          }
        }
      }
    }
  },
  "certificate_days_left": 123
}

Notas

• El XML está en
  ResponseDian → Envelope → Body → GetXmlByDocumentKeyResponse → GetXmlByDocumentKeyResult → XmlBytesBase64.
  Decodificar el base64 para obtener el UBL.

• Si el documento viene envuelto en un AttachedDocument, la factura real está
  embebida dentro de un cbc:Description.

• Si la DIAN rechaza la consulta responde con success: false y el detalle en
  ResponseDian.

Request

Headers

Header	Valor
Content-Type	application/json
Accept	application/json
Authorization	Bearer <TU_TOKEN>

Responses

200

Respuesta 200