Cambios en la respuesta al crear documentos

IMPORTANTE❗ Estos cambios se llevarán a producción el Jueves 08 de Mayo 2025

Modificación del Formato de Respuesta

Se actualizó el formato de respuesta para todos los endpoints de creación de documentos:

Se agregó el campo files:
Contiene enlaces de descarga temporal (válidos por 1 hora) para los archivos asociados al documento.

Detalles por Tipo de Documento

📄 Facturas, Notas Crédito, Notas Débito y Documento Equivalente POS

"files": {
  "xml": "[URL]",
  "attachedDocument": "[URL]",  // PDF u otro adjunto
  "zip": "[URL]"               // Generación asyncrona (hasta 1 minuto de demora)
}

📄 Documentos de Soporte y Notas de Ajuste

"files": {
  "xml": "[URL]",
  "applicationResponse": "[URL]"  // Respuesta de la DIAN
}

📄 Eventos

"files": {
  "xml": "[URL]",
  "attachedDocument": "[URL]"  // Archivo adjunto relacionado
}

Ejemplo de respuesta completa de una factura creada

{
    "invoice": {
        "id": "01JQA3WBHHFGF36RJW3WK3JBSJ",
        "companyIdentification": "string",
        "customerIdentification": "string",
        "type": "STANDARD",
        "cufe": "string",
        "date": "2025-03-26T15:56:39-05:00",
        "prefix": "SEFE",
        "number": 1000001,
        "fullNumber": "SETP993010042",
        "status": "SENT",
        "legalStatus": "ACCEPTED_WITH_OBSERVATIONS",
        "governmentResponse": {
            "code": "00",
            "message": "Procesado Correctamente.",
            "errorMessages": [
                "string"
            ]
        },
        "xmlFileName": "ds0900559088085210000002F.xml",
        "zipFileName": "z0900559088085210000002E.zip",
        "qrCodeContent": "string"
    },
    "files": {
        "xml": "https://api-alegra-e-provider-col-sand.s3.us-east-1.amazonaws.com",
        "attachedDocument": "https://api-alegra-e-provider-col-sand.s3.us-east-1.amazonaws.com",
        "zip": "https://api-alegra-e-provider-col-sand.s3.us-east-1.amazonaws.com"
    }
}

Notas Adicionales

Generación Asyncrona de ZIP:

En documentos que incluyen zip, este se genera en segundo plano y podría demorar hasta 1 minuto.
Ejemplo: El ZIP contiene el applicationResponse y el PDF generado, pero estará disponible tras la generación.

Validez de Enlaces:

Todos los enlaces en files expiran después de 60 minutos desde su creación. Pueden ser renovados al consultar el documento nuevamente.

Acciones Requeridas

Considerar la demora en la generación de ZIP para flujos que dependan de este archivo.