Configuración de Webhook

Este artículo describe la configuración y el funcionamiento del Webhook de notificación del estado final del DTE en la plataforma InvoiCy. El Webhook permite notificar automáticamente al emisor cuando un DTE alcanza su estado final de “Autorizado” o “Rechazado SIFEN”.

Mediante esta funcionalidad, se elimina la necesidad de realizar consultas manuales para conocer el resultado del procesamiento del documento, ya que el sistema envía de forma proactiva una notificación al endpoint configurado, incluyendo el JSON actualizado del documento.

Para habilitar esta funcionalidad, se deben configurar dos campos en la pantalla “Parámetros de Emisión”, accesible 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"
                }
            ]
        }
    ]
}

Autores : Gustavo Paluchowski