Exportação
O Dunning exporta clientes e cobranças em CSV de duas formas: download imediato (síncrono), para recortes de até 10 mil linhas, e exportação em segundo plano (página Exportações), para bases grandes.
Download imediato (até 10 mil linhas)
O botão Exportar disponível nas telas gera o CSV na hora e baixa direto no navegador. Para cobranças, aceita filtros de status e de período de vencimento.
O limite é de 10.000 linhas por download. Se a sua base é maior que isso, o arquivo virá cortado — use a exportação em segundo plano, que existe exatamente para esse caso.
Exportações em segundo plano
A página Exportações do menu lateral gera planilhas grandes sem travar a tela e sem parar em 10 mil linhas. O fluxo:
- Clique em Nova exportação.
- Escolha o que exportar: Clientes ou Cobranças.
- Para cobranças, filtre se quiser: Status (por exemplo
overdue,paid,pending) e faixa de vencimento (de/até). - Clique em Gerar exportação. A geração roda em segundo plano; você pode continuar trabalhando.
Quando o arquivo fica pronto, você recebe uma notificação no sino e a linha da tabela muda para Pronta, com o botão Baixar. A tabela mostra o arquivo, o tipo, o número de linhas, o status (Na fila → Gerando → Pronta ou Falhou) e quando foi gerada.
Dois detalhes importantes:
- Teto de segurança: exportações assíncronas param em 100.000 linhas. Se a consulta passar disso, o arquivo é gerado até o teto e marcado explicitamente como (parcial) na tabela — nunca cortado em silêncio. Nesse caso, use os filtros para fatiar a exportação (por status ou por período de vencimento).
- Validade de 7 dias: o CSV pronto fica disponível para download por 7 dias. Depois disso aparece como expirada e o conteúdo é apagado (o arquivo carrega dados pessoais; não faz sentido retê-lo indefinidamente). Precisou de novo? Gere outra exportação.
O que sai no arquivo
- Clientes:
nome,documento,tipo_documento,email,telefone,classificacao,external_id,tags,criado_em. - Cobranças:
cliente,documento_cliente,numero_documento,descricao,valor_original,valor_atual,vencimento,dias_atraso,status,origem,external_id.
As colunas de clientes seguem o mesmo vocabulário da importação, então um CSV exportado serve de base para ajustes em massa: exporte, edite na planilha e importe de volta — a deduplicação por external_id/documento atualiza os registros em vez de duplicar.
Qual usar?
| Situação | Use |
|---|---|
| Recorte pequeno, preciso agora | Download imediato |
| Base completa ou acima de 10 mil linhas | Exportações (segundo plano) |
| Relatório recorrente para outra área | Exportações, com filtros salvos na sua rotina |
| Integração contínua com outro sistema | Prefira a API ou webhooks, não CSV |