Descrição
O dataset de consulta ao SINTEGRA retorna os dados extraídos da consulta ao SINTEGRA (Sistema Integrado de Informações Sobre Operações Interestaduais com Mercadorias e Serviços) no site oficial do governo. O Sintegra faz um controle informatizado das operações de entradas e saídas interestaduais que são realizadas por contribuintes de ICMS (Imposto sobre Circulação de Mercadorias e Serviços), concentrando essas informações e as comunicando para os fiscos estaduais, a Secretaria da Fazenda e a Receita Federal. É a partir deste registro que as empresas podem emitir notas fiscais para seus clientes.
Origem da Informação
As informações retornadas nesta consulta provém de dados avaliados do Cadastro Centralizado de Contribuintes, os quais são fornecidos pelas secretarias da fazenda de cada estado.
Tabela de preços para esse dataset
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10000 | R$ 0,090 |
| 10001 - 50000 | R$ 0,085 |
| 50001 - 100000 | R$ 0,081 |
| 100001 - 500000 | R$ 0,077 |
| 500001 - 1000000 | R$ 0,073 |
| 1000001 - 5000000 | R$ 0,069 |
| 5000001 - 10000000 | R$ 0,066 |
| 10000001 - 50000000 | R$ 0,063 |
| 50000001 e acima | R$ 0,060 |
Parâmetros de consulta
A tabela abaixo detalha os campos aceitos na consulta a este dataset.
| Campo | Descrição | Valores Possíveis | Tipo de Campo |
|---|---|---|---|
| doc | Documento de identificação | CNPJ | 🛑 Obrigatório |
| uf | Trata-se da Unidade Federativa (UF) do Estado onde se realizará a consulta. Caso não seja informada, utilizaremos por padrão a que consta no endereço principal associado internamente ao CNPJ. | Estado/UF da fonte a realizar a consulta. Ex: RJ, SP, MG, etc. | ⚠️ Semi-Obrigatório |
Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.
Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:
{
"Datasets": "ondemand_sintegra_company",
"q": "doc{CNPJ}"
}
Descrição dos campos do objeto principal de retorno
Alguns campos são sufixados por um número inteiro começando com zero, para designar que fazem parte do mesmo objeto no grupo de prefixo. O grupo de prefixo "Historic." designa as mudanças históricas do documento e inscrições estaduais associadas, enquanto o prefixo "StatesData." designa o mesmo documento em diferentes UFs e inscrições estaduais vinculadas. Já para o prefixo "StateRegistrationEntry.", é uma forma mais simplificada que agrega as informações de "StatesData." por UF (se presente).
| Campo | Descrição |
|---|---|
| Origin | Fonte dos Dados Entregues |
| InputParameters | Parâmetros de entrada |
| QueryDate | Data da consulta realizada |
| QueryResultData.IdNumber | Número de identificação (CNPJ) |
| QueryResultData.State | Estado |
| QueryResultData.OfficialName | Nome oficial (razão social) da empresa |
| QueryResultData.BusinessName | Nome fantasia |
| QueryResultData.FoundingDate | Data de Fundação |
| QueryResultData.StateRegistration | Inscrição Estadual |
| QueryResultData.Address.AddressCore.{i} | Núcleo do endereço |
| QueryResultData.Address.Number.{i} | Número de porta do endereço |
| QueryResultData.Address.Complement.{i} | Complemento do endereço |
| QueryResultData.Address.Neighborhood.{i} | Bairro do endereço |
| QueryResultData.Address.City.{i} | Cidade |
| QueryResultData.Address.State.{i} | Estado |
| QueryResultData.Address.ZipCode.{i} | CEP |
| QueryResultData.Address.Country.{i} | País |
| QueryResultData.Status | Status |
| QueryResultData.Statusdate | Data do Status |
| QueryResultData.Tributationregime | Regime de tributação |
| QueryResultData.Maincnae | Código CNAE de atividade principal |
| Stateregistrationinformationasrecipient | Informação da IE como destinatário |
| Companysize | Porte da empresa registrada |
| Presumedcredit | Crédito presumido |
| Producertype | Flag indicando se é do tipo produtor |
| Historic.Nsu.{i} | Número de movimentação do histórico |
| Historic.DocNumber.{i} | Número de documento do histórico |
| Historic.DocNumberStatus.{i} | Status do documento no histórico |
| Historic.State.{i} | Estado/UF do documento no histórico |
| Historic.StateRegistrationNumber.{i} | Número de inscrição estadual histórico |
| Historic.StateRegistrationStatus.{i} | Status da inscrição estadual histórica |
| Historic.ICMSRule.{i} | Regime tributário histórico |
| Historic.Reason.{i} | Motivo do registro histórico |
| Historic.StatusDate.{i} | Data de situação |
| Historic.UpdateDate.{i} | Data de atualização |
| StatesData.DocNumber.{i} | Número do mesmo documento em todas UF |
| StatesData.DocNumberStatus.{i} | Status do mesmo documento em todas UF |
| StatesData.AddressState.{i} | Estado/UF (endereço) de entrada para o documento |
| StatesData.StateOfRegistration.{i} | Estado/UF de entrada para o documento |
| StatesData.StateRegistrationNumber.{i} | Inscrição estadual para o estado/UF de entrada |
| StatesData.StateRegistrationStatus.{i} | Status da inscriçãoe estadual para o estado/UF de entrada |
| StatesData.StateRegistrationType.{i} | Tipo da inscrição estadual para o estado/UF de entrada |
| StateRegistrationEntry.{UF}.Number | Inscrição estadual para um UF específico (se houver entrada de dados) |
| StateRegistrationEntry.{UF}.Status | Status da inscrição estadual para um UF específico (se houver entrada de dados) |
| StateRegistrationEntry.{UF}.Type | Tipo da inscrição estadual para um UF específico (se houver entrada de dados) |
| RawResultFile_{OfficialName} | Link para URL de evidência (campo sufixado pelo nome oficial registrado) |
| RawResultFileType_{OfficialName} | Tipo da evidência, sendo html, pdf, json, etc (campo sufixado pelo nome oficial registrado) |
| QueryResultData.DetailedErrorMessage | Mensagem de erro mais detalhada (se presente) sobre a consulta |