Execução de dívidas
-
3
 min de leitura

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

Recuperar um webhook perdido na Integração Starter

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

  1. 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.
  2. 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.
  3. 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

Três decisões de recuperação do estado atual
Pedido existenteO que aconteceuLeitura atual ou erroVisualização e próximo responsável
Pedido A · INV-41O 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-42O 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-43O 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 faturaReferência do pedidoGatilhoHora da tentativa UTCÚltimo estado confirmadoResultado da leitura atualContinuar a ligaçãoPróximo responsável
INV-41Pedido AEvento repetido10:03submetidoProcesso em verificaçãoOcultoIntegração
INV-42Pedido BRetorno alojado10:06a aguardar assinaturaLink atual devolvidoApresentadoUtilizador
INV-43Pedido CAtualização manual10:08necessita de correção às 09:58 UTCTempo limite excedidoOcultoResponsá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

Subscrição

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.

Obrigado! O seu envio foi recebido!
Ups! Algo correu mal ao enviar o formulário.