NS NFCe

  1. Inicio
  2. Documentos
  3. NS NFCe
  4. Emissão NFCe Contingência...
  5. Emissão

Emissão

Emissão de NFC-e em Contingência

O serviço de emissão de NFCe em contingência via API é possível fazer a emissão do NFCe no momento que a Sefaz está fora do ar ou com alguma instabilidade.

Campos que são necessários ser preenchidos

A lista abaixo apresenta os campos e atributos do layout de emissão que deve ser preenchidos para emissão em contingência: 

  • tpEmis (tipo de emissão) como “9”
  • dhCont (data e hora da entrada de contingência)
  • xJust (justificativa da entrada em contingência)
URL

Produção: POST https://nfce.ns.eti.br/v1/nfce/cont/issue

Dados de entrada
Envio dos dados para a Contingência via API

Ao tentar emitir uma NFCe com o tipo de emissão(tpEmis) normal e recebendo algum retorno de instabilidade ou Sefaz fora do ar.
Basta alterar o tpEmis para 9 no arquivo de emissão e adicionar os campos dhCont e xJust, e envia-lo para a URL de emissão em contingência.
Com isso a API já retornará o XML com o QRCode e após isso pode ser feito o Download da Base64 desta NFCe.

Exemplo de requisição

Requisição de emissão de NFC-e em JSON

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
         "X-AUTH-TOKEN":"...",
         "NFCe":{...}
        }' \
    https://nfce.ns.eti.br/v1/nfce/cont/issue

Dados retornados
CampoDescriçãoTipoOcorrênciaObservação
StatusCódigo de status do processamentoInteger1-1
MotivoDescrição literal do status de processamentoString1-1
chNFeObjeto com a chave da NFCe em ContingênciaInteger0-1Apenas em status = 200
XMLObjeto com o XML da NFCe em contingênciaInteger0-1Apenas em status = 200
Exemplos de retorno

Retorno com sucesso

{
    "status": 200,
    "motivo": "NFCe gerada em contingencia com sucesso!",
    "chNFe": "43220807364617000135650800000000029000294833",
    "xml": "<NFe xmlns=\"http://www.portalfiscal.inf.br/nfe\" ><infNFe versao=\"4.00\" Id=\"NFe43220807364617000135650800000000029000294833</nfeProc>"}

Retorno com erro de dados

{
    "status": -995,
    "motivo": "Documento invalido de acordo com a validacao contra o XSD",
    "erros": [
        "O campo 'dhCont' foi preenchido incorretamente com o valor '2022-08-17T15:3h4:00-03:00'. Este campo deve ser preenchido com data no seguinte formato: 'AAAA-MM-DDThh:mm:ss TZD (Ex.: 2020-01-31T13:00:00-03:00)'. Este campo e opcional."
    ]
}
Códigos de retorno
CódigoDescrição
200NFCe gerada em contingencia com sucesso!
-995NFC-e inválida de acordo com a validação contra o XSD

Verifique o campo erros para identificar os erros de validação
-996Sem permissões para gerenciar documentos do CNPJ contribuinte
-997Campos obrigatórios não informados

O campo motivo terá maiores informações
-999Erro interno ao processar a requisição

O campo motivo terá maiores informações

Como podemos ajudar?