Fiscal print data - Fire Docs

GET https://api.fire.rest/v1/orders/21ec1f6c-c301-4528-b999-7836c1d21c6c/fiscal-print?vendorId=v_blueco_br
x-api-key: <your_api_key>
Accept: application/json

{
  "fiscal": {
    "countryCode": "BR",
    "documentType": "nfce",
    "documentNumber": "1000013",
    "authorizationProtocol": "141200000956123",
    "authorizedAt": "2026-05-06T01:23:10.991Z",
    "pdfUrl": "https://api.fiscal-provider.example/nfce/<docId>/pdf",
    "xmlUrl": "https://api.fiscal-provider.example/nfce/<docId>/xml"
  },
  "countryData": {
    "chaveAcesso": "41201008187168000160558050010000131609769080",
    "serie": "1",
    "serialNumber": 1
  },
  "company": {
    "legalName": "Sandbox LTDA",
    "tradeName": "Sandbox",
    "govIdType": "CNPJ",
    "govIdNumber": "00000000000000"
  },
  "store": {
    "name": "Loja Centro - SP",
    "code": "BR-SP-001",
    "govIdType": "CNPJ",
    "govIdNumber": "00000000000000",
    "stateRegistration": "000000000000",
    "city": "São Paulo",
    "address": "Av. Paulista 1578, Bela Vista",
    "phone": "1132094347"
  },
  "buyer": {
    "isFinalConsumer": true,
    "govIdType": "FINAL_CONSUMER",
    "govIdNumber": "00000000000",
    "name": "CONSUMIDOR FINAL",
    "email": null,
    "phone": null,
    "address": null
  },
  "order": {
    "id": "21ec1f6c-c301-4528-b999-7836c1d21c6c",
    "orderCode": "OC-br-001",
    "status": "COMPLETED",
    "isCancelled": false,
    "businessDayDate": "2026-05-06",
    "createdAt": "2026-05-06T01:22:59.028Z"
  }
}

GET

api

restaurant-os

injected-orders

{orderId}

fiscal-print

GET https://api.fire.rest/v1/orders/21ec1f6c-c301-4528-b999-7836c1d21c6c/fiscal-print?vendorId=v_blueco_br
x-api-key: <your_api_key>
Accept: application/json

{
  "fiscal": {
    "countryCode": "BR",
    "documentType": "nfce",
    "documentNumber": "1000013",
    "authorizationProtocol": "141200000956123",
    "authorizedAt": "2026-05-06T01:23:10.991Z",
    "pdfUrl": "https://api.fiscal-provider.example/nfce/<docId>/pdf",
    "xmlUrl": "https://api.fiscal-provider.example/nfce/<docId>/xml"
  },
  "countryData": {
    "chaveAcesso": "41201008187168000160558050010000131609769080",
    "serie": "1",
    "serialNumber": 1
  },
  "company": {
    "legalName": "Sandbox LTDA",
    "tradeName": "Sandbox",
    "govIdType": "CNPJ",
    "govIdNumber": "00000000000000"
  },
  "store": {
    "name": "Loja Centro - SP",
    "code": "BR-SP-001",
    "govIdType": "CNPJ",
    "govIdNumber": "00000000000000",
    "stateRegistration": "000000000000",
    "city": "São Paulo",
    "address": "Av. Paulista 1578, Bela Vista",
    "phone": "1132094347"
  },
  "buyer": {
    "isFinalConsumer": true,
    "govIdType": "FINAL_CONSUMER",
    "govIdNumber": "00000000000",
    "name": "CONSUMIDOR FINAL",
    "email": null,
    "phone": null,
    "address": null
  },
  "order": {
    "id": "21ec1f6c-c301-4528-b999-7836c1d21c6c",
    "orderCode": "OC-br-001",
    "status": "COMPLETED",
    "isCancelled": false,
    "businessDayDate": "2026-05-06",
    "createdAt": "2026-05-06T01:22:59.028Z"
  }
}

Partner API. This endpoint is intended for platform integrators. Standard Fire customers do not have direct access — contact your account manager if you need this integration.

Returns the consolidated fiscal context for a specific order — the data your point-of-sale or backoffice would render on a printed/digital receipt. It exposes:

Emitter context — legal entity, gov ID, store info, state registration
Country-specific fiscal references — chave de acesso, CUFE, clave de acceso, CAE, folio, etc., per country
Buyer context — recipient, with anonymous/final-consumer flagging
Order summary — code, status, business day

This endpoint is read-only. Side effect-free.

Authentication

x-api-key

string

required

Your Fire API key with the orders:read scope. Vendor-scoped: the API key must belong to the same vendor that owns the store/order.

Path parameters

orderId

string

required

Fire’s internal order UUID. Matches data.orderId in the order.completed event for this order.

Query parameters

vendorId

string

required

Vendor identifier. Used as an ownership guard — Fire returns 404 if the order does not belong to this vendor under your API key’s account.

GET https://api.fire.rest/v1/orders/21ec1f6c-c301-4528-b999-7836c1d21c6c/fiscal-print?vendorId=v_blueco_br
x-api-key: <your_api_key>
Accept: application/json

Response

fiscal

object

Common fiscal references for the document, regardless of country.

Show fiscal

countryCode

string

ISO 3166-1 alpha-2 country code: BR, CO, EC, CL, AR, VE.

documentType

string

Country-specific document type — e.g. nfce, nfe, factura_electronica, dte, factura_a.

documentNumber

string | null

Sequential document number assigned by the fiscal authority/provider.

authorizationProtocol

string | null

Authorization protocol from the tax authority (SEFAZ for BR, DIAN for CO, SRI for EC, SII for CL, AFIP for AR, SENIAT for VE). null until the document is authorized.

authorizedAt

string | null

ISO 8601 UTC timestamp of when the authority stamped the authorization.

pdfUrl

string | null

URL to fetch the rendered PDF (DANFE for BR NF-e, DANFCE for BR NFC-e, equivalent country-specific renderings elsewhere). May be ephemeral in production — download and persist on receipt.

xmlUrl

string | null

URL to fetch the canonical authority XML.

countryData

object

Country-specific document references. Shape varies by fiscal.countryCode. Examples:

BR: chaveAcesso (44 digits), serie, serialNumber
CO: cufe, prefijo, numeroDian
EC: claveAcceso (49 digits), numeroAutorizacion, ambiente
CL: folio, ted, tipoDte, trackId
AR: cae, fechaVtoCae, puntoVenta, numeroComprobante, tipoComprobante
VE: numeroControl, numeroFactura, rifEmisor

company

object | null

Legal entity emitting the document.

Show company

legalName

string | null

Razón social / legal name.

tradeName

string | null

Nombre fantasía / trade name.

govIdType

string | null

CNPJ / NIT / RUC / RUT / CUIT / RIF.

govIdNumber

string | null

Country-specific format.

store

object | null

Store-level info for the printed header.

Show store

name

string | null

Display name.

code

string | null

Store code (e.g. BR-SP-001).

govIdType

string | null

Same as company’s, repeated for convenience.

govIdNumber

string | null

Same as company’s.

stateRegistration

string | null

Inscrição Estadual (IE) for BR, equivalent in other countries.

city

string | null

City.

address

string | null

Street address.

phone

string | null

Store phone.

buyer

object

Recipient of the document.

Show buyer

isFinalConsumer

boolean

true for anonymous consumer (e.g. BR CONSUMIDOR FINAL placeholder). When true, name, email, phone, address are typically null and govIdType is "FINAL_CONSUMER" with govIdNumber: null (or a placeholder per country).

govIdType

string | null

Buyer’s tax/government ID type (CPF, CNPJ, RUT, DNI, etc.).

govIdNumber

string | null

Buyer’s gov ID number.

name

string | null

Buyer name. null for isFinalConsumer: true.

string | null

Buyer email.

phone

string | null

Buyer phone.

address

string | null

Buyer address.

order

object

Minimal order context for cross-reference.

Show order

string

Same as path.orderId.

orderCode

string | null

Short code (e.g. OC-br-001).

status

string

OPEN, COMPLETED, or CANCELLED.

isCancelled

boolean

Convenience flag for status === "CANCELLED".

businessDayDate

string | null

YYYY-MM-DD.

createdAt

string

ISO 8601 UTC.

{
  "fiscal": {
    "countryCode": "BR",
    "documentType": "nfce",
    "documentNumber": "1000013",
    "authorizationProtocol": "141200000956123",
    "authorizedAt": "2026-05-06T01:23:10.991Z",
    "pdfUrl": "https://api.fiscal-provider.example/nfce/<docId>/pdf",
    "xmlUrl": "https://api.fiscal-provider.example/nfce/<docId>/xml"
  },
  "countryData": {
    "chaveAcesso": "41201008187168000160558050010000131609769080",
    "serie": "1",
    "serialNumber": 1
  },
  "company": {
    "legalName": "Sandbox LTDA",
    "tradeName": "Sandbox",
    "govIdType": "CNPJ",
    "govIdNumber": "00000000000000"
  },
  "store": {
    "name": "Loja Centro - SP",
    "code": "BR-SP-001",
    "govIdType": "CNPJ",
    "govIdNumber": "00000000000000",
    "stateRegistration": "000000000000",
    "city": "São Paulo",
    "address": "Av. Paulista 1578, Bela Vista",
    "phone": "1132094347"
  },
  "buyer": {
    "isFinalConsumer": true,
    "govIdType": "FINAL_CONSUMER",
    "govIdNumber": "00000000000",
    "name": "CONSUMIDOR FINAL",
    "email": null,
    "phone": null,
    "address": null
  },
  "order": {
    "id": "21ec1f6c-c301-4528-b999-7836c1d21c6c",
    "orderCode": "OC-br-001",
    "status": "COMPLETED",
    "isCancelled": false,
    "businessDayDate": "2026-05-06",
    "createdAt": "2026-05-06T01:22:59.028Z"
  }
}

Common patterns

Render-time fetch. Call this endpoint at print/render time and persist the response if you need durable artifacts — pdfUrl and xmlUrl may be signed URLs that expire.
Final-consumer flag. Always check buyer.isFinalConsumer before rendering buyer details. For anonymous consumers in BR, govIdNumber is "00000000000" and other buyer fields are null.
Country-specific UI. Use fiscal.countryCode to dispatch to the right rendering template — DANFCE for BR NFC-e, DIAN-style for CO, SRI for EC, etc.

order.completed event

The full order snapshot — much richer than fiscal-print, used for non-print integrations.

order.invoiced event

Brazil only — fires when SEFAZ authorizes; carries the same fiscal references.

Fiscal callback

The inbound endpoint your fiscal provider uses to update fiscal state.

Payment methods config Expected cash

​Authentication

​Path parameters

​Query parameters

​Response

​Common patterns

​Related

order.completed event

order.invoiced event

Fiscal callback

Authentication

Path parameters

Query parameters

Response

Common patterns

Related