Fila de NF-e, Diagnóstico de Erros e Como Retentar
Filtros em Pedidos: A emitir, Na fila, Aguardando canal e Falhou — e o que fazer em cada caso.
No Linka ERP, o processamento de notas fiscais é assíncrono e baseado em filas de alta resiliência. Isso assegura que picos de vendas (como Black Friday ou promoções relâmpago) sejam faturados com velocidade sem sobrecarregar a SEFAZ nem derrubar sua operação.
Status da Fila em Pedidos
Na listagem de Pedidos, utilize as abas de status fiscal para monitorar o andamento:
- A emitir: Pedido com pagamento confirmado que ainda não possui nota fiscal gerada.
- Na fila: O pedido foi enfileirado e está sendo processado pelo motor de faturamento (assinatura digital, envio à SEFAZ ou upload do XML).
- Aguardando canal: A NF-e foi autorizada na SEFAZ e o Linka já transmitiu o XML ao marketplace, aguardando a liberação da etiqueta pelo canal.
- Falhou: Houve rejeição da SEFAZ ou inconsistência cadastral. O motivo exato é detalhado no card do pedido.
Como Diagnosticar e Corrigir Erros
Ao filtrar por Falhou, abra os detalhes do pedido para verificar o motivo da rejeição. Os casos mais frequentes são:
- Rejeição de NCM inexistente ou inválido: Acesse o cadastro do produto correspondente e informe um código NCM válido com 8 dígitos.
- Dados do destinatário incompletos: CPF/CNPJ com dígitos incorretos ou ausência de endereço válido no cadastro do comprador.
- Certificado Digital expirado ou com senha incorreta: Atualize o arquivo A1 em Configurações > Fiscal > Certificado.
- Rejeição 203 no Paraná: Empresa paranaense sem cadastro de autorização de uso de sistema na Receita Estadual (veja nosso tutorial específico de liberação no PR).
Como Retentar a Emissão
Após corrigir a causa do erro no produto, cadastro ou certificado:
- Abra o pedido com status de falha.
- Clique no botão "Retentar NF".
- O Linka revalida os dados corrigidos e coloca a emissão imediatamente de volta na fila prioritária.
Política de Segurança: O Linka não mantém tentativas infinitas em erros permanentes para evitar bloqueio de IP ou multas por repetição desnecessária na SEFAZ. O pedido permanece em Falhou até você realizar a correção e clicar em Retentar.