Guia

Consultar CNPJ em lote via API

Para volume recorrente, combine recorte estável, execução em lotes e registro de snapshot para manter comparabilidade.

Proposta de valor

Consulta em lote reduz trabalho manual e melhora consistência da sua operação comercial. O ganho principal é previsibilidade: mesmo recorte, mesma base do mês, resultado comparável.

Exemplo prático

bash
curl -X POST "https://api.orbioapi.com.br/v1/accounts/search" \
  -H "Authorization: Bearer $ORBIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "spec": {
      "kind": "account_query",
      "spec_version": "2.0",
      "entity": "company",
      "filters": {
        "industry": { "cnae_any_of": ["6201-5/00"] },
        "geo": { "uf_any_of": ["SP", "MG"] },
        "company": { "registration_status_any_of": [2] }
      }
    },
    "limit": 100
  }'
ts
const payload = {
  spec: {
    kind: "account_query",
    spec_version: "2.0",
    entity: "company",
    filters: {
      industry: { cnae_any_of: ["6201-5/00"] },
      geo: { uf_any_of: ["SP", "MG"] },
      company: { registration_status_any_of: [2] },
    },
  },
  limit: 100,
};

Limitações

  • Lotes grandes sem checkpoint podem gerar retrabalho em caso de falha.
  • Mudar filtros no meio da execução dificulta comparação histórica.
  • Sem revisão de amostra, o lote pode carregar ruído para o CRM.
  • Use paginação com cursor para processar sem duplicidade.
  • Migre para export CSV quando o volume ficar contínuo.
  • Reforce linkagem interna a partir de guias com maior tráfego.

Próximos passos

Depois de validar o lote inicial, padronize o processo de export e registre evidências no tracker mensal.