Dados fiscais para impressão

GET https://api.fire.rest/v1/orders/21ec1f6c-c301-4528-b999-7836c1d21c6c/fiscal-print?vendorId=v_blueco_br
x-api-key: <sua_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: <sua_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 parceiro. Este endpoint é destinado a integradores de plataforma. Clientes padrão do Fire não têm acesso direto — entre em contato com seu account manager se precisar desta integração.

Retorna o contexto fiscal consolidado de um pedido específico — os dados que seu point-of-sale ou backoffice renderizaria em um recibo/nota fiscal impresso ou digital. Expõe:

Contexto do emissor — entidade legal, gov ID, info de loja, inscrição estadual
Referências fiscais por país — chave de acesso, CUFE, clave de acceso, CAE, folio, etc., conforme país
Contexto do comprador — destinatário, com flag de anônimo/consumidor final
Resumo do pedido — código, status, dia de negócio

Endpoint somente leitura. Sem side effects.

Autenticação

x-api-key

string

obrigatório

Sua API key do Fire com scope orders:read. Vendor-scoped: a API key deve pertencer ao mesmo vendor dono da loja/pedido.

Path parameters

orderId

string

obrigatório

UUID interno do pedido no Fire. Coincide com data.orderId no evento order.completed deste pedido.

Query parameters

vendorId

string

obrigatório

Identificador do vendor. Usado como guard de ownership — o Fire retorna 404 se o pedido não pertencer a este vendor sob o account da sua API key.

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

Resposta

fiscal

object

Referências fiscais comuns do documento, independente do 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 — ex.: nfce, nfe, factura_electronica, dte, factura_a.

documentNumber

string | null

Número sequencial do documento atribuído pela autoridade fiscal/provedor.

authorizationProtocol

string | null

Protocolo de autorização da autoridade tributária (SEFAZ para BR, DIAN para CO, SRI para EC, SII para CL, AFIP para AR, SENIAT para VE). null até o documento ser autorizado.

authorizedAt

string | null

Timestamp ISO 8601 UTC de quando a autoridade carimbou a autorização.

pdfUrl

string | null

URL para obter o PDF renderizado (DANFE para BR NF-e, DANFCE para BR NFC-e, equivalentes específicos por país nos outros). Pode ser efêmera em produção — baixe e persista ao receber.

xmlUrl

string | null

URL para obter o XML canônico da autoridade.

countryData

object

Referências do documento específicas por país. O formato varia conforme fiscal.countryCode. Exemplos:

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

Entidade legal que emite o documento.

Mostrar company

legalName

string | null

Razão social / legal name.

tradeName

string | null

Nome fantasia / 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 nível de loja para o cabeçalho impresso.

Mostrar store

name

string | null

Nome de exibição.

code

string | null

Código de loja (ex.: BR-SP-001).

govIdType

string | null

Igual ao de company, repetido por conveniência.

govIdNumber

string | null

Igual ao de company.

stateRegistration

string | null

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

city

string | null

Cidade.

address

string | null

Endereço.

phone

string | null

Telefone da loja.

buyer

object

Destinatário do documento.

Mostrar buyer

isFinalConsumer

boolean

true para consumidor anônimo (ex.: placeholder BR CONSUMIDOR FINAL). Quando é true, name, email, phone, address tipicamente são null e govIdType é "FINAL_CONSUMER" com govIdNumber: null (ou um placeholder por país).

govIdType

string | null

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

govIdNumber

string | null

Número do documento do comprador.

name

string | null

Nome do comprador. null para isFinalConsumer: true.

string | null

E-mail do comprador.

phone

string | null

Telefone do comprador.

address

string | null

Endereço do comprador.

order

object

Contexto mínimo do pedido para cross-reference.

Mostrar order

string

Igual a path.orderId.

orderCode

string | null

Código curto (ex.: OC-br-001).

status

string

OPEN, COMPLETED ou CANCELLED.

isCancelled

boolean

Flag de conveniência 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"
  }
}

Padrões comuns

Fetch no momento da impressão. Chame este endpoint na hora de imprimir/renderizar e persista a resposta se precisar de artefatos duráveis — pdfUrl e xmlUrl podem ser URLs assinadas que expiram.
Flag de consumidor final. Sempre verifique buyer.isFinalConsumer antes de renderizar detalhes do comprador. Para consumidores anônimos em BR, govIdNumber é "00000000000" e os outros campos do comprador são null.
UI específica por país. Use fiscal.countryCode para despachar para o template de renderização correto — DANFCE para BR NFC-e, estilo DIAN para CO, SRI para EC, etc.

Relacionado

Evento order.completed

O snapshot completo do pedido — muito mais rico que fiscal-print, usado para integrações não-print.

Evento order.invoiced

Apenas Brasil — dispara quando a SEFAZ autoriza; carrega as mesmas referências fiscais.

Callback fiscal

O endpoint inbound que seu provedor fiscal usa para atualizar o estado fiscal.

Configuração de métodos de pagamento Caixa esperado

​Autenticação

​Path parameters

​Query parameters

​Resposta

​Padrões comuns

​Relacionado

Evento order.completed

Evento order.invoiced

Callback fiscal

Autenticação

Path parameters

Query parameters

Resposta

Padrões comuns

Relacionado