Versión 1.64.0 de InvoiCy

Webhook para la notificación del estado final del DTE

En esta nueva versión de la plataforma InvoiCy, se incorpora la posibilidad de configurar un Webhook que permite notificar automáticamente al emisor cuando un DTE alcance su estado final de “Autorizado” o “Rechazado SIFEN”.

Con esta automatización, ya no es necesario realizar consultas manuales para conocer el resultado del procesamiento; el sistema notificará proactivamente a su URL configurada enviando el JSON del documento actualizado.

Para ello, se agregaron dos nuevos campos en la pantalla “Parámetros de Emisión”, la cual puede ser accedida desde el menú “Sucursal” en el Panel de Control.

Parámetros para la configuración del Webhook

URL del Webhook para Respuesta del Estado Final de la Factura: En este campo se debe informar la URL a la cual InvoiCy realizará la petición POST para enviar la notificación del cambio de estado del documento. Recuerde que la URL debe ser válida y segura (HTTPS).

Authorization Header para Autenticación del Webhook: Este campo es opcional y se utiliza para informar un token de autenticación que será enviado en el header Authorization de la solicitud HTTP. El valor informado debe ser estático y puede corresponder a un JWT, un hash (por ejemplo, MD5) u otro identificador previamente acordado entre las partes. La utilización de este parámetro es altamente recomendada, ya que permite validar el origen de la notificación, reforzando la seguridad de la API y la integridad de los datos intercambiados.

Una vez configurada la URL del webhook en el campo correspondiente, cada vez que ocurra una actualización del estado de un documento en InvoiCy, por ejemplo al pasar a “Autorizado” o “Rechazado SIFEN”, el sistema enviará automáticamente una notificación al endpoint configurado.

La notificación será enviada mediante una petición HTTP POST y contendrá en el cuerpo de la solicitud el JSON completo del documento, incluyendo la información correspondiente a su estado final. A continuación, se presenta un ejemplo de la notificación enviada por el sistema.

{
    "Encabezado": {
        "RUCEmisor": "",
        "CodEstablecimiento": "",
        "CodMensaje": "",
        "DescMensaje": ""
    },
    "ListadoDocumentos": [
        {
            "CodTipoDocumento": 1,
            "CodPuntoExpedicion": "001",
            "CodEstablecimiento": "001",
            "NumDocumento": 99999,
            "NumTimbrado": 99999999,
            "DescSerie": "",
            "CodEstadoDocumento": 5,
            "FechEmision": "2025-12-02T14:00:25",
            "DescImpresion": "XXXXx9xXxXXXxXxXxXxXxXXXXXXxxx99XXXx=",
            "DescImpresionLink": "https://mcppy-dsv-gx18.migrate.info/InvoiCy_PY_IHML/downloaddocumentos.aspx?xx99x99xx99xxx9xx9xxx9xxx9xx99xxxxxx9x9xx9xxx9xxxxx99xxxx999x9xxxx99xx9xxx9x99xx9xx9x9xx9xxxxx9-xxxxxxxx99x",
            "DescVisualizacionLink": "https://mcppy-dsv-gx18.migrate.info/InvoiCy_PY_IHML/impresion.aspx?xx9999xx-x9x99xx9xxxxxx9xxxxxxxxx9xx9xxxxxx9x9xxxx9x_xxxxxxxxx9xxxx9xxxx9x9xxx9xx9x",
            "NumCDC": "99999999999999999999999999999999999999999999",
            "NumProtocolo": 99999999,
            "XMLBase64": "XXXXx9xXxXXXxXxXxXxXxXXXXXXxxx99XXXx==",
            "XMLLink": "https://mcppy-dsv-gx18.migrate.info/InvoiCy_PY_IHML/downloaddocumentos.aspx?xx99x99xx99xxx9xx9xxx9xxx9xx99xxxxxx9x9xx9xxx9xxxxx99xxxx999xx9xx9xx99xx9xxxxxx_xxxxxxx9x9xx_xxxxxxx-xxxx9x",
            "GUID": "999x99x9-xxxx-9x9x-xxxx-999xx9xx9999",
            "RetornosInvoiCy": [],
            "RetornosGobierno": [
                {
                    "CodRetorno": "0260",
                    "DescRetorno": "Aprobado"
                }
            ]
        }
    ]
}

Otras mejoras y ajustes:

• Fue implementada una corrección en la integración con Cloudbeds para permitir la emisión de documentos cuando el huésped tenga registrado el tipo de documento “Licencia de Conducción”, evitando errores o rechazos durante el procesamiento.
• Mejoras y ajustes internos para un mejor rendimiento y usabilidad de la plataforma.

Autores : Gustavo Paluchowski