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ção | Observação |
|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | |
| CNPJCont | CNPJ do contribuinte | O CNPJ do contribuinte deve ser fornecido para identificar ocertificado digital que será utilizado na comunicação com a Sefaz |
| UF | Sigla do estado de cadastro da pessoa a ser consultada | |
| tpAmb | Tipo de ambiente | 1 - Produção2 - Homologação |
| versao | Versão do projeto NF-e | 4.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
| Campo | Descrição | Tipo | Ocorrência | Pai | Observação |
|---|---|---|---|---|---|
| status | Código de status do processamento | N | 1-1 | ||
| motivo | Descrição literal do status de processamento | A | 1-1 | ||
| retStatusServico | Objeto contendo os dados da pessoa solicitada | O | 0-1 | Somente em status = 200 | |
| cStat | Código da situação do WS da Sefaz | N | 1-1 | retStatusServico | |
| xMotivo | Descrição literal da situação do WS da Sefaz | A | 1-1 | retStatusServico |
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 |
|---|---|
| 200 | Consulta realizada com sucesso |
| -3 | Não foi possível realizar a consulta de a um erro de requisição. Verifique o retorno para identificar o motivo. |