Faixa de faturamento (derivada do porte) e faixa de funcionários

São dois campos com origens muito diferentes, e vale saber qual é qual antes de usar qualquer um dos dois numa decisão.

Faixa de faturamento é derivada do porte

A faixa de faturamento é uma função do porte declarado, e de nada mais. Um porte entra, um texto de faixa sai; a mesma entrada devolve sempre a mesma saída. Não há apuração, não há modelo e não há dado de terceiro no meio.

Para deixar isso explícito na própria resposta, o campo vem com um irmão: faixa_faturamento.origem, que é a constante porte. Ele não varia — existe para que qualquer sistema que consuma a API saiba, sem ler documentação, de onde a faixa veio.

Consequência prática: a faixa não distingue duas empresas de mesmo porte. Toda empresa fora dos limites do Simples Nacional recebe o mesmo texto, do restaurante de bairro à companhia aberta. Onde o porte é grosso, a faixa é igualmente grossa.

Faixa de funcionários é outra coisa

faixa_funcionarios não vem do cadastro do CNPJ. É enriquecimento da Oportunidados, entregue como texto, e pode assumir duas formas: um número exato, como 37, ou um intervalo, como Entre 12 e 40. Vem null quando não há dado.

Quem precisa de número tem de tratar as duas formas no cliente. Converter direto para inteiro quebra na primeira faixa que chegar.

Como a API devolve

"faixa_faturamento": {
  "faixa": "Superior a R$4.800.000,00",
  "origem": "porte"
},
"faixa_funcionarios": "Entre 12 e 40"

Perfil full, os dois. O objeto de faturamento inteiro vem null quando não há porte para traduzir. A busca de empresas não filtra por nenhum dos dois; para recortar por tamanho, o filtro disponível é porte, que é a mesma informação um passo antes.

Como usar

• Priorização de fila: use a faixa para separar conta pequena de conta grande no topo do funil, com a mesma confiança que você daria ao porte — porque é o porte.
• Roteamento comercial: a faixa de funcionários costuma discriminar melhor dentro do balde de empresas maiores, quando existe.
• Cadastro: guarde os dois como texto, junto com origem e com a data da base; converter para número perde a informação de que é intervalo.
• Não use: para score de crédito, para projeção de receita ou para qualquer número que vá a um relatório como se fosse faturamento apurado. A base não tem esse dado, e a faixa não é substituto dele.

Campos completos em Campos da resposta.