1. Inicio
  2. Documentos
  3. NS CTe (English)
  4. CTe Utility Functions
  5. Consult Contributor Registration

Consult Contributor Registration

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.


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.

X-AUTH-TOKENUser access token
CNPJContCNPJ of the contributor requesting the registrationThe contributor's CNPJ must be provided to identify the digital certificate that will be used in communication with Sefaz
UFAcronym of the State of the registration of the person to be consulted
IEIE of the person to be consultedIt'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)
CNPJCNPJ of the person/company to be consulted
CPFCPF 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 '{
      "CNPJCont": "07364617000135", 
      "UF": "RS", 
      "IE": "170108708"

Consult Contributor Registration request sending data via QueryString

curl -X POST \
-H "Content-Type: application/json" \
Returned data
statusProcessing status code
motivoProcessing status literal description
retConsCadObject containing the requested peron's dataOnly 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
200Consult carried out successfully
-2IE, CNPJ and CPF not informed. It's necessary to inform one of these fields.
-3It's was not possible to carry out the consultation because of a request error. Verify the return to identify the reason

Como podemos ajudar?