Skip to main content

Migrando da ReceitaWS

A migração da ReceitaWS é simples. O endpoint /cnpj/{cnpj} suporta o parâmetro formato=receitaws, que retorna a resposta no mesmo formato que a API da ReceitaWS.

Passo 1: Altere a URL base

- https://receitaws.com.br/v1/cnpj/12345678000195
+ https://api.cnpj-api.com.br/v1/cnpj/12345678000195?token=SEU_TOKEN&formato=receitaws

Passo 2: Adicione autenticação

Adicione o parâmetro token na URL ou o header Authorization: Bearer {token}.

Passo 3: Teste

A resposta terá o mesmo formato que a ReceitaWS. Nenhuma alteração no parsing é necessária.

Diferenças

AspectoReceitaWSEsta API
AutenticaçãoVaria por planoToken via URL ou header
Rate limitVaria por plano5 req/min (gratuito)
Dados extrasApenas cadastroCadastro + logos + Simples
Formato nativoPróprioPróprio (com compatibilidade)

Quando remover o parâmetro formato

Recomendamos que, após validar a migração, você remova o parâmetro formato=receitaws e adapte seu código ao formato nativo desta API. O formato nativo oferece mais campos e dados estruturados.