GNRE
A tela GNRE centraliza as guias de recolhimento (Guia Nacional de Recolhimento de Tributos Estaduais) emitidas para os pedidos da empresa. Cada linha é uma guia gerada para um pedido — com código de barras, número do protocolo após emissão, vencimento, valor principal, juros, multa, correção e o status atual do processamento (Pendente, Enviada, Processada, Recusada, etc.). A tela também concentra as ações Gerar GNRE em massa (a partir dos pedidos selecionados na tela de Pedidos ou na própria lista), Baixar guias (ZIP com os PDFs) e Visualizar arquivo (modal com o PDF da guia individual).
A geração da GNRE depende de a NF principal do pedido estar emitida e de o estado de destino ter inscrição estadual + alíquotas cadastradas na conta. As configurações que mudam quando/como o sistema gera, vence e contabiliza a guia ficam em Configurações → Parametrizações e estão resumidas no final desta página.
Índice
Conceito
Geração e ações em lote
- Como gerar GNRE em massa?
- Quais erros podem aparecer ao gerar?
- Como baixar o PDF de várias guias de uma vez?
- Como visualizar o PDF de uma guia específica?
Lendo a lista
Busca e filtros
- Como filtrar por período?
- Como filtrar por estado destino?
- Como filtrar por pedido ou nota fiscal?
- Como ver só guias vencendo nos próximos dias?
Regras de negócio
- O sistema gera GNRE automaticamente?
- Como o vencimento é calculado?
- A geração cria conta a pagar?
- Por que não consigo gerar GNRE para um pedido?
- O sistema gera arquivo CNAB das guias?
Configurações
Referência rápida
O que é a tela GNRE?
É a tela que lista as guias de recolhimento estaduais emitidas para os pedidos da empresa — a guia (boleto fiscal) que a empresa precisa pagar para o estado de destino quando emite uma NF interestadual com DIFAL/FCP. Cada guia carrega código de barras, vencimento, valor, status atual e fica vinculada ao pedido e à sua NF principal.
📍 Onde: menu lateral → Vendas → GNRE.
Qual a diferença para a tela Apuração DIFAL?
| Apuração DIFAL | GNRE | |
|---|---|---|
| O que lista | NFs interestaduais com ICMS DIFAL / FCP UF Destino. | Guias de recolhimento já emitidas. |
| Foco | Conferência do que vai ser pago. | Operação do que já tem guia. |
| Ação | Somente leitura. | Gerar guia em massa, baixar PDFs. |
Você usa a Apuração DIFAL para conferir a base e depois vem para GNRE gerar/baixar a guia correspondente.
Quais status uma guia pode ter?
O status reflete o estado do processamento da guia junto à SEFAZ. Os valores possíveis estão cadastrados em uma tabela de tipo e variam por integração — incluem situações como Pendente (criada, ainda não enviada), Enviada, Processando, Processada (com número de recibo), Recusada (com mensagem de retorno da SEFAZ), entre outros. A coluna Status da lista mostra a descrição atual.
Use o filtro de Status para isolar guias que ainda precisam de atenção.
Como gerar GNRE em massa?
- Selecione os pedidos desejados na lista (caixas à esquerda).
- Abra Mais Ações no topo direito.
- Clique em Gerar GNRE em massa.
- Aguarde o processamento — a tela mostra "Gerando GNRE em massa…" durante a execução.
- Ao concluir, a lista atualiza automaticamente com as guias recém-criadas.
O sistema só aceita gerar guia para pedidos que tenham NF principal emitida. Pedidos com NF em qualquer outro status (pendente, denegada, cancelada) recebem a mensagem "Nota fiscal não emitida" e ficam de fora do lote.
Pré-requisito: privilégio Criar gnre.
Quais erros podem aparecer ao gerar?
Os erros mais comuns:
- "Nota fiscal não emitida" — algum pedido do lote tem NF principal em status diferente de Emitida. Verifique o pedido na lista de Notas Fiscais e regularize antes.
- "Pedido não localizado" — nenhum dos pedidos enviados pertence à conta autenticada (ex.: usuário trocou de conta no meio da operação ou o pedido foi excluído).
- Erros da SEFAZ — o sistema envia o lote para a SEFAZ e propaga a mensagem de erro de lá (problema de inscrição estadual, alíquota faltando, código de receita inválido). Cada UF tem suas regras.
A primeira coisa a verificar quando o lote falha por SEFAZ é a tela Configurações → Inscrição Estadual — alíquotas, código de receita e situação cadastral da empresa naquele estado.
Como baixar o PDF de várias guias de uma vez?
- Selecione as guias desejadas (caixas à esquerda).
- Abra Mais Ações → Baixar guias (ou ação equivalente).
- O sistema prepara um arquivo ZIP com os PDFs e gera um link para download.
- O mesmo link é enviado também por e-mail para o usuário logado.
O link fica válido por 2 dias — depois disso, expira e você precisa gerar de novo.
Como visualizar o PDF de uma guia específica?
Clique no ícone correspondente na linha da guia (geralmente olho ou PDF). O sistema abre uma janela com o PDF da guia, sem precisar fazer download.
Quais informações cada linha mostra?
Cada guia traz:
- Data de criação da guia.
- Vencimento.
- UF destino.
- Descrição do código de receita da UF.
- Código de barras (campo da guia para pagamento).
- Número do protocolo (preenchido após o processamento).
- Status atual.
- Valor principal, Juros, Multa, Correção e o Valor total (soma dos quatro).
- Pedido vinculado e NF principal (número, série, data, status).
- Status do pedido.
- Transportadora (quando há).
- Canal de venda.
- Conta dona do pedido e Conta do faturador (em ambientes multi-conta com CNPJ de faturamento separado).
- CNPJ do faturador.
O que é o código de receita?
É um código numérico definido por cada estado para identificar o tipo de tributo recolhido (DIFAL, ICMS ST, FCP, etc.). Cada UF tem sua tabela própria de códigos. A descrição correspondente vem do cadastro do estado e aparece na lista junto da guia.
Quando o código está errado ou o cadastro falta para uma UF, a SEFAZ rejeita o envio. O cadastro fica em Configurações → Inscrição Estadual, na configuração de cada estado.
Como filtrar por período?
No painel Filtros, use:
- Data criação — janela em que a guia foi criada no sistema.
- Data vencimento — janela do vencimento da guia (útil para localizar o que vai vencer ou o que já venceu).
- Data emissão NF — janela de emissão da NF principal.
- Data envio — janela de envio dos pacotes do pedido.
Clique em Aplicar para atualizar.
Como filtrar por estado destino?
No painel Filtros, use o campo UF destino e selecione um ou vários estados. Cada UF tem vencimento e código de receita próprios, então filtrar por UF é a forma natural de organizar a tela.
Como filtrar por pedido ou nota fiscal?
Use os campos do painel Filtros:
- Pedido e Código pedido — pelo número do pedido (visível ao cliente) ou pelo código interno.
- Número NF + Série NF — pela nota fiscal principal vinculada.
- Canal de venda — para isolar guias de pedidos de determinado marketplace.
- Transportadora — pelo identificador da transportadora amarrada ao pedido.
Como ver só guias vencendo nos próximos dias?
Use o filtro Data vencimento com a faixa desejada (ex.: hoje + 5 dias) e combine com o filtro de Status para excluir guias já pagas/processadas.
O sistema gera GNRE automaticamente?
Sim, quando as parametrizações apropriadas estão ativadas:
- Criar GNRE automaticamente (
liga/desligao piloto automático geral). - Criar GNRE após emissão nota fiscal — quando ativa, a guia é gerada imediatamente após a NF principal ser emitida, sem precisar de ação manual.
Com isso desligado, a geração só ocorre pelo botão Gerar GNRE em massa desta tela ou da tela de Pedidos.
Como o vencimento é calculado?
Duas configurações combinadas definem o vencimento:
- Utilizar o dia de vencimento igual emissão NF (sim/não) — quando sim, a base é a data de emissão da NF; quando não, a base é a data corrente da geração.
- Dias adicionais vencimento/pagamento — número fixo de dias somado à base.
O vencimento final é base + dias adicionais. Cada UF também pode ter um dia padrão de vencimento por mês (configurado em Configurações → Inscrição Estadual por estado) que prevalece para alguns regimes.
A geração cria conta a pagar?
Depende do modo:
- Por guia (default) — o sistema cria uma conta a pagar por guia usando o Plano de contas para criar contas a pagar, o Tipo de documento para criar contas a pagar GNRE operação e o Centro de custo configurados.
- Por apuração — quando Criar contas a pagar apuração está ativa, a conta a pagar não é criada por guia; ela é criada agregada, uma por estado/mês, a partir da apuração DIFAL (ver a tela Apuração DIFAL). Nesse caso, o tipo de documento usado é o GNRE apuração.
Por que não consigo gerar GNRE para um pedido?
Verifique nesta ordem:
- NF principal está emitida? — sem NF emitida (status diferente de Emitida), o sistema bloqueia com "Nota fiscal não emitida".
- Inscrição estadual cadastrada para a UF de destino? — sem cadastro, a SEFAZ recusa.
- Alíquotas de DIFAL/FCP preenchidas no cadastro estadual?
- Código de receita cadastrado para aquele tipo de operação naquela UF?
- A operação realmente exige GNRE? — vendas para destinatário dentro da mesma UF não geram GNRE de DIFAL.
A mensagem de erro retornada pela SEFAZ aparece no Comentários da guia (ou no Log Pedidos) e geralmente aponta o item faltando.
O sistema gera arquivo CNAB das guias?
Sim, quando a parametrização Gerar arquivo CNAB das GNREs está ativada. Nesse modo, o sistema gera um arquivo no formato CNAB com as guias do período, pronto para envio ao banco para pagamento em lote.
Resumo de parametrizações
Acesse em Configurações → Parametrizações → GNRE. Estas são as configurações que afetam a geração e o comportamento da tela:
| Parametrização | Submenu | O que muda quando ativada |
|---|---|---|
| Criar GNRE automaticamente | GNRE | Liga/desliga a geração automática da guia pelo sistema. Com não, a geração só ocorre pelo botão Gerar GNRE em massa. |
| Criar GNRE após emissão nota fiscal | GNRE | Quando ativa, a guia é gerada imediatamente após a NF principal ser emitida, sem ação manual. |
| Utilizar o dia de vencimento igual emissão NF | GNRE | Usa a data de emissão da NF como base do vencimento da guia (em vez da data corrente). |
| Dias adicionais vencimento/pagamento | GNRE | Número de dias somado à data base do vencimento. |
| Email para enviar relatório de GNRE | GNRE | E-mail que recebe os relatórios e o link de download das guias. |
| Plano de contas para criar contas a pagar | GNRE | Plano de contas usado nos lançamentos de contas a pagar gerados pela guia (modo por guia). |
| Tipo de documento para criar contas a pagar GNRE operação | GNRE | Tipo de documento dos lançamentos por guia. |
| Centro de custo para criar contas a pagar | GNRE | Centro de custo dos lançamentos por guia. |
| Criar contas a pagar apuração | GNRE | Em vez de criar uma conta a pagar por guia, cria uma única por estado/mês a partir da apuração DIFAL. Ver a tela Apuração DIFAL. |
| Tipo de documento para criar contas a pagar GNRE apuração | GNRE | Tipo de documento dos lançamentos por apuração (consumido apenas quando Criar contas a pagar apuração está ativa). |
| Gerar arquivo CNAB das GNREs | GNRE | Gera arquivo CNAB com as guias do período, pronto para envio bancário em lote. |
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar gnre | Acesso à tela e à lista de guias. |
| Criar gnre | Ação Gerar GNRE em massa. |
| Editar gnre | Edição de uma guia existente (anotações, atualização manual). |
| Deletar gnre | Remoção de guia. |