API Sintegra

Documentação da API Sintegra

Recuperar dados de uma empresa no Sintegra

Método para recuperar as informações, incluindo a inscrição estadual de uma empresa brasileira através do CNPJ ou IE. As informações são exatamente as mesmas retornadas pelo site do Sintegra.

GET

URL para requisição 

https://www.sintegraws.com.br/api/v1/execute-api.php?token={token}&cnpj={cnpj}&plugin={ST}

Parâmetros de requisição da API do Sintegra

token
string

obrigatório
O seu token é gerado após o cadastro no portal.
Ver meu token

cnpj ou ie
string

obrigatório
CNPJ ou inscrição estadual que deseja obter as informações do Sintegra.

uf
string

obrigatório apenas quando consultar por IE
UF da inscrição estadual que deseja obter as informações do Sintegra.

plugin
string

obrigatório
Site no qual deseja as informações, no caso da API Sintegra informar "ST".

Exemplo de resposta da API Sintegra
Uma resposta típica é composta por um JSON.

Consultar por
  • Status: 200 OK
  • Time: 200 ms
  • Size: 2021 bytes 
{"code":"0","status":"OK","message":"Pesquisa realizada com sucesso.","cnpj":"06990590000123","inscricao_estadual":"149848403115","nome_empresarial":"Google brasil internet ltda.","nome_fantasia":"","situacao_cnpj":"Sem restri\u00e7\u00e3o","situacao_ie":"Ativo","situacao_ie_desc":"Habilitado","cnae_principal":{"code":"6319400","text":"Portais, provedores de conte\u00fado e outros servi\u00e7os de informa\u00e7\u00e3o na internet"},"cep":"04538133","uf":"SP","municipio":"S\u00e3o Paulo","bairro":"Itaim bibi","logradouro":"Avenida brig faria lima","numero":"3477","complemento":"Andar 17a20 tsul 2 17a20","regime_tributacao":"Normal","informacao_ie_como_destinatario":"Obrigat\u00f3ria","porte_empresa":"Demais empresas","tipo_inscricao":"IE Normal","data_inicio_atividade":"16-10-2007","data_fim_atividade":"","data_situacao_cadastral":"16-10-2007","contribuinte_icms":true,"outras_ies":[],"ibge":{"codigo_municipio":"3550308","codigo_uf":"35","ibge_municipio":"S\u00e3o Paulo"}}

Campos de retorno da API Sintegra

status string
Indica a situação da requisição.
Valores possíveis:
  • OK
  • ERROR
code string
Código de retorno utilizado para informar o status da requisição.
message string
Mensagem explicativa indicando o campo status.
cnpj string
CNPJ no formato 00000000000000.
inscricao_estadual string
Inscrição estadual.
nome_empresarial string
Razão social.
nome_fantasia string
Nome fantasia.
situacao_cnpj string
Situação cadastral do CNPJ.
situacao_ie string
Situação cadastral da inscrição estadual no Sintegra.
Valores possíveis:
  • Ativo
  • Inativo
  • Baixado
situacao_ie_desc string Novidade
Descrição da situação cadastral da inscrição estadual.
cnae_principal objeto
Atividade econômica principal.

cnae_principal.code string
Código do CNAE principal.
cnae_principal.text string
Descrição da atividade econômica principal.
cep string
CEP no formato 00000000.
uf string
Sigla da Unidade da Federação.
municipio string
Município.
bairro string
Bairro.
logradouro string
Logradouro.
numero string
Número.
complemento string
Complemento.
regime_tributacao string
Regime de tributação.
informacao_ie_como_destinatario string
Informação da inscrição estadual como destinatário.
porte_empresa string
Porte da empresa.
tipo_inscricao string
Tipo de inscrição estadual.
data_inicio_atividade string
Data do início da atividade no formato dd-MM-yyyy.
data_fim_atividade string
Data de fim da atividade no formato dd-MM-yyyy, quando disponível.
data_situacao_cadastral string
Data da situação cadastral no formato dd-MM-yyyy.
contribuinte_icms boolean Beta
Indica se a inscrição estadual é contribuinte de ICMS.
Valores possíveis:
  • true
  • false
outras_ies Array [objeto] Beta
Lista de outras inscrições estaduais vinculadas ao CNPJ.

outras_ies.inscricao_estadual string
Inscrição estadual.
outras_ies.uf string
Sigla da Unidade da Federação.
outras_ies.situacao_ie string
Situação cadastral da inscrição estadual.
Valores possíveis:
  • Ativo
  • Inativo
  • Baixado
outras_ies.contribuinte_icms boolean
Indica se a inscrição estadual é contribuinte de ICMS.
Valores possíveis:
  • true
  • false
ibge objeto
Informações de códigos IBGE.

ibge.codigo_municipio string
Código IBGE do município.
ibge.codigo_uf string
Código IBGE da UF.
ibge.ibge_municipio string Novidade
Nome do município conforme IBGE.
Retornos disponíveis
Status Request code status message
200 OK 0 OK Pesquisa realizada com sucesso.
200 OK 1 OK Nenhum estabelecimento encontrado no SINTEGRA.
200 OK 2 ERROR CNPJ inválido.
401 Unauthorized 3 ERROR Token inválido.
200 OK 4 ERROR Usuário não contratou nenhum pacote de créditos.
200 OK 5 ERROR Os créditos contratados acabaram.
200 OK 6 ERROR Plugin não existe.
200 OK 7 ERROR Site do Sintegra está com instabilidade.
200 OK 8 ERROR Ocorreu um erro interno, por favor contatar o nosso suporte.