> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.
# order.invoiced
> The fiscal authority has authorized the document (electronic invoice) for an order via your fiscal provider — all countries.
**Deprecated (v1).** Previous contract, kept only as a historical reference. The current version is [order.invoiced — v1.1](/en/events/order-invoiced).
`order.invoiced` fires once the **country's fiscal authority** authorizes the fiscal document associated with an order — SEFAZ in Brazil, SRI in Ecuador, DIAN in Colombia, AFIP in Argentina, SII in Chile, SENIAT in Venezuela. It is emitted by Fire's fiscal pipeline, which integrates with your fiscal provider as the document provider.
This event is **separate from** [`order.completed`](/en/events/order-completed): the order is paid first (`order.completed`), then Fire requests fiscal emission via your fiscal provider, and `order.invoiced` fires only when the fiscal authority returns the authorization.
## Trigger condition
Fire emits `order.invoiced` once per fiscal document, the first time **all** of these are true:
* The order is in a store with fiscal billing enabled (`storeFiscalConfig.enabled === true`)
* A fiscal document was emitted to your fiscal provider
* your fiscal provider reports that the fiscal authority authorized the document (`status` transitions to `authorized`; in Brazil this maps to the SEFAZ `cStat` authorized code)
| | |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Coverage | **All countries** — Brazil (NFC-e/NF-e via SEFAZ) and CO/EC/CL/AR/VE via the [generic fiscal callback](/en/api-reference/fiscal-callback). The country travels in `fiscal.countryCode`, no longer in the event name |
| Document types | Vary by country — `nfce`/`nfe` (BR), electronic invoice (CO/EC/CL/AR/VE). Arrives in `fiscal.docSubtype` |
| Idempotency key | `event.id` |
| Fires more than once | No, unless retried |
| Latency relative to `order.completed` | Usually seconds; can be minutes if the fiscal authority is degraded |
## What's in `trigger.data`
Same V4 order snapshot as [`order.completed`](/en/events/order-completed) plus a top-level **`fiscal`** block carrying the authorized document references. **Fields vary by country** — Brazil is shown below (`chaveAcesso`, `protocolo`); other countries carry their own identifiers (`cufe` in CO, `claveAcceso` in EC, `cae` in AR, etc.). See the [generic fiscal callback](/en/api-reference/fiscal-callback) for the per-country contract.
The order's `status` remains `"COMPLETED"` and `paymentStatus` remains `"SUCCEEDED"` — fiscal authorization does not change order status.
## Example — real production payload (BR, sanitized)
```json theme={null}
{
"event": {
"id": "...",
"type": "order.invoiced",
"createdAt": "2026-05-06T01:23:11.000Z"
},
"data": {
"orderId": "8017b54c-af0c-4246-a60a-a0d4ae9a0fef",
"orderCode": "OC-br-001",
"businessDayDate": "2026-03-31",
"externalOrderId": "8017b54c-af0c-4246-a60a-a0d4ae9a0fef",
"status": "COMPLETED",
"paymentStatus": "SUCCEEDED",
"createdAt": "2026-05-06T01:22:56.488Z",
"store": { /* same as order.completed — includes storeFiscalConfig with CNPJ, legalName */ },
"client": { /* ... */ },
"payments": { /* ... — includes payments.metadata.fiscal aggregates */ },
"orderLines": [ /* ... */ ],
"fulfillment": { /* ... */ },
"device": { /* ... */ },
"channel": { /* ... */ },
"operator": { /* ... */ },
"kds": { /* ... */ },
"marketing": null,
"metadata": {},
"fiscal": {
"status": "authorized",
"docSubtype": "nfce",
"chaveAcesso": "41201008187168000160558050010000131609769080",
"numero": "1000013",
"serie": null,
"protocolo": "141200000956123",
"providerDocId": "69fa97fe427d1240856e1282",
"pdfUrl": "https://api.fiscal-provider.example/nfce/69fa97fe427d1240856e1282/pdf",
"xmlUrl": "https://api.fiscal-provider.example/nfce/69fa97fe427d1240856e1282/xml",
"dataAutorizacao": "2026-05-06T01:23:10.991Z",
"cStat": null
}
},
"_meta": { "executionId": "...", "flowId": "...", "attempt": "1" }
}
```
## `data.fiscal` reference
SEFAZ-authorized document references.
Document status. For this event, always `"authorized"`. Other values you may see in your fiscal provider (`pending`, `processing`, `rejected`, `denied`) do **not** trigger `order.invoiced` — only the terminal authorized state does.
Document type. Values: `nfce` (NFC-e — consumer invoice, B2C) or `nfe` (NF-e — business invoice, B2B).
The 44-digit SEFAZ access key. Encodes UF, year/month, CNPJ, model, series, number, type of emission, and a check digit. Use this for reconciliation with SEFAZ portals.
Document number assigned by Fire's emission pipeline. Sequential per `(cnpj, serie, docSubtype)`.
Document series. May be `null` for some configurations; the series is encoded in `chaveAcesso` regardless.
SEFAZ authorization protocol number. Required for any subsequent SEFAZ operation (cancellation, correction).
Internal document ID assigned by your fiscal provider. Use it to query your provider's APIs directly (e.g. fetch the canonical XML).
URL to download the document's PDF (DANFE for NF-e, DANFCE for NFC-e). Hosted by your fiscal provider; signed/short-lived in production, durable in sandbox.
URL to download the canonical SEFAZ XML. Same hosting as `pdfUrl`.
ISO 8601 UTC timestamp of the SEFAZ authorization (when SEFAZ stamped the protocol).
Raw SEFAZ status code. May be `null` when the provider does not surface it (some providers hide it for consumer flows). When present, `100` (NF-e) or `100` (NFC-e) indicate authorization.
## Where the fiscal totals live
The aggregate fiscal values (vBC, vNF, vICMS, etc.) **are not** inside `data.fiscal` — they're in `data.payments.metadata.fiscal`, the same place [`order.completed`](/en/events/order-completed#fiscal-data) carries them. `order.invoiced` does not duplicate them; treat the order snapshot as the single source of truth for monetary aggregates.
Per-line classification (NCM, CFOP, CSOSN, fiscalCategoryCode) lives in `data.orderLines[n].metadata.fiscal`. Same as in `order.completed`.
The `data.store.storeFiscalConfig` block carries the emitter identity (CNPJ, legalName, tradeName) — also unchanged from `order.completed`.
## Handler example
```js theme={null}
async function onFiscalAuthorized(data) {
const { orderId, fiscal, store } = data;
// 1. Persist the SEFAZ authorization for audit
await db.fiscalDocs.upsert({
where: { providerDocId: fiscal.providerDocId },
create: {
providerDocId: fiscal.providerDocId,
fireOrderId: orderId,
country: "BR",
cnpj: store.storeFiscalConfig.govIdNumber,
docSubtype: fiscal.docSubtype,
chaveAcesso: fiscal.chaveAcesso,
protocolo: fiscal.protocolo,
authorizedAt: new Date(fiscal.dataAutorizacao),
status: "authorized",
},
update: {},
});
// 2. Fetch the canonical XML for archival (legally required in BR)
const xml = await fetch(fiscal.xmlUrl).then(r => r.text());
await archive.put(`xml/${fiscal.providerDocId}.xml`, xml);
// 3. Notify the customer with the PDF link
await mailer.send({
to: data.client?.email,
template: "fiscal-receipt",
pdf: fiscal.pdfUrl,
});
}
```
## Common pitfalls
* **`status === "authorized"`, not `"COMPLETED"`.** The `data.status` (the order status) is `"COMPLETED"`; the fiscal status is in `data.fiscal.status`.
* **`pdfUrl` and `xmlUrl` may be ephemeral.** In production, your fiscal provider may sign/expire these links. Download and persist the artifacts on receipt rather than linking customers directly to your fiscal provider.
* **`cStat` is often `null`.** Don't make logic depend on it. Use `status === "authorized"` and `protocolo` as the authoritative signals.
* **No event for `rejected` / `denied` / `error`.** If SEFAZ rejects the document, no event fires today. The fiscal document's status is persisted internally but no flow is triggered. Watch for this in the roadmap.
* **The country no longer lives in the event name.** `order.invoiced` fires for all countries; filter on `fiscal.countryCode`. The `fiscal` block fields vary per country (chaveAcesso/protocolo in BR, cufe in CO, claveAcceso in EC, etc.).
## Related events
Fires before this event — the order itself.
Fires later if the document gets cancelled at SEFAZ.