1. Inicio
  2. Documentos
  3. NS NFe
  4. Funções Utilitárias
  5. Consulta Status WS da Sefaz

Consulta Status WS da Sefaz

Através do serviço de Consulta Status WS da Sefaz é possível verificar o status de funcionamento do WS da Sefaz.

A API da NS faz o controle automático de verificação de status do WS da Sefaz e realiza o processo de emissão em contingência SVC caso a Sefaz autorizadora normal não esteja recebendo requisições e tenha habilitado a emissão em contingência.

URL

Produção: POST https://nfe.ns.eti.br/util/wssefazstatus

Dados de entrada

Os dados de entrada deste método devem ser enviados no corpo da requisição em formato JSON.

Campo DescriçãoObservação
X-AUTH-TOKENToken de acesso do usuário
CNPJContCNPJ do contribuinteO CNPJ do contribuinte deve ser fornecido para identificar ocertificado digital que será utilizado na comunicação com a Sefaz
UFSigla do estado de cadastro da pessoa a ser consultada
tpAmbTipo de ambiente1 - Produção2 - Homologação
versaoVersão do projeto NF-e4.00
Exemplo de requisição

Requisição de Consulta Cadastro de Contribuinte enviando dados via JSON

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
         "X-AUTH-TOKEN": "SEU_TOKEN", 
         "CNPJCont": "11111111111111", 
         "tpAmb": "2", 
         "UF": 43, 
         "versao": "4.00"
        }'\
     https://nfe.ns.eti.br/util/wssefazstatus
Dados retornados
CampoDescriçãoTipoOcorrência PaiObservação
statusCódigo de status do processamentoN1-1
motivoDescrição literal do status de processamentoA1-1
retStatusServicoObjeto contendo os dados da pessoa solicitadaO0-1Somente em status = 200
cStatCódigo da situação do WS da SefazN1-1retStatusServico
xMotivoDescrição literal da situação do WS da SefazA1-1retStatusServico
Exemplos de retorno

Retorno com sucesso

{
    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "retStatusServico": 
    {
        "cStat": 107,
        "xMotivo": "Servico em Operacao"
    }
}
Códigos de retorno
Código Descrição
200Consulta realizada com sucesso
-3Não foi possível realizar a consulta de a um erro de requisição. Verifique o retorno para identificar o motivo.

Como podemos ajudar?