Skip to main content

NF-e Configuration

Each organization can enable and configure automatic invoice issuance.

Configuration Fields

FieldDescription
Providermock, nfe_io, or kobana
Environmentsandbox or production
EnabledWhether NF-e issuance is active
Issuance policyWhen the NF-e is issued automatically
NFe.io API keyAuthentication key (encrypted)
NFe.io companiesCache of companies registered with the provider
Service descriptionDefault description added to invoices
Max issuance attemptsDefault: 5
Max cancellation attemptsDefault: 5
Retry intervals (minutes)Default: [0, 30, 60, 180, 360]

Issuance Policies

PolicyDescription
disabledNF-e issuance disabled
on_finalizationIssue when the invoice is finalized
on_full_paymentIssue when the invoice is fully paid (default)
per_installmentIssue 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.