Conceber uma transição de correção de fatura para a Integração Starter
Mostrar a ação correta enquanto um cliente corrige um rascunho de fatura, o guarda e o submete explicitamente através da Integração Starter da Debitura.
Por Lars Holdgaard, Fundador e Diretor-Geral da Debitura

Quando a Integração Starter devolve needs_fixing com uma hiperligação de correção atual, manter o pedido na linha de fatura existente e enviar o cliente para o passo de correção alojado. Após o regresso do cliente, ler o mesmo pedido novamente para decidir o que a linha deve mostrar.
Seguir uma fatura ao longo da transição
Exemplo fictício. A fatura INV-624 é legível, mas o pedido atual reporta falta de morada da rua do comprador. Pertence a um cliente já ligado sem nenhuma ação anterior pendente. O cliente corrige-a na Debitura. A sua aplicação acompanha o pedido e a ação seguinte que a API devolve atualmente.
| Passo do cliente | Provas do pedido atual | O que a linha de fatura mostra | Quem atua |
|---|---|---|---|
| Primeira leitura · 10:00 UTC | needs_fixing, solutionType fix e uma ligação de ação atual. O resultado da fatura é rascunho, com um problema de morada. | Corrigir a fatura e enviar. Abrir a ligação fornecida pela resposta atual. Manter a mesma fatura e pedido associados. | O cliente abre a correção alojada. |
| O cliente guarda e regressa · 10:07 UTC | Uma leitura recente continua a mostrar needs_fixing e uma fatura em rascunho. Guardar os detalhes deixa-a como rascunho. | Regressar à tarefa de correção se a resposta atual continuar a fornecer a ligação de correção. O pedido aguarda um envio explícito. | O cliente revê e submete na Debitura. |
| O cliente submete e regressa · 10:12 UTC | Uma leitura recente mostra o estado do pedido como submetido, o resultado da fatura como criado, um ID de processo e o estado do processo PendingVerification neste exemplo. | Submetido para verificação. Mostrar a ligação do processo devolvida quando disponível e apresentar o estado real do processo. | A sua aplicação atualiza a linha da fatura existente a partir da leitura atual. |
Disponibilizar uma ação ao cliente com base na resposta atual
A resposta GET atual determina a visualização após o regresso do cliente ou após selecionar Atualizar, ou depois de a sua integração receber uma atualização verificada. Um novo link para esta fatura pode abrir a ação atualmente em falta. Se o link não estiver presente, mantenha uma ação de atualização e mostre o que a resposta atual confirma.
Manter a correção no fluxo alojado
A sua linha pode mostrar o problema descrito pela resposta e a hora da última confirmação. Peça ao cliente para introduzir os dados corrigidos da fatura na Debitura. Mantenha a ação de submissão original da sua aplicação indisponível enquanto essa fatura tiver um pedido existente pendente.
Copiar a folha de cálculo
Cole as linhas numa folha de cálculo e substitua os identificadores fictícios pelos seus próprios dados.
| Ref. da fatura | Ref. do pedido | Passo do cliente | Hora UTC | Estado do pedido atual | Resultado da fatura / estado do processo | Ação de linha | Próximo responsável |
|---|---|---|---|---|---|---|---|
| INV-624 | REQ-624 | Primeira leitura | 10:00 | necessita_de_correção | rascunho | Abrir o link de correção atual | Cliente |
| INV-624 | REQ-624 | Guardado | 10:07 | necessita_de_correção | rascunho | Abrir o link de correção atual, se disponível | Cliente |
| INV-624 | REQ-624 | Submetido | 10:12 | submetido | criado / PendenteDeVerificação | Mostrar o estado do processo atual e o link devolvido, se disponível | Integração |
Próximo passo
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)