NF-e Configuration
Each organization can enable and configure automatic invoice issuance.
Configuration Fields
| Field | Description |
|---|---|
| Provider | mock, nfe_io, or kobana |
| Environment | sandbox or production |
| Enabled | Whether NF-e issuance is active |
| Issuance policy | When the NF-e is issued automatically |
| NFe.io API key | Authentication key (encrypted) |
| NFe.io companies | Cache of companies registered with the provider |
| Service description | Default description added to invoices |
| Max issuance attempts | Default: 5 |
| Max cancellation attempts | Default: 5 |
| Retry intervals (minutes) | Default: [0, 30, 60, 180, 360] |
Issuance Policies
| Policy | Description |
|---|---|
disabled | NF-e issuance disabled |
on_finalization | Issue when the invoice is finalized |
on_full_payment | Issue when the invoice is fully paid (default) |
per_installment | Issue one NF-e for each installment paid |
Examples
on_full_payment: A R$ 1,000 invoice generates one NF-e for R$ 1,000 when fully paid.
per_installment: A R$ 1,000 invoice split into 3 installments generates three NF-e of R$ 333.33 as each installment is paid.
on_finalization: The NF-e is issued at the time of invoice finalization, regardless of payment.