1. Inicio
  2. Documentos
  3. NS NFe (English)
  4. Utility Functions
  5. Consult NF-e Contributor Registration

Consult NF-e Contributor Registration

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.


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.

X-AUTH-TOKENUser access token
CNPJContContributor CNPJ requesting the registrationThe contributor CNPJ must be provided to identify the digital certificate that will be used in communication with Sefaz
UFAbbreviation of the state of the registration of the person to be consulted
IEPerson IE to be consulted
CNPJPerson/company CNPJ to be consulted
CPFPerson 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"}'\

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 person'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 or CPF not informed. It's necessary to inform one of these fields
-3Not possible to carry out the consult because of a request error. Check the return to identify the reason

Como podemos ajudar?