CNPJ multifonte

Consulte Receita Federal, Sintegra, Suframa e Simples Nacional em uma única chamada, escolhendo de uma a quatro fontes. A resposta reúne os dados selecionados, com situação, identificador e créditos consumidos por cada fonte. Uma falha técnica não impede a consulta às demais fontes habilitadas.

Endpoint

GET https://api.sintegrapi.com.br/consultas/v2/cnpj-multifonte/{cnpj}

Use a mesma chave de API das consultas individuais, no cabeçalho x-api-key.

ParâmetroLocalObrigatórioDescrição
cnpjCaminhoSimCNPJ completo e válido, numérico ou alfanumérico. Aceita formatação.
receitaQuery stringNãotrue (padrão) inclui a Receita Federal; false desabilita esse recurso.
sintegraQuery stringNãotrue (padrão) inclui o Sintegra; false desabilita esse recurso.
suframaQuery stringNãotrue (padrão) inclui a Suframa; false desabilita esse recurso.
simplesQuery stringNãotrue (padrão) inclui o Simples Nacional; false desabilita esse recurso.
ufQuery stringNãoUma UF para o Sintegra, como SP. Quando omitida, utiliza a identificação automática. Ignorado se sintegra=false.

Cada parâmetro omitido vale true. Por exemplo, informar apenas suframa=false mantém Receita Federal, Sintegra e Simples Nacional habilitados. Use true ou false; valores inválidos retornam 400. Pelo menos uma fonte deve estar habilitada: os quatro parâmetros como false retornam 400 com código NENHUMA_FONTE_SELECIONADA, sem consulta nem cobrança.

Quando habilitado, o Sintegra consulta uma UF. Não aceita uf=BR, listas de UFs ou o adicional de endereço. Para essas opções, use o endpoint Sintegra.

curl 'https://api.sintegrapi.com.br/consultas/v2/cnpj-multifonte/15436940000103?uf=SP' \
  -H 'x-api-key: SUA_API_KEY'

Para consultar somente Receita Federal e Sintegra:

curl 'https://api.sintegrapi.com.br/consultas/v2/cnpj-multifonte/15436940000103?receita=true&sintegra=true&suframa=false&simples=false&uf=SP' \
  -H 'x-api-key: SUA_API_KEY'

Para consultar somente Suframa, use ?receita=false&sintegra=false&suframa=true&simples=false. Sem os quatro parâmetros de seleção, todas as fontes ficam habilitadas.

Os exemplos usam o CNPJ 15.436.940/0001-03, da Amazon. Esse documento já integra a lista de CNPJs de teste da Sintegrapi e é isento de créditos; por isso, o exemplo de resposta abaixo apresenta creditos: 0. Para outros CNPJs, vale a cobrança por fonte descrita a seguir.

Créditos

FonteConsulta concluída, incluindo “não encontrado”Erro técnico
Receita Federal1 crédito0
Sintegra1 crédito0
Suframa1 crédito0
Simples Nacional1 crédito0
TotalAté 4 créditosDevolução da reserva da fonte com erro

No pré-pago, a API reserva um crédito por fonte selecionada, antes de executar as consultas: uma fonte exige um crédito, duas exigem dois, três exigem três e quatro exigem quatro. Se não houver saldo suficiente, responde 402, cancela as reservas já feitas e não executa consultas.

Cada fonte selecionada que conclui sem erro técnico consome um crédito, mesmo que informe “não encontrado”. Fontes desabilitadas não geram reserva, cobrança ou registro de uso. Não existe cobrança adicional pela chamada multifonte.

Pós-pago, contas de sistema e documentos de teste mantêm as regras de consumo e isenção já existentes. A consulta em cache tem o mesmo custo da consulta online.

Resposta

A resposta inclui somente as fontes selecionadas; por exemplo, suframa=false remove a chave suframa do resultado. O parâmetro receita controla a chave receita_federal; simples controla simples_nacional.

Cada chave de fontes contém request_id, status_http, creditos, cobranca_pendente e dados. O conteúdo de dados mantém o contrato do endpoint individual correspondente:

  • receita_federal: cadastro da Receita Federal, com seus campos dentro de response.
  • sintegra: dados e inscrições estaduais.
  • suframa: inscrição, situação e demais informações disponíveis.
  • simples_nacional: opção pelo Simples Nacional e SIMEI, históricos e eventos futuros de IBS/CBS quando disponíveis.

Exemplo completo, com as quatro fontes selecionadas para o CNPJ 15436940000103. Os blocos dados reproduzem integralmente os retornos das consultas individuais à Sintegrapi em 22/10/2026, organizados no formato multifonte. O request_id principal é ilustrativo; cada fonte conserva o identificador do retorno consultado. Campos opcionais seguem o contrato de cada fonte: podem ser null ou não aparecer quando não se aplicam.

Nesse retorno, a Suframa informa “não encontrado” (status_http: 404, error: false), e o Simples Nacional informa que a empresa não é optante, sem eventos futuros. As quatro consultas foram concluídas; por isso, o resultado geral é bem-sucedido. O total de zero créditos decorre da isenção desse CNPJ de teste, e não da ausência de cadastro ou de opção pelo Simples.

{
  "request_id": "5ef8f5fd-57b7-4370-96fa-0124e6754447",
  "success": true,
  "error": false,
  "parcial": false,
  "creditos": 0,
  "cobranca_pendente": false,
  "fontes": {
    "receita_federal": {
      "request_id": "b177b6fd-4772-4e58-9642-82ed2643ffdb",
      "status_http": 200,
      "creditos": 0,
      "cobranca_pendente": false,
      "dados": {
        "request_id": "b177b6fd-4772-4e58-9642-82ed2643ffdb",
        "success": true,
        "error": false,
        "response": {
          "cnpj": "15436940000103",
          "identificador_matriz_filial": "Matriz",
          "data_de_abertura": "2012-04-02",
          "nome_empresarial": "AMAZON SERVICOS DE VAREJO DO BRASIL LTDA.",
          "nome_fantasia": "Amazon.Com.Br",
          "atividade_economica_principal": {
            "codigo": "4761001",
            "descricao": "Comércio varejista de livros"
          },
          "atividades_economicas_secundarias": [
            {
              "codigo": "4530703",
              "descricao": "Comércio a varejo de peças e acessórios novos para veículos automotores"
            },
            {
              "codigo": "4530705",
              "descricao": "Comércio a varejo de pneumáticos e câmaras-de-ar"
            },
            {
              "codigo": "4541206",
              "descricao": "Comércio a varejo de peças e acessórios novos para motocicletas e motonetas"
            },
            {
              "codigo": "4713004",
              "descricao": "Lojas de departamentos ou magazines, exceto lojas francas (Duty free)"
            },
            {
              "codigo": "4721104",
              "descricao": "Comércio varejista de doces, balas, bombons e semelhantes"
            },
            {
              "codigo": "4723700",
              "descricao": "Comércio varejista de bebidas"
            },
            {
              "codigo": "4729699",
              "descricao": "Comércio varejista de produtos alimentícios em geral ou especializado em produtos alimentícios não especificados anteriormente"
            },
            {
              "codigo": "4732600",
              "descricao": "Comércio varejista de lubrificantes"
            },
            {
              "codigo": "4744001",
              "descricao": "Comércio varejista de ferragens e ferramentas"
            },
            {
              "codigo": "4751201",
              "descricao": "Comércio varejista especializado de equipamentos e suprimentos de informática"
            },
            {
              "codigo": "4752100",
              "descricao": "Comércio varejista especializado de equipamentos de telefonia e comunicação"
            },
            {
              "codigo": "4753900",
              "descricao": "Comércio varejista especializado de eletrodomésticos e equipamentos de áudio e vídeo"
            },
            {
              "codigo": "4754701",
              "descricao": "Comércio varejista de móveis"
            },
            {
              "codigo": "4755503",
              "descricao": "Comercio varejista de artigos de cama, mesa e banho"
            },
            {
              "codigo": "4759899",
              "descricao": "Comércio varejista de outros artigos de uso doméstico não especificados anteriormente"
            },
            {
              "codigo": "4761003",
              "descricao": "Comércio varejista de artigos de papelaria"
            },
            {
              "codigo": "4763601",
              "descricao": "Comércio varejista de brinquedos e artigos recreativos"
            },
            {
              "codigo": "4763603",
              "descricao": "Comércio varejista de bicicletas e triciclos; peças e acessórios"
            },
            {
              "codigo": "4771704",
              "descricao": "Comércio varejista de medicamentos veterinários"
            },
            {
              "codigo": "4772500",
              "descricao": "Comércio varejista de cosméticos, produtos de perfumaria e de higiene pessoal"
            },
            {
              "codigo": "4773300",
              "descricao": "Comércio varejista de artigos médicos e ortopédicos"
            },
            {
              "codigo": "4774100",
              "descricao": "Comércio varejista de artigos de óptica"
            },
            {
              "codigo": "4789002",
              "descricao": "Comércio varejista de plantas e flores naturais"
            },
            {
              "codigo": "4789004",
              "descricao": "Comércio varejista de animais vivos e de artigos e alimentos para animais de estimação"
            },
            {
              "codigo": "4789005",
              "descricao": "Comércio varejista de produtos saneantes domissanitários"
            },
            {
              "codigo": "4789007",
              "descricao": "Comércio varejista de equipamentos para escritório"
            },
            {
              "codigo": "4789099",
              "descricao": "Comércio varejista de outros produtos não especificados anteriormente"
            },
            {
              "codigo": "5211799",
              "descricao": "Depósitos de mercadorias para terceiros, exceto armazéns gerais e guarda-móveis"
            },
            {
              "codigo": "5811500",
              "descricao": "Edição de livros"
            },
            {
              "codigo": "5911101",
              "descricao": "Estúdios cinematográficos"
            },
            {
              "codigo": "5911199",
              "descricao": "Atividades de produção cinematográfica, de vídeos e de programas de televisão não especificadas anteriormente"
            },
            {
              "codigo": "5913800",
              "descricao": "Distribuição cinematográfica, de vídeo e de programas de televisão"
            },
            {
              "codigo": "6202300",
              "descricao": "Desenvolvimento e licenciamento de programas de computador customizáveis"
            },
            {
              "codigo": "6203100",
              "descricao": "Desenvolvimento e licenciamento de programas de computador não customizáveis"
            },
            {
              "codigo": "6204000",
              "descricao": "Consultoria em tecnologia da informação"
            },
            {
              "codigo": "6311900",
              "descricao": "Tratamento de dados, provedores de serviços de aplicação e serviços de hospedagem na Internet"
            },
            {
              "codigo": "6319400",
              "descricao": "Portais, provedores de conteúdo e outros serviços de informação na Internet"
            },
            {
              "codigo": "6499999",
              "descricao": "Outras atividades de serviços financeiros não especificadas anteriormente"
            },
            {
              "codigo": "6619399",
              "descricao": "Outras atividades auxiliares dos serviços financeiros não especificadas anteriormente"
            },
            {
              "codigo": "7319002",
              "descricao": "Promoção de vendas"
            },
            {
              "codigo": "7319004",
              "descricao": "Consultoria em publicidade"
            },
            {
              "codigo": "7319099",
              "descricao": "Outras atividades de publicidade não especificadas anteriormente"
            },
            {
              "codigo": "7490104",
              "descricao": "Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários"
            },
            {
              "codigo": "8211300",
              "descricao": "Serviços combinados de escritório e apoio administrativo"
            },
            {
              "codigo": "8220200",
              "descricao": "Atividades de teleatendimento"
            },
            {
              "codigo": "8291100",
              "descricao": "Atividades de cobrança e informações cadastrais"
            },
            {
              "codigo": "8299799",
              "descricao": "Outras atividades de serviços prestados principalmente às empresas não especificadas anteriormente"
            }
          ],
          "natureza_juridica": {
            "codigo": "2062",
            "descricao": "Sociedade Empresária Limitada"
          },
          "tipo_logradouro": null,
          "logradouro": "Avenida Pres Juscelino Kubitschek",
          "numero": "2041",
          "bairro": "Vila Nova Conceicao",
          "complemento": "Andar Rec5 6 8 9 10 12AO23PAVMTOANDAR 17 Parte",
          "cep": "04543011",
          "municipio": "São Paulo",
          "uf": "SP",
          "endereco_eletronico": "amzbr-tax-compliance@amazon.com",
          "telefone": "1141302000",
          "ente_federativo_responsavel": null,
          "situacao_cadastral": "Ativa",
          "data_da_situacao_cadastral": "2012-04-02",
          "situacao_especial": null,
          "data_da_situacao_especial": null,
          "porte": "DEMAIS",
          "socios": [
            {
              "nome": "Ricardo Jose Thomaz Pagani",
              "cpf_cnpj_socio": "***678298**",
              "qualificacao_socio": "Administrador",
              "data_entrada_sociedade": "2017-08-10 00:00:00",
              "pais": null,
              "documento_representante_legal": null,
              "nome_representante_legal": null,
              "faixa_etaria": "61-70"
            },
            {
              "nome": "Juliana Soibelmann Sztrajtman",
              "cpf_cnpj_socio": "***185588**",
              "qualificacao_socio": "Administrador",
              "data_entrada_sociedade": "2025-02-13 00:00:00",
              "pais": null,
              "documento_representante_legal": null,
              "nome_representante_legal": null,
              "faixa_etaria": "41-50"
            },
            {
              "nome": "RAINFOREST HOLDCO 1 LLC",
              "cpf_cnpj_socio": "28886481000101",
              "qualificacao_socio": "Sócio Pessoa Jurídica Domiciliado no Exterior",
              "data_entrada_sociedade": "2017-11-30 00:00:00",
              "pais": null,
              "documento_representante_legal": "***747448**",
              "nome_representante_legal": "Fernando Gentil Monteiro",
              "faixa_etaria": null
            }
          ]
        }
      }
    },
    "sintegra": {
      "request_id": "8dd35915-538f-4614-8bf1-cf7fc0105a3b",
      "status_http": 200,
      "creditos": 0,
      "cobranca_pendente": false,
      "dados": {
        "cnpj": "15436940000103",
        "razao_social": "AMAZON SERVICOS DE VAREJO DO BRASIL LTDA.",
        "uf": "SP",
        "inscricoes_estaduais": [
          {
            "inscricao_estadual": "145214552117",
            "uf": "SP",
            "ativa": true,
            "tipo_ie": "IE Substituto Tributário",
            "situacao_pj": "Sem restrição",
            "updated_at": "2026-10-22 20:08:37"
          }
        ],
        "request_id": "8dd35915-538f-4614-8bf1-cf7fc0105a3b",
        "success": true,
        "error": false,
        "is_cache": false
      }
    },
    "suframa": {
      "request_id": "b3c7ae50-97a6-4a00-ad1f-df453804fcb6",
      "status_http": 404,
      "creditos": 0,
      "cobranca_pendente": false,
      "dados": {
        "desde": "",
        "matriz": false,
        "aprovado": false,
        "request_id": "b3c7ae50-97a6-4a00-ad1f-df453804fcb6",
        "success": false,
        "error": false,
        "error_message": {
          "message": "O CNPJ não foi localizado no cadastro do SUFRAMA."
        }
      }
    },
    "simples_nacional": {
      "request_id": "d7267df7-6e07-4cd1-aa9b-cab58afed8ad",
      "status_http": 200,
      "creditos": 0,
      "cobranca_pendente": false,
      "dados": {
        "request_id": "d7267df7-6e07-4cd1-aa9b-cab58afed8ad",
        "success": true,
        "error": false,
        "cnpj": "15436940000103",
        "atualizado_em": "2026-10-21T16:16:37.242Z",
        "simples_nacional": {
          "optante": false,
          "historico": [],
          "eventos_futuros": []
        },
        "simei": {
          "optante": false,
          "historico": []
        }
      }
    }
  }
}

Na resposta multifonte, success=true significa que todas as fontes selecionadas foram concluídas sem erro técnico, incluindo resultados “não encontrado”. Por isso, verifique também dados.success e dados.error de cada fonte. O status_http interno preserva a situação da consulta individual: por exemplo, a ausência de cadastro na Suframa é 404, sem tornar a chamada multifonte uma falha técnica. O contrato individual do Simples Nacional usa 200 também em alguns retornos com erro; sempre verifique dados.error. Um erro técnico nessa fonte continua sem cobrança e afeta o status geral da chamada.

creditos informa o consumo confirmado da chamada; por fonte, informa o consumo daquela consulta. Os identificadores das fontes selecionadas correspondem aos seus registros individuais no histórico de uso. O identificador principal serve para correlacionar a operação.

Se a chamada for bloqueada antes da execução, as fontes não consultadas podem aparecer com status_http=424 e sem dados. Esses identificadores não representam consultas concluídas nem cobrança confirmada.

Falhas parciais e novas tentativas

HTTP da chamadaSignificado
200Todas as fontes selecionadas concluídas, incluindo possíveis resultados “não encontrado”.
207Resultado parcial: pelo menos uma fonte concluiu e outra apresentou erro técnico.
400CNPJ, UF aplicável ou booleano inválido, ou nenhuma fonte selecionada; nenhuma consulta executada.
401Autenticação ausente ou inválida.
402Saldo insuficiente para reservar as consultas selecionadas.
429Limite de requisições ou de consultas gratuitas por IP atingido.
503Nenhuma fonte concluiu, ou houve falha que impede confirmar a cobrança. Confira os resultados individuais.

Em uma resposta parcial, os dados das fontes concluídas continuam disponíveis. A fonte com erro técnico tem dados.error=true e creditos=0 quando sua reserva foi devolvida. Se duas fontes concluírem, o total será dois créditos.

Não repita automaticamente todas as fontes. Uma nova chamada é uma nova operação e poderá cobrar novamente as fontes que já concluíram. Após um 207, preserve os resultados recebidos e, se necessário, consulte apenas a fonte que falhou pelo endpoint individual ou desabilitando as demais fontes nesta rota.

Se a confirmação no banco for interrompida, cobranca_pendente=true e creditos=null indicam que o consumo ainda precisa ser conferido. null não significa gratuidade. Guarde os request_id e confira o histórico ou acione o suporte antes de repetir. Uma desconexão também pode ocorrer após uma fonte já ter concluído.

Atualização dos dados

A consulta multifonte reutiliza os serviços de consulta existentes. Receita Federal e Sintegra utilizam ONLINE_PREFERENCIAL com janela de cache de sete dias; Suframa mantém o comportamento do seu provedor. Simples Nacional utiliza o padrão do endpoint individual, com cache de sete dias e fallback habilitado. Cada fonte pode ter uma data de atualização diferente.

A resolução automática de UF do Sintegra pode utilizar consultas cadastrais auxiliares mesmo quando receita=false. Isso não inclui o recurso Receita Federal na resposta nem acrescenta crédito; informar uma UF evita essa resolução automática.

Nesta versão, os parâmetros aceitos são cnpj, uf, receita, sintegra, suframa e simples. Para controlar cache, consulta nacional, endereço ou outras opções específicas, utilize os endpoints individuais.

Esta página foi útil?