Recuperar um webhook perdido na Integração Starter
Recuperar o estado de uma fatura desatualizada após um webhook perdido. Resolva a entrega duplicada, um evento ausente e uma leitura atual falhada.
Por Lars Holdgaard, Fundador e Diretor-Geral da Debitura

Quando um pedido de cobrança da Debitura parecer desatualizado, consulte o pedido atual a partir do seu servidor utilizando o ID de pedido guardado. Atualize a linha da fatura correspondente com base nesse resultado. Mantenha o último estado confirmado visível com um aviso caso a leitura falhe e oculte qualquer link de continuação antigo até obter uma resposta recente.
Reconciliar linhas de fatura existentes
- Liste os pedidos existentes afetados pela atualização perdida. Mantenha associados a conta do parceiro, o mapeamento de cliente, a linha da fatura e o ID do pedido Debitura. O ID de um pedido de cobrança identifica o pedido. O ID do processo identifica o processo resultante.
- Executar um procedimento no lado do servidor
GET /collection-requests/{id}após o retorno da configuração alojada, após um webhook verificado ou numa nova verificação manual. Leia todos os pedidos conhecidos afetados, caso um passo de configuração partilhado possa ter alterado mais do que um. Utilize o mesmo ambiente do pedido original. - Substitua a visualização pelo estado atual e pelo resultado da resposta. Mostre a opção Continuar apenas quando o estado atual exigir uma ação do cliente e a resposta atual fornecer o respetivo link. Se a leitura falhar, identifique o último resultado verificado com a respetiva hora e um erro de atualização. Mantenha os links desatualizados fora de vista e tente novamente a leitura de acordo com a sua política de novas tentativas.
Três decisões de recuperação fictícias
| Pedido existente | O que aconteceu | Leitura atual ou erro | Visualização e próximo responsável |
|---|---|---|---|
| Pedido A · INV-41 | O mesmo evento verificado chegou duas vezes. | 10:03 UTC · submetido, ID do processo presente, estado do processo ainda sob verificação. | Mostrar o processo e o seu estado real. Elimine a duplicação do evento repetido no gestor e registe a recuperação na linha da fatura existente. |
| Pedido B · INV-42 | O utilizador regressou da configuração alojada e não foi observado nenhum evento. | 10:06 UTC · a aguardar assinatura, hiperligação de ação atual presente. | Mostrar Continuar a partir desta leitura. O utilizador pode abrir a ação associada e a integração volta a verificar o pedido no regresso. |
| Pedido C · INV-43 | O utilizador selecionou Atualizar e a leitura atual excedeu o tempo limite. | 10:08 UTC · Sem novo estado. O último resultado confirmado às 09:58 UTC foi necessita_de_correção. | Mantenha o estado anterior etiquetado como última verificação, mostre o erro de atualização e oculte Continuar. O responsável pela integração verifica o mapeamento do pedido e os registos se as tentativas continuarem a falhar. |
Subir de nível com provas
Fornecer ao responsável pela implementação o ID do pedido, a referência da fatura, o ambiente, a hora da última leitura bem-sucedida, a hora da tentativa falhada e a classe de erro. Manter as chaves, os segredos de assinatura, os detalhes brutos do cliente e os URLs de ação alojados fora do registo de recuperação. Um redirecionamento, um evento perdido e um esgotamento do tempo limite deixam o estado atual por confirmar até uma leitura bem-sucedida. Utilizar o pedido existente para a recuperação. Uma nova submissão tem um objetivo diferente e deve seguir o fluxo de submissão documentado.
Copiar o registo de recuperação
Colar as linhas separadas por tabulação numa folha de cálculo. Manter o fuso horário em cada carimbo de data/hora e registar quem é o responsável por cada verificação pendente.
| Linha de fatura | Referência do pedido | Gatilho | Hora da tentativa UTC | Último estado confirmado | Resultado da leitura atual | Continuar a ligação | Próximo responsável |
|---|---|---|---|---|---|---|---|
| INV-41 | Pedido A | Evento repetido | 10:03 | submetido | Processo em verificação | Oculto | Integração |
| INV-42 | Pedido B | Retorno alojado | 10:06 | a aguardar assinatura | Link atual devolvido | Apresentado | Utilizador |
| INV-43 | Pedido C | Atualização manual | 10:08 | necessita de correção às 09:58 UTC | Tempo limite excedido | Oculto | Responsável pela integração |
Ler os guias de integração
Utilize a regra de integração Starter e a referência de pedido de cobrança para obter a estrutura do pedido, a verificação de assinaturas e a desduplicação de eventos. O guia de recuperação de crédito incorporado explica como a etapa de cobrança se enquadra no seu produto.
Veja como incorporar a recuperação de crédito
Referências
-min.webp)
Subscreva a nossa newsletter
Mantenha-se atualizado sobre as melhores práticas, dicas e truques relativos à recuperação internacional de crédito e à gestão de contas a receber.

.webp)