Correção automática de NFCe com erro de timeout em São Paulo

Egon Hilgenstieler

Conteúdo

Nos estados onde há contingência offline para NFCe, se a SEFAZ ficar fora do ar, a emissão é feita automaticamente via contingência offline. A nota é efetivada quando a SEFAZ volta a ficar disponível. Em algumas situações, a SEFAZ fica instável e autoriza a nota sem nosso conhecimento, dando erro de “timeout” na conexão. Nesses casos a API cancela automaticamente a nota em duplicidade.

O problema ainda existia em estados que não possuem contingência offline, como São Paulo. Nestes casos poderia haver erro de duplicidade se a SEFAZ tivesse um erro de “timeout” no momento de autorização da nota.

Alteramos o comportamento da API agora para agendar uma correção no caso de suspeita de erro de timeout. Nossa API faz uma consulta da nota, e caso ela esteja autorizada, cancelamos automaticamente a nota com a mensagem “NFCe cancelada devido a erro de timeout na tentativa original”. A nota com erro de timeout é sempre cancelada, mesmo que não tenha nenhuma nota autorizada com a mesma referência.

Acrescentamos uma nova chave na consulta de uma NFCe, chamada “tentativas_anteriores” que devolve um array de notas com todas as tentativas anteriores que resultaram em timeout e que foram canceladas (pois pode ter havido mais de uma tentativa na mesma referência). Abaixo segue um exemplo possível de retorno:

{
  "cnpj_emitente": "28999399000136",
  "ref": "46262079",
  "status": "autorizado",
  "status_sefaz": "100",
  "mensagem_sefaz": "Autorizado o uso da NF-e",
  "chave_nfe": "NFe35230428199999000136650010009920901420209841",
  "numero": "90",
  "serie": "1",
  "protocolo": "135230310999953",
  "caminho_xml_nota_fiscal": "/arquivos/28999399000136/202304/XMLs/35230428199999000136650010009920901420209841-nfe.xml",
  "caminho_danfe": "/notas_fiscais_consumidor/NFe35230428199999000136650010009920901420209841.html",
  "qrcode_url": "https://www.nfce.fazenda.sp.gov.br/?p=NFe35230428199999000136650010009920901420209841",
  "url_consulta_nf": "https://www.nfce.fazenda.sp.gov.br/consulta",
  "tentativas_anteriores": [
    {
      "status": "cancelado",
      "chave_nfe": "NFe35230999999999000136650010009920881211857222",
      "numero": "88",
      "serie": "1",
      "protocolo": "135230310368696",
      "caminho_xml_nota_fiscal": "/arquivos/28165341000136/202304/XMLs/35230999999999000136650010009920881211857222-nfe.xml",
      "caminho_xml_cancelamento": "/arquivos/28165341000136/202304/XMLs/35230999999999000136650010009920881211857222-can.xml"
    }
  ]
}

Caso você queira acompanhar as notas canceladas nesta situação, é possível criar um webhook com o tipo “nfce_correcao_timeout” que sua aplicação será notificada de cada cancelamento que acontecer nesta situação.

Picture of Egon Hilgenstieler

Egon Hilgenstieler

CTO e cofundador do Focus NFe, desenvolvedor, professor de yoga e praticante de meditação. Enquanto não está programando, procura a resposta para a vida, para o universo e para tudo mais.

Inscreva-se em nossa newsletter​

Receba nossos conteúdos exclusivos em primeira mão.

Explore outros conteúdos:

decreto-n-599-2023
Nota Fiscal
Ludmila Ferreira

Decreto n° 599/2023: novas regras de pagamento da NFe e NFCe

O Decreto n.º 599/2023, publicado em 28 de novembro de 2023 no Diário Oficial do Mato Grosso, introduz na legislação estadual a obrigatoriedade de vinculação dos pagamentos eletrônicos ao programa emissor da Nota Fiscal Eletrônica (NF-e) e Nota Fiscal do Consumidor Eletrônica (NFC-e).

Conforme o Portal da Transparência de Mato Grosso, com o avanço das tecnologias aplicadas ao comércio, principalmente aquelas que concernem aos pagamentos eletrônicos, permite-se que os sistemas emissores e APIs de documentos fiscais (NF-e) possam se integrar a diversos meios de pagamento eletrônico.

Por este motivo, trazemos explicações sobre o Decreto n.º 599/2023, suas alterações, quem deve aderir às suas regras e prazo de se adequar à obrigatoriedade disposta no Decreto.

Leia mais »
O que é GNRE? Saiba quem precisa emitir e como gerar!
Nota Fiscal
Douglas Pinheiro

GNR-e: o que é, quem precisa emitir e como gerar

Durante operações de transporte interestaduais, determinados documentos são necessários, e a GNRE é um deles.
Assim como outros documentos, a exemplo do Conhecimento de Transporte Eletrônico (CTe), a Guia Nacional de Recolhimento de Tributos Estaduais (GNRE) deve estar presente junto à mercadoria durante o processo de carga, pois a ausência dela pode gerar complicações para a empresa transportadora.
Quer saber mais? Confira o artigo de hoje! Nele, falamos o que é a GNRE, qual a sua importância, como gerá-la e outras informações relevantes.

Leia mais »