Ejecución de sentencia
-
3
 minutos de lectura

Recuperar un webhook perdido en la integración inicial

Recuperar el estado de una factura desactualizada tras perder un webhook. Gestione la entrega duplicada, la ausencia de eventos y los errores en la lectura actual.

Por Lars Holdgaard, fundador y consejero delegado de Debitura

Recuperar un webhook perdido en la integración inicial

Cuando una solicitud de cobro de Debitura parezca desactualizada, lea la solicitud actual desde su servidor utilizando su ID de solicitud guardado. Actualice la fila de la factura correspondiente a partir de ese resultado. Mantenga visible el último estado confirmado con una advertencia si la lectura falla y oculte cualquier enlace de continuación antiguo hasta que obtenga una respuesta reciente.

Conciliar las filas de facturas existentes

  1. Enumerar las solicitudes existentes afectadas por la actualización perdida. Mantenga asociados la cuenta del socio, la asignación de su cliente, la fila de la factura y el ID de solicitud de Debitura. El ID de solicitud de cobro identifica la solicitud. El ID de expediente identifica el caso resultante.
  2. Ejecutar una operación en el servidor GET /collection-requests/{id} tras el retorno desde la configuración alojada, tras un webhook verificado o en una nueva comprobación manual. Lea todas las solicitudes afectadas conocidas si un paso de configuración compartido pudo haber cambiado más de una. Utilice el mismo entorno que la solicitud original.
  3. Reemplace la visualización con el estado actual y el resultado de la respuesta. Muestre Continuar solo cuando el estado actual requiera la acción del cliente y la respuesta actual proporcione su enlace. Si la lectura falla, etiquete el último resultado comprobado con su hora y un error de actualización. Mantenga los enlaces obsoletos fuera de la vista y vuelva a intentar la lectura utilizando su política de reintentos.

Tres decisiones de recuperación ficticias

Tres decisiones de recuperación del estado actual
Solicitud existenteQué ha sucedidoLectura actual o errorVisualización y siguiente responsable
Solicitud A · INV-41El mismo evento verificado llegó dos veces.10:03 UTC · enviado, ID de expediente presente, estado del expediente aún bajo verificación.Muestre el expediente y su estado real. Elimine el evento duplicado en el gestor y registre la recuperación en la fila de factura existente.
Solicitud B · INV-42El usuario regresó de la configuración alojada y no se observó ningún evento.10:06 UTC · pendiente de firma, enlace de acción actual presente.Muestre Continuar a partir de esta lectura. El usuario puede abrir la acción vinculada y la integración vuelve a comprobar la solicitud al regresar.
Solicitud C · INV-43El usuario seleccionó Actualizar y la lectura actual agotó el tiempo de espera.10:08 UTC · Ningún estado nuevo. El último resultado confirmado a las 09:58 UTC fue necesita corrección.Mantenga el estado anterior etiquetado como última comprobación, muestre el error de actualización y oculte Continuar. El responsable de la integración comprueba la asignación de solicitudes y los registros si los reintentos siguen fallando.

Escalar con pruebas

Proporcione al responsable de la implementación el ID de solicitud, la referencia de factura, el entorno, la hora de la última lectura exitosa, la hora del intento fallido y la clase de error. Mantenga las claves, los secretos de firma, los datos brutos del cliente y las URL de acciones alojadas fuera del registro de recuperación. Una redirección, un evento perdido y un tiempo de espera de espera de respuesta dejan el estado actual sin confirmar hasta que se produzca una lectura exitosa. Utilice la solicitud existente para la recuperación. Un nuevo envío tiene un propósito diferente y debe seguir el flujo de envío documentado.

Copiar el registro de recuperación

Pegue las filas separadas por tabulaciones en una hoja de cálculo. Mantenga la zona horaria en cada marca de tiempo y registre quién es el responsable de cada comprobación abierta.

Fila de facturaReferencia de solicitudDesencadenanteHora del intento UTCÚltimo estado confirmadoResultado de lectura actualEnlace de continuaciónPróximo responsable
INV-41Solicitud AEvento repetido10:03enviadoExpediente en verificaciónOcultoIntegración
INV-42Solicitud BRetorno alojado10:06pendiente de firmaEnlace actual devueltoVisibleUsuario
INV-43Solicitud CActualización manual10:08needs_fixing a las 09:58 UTCTiempo de espera agotadoOcultoResponsable de la integración

Lea las guías de integración

Utilice la receta de integración inicial y la referencia de la API para las solicitudes, la verificación de firmas y la deduplicación de eventos. La guía de cobro de deudas integrada explica cómo este paso encaja en su producto.

Descubra cómo integrar el cobro de deudas

Referencias

Suscripción

Suscríbase a nuestra newsletter

Manténgase al día sobre las mejores prácticas, consejos y trucos acerca del recobro internacional de deudas y la gestión de cuentas por cobrar.

¡Gracias! ¡Su solicitud ha sido recibida!
¡Ups! Algo salió mal al enviar el formulario.