Webhooks
Webhooks
Puedes especificar un webhook para recibir notificaciones en tu servidor cuando un documento ha sido firmado, revisarlo, y continuar con tu proceso.
Para especificar un webhook, inicia sesión en tu cuenta de desarrollador en https://acertia.mx/developers/login. La URL que proporciones debe aceptar solicitudes HTTP POST con un JSON Content Type (application/json
).
Cada vez que se firme un documento que tu generaste, Acertia hará un POST a tu webhook con esta información:
Si la cuenta de tu organización tiene activados los sellos NOM151 de manera automática, además de las anteriores recibirás otras dos notificaciones
Confirmación de Webhook
Acertia espera recibir un código HTTP 200 como respuesta a la notificación. Si no lo recibe, asume que hay un problema y se comportará de la siguiente manera:
URL inválida: si el webhook es una URL inválida, no volverá a intentar
Si no se obtiene respuesta de una URL válida: Acertia volverá a intentar utilizando exponential backoff. Esto quiere decir que programará su ejecución de acuerdo a la siguiente fórmula:
10 segundos + min((2 ^ intentos), 600) + Random(0-1)ms
Por lo que el tiempo irá incrementando entre cada intento hasta llegar a un máximo de 600 segundos (10 minutos) y 30 intentos.
Consultas
Con el notification_id
puedes solicitar más detalles sobre un documento. La solicitud tiene que contener la siguiente información:
Acciones disponibles
Actualmente hay cuatro acciones disponibles
1.download_document. Descarga un JSON con el documento con las firmas encapsuladas
Esto regresará un JSON con la siguiente información:
2. download_document_bytes. Descarga el documento con las firmas encapsuladas
3. download_original_document. Descarga un JSON con el documento con las firmas originales.
4. download_original_bytes. Descarga el documento con las firmas originales.
Última actualización