Through the Contributor Registration Consult service, it’s possible to obtain the registration information of a person registered in Sefaz’s database.
This functionality is widely used in cases where it’s necessary to complete data due to the incomplete registration of a person in the contributor’s database and also for data check.
URL
Production: POST https://nfe.ns.eti.br/util/conscad
Input data
The input data of this method can be sent in the request body in JSON format or as QueryString in the URL of the method.
| Field | Description | Notes |
|---|---|---|
| X-AUTH-TOKEN | User access token | |
| CNPJCont | Contributor CNPJ requesting the registration | The contributor CNPJ must be provided to identify the digital certificate that will be used in communication with Sefaz |
| UF | Abbreviation of the state of the registration of the person to be consulted | |
| IE | Person IE to be consulted | |
| CNPJ | Person/company CNPJ to be consulted | |
| CPF | Person CPF to be consulted |
Obs.: It’s necessary to inform at least one of these three fields (IE, CNPJ, CPF). The CPF will only find results for people registered as contributors in the state (e.g.: Rural Producer).
Request example
Consult contributor registration request sending data via JSON
curl -X POST \
-H "Content-Type: application/json" \
-d '{"X-AUTH-TOKEN": "YOUR_TOKEN", "CNPJCont": "11111111111111", "UF": "RS", "IE": "111111111"}'\
https://nfe.ns.eti.br/util/conscad
Consult contributor registration request sending data via QueryString
curl -X POST \
-H "Content-Type: application/json" \
http://nfehml.ns.eti.br/util/conscad?X-AUTH-TOKEN=YOUR_TOKEN&CNPJCont=11111111111111&UF=RS&IE=111111111
Returned data
| Field | Description | Notes |
|---|---|---|
| status | Processing status code | |
| motivo | Processing status literal description | |
| retConsCad | Object containing the requested person's data | Only when status = 200 |
The person’s registration data will only be returned if the retConsCad.cStat field is 111 or 112.
Return example
Successful return
{
"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"
}
}
Return codes
| Code | Description |
|---|---|
| 200 | Consult carried out successfully |
| -2 | IE, CNPJ or CPF not informed. It's necessary to inform one of these fields |
| -3 | Not possible to carry out the consult because of a request error. Check the return to identify the reason |