NF-e Providers
The system abstracts communication with NF-e providers through a common interface.
Available Providers
NFe.io (nfe_io)
Integration with the NFe.io platform for NFS-e issuance.
- API: https://api.nfe.io
- Documentation: https://nfe.io/docs/desenvolvedores/rest-api/
- Support: NFS-e (services)
Status Mapping:
| NFe.io Status | Internal Status |
|---|---|
| Created, WaitingCalculateTaxes, WaitingSend, WaitingReturn, WaitingDownload | processing |
| Issued | issued |
| Cancelled | canceled |
| Error | error |
Kobana NF-e (kobana)
Integration with Kobana's internal NF-e service.
- API: https://nfe.kobana.com.br (configurable)
- Version: /api/v1
- Support: Issuance and cancellation
Mock (mock)
Development provider that simulates issuances with fictitious data.
- No external calls
- In-memory storage
- Generates realistic keys and verification codes
Common Interface
All providers implement:
| Operation | Description |
|---|---|
issue | Issue an NF-e |
cancel | Cancel an issued NF-e |
query | Query the status of an NF-e |
downloadXml | Download the invoice XML |
downloadPdf | Download the PDF (DANFE) |