Datos fiscales para impresión

GET https://api.fire.rest/v1/orders/21ec1f6c-c301-4528-b999-7836c1d21c6c/fiscal-print?vendorId=v_blueco_br
x-api-key: <tu_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: <tu_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"
  }
}

API de partner. Este endpoint está pensado para integradores de plataforma. Los clientes estándar de Fire no tienen acceso directo — contactá a tu account manager si necesitás esta integración.

Devuelve el contexto fiscal consolidado de una orden específica — los datos que tu point-of-sale o backoffice renderizaría en un recibo/factura impreso o digital. Expone:

Contexto del emisor — entidad legal, gov ID, info de tienda, inscripción estatal
Referencias fiscales por país — chave de acesso, CUFE, clave de acceso, CAE, folio, etc., según país
Contexto del comprador — destinatario, con flag de anónimo/consumidor final
Resumen de la orden — código, status, día de negocio

Endpoint solo lectura. Sin side effects.

Autenticación

x-api-key

string

requerido

Tu API key de Fire con scope orders:read. Vendor-scoped: la API key debe pertenecer al mismo vendor dueño de la tienda/orden.

Path parameters

orderId

string

requerido

UUID interno de la orden en Fire. Coincide con data.orderId en el evento order.completed de esta orden.

Query parameters

vendorId

string

requerido

Identificador de vendor. Se usa como guard de ownership — Fire devuelve 404 si la orden no pertenece a este vendor bajo el account de tu API key.

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

Respuesta

fiscal

object

Referencias fiscales comunes del documento, sin importar el país.

Mostrar fiscal

countryCode

string

Código de país ISO 3166-1 alpha-2: BR, CO, EC, CL, AR, VE.

documentType

string

Tipo de documento específico por país — p. ej. nfce, nfe, factura_electronica, dte, factura_a.

documentNumber

string | null

Número secuencial del documento asignado por la autoridad fiscal/proveedor.

authorizationProtocol

string | null

Protocolo de autorización de la autoridad tributaria (SEFAZ para BR, DIAN para CO, SRI para EC, SII para CL, AFIP para AR, SENIAT para VE). null hasta que el documento sea autorizado.

authorizedAt

string | null

Timestamp ISO 8601 UTC de cuándo la autoridad estampó la autorización.

pdfUrl

string | null

URL para obtener el PDF renderizado (DANFE para BR NF-e, DANFCE para BR NFC-e, equivalentes específicos por país en otros). Puede ser efímera en producción — descarga y persiste al recibir.

xmlUrl

string | null

URL para obtener el XML canónico de la autoridad.

countryData

object

Referencias del documento específicas por país. La forma varía según fiscal.countryCode. Ejemplos:

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

company

object | null

Entidad legal que emite el documento.

Mostrar 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

Formato específico por país.

store

object | null

Info a nivel tienda para el header impreso.

Mostrar store

name

string | null

Nombre para mostrar.

code

string | null

Código de tienda (p. ej. BR-SP-001).

govIdType

string | null

Igual que el de company, repetido por conveniencia.

govIdNumber

string | null

Igual que el de company.

stateRegistration

string | null

Inscrição Estadual (IE) para BR, equivalente en otros países.

city

string | null

Ciudad.

address

string | null

Dirección.

phone

string | null

Teléfono de la tienda.

buyer

object

Destinatario del documento.

Mostrar buyer

isFinalConsumer

boolean

true para consumidor anónimo (p. ej. placeholder BR CONSUMIDOR FINAL). Cuando es true, name, email, phone, address típicamente son null y govIdType es "FINAL_CONSUMER" con govIdNumber: null (o un placeholder según país).

govIdType

string | null

Tipo de documento del comprador (CPF, CNPJ, RUT, DNI, etc.).

govIdNumber

string | null

Número del documento del comprador.

name

string | null

Nombre del comprador. null para isFinalConsumer: true.

string | null

Email del comprador.

phone

string | null

Teléfono del comprador.

address

string | null

Dirección del comprador.

order

object

Contexto mínimo de la orden para cross-reference.

Mostrar order

string

Igual que path.orderId.

orderCode

string | null

Código corto (p. ej. OC-br-001).

status

string

OPEN, COMPLETED o CANCELLED.

isCancelled

boolean

Flag de conveniencia para 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"
  }
}

Patrones comunes

Fetch en tiempo de impresión. Llama este endpoint al momento de imprimir/renderizar y persiste la respuesta si necesitas artefactos durables — pdfUrl y xmlUrl pueden ser URLs firmadas que expiran.
Flag de consumidor final. Siempre revisa buyer.isFinalConsumer antes de renderizar detalles del comprador. Para consumidores anónimos en BR, govIdNumber es "00000000000" y otros campos del comprador son null.
UI específica por país. Usa fiscal.countryCode para despachar al template de renderizado correcto — DANFCE para BR NFC-e, estilo DIAN para CO, SRI para EC, etc.

Relacionado

Evento order.completed

El snapshot completo de la orden — mucho más rico que fiscal-print, usado para integraciones no-print.

Evento order.invoiced

Solo Brasil — dispara cuando SEFAZ autoriza; lleva las mismas referencias fiscales.

Callback fiscal

El endpoint inbound que tu proveedor fiscal usa para actualizar el estado fiscal.

Configuración de métodos de pago Efectivo esperado

​Autenticación

​Path parameters

​Query parameters

​Respuesta

​Patrones comunes

​Relacionado

Evento order.completed

Evento order.invoiced

Callback fiscal

Autenticación

Path parameters

Query parameters

Respuesta

Patrones comunes

Relacionado