Sintegra

Nossa API oferece uma forma rápida e eficiente de consultar informações cadastrais de empresas nos sistemas estaduais do Sintegra. Com ela, é possível verificar a regularidade fiscal, validar a Inscrição Estadual e obter dados detalhados de qualquer CNPJ ou Inscrição Estadual registrada no sistema.

Informações de entrada

Para realizar uma consulta na API, são necessários apenas dois parâmetros:

CNPJ: O número do Cadastro Nacional da Pessoa Jurídica (CNPJ) da empresa que deseja consultar. Deve ser informado sem pontos, traços ou barras (exemplo: 12345678000195).

Cache: Define se os dados podem ser retornados a partir de um cache recente ou se uma nova consulta deve ser realizada diretamente nas fontes oficiais. O valor aceito vai de 0 a 45, sendo que qualquer número acima de 0 indica que o cache deve ser utilizado, se disponível, enquanto o valor 0 força uma nova consulta, ignorando completamente o cache. O cache é compartilhado entre os clientes, o que significa que uma consulta realizada por um cliente pode alimentar o cache utilizado por outros.

Os valores aceitos para uf são: BR, AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP e TO.

BR realiza consulta em todas as UFs — cada UF consome 1 crédito, use somente se necessário.
Para consultar mais de uma UF, informe separando por vírgula.

Exemplo: ?uf=SP,RJ

Quando nenhuma UF é informada, a consulta é feita automaticamente na UF de registro do CNPJ, consumindo apenas 1 crédito.

Parâmetros Obrigatórios

Name
cnpj
Type
string
Description
Documento fiscal da empresa - pode ser informado em qualquer padrão de formatação contanto que esteja completo.

GET/consultas/v2/sintegra/{cnpj}

Sintegra

Esse endpoint habilita você receber os dados do Sintegra mais atualizados, consultados diretamente no Cadastro Centralizado de Contribuintes e os Sintegras Estaduais.

Atributos opcionais

Name
cache
Type
number
Description
Informa a API se ela pode consultar o cache ou não. Há um ganho significativo de performance, porém, a informação pode ter uma atraso. O valor default deste campo é 25.

Name
uf
Type
string
Description
Informa a API em quais UFs ela deve realizar a consulta. Os valores possíveis aqui são: BR, AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP, TO.
Onde BR inclui todas as UFs, porém cada UF custa um crédito use com atenção.

Requisição

GET

/consultas/v2/sintegra/{cnpj}?uf={ufs}

curl -G https://api.sintegrapi.com.br/consultas/v2/sintegra/15436940000103?uf=SP,MT,RJ \
  -H "x-api-key: {apiKey}" \
  -H "cache: 25"

Resposta

  {
      "cnpj": "15436940000103",
      "razao_social": "AMAZON SERVICOS DE VAREJO DO BRASIL LTDA.",
      "uf": "SP",
      "inscricoes_estaduais": [
          {
              "inscricao_estadual": "92029590",
              "uf": "RJ",
              "ativa": true,
              "data_status": "2015-11-27 00:00:00",
              "tipo_ie": "IE Substituto Tributário",
              "situacao_pj": "Sem restrição"
          },
          {
              "inscricao_estadual": "00136148808",
              "uf": "MT",
              "ativa": true,
              "data_status": "2016-02-23 00:00:00",
              "tipo_ie": "IE Substituto Tributário",
              "situacao_pj": "Sem restrição"
          },
      ],
      "request_id": "318be3b8-ec09-40b3-8140-f355b84affeb",
      "success": true,
      "error": false
  }

Variações relevantes nos campos de resposta

Abaixo estão descritas variações importantes que podem ocorrer nos campos retornados pela API.

Name
ativa
Type
bool
Description
Este campo pode assumir os valores true ou false.

Name
tipo_ie
Type
string
Description
- IE Normal.
- IE Substituto Tributário.
- IE Não Contribuinte (Canteiro de Obras, IE Virtual, outros).
- IE Contribuinte da UF com Endereço em Outra UF.
- IE de Produtor Rural.
- IE Não Informada.

Name
situacao_pj
Type
string
Description
- Sem restrição.
- Bloqueado como destinatário na UF.
- Vedada operação como destinatário na UF.
- Emitente bloqueado no destino.