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 capturados diretamente das 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_v2",
"q": "doc{CNPJ}"
}
Notas de Mudanças nos Dados Retornados
A consulta Sintegra disponibilizada cobria anteriormente a fonte centralizada Sefaz CCC, porém, como a captura pública dessa fonte se tornou inviável, as consultas nas respectivas fontes públicas estaduais do Sintegra foram reintegradas (todavia, apenas nos estados em que é possível/viável tal captura pública de dados). Devido a essa mudança na fonte Sintegra capturada (deixando de ser centralizada para ser específica nos estados/UFs), pode existir variações nos formatos de dados entre essas fontes estaduais, além é claro, em relação aos dados entregues pela antiga fonte centralizada CCC anteriormente capturada (majoritariamente com os dados IE históricos e agregados/unificados 'de todos estados' não sendo mais entregues). Sobre essas variações, para facilitar, por exemplo, a decodificar o status de uma Inscrição / Registro Estadual Sintegra, pode se utilizar o campo booleano HasActiveStatus (sendo true ou false), uma vez que o formato do dado do Status (situação cadastral) da IE varia, também, entre as fontes estaduais do Sintegra - esse campo booleano então é computado ao parsear os variados status IE retornados das fontes estaduais.
