CCC – Consulta CPF Produtor Rural
A API oferece uma forma direta e eficiente de consultar informações de Produtores Rurais registrados no Cadastro Centralizado de Contribuintes (CCC). Com ela, é possível verificar a situação cadastral do CPF, identificar enquadramentos específicos e obter dados oficiais vinculados ao cadastro.
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: AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, MT, RJ, RN, RO, RR, RS, SC, SE, SP e TO.
- Quando nenhuma UF é informada, a consulta retorna um erro.
- Caso necessite consultar todas as UFs, será necessário realizar uma consulta para cada UF.
Informações de entrada
Para realizar a consulta, são necessários apenas dois atributos obrigatórios:
- Name
cpf- Type
- string
- Description
Informe o CPF do Produtor Rural - pode ser informado em qualquer padrão de formatação contanto que esteja completo e seja válido. Exemplo:
41012345678
- Name
uf- Type
- string
- Description
Informa a API em quais UFs ela deve realizar a consulta. Os valores possíveis aqui são: AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, MT, RJ, RN, RO, RR, RS, SC, SE, SP, TO.
Este endpoint não permite consultar todas as UFs de uma vez. Caso queira fazer isso, será necessário realizar uma chamada para cada UF desejada.
Simples
A diferença entre essa consulta e a 'Completa' é que essa retorna menos dados, não retorna por exemplo, dados de endereçamento. Essa é focada em retornar as IEs. Essa consulta é mais estável que a outra, já que ela captura menos dados da página da CCC.
Você deve usar esta consulta se:
- Não precisa dos dados de endereço
- Precisa de maior estabilidade operacional
- Quer um layout praticamente idêntico ao da consulta Sintegra, facilitando a integração
- Dados completamente normalizados
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.
Requisição
curl -G https://api.sintegrapi.com.br/consultas/v3/ccc-cpf-light/41012345678?uf=MT \
-H "x-api-key: {apiKey}" \
-H "cache: 25"
Resposta
{
"cpf": "41241231",
"nome": "JOAO DA SILVA",
"uf": "MT",
"inscricoes_estaduais": [
{
"inscricao_estadual": "00133685622",
"uf": "MT",
"ativa": true,
"data_status": "2021-09-28",
"tipo_ie": "IE de Produtor Rural"
}
],
"request_id": "d378de7d-128c-4b49-8d03-06866c22b16b",
"success": true,
"error": false
}
Completa
Esta consulta retorna o conjunto completo de informações do Produtor Rural cadastradas no Cadastro Centralizado de Contribuintes (CCC).
Além da situação cadastral do CPF e das Inscrições Estaduais (IEs) vinculadas, a versão completa inclui dados de endereçamento e informações complementares disponíveis no cadastro.
Por capturar um volume maior de dados diretamente da página do CCC, esta consulta pode apresentar menor estabilidade operacional em comparação à versão simples, especialmente em cenários de variação no layout da fonte. Você deve usar esta consulta se:
- Precisa dos dados de endereço
- Necessita das informações cadastrais completas do Produtor Rural
- Aceita menor estabilidade em troca de maior riqueza de dados
- Dados normalizados no nível essencial
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.
Requisição
curl -G https://api.sintegrapi.com.br/consultas/v3/ccc-cpf/41012345678?uf=MT \
-H "x-api-key: {apiKey}" \
-H "cache: 25"
Resposta
{
"inscricoes_estaduais": [
{
"nome_empresa": "JOSE DA SILVA",
"uf": "MT",
"cpf": "41012345678",
"situacao_cpf": "Sem restrição",
"inscricao_estadual": "567890",
"situacao_ie": "Habilitado",
"tipo_ie": "IE de Produtor Rural",
"cnae_principal": "",
"data_situacao_uf": "2008-02-07",
"dados_contribuinte": {
"nome_fantasia": "FAZENDA ESTÂNCIA PANTANALFAZENDA ESTÂNCIA PANTANAL",
"data_inicio_atividade": "2008-02-07",
"regime_tributacao": "Não informado",
"informacao_ie_como_destinatario": "Opcional",
"porte_empresa": "Não informado",
"credito_presumido": "Não",
"tipo_produtor": "Não"
},
"dados_endereco": {
"municipio_ibge": "4118303",
"municipio_nome": "CUIABA",
"uf_localizacao": "MT",
"logradouro": "Estrada Das Lagrimas",
"numero": "null",
"complemento": "",
"bairro": "Rural",
"cep": "87680000"
},
"historico": [
{
"nsu_movimento": "135340069",
"uf": "MT",
"cpf": "41012345678",
"ie": "567890",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"regime_icms": "Não informado",
"data_situacao": "2008-02-07",
"data_atualizacao": "2021-05-07",
"motivo": "Alteração"
},
{
"nsu_movimento": "113101119",
"uf": "MT",
"cpf": "41012345678",
"ie": "567890",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"regime_icms": "Não informado",
"data_situacao": "2008-02-07",
"data_atualizacao": "2019-11-05",
"motivo": "Alteração"
},
{
"nsu_movimento": "112047123",
"uf": "MT",
"cpf": "41012345678",
"ie": "567890",
"situacao_ie": "Não Habilitado",
"situacao_cpf": "Vedada operação como Destinatário na UF",
"regime_icms": "Não informado",
"data_situacao": "2019-10-16",
"data_atualizacao": "2019-10-16",
"motivo": "Alteração"
},
{
"nsu_movimento": "87346005",
"uf": "MT",
"cpf": "41012345678",
"ie": "567890",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"regime_icms": "Não informado",
"data_situacao": "2008-02-07",
"data_atualizacao": "2018-10-02",
"motivo": "Inclusão"
}
],
"mesmo_cnpj": [
{
"uf_cadastro": "MT - 41",
"cpf": "41012345678",
"ie": "567890",
"tipo_ie": "IE de Produtor Rural",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"uf_endereco": "MT"
},
{
"uf_cadastro": "MT - 41",
"cpf": "41012345678",
"ie": "1234567",
"tipo_ie": "IE de Produtor Rural",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"uf_endereco": "MT"
}
]
},
{
"nome_empresa": "JOAO DA SILVA",
"uf": "MT",
"cpf": "41012345678",
"situacao_cpf": "Sem restrição",
"inscricao_estadual": "1234567",
"situacao_ie": "Habilitado",
"tipo_ie": "IE de Produtor Rural",
"cnae_principal": "",
"data_situacao_uf": "2008-02-15",
"dados_contribuinte": {
"nome_fantasia": "FAZENDA ESTÂNCIA PANTANAL",
"data_inicio_atividade": "2008-02-15",
"regime_tributacao": "Não informado",
"informacao_ie_como_destinatario": "Opcional",
"porte_empresa": "Não informado",
"credito_presumido": "Não",
"tipo_produtor": "Não"
},
"dados_endereco": {
"municipio_ibge": "4112603",
"municipio_nome": "Jardim Tremembe",
"uf_localizacao": "MT",
"logradouro": "Fazenda das lagrimas",
"numero": "0",
"complemento": "",
"bairro": "Rural",
"cep": "87690000"
},
"historico": [
{
"nsu_movimento": "245124862",
"uf": "MT",
"cpf": "41012345678",
"ie": "1234567",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"regime_icms": "Não informado",
"data_situacao": "2008-02-15",
"data_atualizacao": "2025-08-11",
"motivo": "Alteração"
},
{
"nsu_movimento": "168911184",
"uf": "MT",
"cpf": "41012345678",
"ie": "1234567",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"regime_icms": "Não informado",
"data_situacao": "2008-02-15",
"data_atualizacao": "2023-03-16",
"motivo": "Alteração"
},
{
"nsu_movimento": "167404431",
"uf": "MT",
"cpf": "41012345678",
"ie": "1234567",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"regime_icms": "Não informado",
"data_situacao": "2008-02-15",
"data_atualizacao": "2023-02-27",
"motivo": "Alteração"
},
{
"nsu_movimento": "135347592",
"uf": "MT",
"cpf": "41012345678",
"ie": "1234567",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"regime_icms": "Não informado",
"data_situacao": "2008-02-15",
"data_atualizacao": "2021-05-07",
"motivo": "Alteração"
},
{
"nsu_movimento": "87346004",
"uf": "MT",
"cpf": "41012345678",
"ie": "1234567",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"regime_icms": "Não informado",
"data_situacao": "2008-02-15",
"data_atualizacao": "2018-10-02",
"motivo": "Inclusão"
}
],
"mesmo_cnpj": [
{
"uf_cadastro": "MT - 41",
"cpf": "41012345678",
"ie": "567890",
"tipo_ie": "IE de Produtor Rural",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"uf_endereco": "MT"
},
{
"uf_cadastro": "MT - 41",
"cpf": "41012345678",
"ie": "1234567",
"tipo_ie": "IE de Produtor Rural",
"situacao_ie": "Habilitado",
"situacao_cpf": "Sem restrição",
"uf_endereco": "MT"
}
]
}
],
"request_id": "b5b56675-0162-4b49-9ef3-51ea145ddd24",
"success": true,
"error": false
}
