1. Inicio
  2. Documentos
  3. NS NFe (English)
  4. Utility Functions
  5. Sefaz WS Status Consult

Sefaz WS Status Consult

Through the Sefaz WS Status Consult service, it’s possible to check the working status of Sefaz’s WS.

The NS API automatically controls the Sefaz’s WS status consult and carries out the SVC contingency issuance process if the normal authorizing Sefaz is not receiving requests and has enabled contingency issuance.


Production: POST https://nfe.ns.eti.br/util/wssefazstatus

Input data

The input data of this method must be sent in the request body in JSON format.

X-AUTH-TOKENUser access token
CNPJContContributor's CNPJThe 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 person to be consulted
tpAmbEnvironment type1 - Production
2 - Homologation
versaoNF-e project version4.00
Request example

Consult WS status request sending data via JSON

curl -X POST \
-H "Content-Type: application/json" \-d '{"X-AUTH-TOKEN": "YOUR_TOKEN", "CNPJCont": "11111111111111", "tpAmb": "2", "UF": 43, "versao": "4.00"}'\
Returned data
FieldDescriptionData TypeOccurrenceParentNotes
statusProcessing status codeInt1-1
motivoProcessing status literal descriptionString1-1
retStatusServicoObject containing the requested person dataObject0-1Only when status = 200
cStatSefaz's WS situation codeInt1-1retStatusServico
xMotivoSefaz's WS situation literal descriptionString1-1retStatusServico
Return exapmle

Successful return

    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "retStatusServico": {
       "cStat": 107,
       "xMotivo": "Servico em Operacao"
Return code
200Consult carried out successfully
-3Not possible to carry out the consult because of an error in the request. Check the return to identify the reason

Como podemos ajudar?