Emisión de NF-e
Estados de la NF-e
draft → pending → processing → issued
↓ (error) → error
issued → pending_cancel → canceling → canceled
↓ (error) → error
| Estado | Descripción |
|---|---|
| draft | Borrador, aún no enviada |
| pending | En cola para emisión |
| processing | Siendo procesada por el proveedor (async) |
| issued | Emitida con éxito |
| pending_cancel | Marcada para cancelación |
| canceling | Cancelación en procesamiento |
| canceled | Cancelada con éxito |
| error | Fallo en la emisión/cancelación tras agotar intentos |
Campos de la NF-e
Identificación
| Campo | Descripción |
|---|---|
| Factura | Factura asociada |
| Cuenta de cobro | Cliente |
| Empresa | Empresa emisora |
Números y Claves
| Campo | Descripción |
|---|---|
| Número de la NF-e | Número secuencial |
| Serie | Serie de la NF-e |
| Clave | Clave de 44 dígitos |
| Código de verificación | Para consulta |
| Número RPS | Recibo Provisório de Serviços |
Servicio
| Campo | Descripción |
|---|---|
| Valor | Valor del servicio |
| Código del servicio | Código LC 116/2003 |
| Descripción | Descripción del servicio prestado |
| Código CNAE | Clasificación de actividad |
| Código NBS | Nomenclatura Brasileira de Serviços |
Impuestos
La NF-e almacena el detalle de los impuestos calculados:
- ISS (tasa y valor)
- PIS, COFINS, CSLL
- IRRF
- INSS
URLs
| Campo | Descripción |
|---|---|
| URL del XML | Descarga del XML de la nota |
| URL del PDF | Descarga del DANFE en PDF |
Snapshot del Cliente
La NF-e almacena una foto de los datos del cliente en el momento de la emisión:
- Nombre, documento, e-mail, teléfono
- Dirección completa con código IBGE de la ciudad
Esto garantiza que la nota refleje los datos correctos incluso si el cliente modifica su registro posteriormente.
Pista de Auditoría
Cada solicitud HTTP realizada al proveedor se registra en NfeRequestTry:
- Acción (emitir, cancelar, consultar)
- Endpoint llamado
- Request y response completos
- Estado HTTP
- Duración en milisegundos
- Resultado (éxito/fallo)
Capturas de pantalla
Lista de NF-e
La pantalla /dashboard/nfes lista todas las notas fiscales emitidas, con filtros por status (pending, processing, issued, error, canceled), empresa, cliente, rango y número. Cada fila muestra el número, el valor, los impuestos calculados, la factura/origen y acciones (descargar XML, PDF, reenviar, cancelar).
Detalle de la NF-e
La página /dashboard/nfes/[id] reúne los datos fiscales completos: emisora, destinatario, ítems (con códigos LC 116/municipal), impuestos calculados, retenciones, XML devuelto por la alcaldía (prefeitura), PDF e historial de intentos en el proveedor.
