Novedades

[API FE DOM] Mejoras en lo webhooks para notificaciones de documentos electrónicos

¡Mejoras en la seguridad y funcionalidad de los webhooks para notificaciones de documentos electrónicos!

En esta mejora específica, hemos introducido un flujo de trabajo más seguro y controlado en la configuración y manejo de los webhooks relacionados con las notificaciones de documentos electrónicos.

Flujo de Notificaciones a través de Webhooks:

  • Una vez que la entidad marca el documento como aceptado o rechazado, nuestro sistema genera una notificación.
  • Antes de llamar al webhook principal para enviar esta notificación, se realiza un paso adicional:
    • Se accede al endpoint de autenticación (url proporcionada en la configuración del webhook).
    • Se obtienen las credenciales necesarias para autorizar la llamada al webhook principal.
      Las credenciales obtenidas son utilizadas para la autorización en la solicitud al webhook principal.

Para explorar detalladamente cómo configurar estos cambios en los webhooks para notificaciones de documentos electrónicos, les invitamos a revisar la documentación:

Aquí hay un ejemplo de la estructura JSON asociada, donde se detalla la configuración de autenticación:

{
   "webhooks":{
      "documents":{
         "emissionFinished":{
            "status":"active",
            "url":"https://api.com/webhook/endpoint",
            "auth":{
               "status":"active",
               "url":"https://api-autenticacion.com/v1/auth/token",
               "body":{
                  "customField1":"valor1",
                  "customField2":"valor2"
               },
               "headersRequest":{
                  "customHeader1":"headerValue1",
                  "customHeader2":"headerValue2"
               },
               "headersResponse":{
                  "fields":[
                     "accessToken"
                  ],
                  "cache":{
                     "status":"active",
                     "ttl":3600
                  }
               }
            }
         }
      }
   }
}