Emissão de NF-e
Estados da NF-e
draft → pending → processing → issued
↓ (erro) → error
issued → pending_cancel → canceling → canceled
↓ (erro) → error
| Status | Descrição |
|---|---|
| draft | Rascunho, ainda não enviada |
| pending | Na fila para emissão |
| processing | Sendo processada pelo provedor (async) |
| issued | Emitida com sucesso |
| pending_cancel | Marcada para cancelamento |
| canceling | Cancelamento em processamento |
| canceled | Cancelada com sucesso |
| error | Falha na emissão/cancelamento após esgotar tentativas |
Campos da NF-e
Identificação
| Campo | Descrição |
|---|---|
| Fatura | Fatura associada |
| Conta de cobrança | Cliente |
| Empresa | Empresa emissora |
Números e Chaves
| Campo | Descrição |
|---|---|
| Número da NF-e | Número sequencial |
| Série | Série da NF-e |
| Chave | Chave de 44 dígitos |
| Código de verificação | Para consulta |
| Número RPS | Recibo Provisório de Serviços |
Serviço
| Campo | Descrição |
|---|---|
| Valor (centavos) | Valor do serviço |
| Código do serviço | Código LC 116/2003 |
| Descrição | Descrição do serviço prestado |
| Código CNAE | Classificação de atividade |
| Código NBS | Nomenclatura Brasileira de Serviços |
Impostos
A NF-e armazena o detalhamento dos impostos calculados:
- ISS (taxa e valor)
- PIS, COFINS, CSLL
- IRRF
- INSS
URLs
| Campo | Descrição |
|---|---|
| URL do XML | Download do XML da nota |
| URL do PDF | Download do DANFE em PDF |
Snapshot do Cliente
A NF-e armazena uma foto dos dados do cliente no momento da emissão:
- Nome, documento, e-mail, telefone
- Endereço completo com código IBGE da cidade
Isso garante que a nota reflita os dados corretos mesmo se o cliente alterar seu cadastro posteriormente.
Trilha de Auditoria
Cada requisição HTTP feita ao provedor é registrada em NfeRequestTry:
- Ação (emitir, cancelar, consultar)
- Endpoint chamado
- Request e response completos
- Status HTTP
- Duração em milissegundos
- Resultado (sucesso/falha)
Capturas de tela
Lista de NF-e
A tela /dashboard/nfes lista todas as notas fiscais emitidas, com filtros por status (pending, processing, issued, error, canceled), empresa, cliente, intervalo e número. Cada linha mostra número, valor, impostos calculados, fatura/origem e ações (baixar XML, PDF, reenviar, cancelar).
Detalhe da NF-e
A página /dashboard/nfes/[id] reúne dados fiscais completos: emissora, destinatário, itens (com códigos LC 116/municipal), impostos calculados, retenções, XML retornado pela prefeitura, PDF e histórico de tentativas no provedor.
