stackin
Back to blog
Products

NFS-e issuance

The service-invoice surface of the API, backed by Brazil's national NFS-e authorizer.

NFS-e issuance is stackin's service-invoice surface, transmitted to Brazil's national NFS-e system rather than a per-city webservice. It shares the same account, API key, and dashboard as NF-e.

One call — POST /invoices with document_type: "nfse" — covers every municipality, since the national ADN layer resolves the issuer's city on the backend instead of the integration needing to know which local webservice to call.

Response shape matches NF-e's: issued (with access key), rejected (with the authorizer's reason), or cancelled, all visible on the same dashboard timeline — a team handling both document types sees one unified history, not two separate systems bolted together.

Quota and environment behavior are identical to NF-e too: only successful issuances count against plan volume, and the same API key's environment (homologation or production) applies without any extra parameter on the call.

See the API reference for the exact request/response shape, and Issue NFS-e for what an NFS-e item actually needs.