Documentação Técnica

Consulta do SINTEGRA

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 empresas e produtores rurais 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êsValor por consulta
1 - 10000R$ 0,090
10001 - 50000R$ 0,085
50001 - 100000R$ 0,081
100001 - 500000R$ 0,077
500001 - 1000000R$ 0,073
1000001 - 5000000R$ 0,069
5000001 - 10000000R$ 0,066
10000001 - 50000000R$ 0,063
50000001 e acimaR$ 0,060

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCPF🛑 Obrigatório
ufTrata-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 CPF.Estado/UF da fonte a realizar a consulta. Ex: RJ, SP, MG, etc.⚠️ Semi-Obrigatório
birthdateData de Nascimentoyyyy-MM-ddℹ️  Opcional
dateformatFormato da Datayyyy-MM-dd, dd/MM/yyyyℹ️  Opcional

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_person",
    "q": "doc{CPF}"  
}  

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).

CampoDescrição
OriginFonte dos Dados Entregues
InputParametersParâmetros de entrada
QueryDateData da consulta realizada
QueryResultData.IdNumberNúmero de identificação (CPF)
QueryResultData.StateEstado
QueryResultData.OfficialNameNome do indivíduo
QueryResultData.BusinessNameNome da fazenda
QueryResultData.FoundingDateData de Fundação
QueryResultData.StateRegistrationInscriçã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.StatusStatus
QueryResultData.StatusdateData do Status
QueryResultData.TributationregimeRegime de tributação
QueryResultData.MaincnaeCódigo CNAE de atividade principal
StateregistrationinformationasrecipientInformação da IE como destinatário
CompanysizePorte da empresa registrada
PresumedcreditCrédito presumido
ProducertypeFlag 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}.NumberInscrição estadual para um UF específico (se houver entrada de dados)
StateRegistrationEntry.{UF}.StatusStatus da inscrição estadual para um UF específico (se houver entrada de dados)
StateRegistrationEntry.{UF}.TypeTipo 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.DetailedErrorMessageMensagem de erro mais detalhada (se presente) sobre a consulta
Language
Credentials
Click Try It! to start a request and see the response here!