Notas Fiscais Emitidas
Pré-requisitos de acesso
- Permissão (módulo):
viewInvoices - Licença/Feature:
FIAT_PAYMENTS - Contêiner do menu: GERAL → grupo Contabilidade
O que é / quando usar
Lista todas as notas fiscais solicitadas/emitidas para os usuários a partir das operações realizadas na plataforma. Diferente de Gerenciar NFEs (que configura o gabarito por tipo de operação), aqui estão os registros concretos: para cada operação que gerou pedido de nota, vê-se o usuário, a data, o valor, o tipo de operação, o identificador da nota e se ela já foi gerada pelo provedor. É a tela de consulta e conferência contábil/fiscal das notas — usada em fechamentos, auditorias e fiscalizações.
Pré-condições
- Permissão:
viewInvoicescadastrado para a role do operador (permissão dupla — enum CPM no backend + módulo dinâmico no DB). - Licença/Feature:
FIAT_PAYMENTShabilitada na licença do tenant (Vault). Se desabilitada, o item nem aparece no menu. - Dependências de outras telas: as notas só existem se houver configuração de NFE para o tipo de operação (Gerenciar NFEs) e se a integração com o provedor de NFE estiver ativa.
Passo a passo
- Acesse o menu Contabilidade → Notas Fiscais Emitidas.
- Percorra a tabela; cada linha é um pedido de nota gerado por uma operação do usuário.
- Na coluna Gerado, confira se a nota já foi efetivamente emitida pelo provedor.
- Clique no ícone recibo para abrir o PDF/arquivo da nota (quando já gerada) em nova aba.
- Clique no ícone visualizar (olho) para ir aos detalhes do usuário que originou a nota.
- Use Exportar para baixar a lista atual em
.csv(separador;, com BOM, nomeinvoices_<data>.csv).
Filtros e colunas
| Filtro/Coluna | O que mostra | Origem do dado |
|---|---|---|
| Usuário / Nome | E-mail do usuário que originou a nota | user.email (registro UserNFE) |
| Data | Data da operação que gerou a nota | when |
| Valor | Montante da operação base da nota | amount (valor monetário — BigNumber, ver cuidados) |
| Operação | Tipo da operação que originou a nota | operation_type |
| ID | Identificador da nota fiscal | nfe_id |
| Gerado | Se a nota já foi efetivamente emitida pelo provedor (sim/não) | processed (boolean) |
| Ações | Ver detalhes do usuário / abrir o arquivo da nota | — |
TIP
Esta tela não possui filtros de busca — é uma listagem paginada com exportação. Para recortes por período/usuário, use o Exportar e trate o CSV, ou cruze com o Relatório IN 1888.
Ações e modais
- Recibo (ícone receipt): abre a nota fiscal montando a URL
NFEBasePathUrl + nfe_idem nova aba. Só funciona quando hánfe_id(nota já gerada). A URL-base é obtida do backend (getNFEBasePathUrl). - Visualizar (ícone olho): navega para Detalhes do usuário (
/users/informations/details) já com o e-mail do cliente, para investigar a origem da nota. - Exportar: gera um
.csvda página corrente com as colunas usuário, data, valor, operação, ID e "gerado".
Regras de negócio / cuidados
Atenção
- A coluna Gerado = não indica que o pedido existe mas a nota ainda não foi emitida pelo provedor (em processamento ou falha). Notas com
processed = falsenão têm arquivo para abrir. - O ID da nota (
nfe_id) é o elo entre o registro interno e o documento fiscal no provedor — use-o para rastreamento em auditoria.
- Valores financeiros: o valor exibido provém da operação base e deve ser tratado como BigNumber — sem arredondamento manual; confira as casas decimais conforme a moeda/token da operação.
- Idempotência: a emissão segue o padrão financeiro idempotente do BillingService (bls-lib). Reprocessar uma emissão já concluída é seguro; um retorno
E00021"already processed" significa que a nota já foi processada — trate como sucesso, não como erro.