Através do serviço de Consulta Cadastro do Contribuinte é possível obter as informações de cadastro de uma pessoa registrada no banco de dados da Sefaz.
Esta funcionalidade é muito utilizada em casos onde é necessário realizar a complementação de dados devido ao cadastro incompleto de uma pessoa no banco de dados do contribuinte e também para conferência de dados.
URL
Produção: POST https://nfe.ns.eti.br/util/conscad
Dados de entrada
Os dados de entrada deste método por ser enviado no corpo da requisição em formato JSON ou como QueryString na URL do método.
| Campo | Descrição | Observação |
|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | |
| CNPJCont | CNPJ do contribuinte solicitante do cadastro | O CNPJ do contribuinte deve ser fornecido para identificar o certificado digital que será utilizado na comunicação com a Sefaz |
| UF | Sigla do estado de cadastro da pessoa a ser consultada | |
| IE | IE da pessoa a ser consultada | |
| CNPJ | CNPJ da pessoa/empresa a ser consultada | |
| CPF | CPF da pessoa a ser consulta |
Obs: É necessário informar apenas um destes três campos (IE, CNPJ, CPF). O CPF encontrará resultado apenas de pessoas cadastradas como contribuintes no estado (ex.: Produtor Rural).
Exemplo de requisição
Requisição de Consulta Cadastro de Contribuinte enviando dados via JSON
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN": "SEU_TOKEN",
"CNPJCont": "07364617000135",
"UF": "RS",
"IE": "170108708"
}'\
https://nfe.ns.eti.br/util/conscad
Requisição de Consulta Cadastro de Contribuinte enviando dados via QueryString
curl -X POST \
-H "Content-Type: application/json" \
http://nfehml.ns.eti.br/util/conscad?X-AUTH-TOKEN=SEU_TOKEN&CNPJCont=07364617000135&UF=RS&IE=170108708
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| retConsCad | Objeto contendo os dados da pessoa solicitada | Somente em status = 200 |
Os dados de cadastro da pessoa serão retornados apenas se o campo retConsCad.cStat for 111 ou 112.
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Consulta realizada com sucesso",
"retConsCad": {
"infCons": {
"verAplic": "RSb20160107111410",
"cStat": 111,
"xMotivo": "Consulta cadastro com uma ocorrencia",
"UF": "RS",
"dhCons": "2016-12-02T18:46:45",
"cUF": 43,
"infCad": [
{
"IE": "170108708",
"CNPJ": "7364617000135",
"UF": "RS",
"cSit": 1,
"indCredNFe": 2,
"indCredCTe": 4,
"xNome": "NEW-S SYSTEMS LTDA ME",
"xFant": "NEW-S SYSTEMS",
"xRegApur": "SIMPLES NACIONAL",
"CNAE": 4649401,
"dIniAtiv": "2005-06-20",
"dUltSit": "2005-06-20",
"ender": {
"xLgr": "AV ANTONIO DURO",
"nro": "870",
"xCpl": "FUNDOS",
"xBairro": "OLARIA",
"cMun": "4303509",
"xMun": "Camaquã",
"CEP": "96180000"
}
}
]
},
"versao": "2.00"
}
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Consulta realizada com sucesso |
| -2 | IE, CNPJ e CPF não informados. É necessário informar um destes campos |
| -3 | Não foi possível realizar a consulta de a um erro de requisição. Verifique o retorno para identificar o motivo. |