Pular para o conteúdo

Cancelar uma verificação em lote e reconciliar o trabalho já concluído

Interrompa grupos em lote pendentes do NumDetect, aguarde o status final, retenha as respostas concluídas e reconcilie cobranças antes de uma nova tentativa.

Ilustração do fluxo de trabalho do NumDetect para Cancelar uma verificação em lote e reconciliar o trabalho já concluído
Uma visão geral do fluxo de trabalho abordado neste artigo do NumDetect.
Em resumo

Interrompa grupos em lote pendentes do NumDetect, aguarde o status final, retenha as respostas concluídas e reconcilie cobranças antes de uma nova tentativa.

O cancelamento interrompe o trabalho em lote pendente, enquanto grupos concluídos ou despachados ainda precisam de um resultado final e da reconciliação de cobranças.

Após solicitar o cancelamento de um trabalho em lote do NumDetect, mantenha o ID do trabalho, aguarde um status terminal, baixe qualquer resultado disponível e reconcilie as linhas e os grupos por país e produto. O cancelamento interrompe grupos pendentes; ele não apaga respostas concluídas nem desfaz cobranças de grupos que já foram finalizados.

Interrompa o trabalho pendente e preserve a referência do trabalho

Um arquivo ou escolha de produto incorreta é mais fácil de lidar antes que mais trabalho seja despachado. Salve o ID do trabalho em lote e a versão do arquivo enviado, então utilize a ação de cancelamento de trabalho em lote documentada. O guia da API do NumDetect informa que o cancelamento interrompe países que ainda não foram verificados e retorna o valor retido correspondente. O limite de produto mais preciso são os grupos pendentes: grupos já despachados ainda podem ser finalizados. Não trate a resposta de cancelamento como um rollback nem exclua o arquivo de origem.

Informe à equipe por que o trabalho foi interrompido: coluna errada, lista desatualizada, seleção de produto incorreta ou autorização alterada. Congele qualquer importação automatizada subsequente para este trabalho até que seu estado final seja conhecido. Se o upload original foi um CSV, retenha seus IDs de linha e todas as colunas originais. Uma reconciliação posterior precisa distinguir uma linha que foi verificada antes do cancelamento daquela que nunca recebeu um resultado conclusivo.

Outros sistemas de trabalho em lote também alertam que o cancelamento pode manter o trabalho concluído (Axinom); seus status e regras de faturamento não definem o comportamento do NumDetect. Utilize o trabalho do NumDetect como a fonte da verdade.

Aguarde o trabalho terminal e inspecione cada grupo

Leia o endpoint de status de trabalho em lote documentado até que o trabalho relate como concluído, falho ou cancelado. Um status de “em execução” significa que a solicitação de interrupção não processou todos os grupos. O NumDetect agrupa o trabalho de telefone por país e produto; o trabalho de e-mail é agrupado por produto. Um grupo que já foi despachado pode ser concluído após o operador solicitar o cancelamento, enquanto um grupo pendente pode ser cancelado. Portanto, “trabalho cancelado” e “sem respostas úteis” não são sinônimos.

Registre quais grupos de país-produto foram concluídos, falharam ou foram cancelados. Um grupo concluído pode incluir resultados de linha como Registrado, Não registrado e Desconhecido. Desconhecido é uma resposta não resolvida, não uma resposta gratuita ou negativa. Essa visão em nível de grupo explica por que um trabalho interrompido pode ter resultados utilizáveis e fundos retidos liberados. Não reinicie todo o arquivo original simplesmente porque um grupo não foi finalizado; isso pode duplicar o trabalho concluído e os custos.

Se o trabalho indicar result_ready, solicite uma URL de download através do endpoint de resultado de trabalho em lote documentado. O link documentado dura dez minutos; solicite um novo caso expire. Baixe o resultado apenas após estar pronto, armazene-o com o arquivo de origem e o ID do trabalho, e retenha o status do trabalho terminal para a trilha de auditoria.

Reconcilie o CSV final com a origem retida

O CSV de resultado do NumDetect preserva as linhas e colunas originais em sua ordem original e adiciona as colunas numdetect_status, numdetect_country e product. Junte-o ao arquivo de origem retido usando o identificador de linha estável da equipe e compare as contagens de linhas. Marque o status da linha de origem como válido, duplicado ou inválido separadamente do resultado de cada produto selecionado (Registrado, Não registrado, Desconhecido, não suportado, falho ou cancelado). Uma linha com resultado Desconhecido não deve ser convertida para Não registrado quando a empresa preparar uma lista de acompanhamento.

Para o relatório de interrupção do operador, resuma quatro itens: o escopo solicitado originalmente, grupos concluídos antes ou durante o cancelamento, grupos cancelados ou falhos e linhas que exigem uma nova execução deliberada. Mantenha as respostas concluídas como observações datadas. Uma lista de nova tentativa deve conter apenas as linhas de origem elegíveis não resolvidas e os produtos exatos que ainda precisam de verificação, após corrigir o erro original. Revise a seleção de país e produto novamente antes de criar uma nova solicitação em lote e uma nova Idempotency-Key; a chave antiga pertence à operação de criação original.

Esta é uma revisão específica para cancelamento. Um guia geral de importação de CSV pode explicar cada coluna de resultado, mas a questão urgente aqui é o que a ação de interrupção deixou inacabado e o que não deve ser reexecutado.

Reconcilie as cobranças antes de aprovar uma nova execução

O envio em lote reserva um valor por grupo. Sob a regra documentada do NumDetect, um grupo concluído é cobrado integralmente, incluindo resultados Desconhecido. Grupos falhos ou cancelados com sucesso liberam o valor retido; grupos já concluídos permanecem cobrados. Revise o trabalho final e o histórico de saldo em relação a essa regra. Não estime um reembolso contando apenas as linhas Registrado e Não registrado, e não presuma que um grupo concluído com todos os resultados Desconhecido seja gratuito.

Uma nota concisa do operador pode dizer: “Cancelamento solicitado para o trabalho X; estes grupos foram concluídos; estes grupos foram cancelados ou falharam; estas linhas permanecem não resolvidas; cobrança final e liberação verificadas em relação ao registro do trabalho; a próxima execução requer aprovação.” Isso permite que um colega de equipe decida se deve corrigir a entrada, executar apenas grupos não resolvidos selecionados ou deixá-los como estão.

Antes de autorizar a próxima execução, mostre o escopo corrigido e o controle de custos ao proprietário. O primeiro cancelamento deve deixar um estado final claro, evidências preservadas e uma decisão deliberada de nova tentativa, não um segundo trabalho grande iniciado a partir da incerteza.

Saiba mais

Escolha as informações do produto que se ajustam à próxima etapa do seu fluxo de trabalho.

Fontes

  1. numdetect.com
  2. docs.axinom.com

Elaborado com base na documentação de produto do NumDetect e nas fontes citadas.

Continue explorando

Pronto para verificar seus números?

Comece logo após o cadastro, sem aprovação prévia. Recarregue seu saldo e verifique números reais.

Cadastre-se grátis e comece ↗