Sintegra

Sintegra é a sigla de Sistema Integrado de Informações Sobre Operações Interestaduais com Mercadorias e Serviços: um sistema central que engloba informações dos contribuintes e realiza a sua comunicação para os fiscos de cada estado.

Este endpoint aceita três consultas — por CNPJ, por CPF + UF e por inscrição estadual + UF.

🚧 O corpo é repassado do provedor, sem transformação

O conteúdo de data é o que o provedor devolve, entregue como está dentro do envelope padrão. Três consequências práticas:

Os nomes dos campos estão em português, no vocabulário do provedor (razaoSocial, inscricaoEstadual, situacaoCadastral), e não no camelCase em inglês do resto da API.
Todo bloco é opcional. Um bloco só aparece quando o provedor tem dado para ele. Nunca assuma que uma chave existe: teste antes de acessar.
Não há garantia de tipo. Como não há conversão no caminho, o mesmo campo pode chegar como número ou como texto conforme a origem do dado.

A única transformação que a API aplica é remover os campos urlComprovante — veja abaixo.

Request

GET /receita-federal-and-sintegra/v1

É preciso informar um dos três conjuntos de parâmetros abaixo.

Parâmetros - Busca por CNPJ

Parâmetro	Descrição	Obrigatório
cnpj	CNPJ	Sim

Ex.: GET /receita-federal-and-sintegra/v1?cnpj=12.345.678/0001-95

O parâmetro taxId é aceito como sinônimo de cnpj e produz exatamente a mesma consulta. Prefira cnpj, que é o nome usado nos demais conjuntos.

Parâmetros - Busca por CPF + UF

Parâmetro	Descrição	Obrigatório
cpf	CPF	Sim
uf	UF	Sim

Ex.: GET /receita-federal-and-sintegra/v1?cpf=12345678909&uf=SP

Parâmetros - Busca por IE + UF

Parâmetro	Descrição	Obrigatório
ie	Inscrição estadual	Sim
uf	UF	Sim
iepr	Inscrição estadual do Paraná, usada como segunda tentativa quando `uf=PR`	Não

Ex.: GET /receita-federal-and-sintegra/v1?ie=111222333&uf=SP

iepr só tem efeito no Paraná

Com uf=PR, ie e iepr informados juntos, a consulta é tentada primeiro com a ie; se o Sintegra do Paraná não reconhecer a inscrição, ela é refeita com a iepr. Fora do Paraná, ou sem a ie junto, o iepr não é usado como segunda tentativa.

Formato do CNPJ e do CPF

TIP

O CNPJ ou CPF podem ser passados com ou sem máscara (12.345.678/0001-95 ou 12345678000195) e devem ser passados todos os chars, incluindo os zeros à esquerda.

Um CNPJ ou CPF que não passa na validação do dígito verificador devolve 422 antes de qualquer consulta.

CNPJ alfanumérico

O endpoint aceita o CNPJ alfanumérico definido pela IN RFB 2.229/2024, em que as oito primeiras posições da raiz e as quatro da ordem podem conter letras, e os dois dígitos verificadores continuam numéricos.

GET /receita-federal-and-sintegra/v1?cnpj=12ABC34501DE35

As letras podem ser enviadas em minúsculas: a API normaliza para maiúsculas antes de consultar o provedor. A máscara também é aceita: 12.ABC.345/01DE-35.

Headers

http

Authorization: ApiKey <sua-chave-de-api>

Parâmetro de query desconhecido é ignorado

Um parâmetro que não esteja entre taxId, cnpj, cpf, uf, ie e iepr não gera erro: ele é simplesmente ignorado.

Isso vale também para o caso em que nenhum identificador é informado. A chamada não é barrada na entrada — ela segue para o provedor, que responde sem resultado.

Exemplo Request

bash

curl -i -G 'https://api.nxcd.app/receita-federal-and-sintegra/v1' \
  --header 'Authorization: ApiKey SUA_CHAVE_AQUI' \
  --data-urlencode 'cnpj=12345678000195'

Response

Campo	Descrição	Tipo
id	ID único da requisição	`String`
version	Versão da API	`String`
data	Objeto com o resultado da busca	`Object`
data.cnpj	CNPJ consultado	`String`
data.receitaFederal	Dados cadastrais na Receita Federal. Só na busca por CNPJ.	`Object`
data.sintegra	Objeto com o resultado da busca	`Object`
data.sintegra.inscricoesEstaduais	Lista com os dados por IE encontrada	`Object[]`
metadata	Objeto com os metadados da requisição	`Object`
metadata.timeSpent	Tempo da requisição, em milissegundos	`Number`

🚧 Não há urlComprovante nesta resposta

A API remove o campo urlComprovante do bloco receitaFederal e de cada item de sintegra.inscricoesEstaduais antes de responder. O comprovante da consulta não é entregue por este endpoint.

Exemplos JSON

Veja alguns exemplos em JSON da resposta.

Exemplo quando dados encontrados

Status Code: 200

json

{
  "id": "13cfec7c-b238-4820-a4d1-5173e4c1418e",
  "version": "v1",
  "data": {
    "cnpj": "12345678000195",
    "sintegra": {
      "inscricoesEstaduais": [
        {
          "cnpj": "12345678000195",
          "inscricaoEstadual": "00.000.000-0",
          "razaoSocial": "EMPRESA LTDA",
          "nomeFantasia": "EMPRESA LTDA",
          "logradouro": "RUA",
          "numero": "10",
          "complemento": "COMPLEMENTO",
          "bairro": "CENTRO",
          "cep": "00000000",
          "municipio": "GOIANIA",
          "uf": "GO",
          "telefone": "",
          "atividadeEconomica": "4692300 - Comércio atacadista de mercadorias em geral, com predominância de insumos agropecuários (MERCADORIAS EM GERAL, COM PREDOMINÂNCIA DE INSUMOS AGROPECUÁRIOS; COMÉRCIO ATACADISTA DE)",
          "atividadesEconomicasSecundarias": [
            "4623109 - Comércio atacadista de alimentos para animais",
            "4644302 - Comércio atacadista de medicamentos e drogas de uso veterinário"
          ],
          "dataInicioAtividade": "",
          "dataSituacaoCadastral": "01/12/2000",
          "regimeRecolhimento": "Normal",
          "observacao": "",
          "situacaoCadastral": "Suspenso - NÃO HABILITADO",
          "situacaoCadastralTratada": 1,
          "ocorrenciaFiscal": "",
          "atividadeEconomicaTratada": "4930-2/02 - Transporte rodoviário de carga, exceto produtos perigosos e mudanças, intermunicipal, interestadual e internacional",
          "atividadesEconomicasSecundariasTratada": [
            "7719-5/99 - Locação de outros meios de transporte não especificados anteriormente, sem condutor",
            "4744-0/99 - Comércio varejista de materiais de construção em geral"
          ],
          "camposExclusivos": {}
        }
      ]
    }
  },
  "metadata": {
    "timeSpent": 10000
  }
}

Dois campos do item pedem explicação:

situacaoCadastralTratada normaliza a situacaoCadastral: 1 para as situações positivas (ATIVO, HABILITADO) e 0 para as negativas (INATIVO, SUSPENSO).
camposExclusivos é o espaço para dados exclusivos do Sintegra consultado. É de implementação opcional e pode vir vazio.

Headers de resposta

Header	Quando aparece
`Nextid-ReqId`	Em todas as respostas. Traz o identificador da requisição, o mesmo do campo `id` do corpo.

Erros

Código	Quando ocorre
401 Unauthorized	Chave de API ausente, inválida, ou sem a permissão `nextid.bureaus.rfAndSintegra`.
404 Not Found	A versão informada na URL não existe. Só `v1` é aceita.
422 Unprocessable Entity	CNPJ ou CPF que não passa na validação do dígito verificador.
500 Internal Server Error	Falha inesperada durante o processamento.

O 422 traz uma mensagem que identifica qual parâmetro reprovou:

Parâmetro	Mensagem
`cnpj`	`Invalid cnpj`
`cpf`	`Invalid cpf`
`taxId`	`Invalid taxId (CPF/CNPJ)`

taxId é validado como CNPJ

Apesar da mensagem citar CPF e CNPJ, o taxId deste endpoint é validado como CNPJ. Para consultar por CPF, use o parâmetro cpf junto com uf.

Exemplo de resposta com CNPJ inválido:

Status Code: 422

json

{
  "id": "13cfec7c-b238-4820-a4d1-5173e4c1418e",
  "error": {
    "statusCode": 422,
    "error": "Unprocessable Entity",
    "message": "Invalid cnpj"
  }
}

O formato das respostas de erro está descrito em Códigos HTTP das respostas.

Versões

A única versão é a v1, e ela é a que atende quando a versão é omitida na URL. /receita-federal-and-sintegra e /receita-federal-and-sintegra/v1 são equivalentes.

Versão	Situação	O que muda
v1	Recomendada	Única versão. É o que responde quando a versão é omitida na URL.

Qualquer outro valor no lugar de v1 devolve 404 com a mensagem API version not found.

Endpoint relacionado

Para o quadro societário do mesmo CNPJ, veja o QSA.

Classificador

Sintegra ​

Request ​

Parâmetros - Busca por CNPJ ​

Parâmetros - Busca por CPF + UF ​

Parâmetros - Busca por IE + UF ​

Formato do CNPJ e do CPF ​

CNPJ alfanumérico ​

Headers ​

Exemplo Request ​

Response ​

Exemplos JSON ​

Headers de resposta ​

Erros ​

Versões ​

Endpoint relacionado ​