Exportar lista CSV de CNPJs

Quando migrar para export

• Quando o volume não cabe mais no fluxo paginado interativo.
• Quando o consumidor final precisa de CSV ou planilha.
• Quando a operação precisa reprocessar listas em lotes.

Exemplo de fluxo

# 1. cria o job
curl -X POST "https://api.orbioapi.com.br/v1/exports" \
  -H "Authorization: Bearer $ORBIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"spec": {...}, "format": "csv"}'

# 2. consulta o status
curl -H "Authorization: Bearer $ORBIO_API_KEY" \
  "https://api.orbioapi.com.br/v1/exports/exp_123"

# 3. faz o download
curl -L "https://download.orbioapi.com.br/exports/exp_123.csv" -o contas.csv

Checklist operacional

• Reuse os mesmos filtros validados na busca exploratória.
• Guarde o export_id para polling e auditoria.
• Registre snapshot, campos exportados e data do download.
• Se o arquivo alimentar CRM, normalize antes a chave de conta.

Erros comuns

• Polling agressivo demais em jobs longos.
• Mudar os filtros entre validação e export.
• Perder o contexto do snapshot e dificultar análise posterior.