Conciliar uma reserva de tarefa em lote da Consulta da operadora original com sua cobrança final
Separe o saldo reservado, os resultados concluídos e a reserva liberada, e entenda as diferenças quando outras atividades compartilham a mesma carteira.
Um registro de conciliação local conecta uma tarefa em lote da operadora ao seu arquivo, resultados finais e observações da carteira, sem suposições sobre gastos simultâneos.
Para a conciliação de saldo de tarefas em lote da operadora, separe a reserva estimada da cobrança final e da reserva não utilizada. Combine a tarefa com seu arquivo preparado e resultados concluídos, e então verifique se outras atividades afetaram o saldo compartilhado da conta.
Leia a reserva como trabalho em andamento
Você envia um arquivo de operadora, vê o saldo disponível diminuir e, posteriormente, recebe um CSV com menos linhas do que o upload original. O primeiro movimento de saldo, por si só, não informa o custo final da tarefa. O envio em lote reserva um valor estimado enquanto a tarefa é processada.
A CarrierLookup cobra pelos números que retornam resultados e devolve a reserva não utilizada para a mesma carteira. Uma tarefa que falha durante a preparação retorna sua reserva integralmente. Essa conciliação de reserva é diferente de reverter uma recarga ou compra de plano.
Mantenha três valores distintos em seu próprio registro: o valor reservado, a cobrança final e o valor liberado. Quando todos os três estiverem disponíveis para a mesma tarefa, a relação esperada é que a reserva seja igual à cobrança final mais a reserva liberada. Não preencha um valor indisponível no nível da tarefa com uma diferença de saldo de toda a conta apenas para fazer essa equação funcionar.
Construa o registro da tarefa a partir do arquivo enviado
Comece com o arquivo exato que você enviou, não com a versão atual de uma planilha que alguém possa ter editado posteriormente. Salve um resumo (digest) do arquivo, o país selecionado, o tipo de serviço carrier_batch, o ID da tarefa e o horário de envio. Mantenha arquivos com dados de contato em armazenamento restrito e use referências a eles na planilha.
A preparação em lote exclui linhas inválidas, duplicatas, números sem código de país e números fora do país selecionado. Linhas excluídas não são cobradas. Seu relatório de preparação local pode explicar algumas exclusões, mas distinga sua estimativa das contagens realmente relatadas pelo serviço.
| Campo da planilha local | O que ele conecta |
|---|---|
| ID da tarefa e tipo de serviço | Uma tarefa de arquivo de operadora, em vez de todo o trabalho da conta |
| Resumo do arquivo de origem e contagem de linhas | Versão exata do upload |
| País e notas de preparação | Conjunto de números pretendido e exclusões locais |
| Carimbos de data/hora de envio e estado | Período durante o qual a reserva foi mantida |
| Evidência de reserva | Valor retido, se mostrado por registros da tarefa ou da conta |
| Arquivo de resultado, resumo e contagem de linhas | Saída concluída para esta tarefa |
| Evidência de cobrança final e liberação | Valores de liquidação quando disponíveis |
| Outra atividade da carteira | Razões pelas quais os instantâneos de saldo podem não isolar esta tarefa |
| Diferença inexplicada | Um valor visível não resolvido, não um ajuste fabricado |
Estes são campos em sua planilha, não uma API de registro de faturamento do provedor prometida. Preserve a fonte de cada valor para que um operador possa distinguir um valor observado de um cálculo.
Conte os resultados concluídos sem tratar espaços em branco como falhas
Uma tarefa de operadora bem-sucedida fornece um CSV com identifier, carrier, underlying_carrier, number_type, country_code, region e city. Use os identificadores para conectar as linhas de saída à entrada preparada. O CSV em lote não possui o campo exists da resposta síncrona múltipla.
Um valor de operadora ou geografia vazio significa que o valor estava indisponível. Não é evidência suficiente de que a linha falhou ou deveria ser gratuita. Resultados de operadora concluídos podem ser cobráveis mesmo quando os campos de alocação estão vazios. Mantenha a integridade do campo separada da contagem de resultados concluídos ao estimar uma cobrança.
Por exemplo, seu relatório local pode mostrar algumas linhas de entrada duplicadas e algumas linhas de saída concluídas com valores de cidade em branco. As linhas de entrada duplicadas pertencem à conciliação de pré-processamento. As cidades em branco pertencem à revisão de qualidade do resultado. Subtrair ambos os grupos da contagem faturável misturaria duas questões diferentes.
Conte os identificadores de forma consistente e inspecione mapeamentos de saída duplicados ou ausentes antes de calcular os totais. Se o detalhe da tarefa disponível não estabelecer por que um identificador enviado está ausente, rotule a diferença como não resolvida. Não invente um código de falha por número a partir da ausência de uma linha CSV. Use o estado da tarefa e a evidência de serviço disponível para resolvê-lo.
Use uma carteira silenciosa para entender uma tarefa
Em uma execução isolada, pause outros trabalhos pagos sob seu controle e anote o saldo imediatamente antes do envio. Registre a observação da reserva, aguarde o estado final da tarefa e registre o saldo liquidado e qualquer cobrança ou liberação exibida. Inclua recargas, mudanças de plano e qualquer outro movimento da conta no período de observação.
Se realmente não houve outros movimentos, a diferença entre os saldos inicial e liquidado pode corroborar o custo líquido da tarefa. Ainda ajuda comparar esse resultado com a contagem concluída e o preço aplicável mostrado em Preços da CarrierLookup. Preserve o preço usado na época, em vez de substituí-lo silenciosamente por um preço posterior.
GET /api/v1/balance lê o balance_micros atual sem criar uma verificação ou cobrar pela consulta. Armazene esse número inteiro diretamente e use aritmética de inteiros para diferenças; converta para um valor de exibição na borda de sua aplicação. Um instantâneo de saldo é uma observação da conta, não um extrato de tarefa detalhado.
A tarefa pode estar como processing, success ou failed. Uma tarefa em processamento não foi liquidada apenas porque uma leitura de saldo permaneceu inalterada. Consulte o status da tarefa não mais do que a cada 30 segundos e retenha o estado final com o registro do resultado.
Explique gastos simultâneos sem atribuí-los ao arquivo
Verificações de operadora em tempo real e os serviços assíncronos compartilham um saldo. Se outra equipe realizar verificações enquanto sua tarefa em lote é executada, o saldo inicial menos o saldo final inclui esse trabalho. Outra reserva em lote também pode permanecer aberta ao final do período, tornando o saldo disponível um indicador ruim para cobranças liquidadas.
Em sua planilha, separe os valores atribuídos à tarefa dos movimentos de toda a conta. Concilie outras cobranças conhecidas, créditos e reservas pendentes usando evidências que você realmente possui. Se o residual não puder ser atribuído, relate como "diferença de carteira compartilhada não atribuída" com a janela de observação. Não o anexe a qualquer tarefa que tenha terminado por último.
Para uma diferença inexplicada, colete o ID da tarefa, tipo de serviço, carimbos de data/hora, resumo do arquivo, contagem preparada, estado final, contagem de resultados, observações de saldo e quaisquer detalhes de reserva ou liquidação disponíveis. Inclua se o trabalho em tempo real ou outras tarefas de arquivo foram executados simultaneamente. Compartilhe apenas os dados de contato mínimos necessários através do canal de suporte apropriado; nunca inclua uma chave de API.
Comece com a próxima tarefa em lote da operadora: mantenha sua versão de entrada e ID da tarefa juntos antes do envio. Esse pequeno passo torna o CSV final, a reserva liberada e qualquer discrepância restante rastreáveis à mesma peça de trabalho.
Saiba mais
Escolha as informações do produto que se ajustam ao próximo passo em seu fluxo de trabalho.