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:

CSOSN: o que é esse código do Simples Nacional e pra que serve
Nota Fiscal
Junior Muniz

NFe Inutilizada: saiba o que é, como consultar e quando fazer

Se você já enfrentou situações em que uma nota fiscal foi emitida com uma numeração fora da sequência, compreender a importância da NFe Inutilizada é essencial, pois a legislação não permite quebras na ordem numérica das notas fiscais.

Sua aplicação geralmente é feita quando há o preenchimento ou informações incorretas em uma nota fiscal. Assim, se trata de uma das diversas formas de consertar estes erros.

Acompanhe o artigo de hoje e entenda mais sobre o que é a inutilização da Nota Fiscal eletrônica, como consultar o processo e quando ele deve ser feito

Leia mais »
Tabela ICMS 2023
Gestão Empresarial
Ricardo Acras

Tabela ICMS 2024: alíquotas atualizadas de todos os estados!

O ICMS é um imposto usado para operações estaduais e interestaduais, cujas alíquotas variam conforme a Unidade Federativa de prestadores e tomadores de serviço. Além disso, a porcentagem das alíquotas muda periodicamente, o que é motivo de muitas dúvidas.

Sendo assim, trazemos a tabela ICMS 2024 com as alíquotas de cada estado atualizadas no texto a seguir.

Leia mais »
Validação de nota fiscal: o que é, como funciona e onde validar
Nota Fiscal
João Vallim

Validação de nota fiscal: o que é, como funciona e onde validar

A validação de nota fiscal está entre os diversos processos que fazem parte da gestão tributária brasileira, que existem para verificar se tudo está dentro das normas.

Afinal, as notas fiscais, assim como qualquer outro documento, podem sofrer adulterações. Isso pode prejudicar tanto quem emite quanto quem recebe esses documentos. Por isso, conhecer o processo de verificação é importante para evitar transtornos.

Neste artigo, exploraremos o que é a validação de nota fiscal, destacando sua importância para sua empresa. Vamos também examinar os órgãos responsáveis por assegurar que essa verificação seja realizada de maneira eficaz.

Continue lendo para entender como a validação de nota fiscal pode otimizar sua gestão tributária e proteger seus interesses.

Leia mais »