Through this Consult Contributor Registration it’s possible to obtain the registration information about a registered person in the Sefaz 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://cte.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 method URL.
| Field | Description | Notes |
|---|---|---|
| X-AUTH-TOKEN | User access token | |
| CNPJCont | CNPJ of the contributor requesting the registration | The contributor's CNPJ must be provided to identify the digital certificate that will be used in communication with Sefaz |
| UF | Acronym of the State of the registration of the person to be consulted | |
| IE | IE of the person to be consulted | It's to necessary to inform only one of the three fields. The CPF will only find results for people registered as contributors in the State (e.g.: Rural Producer) |
| CNPJ | CNPJ of the person/company to be consulted | |
| CPF | CPF of the person to be consulted |
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": "07364617000135",
"UF": "RS",
"IE": "170108708"
}'\
http://ctehml.ns.eti.br/util/conscad
Consult Contributor Registration request sending data via QueryString
curl -X POST \
-H "Content-Type: application/json" \
http://ctehml.ns.eti.br/util/conscad?X-AUTH-TOKEN=YOUR_TOKEN&CNPJCont=07364617000135&UF=RS&IE=170108708
Returned data
| Field | Description | Notes |
|---|---|---|
| status | Processing status code | |
| motivo | Processing status literal description | |
| retConsCad | Object containing the requested peron'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 and CPF not informed. It's necessary to inform one of these fields. |
| -3 | It's was not possible to carry out the consultation because of a request error. Verify the return to identify the reason |