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
Campo | Descrição | Tipo | Ocorrência | Observação |
---|---|---|---|---|
Status | Código de status do processamento | Integer | 1-1 | |
Motivo | Descrição literal do status de processamento | String | 1-1 | |
chNFe | Objeto com a chave da NFCe em Contingência | Integer | 0-1 | Apenas em status = 200 |
XML | Objeto com o XML da NFCe em contingência | Integer | 0-1 | Apenas 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ódigo | Descrição |
---|---|
200 | NFCe gerada em contingencia com sucesso! |
-995 | NFC-e inválida de acordo com a validação contra o XSD Verifique o campo erros para identificar os erros de validação |
-996 | Sem permissões para gerenciar documentos do CNPJ contribuinte |
-997 | Campos obrigatórios não informados O campo motivo terá maiores informações |
-999 | Erro interno ao processar a requisição O campo motivo terá maiores informações |