7 · Lotes — consultas em massa
Para carteiras: suba um arquivo com centenas ou milhares de documentos e o sistema processa como dossiês individuais, um por linha.
7.1 Quando o lote é a ferramenta certa
Use lote quando o volume torna a consulta manual inviável e você quer o MESMO perfil aplicado a todos:
| Cenário | Lote resolve? |
|---|---|
| Homologar 800 fornecedores no mesmo perfil Compliance PJ | Sim — é o caso clássico |
| Revisar a carteira de crédito no início do mês | Sim, combinado com Monitoramento (cap. 6) |
| Investigar UMA rede de vínculos | Não — isso é UpLink (cap. 4) |
| Perfis diferentes por documento | Não num lote só — separe por perfil |
7.2 O arquivo
.csvou.txt, até 10 MB e 5.000 linhas por arquivo;- codificação UTF-8 ou Latin-1 (UTF-16 é recusado com essa mensagem — reexporte a planilha como CSV UTF-8);
- separador vírgula, ponto-e-vírgula ou tabulação — detectado sozinho, você não configura nada;
- precisa de uma coluna de documento. O cabeçalho aceito é qualquer um
destes:
documento,cpf,cnpj,cpf_cnpj,cpf/cnpj,document,doc. Sem nenhum deles, o upload é recusado antes de cobrar; - CPF e CNPJ podem vir na mesma coluna, com ou sem máscara — o sistema normaliza e detecta o tipo por linha.
Exemplo do formato mínimo:
documento
11.222.333/0001-81
529.982.247-25
00000000000
Linha vazia é ignorada. Documento inválido — dígito verificador errado,
tamanho errado ou todos os dígitos iguais, como a terceira linha do exemplo —
é marcado CPF inválido / CNPJ inválido com o número da linha, para
você achar e corrigir na planilha. Nada disso custa: a validação acontece
antes de qualquer cobrança, e a prévia mostra a contagem de válidas ×
rejeitadas para você decidir.
7.3 O fluxo
- Upload → validação → prévia com contagem e custo total;
- você confirma; o lote entra na fila e processa em ritmo controlado;
- acompanhe o progresso na tela do lote: concluídas, em andamento, falhas;
- falhas são reprocessáveis — o botão de reprocessar tenta só as linhas que falharam, sem recobrar as concluídas.
O selo de estado na lista de lotes tem seis valores:
| Selo | Significado |
|---|---|
| Aguardando | Na fila; ainda não começou a processar |
| Processando | As linhas rodam em ritmo controlado (a tela atualiza sozinha) |
| Concluído | Todas as linhas terminaram sem falha |
| Concluído com falhas | Parte das linhas falhou — reprocessável sem recobrar o resto |
| Falhou | O lote inteiro falhou |
| Cancelado | Interrompido por um manager |
7.4 O que observar
- O lote usa a MESMA franquia dos dossiês: 1.000 linhas = 1.000 consultas. Confira o contador do mês antes de confirmar lote grande.
- Documentos repetidos dentro da janela de reaproveitamento não pagam fonte de novo (mesma regra do capítulo 2).
- Lote interrompido não se perde: um vigia redespacha consultas confirmadas que ficaram para trás.