order.completed

v1.2 · atual
v1.1 · anterior
v1 · descontinuado
v0 · descontinuado

Você está lendo o contrato atual (v1.2) de order.completed. v1.2 adiciona data.fiscalRepresentation: a numeração fiscal que o ponto de venda obteve antes de injetar o pedido. Viaja sempre: em null quando não se tentou numerar, e preenchido quando sim — numberingStatus diz como terminou. Trazer conteúdo não significa que o comprovante esteja autorizado. Apenas aditivo — nada do que você já lia mudou.O bloco carrega o documento fiscal vigente do pedido: os campos que significam o mesmo em qualquer país no topo, os identificadores do órgão dentro de countryData no vocabulário do seu país, e os documentos anteriores em history. Quando um cancelamento numera, a nota de crédito passa ao topo e a de venda desce para o histórico — com compensates apontando para ela.

v1.1 adicionou data.policy.deferredPayment (este pedido pode ser trabalhado antes do pagamento?) e data.lastKnown (estado orientativo de cozinha/fiscal), além do novo evento order.opened. Continua válido: v1.2 apenas soma um bloco.

O contrato v1 está descontinuado — mantido como referência histórica. Abra aqui: order.completed — v1.

order.completed dispara quando um pedido é injetado com sucesso e está pago. Carrega o snapshot V4 do pedido como trigger.data — todos os campos que seu flow precisa para agir sobre o pedido sem voltar a chamar o Fire.

Condição de disparo

O Fire emite order.completed exatamente uma vez por pedido, na primeira vez em que ambos são verdadeiros no momento de injeção:

order.status === "COMPLETED"
order.paymentStatus === "SUCCEEDED"

Pedidos que ainda estão PENDING de pagamento, ou que falham o pagamento, nunca produzem order.completed. Cancelamentos após completar produzem um evento separado order.cancelled — eles não retraem order.completed.


Cobertura	Global (todos os países, todos os canais)
Chave de idempotência	`event.id` (= `flow_executions.id`)
Dispara mais de uma vez	Não, salvo em retentativas — use `event.id` para deduplicar
Ordem	Não garantida entre pedidos — ordene por `data.createdAt` se precisar
Retentativas	Até 5 tentativas com backoff exponencial

O que tem em `trigger.data`

trigger.data é o snapshot V4 do pedido — o mesmo objeto que está persistido em flow_queue.trigger_data e exposto aos templates do seu flow. As chaves top-level, em ordem:

Chave	Tipo	Sempre presente
`orderId`	`string` (UUID)	sim
`orderCode`	`string \| null`	sim
`businessDayDate`	`string` (`YYYY-MM-DD`)	sim
`externalOrderId`	`string`	sim
`redeemPoints`	`boolean`	sim
`accumulatePoints`	`boolean`	sim
`discount`	`boolean`	sim
`createdAt`	`string \| null` (ISO 8601 UTC)	sim
`orderComment`	`string` (pode ser `""`)	sim
`paymentStatus`	`string` (sempre `"SUCCEEDED"`)	sim
`status`	`string` (sempre `"COMPLETED"`)	sim
`marketing`	`object \| null`	sim
`store`	`object`	sim
`device`	`object`	sim
`channel`	`object`	sim
`operator`	`object`	sim
`client`	`object \| null`	sim
`payments`	`object`	sim
`kds`	`object`	sim
`metadata`	`object` (frequentemente `{}`)	sim
`orderLines`	`object[]`	sim
`fulfillment`	`object`	sim

Exemplo — payload real de produção (BR, sanitizado)

O exemplo abaixo vem de uma linha real de flow_queue.trigger_data (tenant sandbox brasileiro, canal KIOSK, serviço dine-in). Os campos PII são substituídos por placeholders; o restante dos campos e formatos é verbatim.

{
  "orderId": "21ec1f6c-c301-4528-b999-7836c1d21c6c",
  "orderCode": "OC-br-001",
  "businessDayDate": "2026-03-31",
  "externalOrderId": "7805610b-97cf-461f-a2d6-d86f63a80833",
  "redeemPoints": false,
  "accumulatePoints": false,
  "discount": false,
  "createdAt": "2026-05-06T01:22:59.028Z",
  "orderComment": "Comentario de prueba orden",
  "paymentStatus": "SUCCEEDED",
  "status": "COMPLETED",
  "marketing": null,
  "store": {
    "uid": "a4019cad-bbac-4269-9f8d-f29654e92c45",
    "code": "BR-SP-001",
    "name": "Loja Centro - SP",
    "phone": "1132094347",
    "address": "Av. Paulista 1578, Bela Vista, São Paulo - SP",
    "externalId": "a4019cad-bbac-4269-9f8d-f29654e92c45",
    "vendor": {
      "uid": "100.2.1",
      "name": "Sandbox Brand",
      "description": "Sandbox Brand",
      "loyaltyPlan": true
    },
    "account": {
      "uid": "100",
      "name": "Sandbox",
      "description": "Sandbox"
    },
    "locationInfo": {
      "city":     { "uid": "1", "code": "SAO", "name": "São Paulo" },
      "country":  { "uid": "6", "code": "BR",  "name": "Brasil" },
      "location": { "lat": "-23.5952979", "lon": "-46.6866818" },
      "timezone": "America/Sao_Paulo",
      "currencyCode": "BRL"
    },
    "storeFiscalConfig": {
      "enabled": true,
      "company": {
        "govIdType": "CNPJ",
        "govIdNumber": "00000000000000",
        "legalName": "Sandbox LTDA",
        "tradeName": "Sandbox"
      },
      "govIdType": "CNPJ",
      "govIdNumber": "00000000000000",
      "secondaryGovIdType": "INSCRICAO_ESTADUAL",
      "secondaryGovIdNumber": "000000000000",
      "metadata": {
        "neverstop":   { "url": "", "enabled": false },
        "storeCode3S": "50000001",
        "serialNumber": 1
      }
    }
  },
  "device": {
    "uid": "device_kiosk_001",
    "name": "KIOSK",
    "platform": "android",
    "metadata": { "ip": "10.0.0.0" }
  },
  "channel": {
    "uid": "c784d4ba-23c7-4929-b2f0-1a1960d9cdc2",
    "code": "KIOSK",
    "metadata": {}
  },
  "operator": {
    "uid": "op_001",
    "name": "Operator Name",
    "session": { "uid": "sess_001" }
  },
  "client": {
    "uid": "usr_consumidorfinal_001",
    "name": "CONSUMIDOR",
    "lastName": "FINAL",
    "email": "consumidor@example.com",
    "phone": "0000000000",
    "govIdType": "FINAL_CONSUMER",
    "govIdNumber": "00000000000",
    "externalId": null,
    "metadata": {
      "fiscal": null,
      "gender": "",
      "birthdate": ""
    },
    "billingInformation": {
      "email": "",
      "phone": "0000000000",
      "address": "",
      "govIdType": "FINAL_CONSUMER",
      "externalId": "",
      "govIdNumber": "00000000000",
      "businessName": ""
    }
  },
  "payments": {
    "totals": [
      {
        "taxes": [
          { "base": "229000", "name": "ICMS",   "rate": "0.04",   "amount": "9200",
            "metadata": { "cst": "90", "cBenef": "SP040100" } },
          { "base": "229000", "name": "PIS",    "rate": "0.0165", "amount": "3800",
            "metadata": { "cst": "01" } },
          { "base": "229000", "name": "COFINS", "rate": "0.076",  "amount": "17400",
            "metadata": { "cst": "01" } },
          { "base": "198700", "name": "IBS_UF",  "rate": "0.0006", "amount": "100",
            "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0.001, "rateEffective": 0.0006 } },
          { "base": "198700", "name": "IBS_MUN", "rate": "0",      "amount": "0",
            "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0, "rateEffective": 0 } },
          { "base": "198700", "name": "CBS",     "rate": "0.0054", "amount": "1100",
            "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0.009, "rateEffective": 0.0054 } }
        ],
        "total": "229000",
        "subtotal": "197400",
        "discounts": [
          { "priority": "1", "type": "FIXED", "value": "20000", "netPrice": "229000",
            "discountValue": "20000", "netPriceAfterDiscount": "209000" }
        ],
        "taxesValue": "31600",
        "currencyCode": "BRL",
        "discountValue": "20000",
        "subtotalBeforeTaxes": "197400"
      }
    ],
    "shippingCost": [
      { "total": "50000", "taxValue": "0", "currencyCode": "BRL",
        "subtotalWithoutTaxes": "50000", "subtotalIncludeDiscounts": "50000" }
    ],
    "extraCharges": [
      { "total": "15000", "taxValue": "0", "description": "Taxa de serviço", "currencyCode": "BRL",
        "subtotalWithoutTaxes": "15000", "subtotalIncludeDiscounts": "15000" }
    ],
    "discounts": [
      { "priority": "1", "type": "FIXED", "value": "20000", "netPrice": "229000",
        "discountValue": "20000", "netPriceAfterDiscount": "209000" }
    ],
    "paymentMethods": [
      {
        "mid": "",
        "tid": "",
        "processor": "CREDIT_CARD",
        "card": {
          "bin": "MASTERCARD",
          "mask": "",
          "brand": "MASTERCARD",
          "holder": "",
          "cardCountry": "",
          "lastFourDigits": "0000"
        },
        "acquirer": { "code": "00000000000000", "name": "ACQUIRER NAME", "cnpj": "01027058000191" },
        "voucher": "",
        "metadata": {},
        "totalBill": 22.9,
        "currencyCode": "BRL",
        "exactPayment": false,
        "transactionId": "tx_a1b2c3d4",
        "referenceNumber": null,
        "transactionDate": {
          "date": "2026-04-17T15:41:55.000Z",
          "timeZoneName": "America/Sao_Paulo"
        },
        "transactionType": "",
        "authorizationCode": "000000000000",
        "paymentMethodCode": "",
        "transactionStatus": "APPROVED",
        "customerCashAmount": "0",
        "idAuth": "952001",
        "receiptCustomer": "COMPROVANTE CLIENTE\n---------------------------\nMASTERCARD ****0000\nAPROVADO\nAuth: 952001",
        "receiptMerchant": "COMPROVANTE ESTABELECIMENTO\n---------------------------\nMASTERCARD ****0000\nAPROVADO\nAuth: 952001"
      }
    ],
    "metadata": {
      "fiscal": {
        "vBC":      "229000",
        "vNF":      "229000",
        "vCBS":     "1100",
        "vIBS":     "100",
        "vPIS":     "3800",
        "vDesc":    "0",
        "vICMS":    "9200",
        "vProd":    "229000",
        "vIBSUF":   "100",
        "vCOFINS":  "17400",
        "vIBSMun":  "0",
        "vTotTrib": "31600",
        "vBCIBSCBS":"198700"
      }
    }
  },
  "kds": {
    "metadata": {},
    "orderCode": "OC-br-001",
    "buzzerName": "Leonardo",
    "invoiceEmail": "",
    "invoicePrint": true
  },
  "metadata": {},
  "orderLines": [
    {
      "uid": "b9912637-eb44-4533-a1e5-f5bf2cdd07e8",
      "hash": "0d86fae2b5bc6198",
      "itemId": "39d1bd7fcd45c52f0c824364c2c0cfc402bd72b046cfaaec276a0131908dbf20",
      "itemType": "COMBO",
      "itemDescription": "Crunch Salad + Batata Pequena + 1 Tira + Refri",
      "quantity": "1",
      "selectedCurrency": "BRL",
      "updatedAt": "2026-05-06T01:22:59.663Z",
      "price": {
        "unitPrice": [
          {
            "taxes": [],
            "netPrice": "229000",
            "grossPrice": "229000",
            "currencyCode": "BRL",
            "discounts": [
              { "priority": "1", "type": "FIXED", "value": "15000", "netPrice": "229000",
                "discountValue": "15000", "netPriceAfterDiscount": "214000" }
            ],
            "discountValue": "15000",
            "taxesValue": "0",
            "subtotalBeforeTaxes": "229000"
          }
        ],
        "totalPrice": [
          {
            "taxes": [
              { "base": "229000", "name": "ICMS",   "rate": "0.04",   "amount": "9200",
                "metadata": { "cst": "90", "cBenef": "SP040100" } },
              { "base": "229000", "name": "PIS",    "rate": "0.0165", "amount": "3800",
                "metadata": { "cst": "01" } },
              { "base": "229000", "name": "COFINS", "rate": "0.076",  "amount": "17400",
                "metadata": { "cst": "01" } },
              { "base": "198700", "name": "IBS_UF",  "rate": "0.0006", "amount": "100",
                "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0.001, "rateEffective": 0.0006 } },
              { "base": "198700", "name": "IBS_MUN", "rate": "0",      "amount": "0",
                "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0, "rateEffective": 0 } },
              { "base": "198700", "name": "CBS",     "rate": "0.0054", "amount": "1100",
                "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0.009, "rateEffective": 0.0054 } }
            ],
            "netPrice": "197400",
            "grossPrice": "229000",
            "currencyCode": "BRL",
            "discounts": [
              { "priority": "1", "type": "FIXED", "value": "15000", "netPrice": "229000",
                "discountValue": "15000", "netPriceAfterDiscount": "214000" }
            ],
            "discountValue": "15000",
            "taxesValue": "31600",
            "subtotalBeforeTaxes": "197400"
          }
        ]
      },
      "lineTotals": [
        {
          "taxes": [
            { "base": "229000", "name": "ICMS",   "rate": "0.04",   "amount": "9200",  "metadata": { "cst": "90", "cBenef": "SP040100" } },
            { "base": "229000", "name": "PIS",    "rate": "0.0165", "amount": "3800",  "metadata": { "cst": "01" } },
            { "base": "229000", "name": "COFINS", "rate": "0.076",  "amount": "17400", "metadata": { "cst": "01" } },
            { "base": "198700", "name": "IBS_UF",  "rate": "0.0006", "amount": "100",  "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0.001, "rateEffective": 0.0006 } },
            { "base": "198700", "name": "IBS_MUN", "rate": "0",      "amount": "0",    "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0, "rateEffective": 0 } },
            { "base": "198700", "name": "CBS",     "rate": "0.0054", "amount": "1100", "metadata": { "cst": "200", "reducao": 0.4, "cClassTrib": "200047", "rateNominal": 0.009, "rateEffective": 0.0054 } }
          ],
          "total": "229000",
          "subtotal": "197400",
          "currencyCode": "BRL",
          "discounts": [
            { "priority": "1", "type": "FIXED", "value": "15000", "netPrice": "229000", "discountValue": "15000", "netPriceAfterDiscount": "214000" }
          ],
          "discountValue": "15000",
          "taxesValue": "31600",
          "subtotalBeforeTaxes": "197400"
        }
      ],
      "modifierGroups": [
        {
          "uid": "e247256ad628b0fd9c45453370e247fef1ad173829cc809c9c6930698d62e56b",
          "description": "Selecione: Escolha seus sanduíches!",
          "selectedModifiers": [
            {
              "itemId": "0104fdb2010be9ac14750a950f81c026b35a49a3c32b36281f41ef650d278b72",
              "itemType": "MODIFIER",
              "itemDescription": "CRUNCH SALAD",
              "quantity": "1",
              "selectedCurrency": "BRL",
              "price": { /* unitPrice / totalPrice arrays — same shape */ },
              "modifierGroups": [],
              "metadata": {
                "redeemed": false,
                "externalCode": "80229#900002186#91198"
              }
            }
          ]
        }
      ],
      "metadata": {
        "fiscal": {
          "ncm": "21069090",
          "cfop": "5101",
          "csosn": "500",
          "vTotTrib": 3.16,
          "fiscalCategoryCode": "2106.90.90"
        },
        "redeemed": false,
        "externalCode": "80229",
        "referenceUnitPrice": null,
        "referenceTotalPrice": null
      }
    }
  ],
  "fulfillment": {
    "service": { "uid": "726c4892-48b9-45da-b066-2a8e83d2cb78", "code": "DINE_IN", "metadata": {} },
    "pickup": {
      "prepDate": "2026-05-06T01:22:59.028Z",
      "prepTime": "",
      "pickupDate": "2026-05-06T01:22:59.028Z",
      "propertyId": "a4019cad-bbac-4269-9f8d-f29654e92c45",
      "prepTimeUnit": "minute"
    },
    "delivery": {
      "city": "São Paulo",
      "country": "Brasil",
      "zipCode": "",
      "latitude": "0",
      "nickName": "HOME",
      "longitude": "0",
      "reference": "",
      "mainStreet": "",
      "propertyId": 1,
      "deliveryDate": null,
      "secondaryStreet": "",
      "deliveryConfirmationCode": "IFOOD-7H3K9"
    }
  }
}

Os valores monetários são strings com o valor inteiro escalado ×10.000 — quatro casas decimais fixas. "229000" é 22,9 BRL, não 229.000. Para ler, divida por 10.000.É a escala com que o FIRE armazena: evita o drift de ponto flutuante ao somar impostos através de várias integrações. Parseie com uma biblioteca decimal, nunca com parseFloat.A exceção é paymentMethods[].totalBill, que a origem às vezes envia como número JSON — trate os dois casos.

Não é a escala de todos os caminhos. A requisição de numeração fiscal leva os valores sem escalar, tal como foram cobrados. Se você tirar um valor deste evento para declará-lo ao órgão, divida antes.

Referência de campos

Identificadores top-level

string

UUID interno do pedido no Fire. Estável através de entregas; use junto com event.id para rastreabilidade.

string | null

Código curto legível mostrado em recibos e telas KDS (ex.: 95K, OC-br-001). null quando o canal não atribui um.

string

Dia de negócio ao qual este pedido pertence, em YYYY-MM-DD. Calculado em hora local da loja, então um pedido feito às 01:00 pode pertencer ao dia de negócio anterior dependendo do corte de fim de dia.

string

O ID de pedido tal como provido pelo canal/agregador na injeção. Use para reconciliar com sistemas upstream (POS, dashboards de agregador).

string | null

Timestamp ISO 8601 UTC de quando o pedido foi originalmente feito. Distinto de event.createdAt, que é quando a execução do flow começou.

string

Sempre "COMPLETED" para este evento.

string

Sempre "SUCCEEDED" para este evento.

boolean

true se pontos de fidelidade foram resgatados neste pedido.

boolean

true se o cliente acumulou pontos de fidelidade.

boolean

true se algum desconto foi aplicado.

string

Nota free-text do cliente para o pedido inteiro. Empty string quando não definido.

`data.store`

object

Snapshot da loja no momento em que o pedido foi completado.

Mostrar store

string | null

UUID da loja no Fire.

string | null

ID da loja no seu sistema externo, quando mapeado.

string | null

Código da loja (ex.: BR-SP-001). Use para limitar flows a lojas específicas.

string | null

Nome de exibição da loja.

string | null

Telefone da loja.

string | null

Endereço da loja.

object

Contexto geográfico.

Mostrar locationInfo

object

{ uid, code, name } — identificadores de cidade.

object

{ uid, code, name } — code é ISO 3166-1 alpha-2 (BR, EC, CO, …).

object

{ lat, lon } como strings de graus decimais.

string | null

Fuso IANA (ex.: America/Sao_Paulo).

string | null

Código de moeda ISO 4217 (BRL, USD, …).

object

{ uid, name, description, loyaltyPlan } — metadata da marca.

object

{ uid, name, description } — account top-level dono da marca.

object | null

Snapshot da configuração fiscal da loja. Incluído apenas quando a emissão fiscal está habilitada para a loja. Veja Dados fiscais abaixo.

`data.client`

object | null

Cliente que fez o pedido. null para pedidos de canal totalmente anônimos. Quando a venda não identifica o comprador —em qualquer país— client trafega populado com o marcador de consumidor final: govIdType: "FINAL_CONSUMER" e govIdNumber em zeros. Não chega traduzido para a regra de cada regime — o NIT genérico da DIAN, por exemplo, é resolvido pelo provedor fiscal.

Mostrar client

string | null

ID do cliente vindo do provedor de autenticação.

string | null

Nome.

string | null

Sobrenome.

string | null

Endereço de e-mail.

string | null

Telefone.

string | null

Tipo de documento do cliente (CPF, CNPJ, FINAL_CONSUMER, …).

string | null

Número do documento do cliente.

string | null

ID do cliente em sistema externo, quando mapeado.

object

Mostrar metadata

string | null

Gênero do cliente quando capturado (frequentemente "").

string | null

Data ISO.

object | null

Apenas Brasil. Populado quando client.govIdType === "CNPJ". Contém cep, tipoLogradouro, logradouro, numero, bairro, codigoCidade, descricaoCidade, estado.

object

Overrides de faturamento. Todos os campos opcionais; podem ser empty strings em vez de null.

`data.payments`

object

Detalhamento de dinheiro.

Mostrar payments

object[]

Totais a nível de pedido — geralmente uma entrada. Todas as chaves são camelCase (total, subtotal, taxesValue, currencyCode, discountValue, subtotalBeforeTaxes, mais os arrays taxes[] e discounts[]).Cada entrada tem: total, subtotal, taxes[], discounts[], taxesValue, currencyCode, discountValue, subtotalBeforeTaxes.Formato de taxes[n]: { base, name, rate, amount, metadata }. Exemplos de name: ICMS, PIS, COFINS, IBS_UF, IBS_MUN, IBS_FED. metadata carrega códigos fiscais por país (cst, cBenef, cClassTrib, reducao, rateNominal, rateEffective).

object[]

Linhas de custo de envio. Vazio para pedidos na loja.

object[]

Gorjetas, taxas de embalagem e outros add-ons.

object[]

Adicionado na v1.

Descontos a nível de pedido. Cada entrada é um objeto Discount:

Mostrar Discount

string

Ordem de aplicação quando há vários descontos.

string

FIXED ou PERCENTAGE.

string

Valor do desconto (×10000).

string

Líquido antes do desconto (×10000).

string

Valor aplicado (×10000).

string

Líquido após o desconto (×10000).

O mesmo Discount aparece em payments.totals[].discounts e em orderLines[].price.*[].discounts + lineTotals[].discounts (descontos por produto).

object[]

Métodos usados para pagar. A maioria dos campos é camelCase (totalBill, currencyCode, transactionId, transactionStatus, paymentMethodCode, …) e o sub-objeto card também é camelCase (card.cardCountry, card.lastFourDigits, card.externalCardBrandId).Cada entrada: processor, currencyCode, paymentMethodCode, transactionType, transactionId, transactionStatus, exactPayment, totalBill, acquirer, card, transactionDate, metadata, mid, tid, voucher, referenceNumber, authorizationCode, customerCashAmount, idAuth, receiptCustomer, receiptMerchant.Campos novos (todos nullable):

idAuth (string | null) — ID de autorização do processador de pagamento (ex.: SiTef IdAuth). Diferente de authorizationCode.
receiptCustomer (string | null) — Texto completo do comprovante para o cliente; pode ser multilinha (separado por quebras de linha).
receiptMerchant (string | null) — Texto completo do comprovante para o estabelecimento; pode ser multilinha.
acquirer.cnpj (string | null) — CNPJ da credenciadora de pagamento. Preenchido apenas para o Brasil; null nos demais países.

object

Mostrar metadata

object | null

Totais fiscais agregados. Veja Dados fiscais abaixo.

`data.fulfillment`

object

Como o pedido é entregue.

Mostrar fulfillment

object

{ uid, code, metadata } — code é DELIVERY, TAKEAWAY, PICKUP ou DINE_IN.

object | null

Populado para PICKUP/TAKEAWAY/DINE_IN. Contém prepDate, pickupDate (ambos ISO 8601 UTC), prepTime, prepTimeUnit, propertyId.

object | null

Populado para DELIVERY. Campos de endereço mais deliveryDate. Nota: o objeto delivery pode estar presente (com valores placeholder como latitude: "0") em serviços non-delivery — ramifique em fulfillment.service.code, não em delivery !== null.

string | null

Adicionado na v1.

Código de confirmação de entrega/retirada do agregador (ex. iFood / Rappi). Vem de shippingMethod.delivery.metadata.deliveryConfirmationCode.

`data.kds`

object

Contexto do kitchen display.

Mostrar kds

string

Identificador de buzzer ou pager. Empty string quando não definido.

string

E-mail do cliente para cópia de fatura. Empty string quando não capturado.

boolean | null

Se a cozinha deve imprimir a cópia da fatura.

string

Espelha o orderCode top-level.

object

Extras KDS específicos do canal.

`data.device` e `data.operator`

object

{ uid, name, platform, metadata.ip } — dispositivo de origem. Os campos podem ser null para canais não físicos.

object

{ uid, name, session.uid } — staff/caixa que processou o pedido. Todos os campos null para canais self-service (quiosque, web).

`data.orderLines`

object[]

Produtos pedidos. Totalmente camelCase (transformado pelo builder V4).

Mostrar orderLines[n]

string

UUID da linha.

string

Hash estável para esta linha — útil para deduplicar se você fizer fan-out de linhas downstream.

string

Identificador do produto.

string

Classificação do item — um de PRODUCT, COMBO, MODIFIER, PACKAGING.

Enum completo na v1.

Passthrough; recai para PRODUCT se o canal não enviar tipo.

Mostrar valores de itemType

enum

Item vendável por si só — a linha é o produto.

enum

Container/bundle; seus componentes com preço ficam em modifierGroups[].selectedModifiers[].

enum

Adicional/opção escolhido dentro de um produto/combo.

enum

Linha de embalagem (sacola, caixa, copo), itemizada para fins fiscais/estoque.

string

Nome de exibição.

string

String inteira (ex.: "1", "2").

string

ISO 4217 (ex.: BRL).

string

ISO 8601 UTC.

object

{ unitPrice: PriceEntry[], totalPrice: PriceEntry[] }. Ambos são arrays para suportar totais multi-moeda (hoje geralmente uma entrada).Chaves de PriceEntry: currencyCode, grossPrice, netPrice, subtotalBeforeTaxes, discountValue, discounts[], taxesValue, taxes[]. As entradas de tax têm { base, name, rate, amount, metadata }.

object[]

Mesmo formato que price.totalPrice[].

object[]

Grupos de modificadores selecionados. Cada um: { uid, description, selectedModifiers[] }. selectedModifiers[n] se forma recursivamente como uma linha de pedido (price, modifierGroups, itemDescription, …) até alguns níveis.

object

Metadata por linha. Pode conter fiscal: { ncm, cfop, csosn, vTotTrib, fiscalCategoryCode } para classificação fiscal BR, mais redeemed, externalCode, referenceUnitPrice, referenceTotalPrice.

`data.marketing`, `data.metadata`, `data.channel`

object | null

Loyalty + cupons. null na maioria dos países hoje; reservado para uso futuro.

object

Bag free-form para extras a nível de pedido. Frequentemente {}.

object

{ uid, code, metadata }. Exemplos de code: KIOSK, APP, IFOOD, RAPPI.

Dados fiscais

Os dados fiscais são incluídos apenas quando a loja tem emissão fiscal habilitada (store.storeFiscalConfig.enabled === true). Para países sem fiscal ou lojas sem configuração, todas as três localizações abaixo estão ausentes ou em null.

order.completed carrega informação fiscal em três localizações distintas. Cada uma serve um propósito diferente:

1. `data.store.storeFiscalConfig` — identidade do emissor e config do provedor

Identifica a entidade legal que emite o documento e como autenticar com o provedor fiscal. Credenciais NÃO estão aqui intencionalmente — o nó fiscal as busca por provedor/account.

"storeFiscalConfig": {
  "enabled": true,
  "company": {
    "govIdType":   "CNPJ",
    "govIdNumber": "00000000000000",
    "legalName":   "Sandbox LTDA",
    "tradeName":   "Sandbox"
  },
  "govIdType":            "CNPJ",
  "govIdNumber":          "00000000000000",
  "secondaryGovIdType":   "INSCRICAO_ESTADUAL",
  "secondaryGovIdNumber": "000000000000",
  "metadata": {
    "neverstop":    { "url": "", "enabled": false },
    "storeCode3S":  "50000001",
    "serialNumber": 1
  }
}

2. `data.payments.metadata.fiscal` — agregados fiscais a nível de pedido

Totais agregados estilo SEFAZ, prontos para envio ao provedor fiscal (seu provedor fiscal no Brasil). Os valores são strings escaladas ×10.000, igual ao resto do evento.

"metadata": {
  "fiscal": {
    "vBC":      "229000",
    "vNF":      "229000",
    "vICMS":    "9200",
    "vPIS":     "3800",
    "vCOFINS":  "17400",
    "vCBS":     "1100",
    "vIBS":     "100",
    "vIBSUF":   "100",
    "vIBSMun":  "0",
    "vTotTrib": "31600",
    "vBCIBSCBS":"198700",
    "vDesc":    "0",
    "vProd":    "229000"
  }
}

3. `data.orderLines[n].metadata.fiscal` — classificação fiscal por linha

Códigos fiscais por produto. Usados pelo provedor fiscal para classificar cada linha no documento.

"metadata": {
  "fiscal": {
    "ncm":               "21069090",
    "cfop":              "5101",
    "csosn":             "500",
    "vTotTrib":          3.16,
    "fiscalCategoryCode":"2106.90.90"
  }
}

Além disso, metadata por imposto vive dentro de cada taxes[n].metadata (em payments.totals[].taxes[], orderLines[].price.totalPrice[].taxes[] e orderLines[].lineTotals[].taxes[]) com códigos como cst, cBenef, cClassTrib, reducao, rateNominal, rateEffective.

Variações por país

O exemplo acima é de uma loja brasileira — o caso mais complexo. O formato V4 é idêntico em todos os países, incluindo o detalhamento granular de taxes[]: cada país popula payments.totals[].taxes[] e os taxes por linha com seus impostos locais no mesmo formato { base, name, rate, amount, metadata }. O que muda por país:

Nomes de imposto — BR usa ICMS, PIS, COFINS, IBS_UF, IBS_MUN, CBS; outros países carregam seus impostos locais (ex. IVA) com a mesma estrutura.
Códigos de metadata — BR carrega códigos SEFAZ (cst, cBenef, cClassTrib, reducao, rateNominal, rateEffective); outros países seus próprios códigos.
Emissão fiscal SEFAZ — apenas Brasil. payments.metadata.fiscal, orderLines[].metadata.fiscal (ncm/cfop/csosn) e os eventos order.invoiced / order.reversed só aplicam ao BR. Os demais países ainda carregam seu taxes[], mas esses blocos SEFAZ estão ausentes.

As lojas brasileiras com storeFiscalConfig.enabled === true carregam o payload fiscal completo — veja a seção Dados fiscais acima. Marcadores de país:

store.locationInfo.country.code: "BR" · name: "Brasil" · timezone: "America/Sao_Paulo"
store.locationInfo.currencyCode: "BRL"
store.storeFiscalConfig.govIdType: "CNPJ" (14 dígitos)
store.storeFiscalConfig.secondaryGovIdType: "INSCRICAO_ESTADUAL"
payments.totals[].currencyCode: "BRL", paymentMethods[].currencyCode: "BRL", orderLines[].selectedCurrency: "BRL"
Populados: payments.metadata.fiscal (vBC / vNF / vICMS / vPIS / vCOFINS / vTotTrib …), orderLines[].metadata.fiscal (ncm / cfop / csosn), lineTotals[].taxes[] (ICMS, PIS, COFINS, IBS_*)

As lojas argentinas carregam o formato V4 mas sem agregados fiscais hoje (nenhum fiscal.* flow trigger dispara para AR). Sample compacto dos campos específicos do país:

{
  "store": {
    "code": "AR-BUE-001",
    "locationInfo": {
      "city":     { "uid": "<uid>", "code": "<code>", "name": "Buenos Aires" },
      "country":  { "uid": "<uid>", "code": "AR",      "name": "Argentina" },
      "currencyCode": "ARS",
      "timezone": "America/Argentina/Buenos_Aires"
    },
    "storeFiscalConfig": {
      "enabled": true,
      "govIdType": "CUIT",
      "govIdNumber": "30-12345678-9",
      "secondaryGovIdType": null,
      "secondaryGovIdNumber": null,
      "company": {
        "govIdType": "CUIT",
        "govIdNumber": "30-12345678-9",
        "legalName": "Your Company SRL",
        "tradeName": "Your Brand"
      },
      "metadata": {}
    }
  },
  "payments": {
    "totals": [
      {
        "currencyCode": "ARS",
        "total": "100000",
        "subtotal": "82645",
        "taxes": [
          { "base": "82645", "name": "IVA", "rate": "0.21", "amount": "17355" }
        ],
        "taxesValue": "17355",
        "discounts": [],
        "discountValue": "0",
        "subtotalBeforeTaxes": "82645"
      }
    ],
    "metadata": { "fiscal": null }
  },
  "orderLines": [
    {
      "selectedCurrency": "ARS",
      "metadata": { "fiscal": null },
      "lineTotals": [{ "currencyCode": "ARS", "total": "100000", "taxes": [
        { "base": "82645", "name": "IVA", "rate": "0.21", "amount": "17355" }
      ] }]
    }
  ]
}

store.locationInfo.currencyCode está populado (ARS) — igual ao comportamento de BR. Você também pode lê-lo de payments.totals[0].currencyCode ou orderLines[0].selectedCurrency se precisar; todos coincidem.

Mesmo formato que Argentina com RUT como tipo de gov ID e CLP como moeda:

{
  "store": {
    "code": "CL-SCL-001",
    "locationInfo": {
      "country": { "code": "CL", "name": "Chile" },
      "currencyCode": "CLP",
      "timezone": "America/Santiago"
    },
    "storeFiscalConfig": {
      "enabled": true,
      "govIdType": "RUT",
      "govIdNumber": "76123456-7",
      "company": {
        "govIdType": "RUT",
        "govIdNumber": "76123456-7",
        "legalName": "Your Company SpA",
        "tradeName": "Your Brand"
      }
    }
  },
  "payments": {
    "totals": [{ "currencyCode": "CLP", "total": "10000", "taxes": [{ "base": "8403", "name": "IVA", "rate": "0.19", "amount": "1597" }] }],
    "metadata": { "fiscal": null }
  },
  "orderLines": [{ "selectedCurrency": "CLP", "metadata": { "fiscal": null } }]
}

Lojas colombianas com NIT como tipo de gov ID e COP como moeda. Sufixo de razão social tipicamente SAS. Sem agregados fiscais hoje (integração DIAN existe apenas a nível de schema — ver POST /v1/webhooks/fiscal/callback):

{
  "store": {
    "code": "CO-BOG-001",
    "locationInfo": {
      "country": { "code": "CO", "name": "Colombia" },
      "currencyCode": "COP",
      "timezone": "America/Bogota"
    },
    "storeFiscalConfig": {
      "enabled": true,
      "govIdType": "NIT",
      "govIdNumber": "900123456-7",
      "company": {
        "govIdType": "NIT",
        "govIdNumber": "900123456-7",
        "legalName": "Your Company SAS",
        "tradeName": "Your Brand"
      }
    }
  },
  "payments": {
    "totals": [{ "currencyCode": "COP", "total": "10000", "taxes": [{ "base": "8403", "name": "IVA", "rate": "0.19", "amount": "1597" }] }],
    "metadata": { "fiscal": null }
  },
  "orderLines": [{ "selectedCurrency": "COP", "metadata": { "fiscal": null } }]
}

Lojas equatorianas com RUC (13 dígitos) como tipo de gov ID. A moeda é USD (moeda oficial do Equador, sem moeda local). Sufixo de razão social tipicamente Cia. Ltda. ou S.A.:

{
  "store": {
    "code": "EC-UIO-001",
    "locationInfo": {
      "country": { "code": "EC", "name": "Ecuador" },
      "currencyCode": "USD",
      "timezone": "America/Guayaquil"
    },
    "storeFiscalConfig": {
      "enabled": true,
      "govIdType": "RUC",
      "govIdNumber": "1790012345001",
      "company": {
        "govIdType": "RUC",
        "govIdNumber": "1790012345001",
        "legalName": "Your Company Cia. Ltda.",
        "tradeName": "Your Brand"
      }
    }
  },
  "payments": {
    "totals": [{ "currencyCode": "USD", "total": "10000", "taxes": [{ "base": "8696", "name": "IVA", "rate": "0.15", "amount": "1304" }] }],
    "metadata": { "fiscal": null }
  },
  "orderLines": [{ "selectedCurrency": "USD", "metadata": { "fiscal": null } }]
}

Mesmo formato com RIF como tipo de gov ID e VES como moeda:

{
  "store": {
    "code": "VE-CCS-001",
    "locationInfo": {
      "country": { "code": "VE", "name": "Venezuela" },
      "currencyCode": "VES",
      "timezone": "America/Caracas"
    },
    "storeFiscalConfig": {
      "enabled": true,
      "govIdType": "RIF",
      "govIdNumber": "J-12345678-9",
      "company": {
        "govIdType": "RIF",
        "govIdNumber": "J-12345678-9",
        "legalName": "Your Company CA",
        "tradeName": "Your Brand"
      }
    }
  },
  "payments": {
    "totals": [{ "currencyCode": "VES", "total": "1000", "taxes": [{ "base": "862", "name": "IVA", "rate": "0.16", "amount": "138" }] }],
    "metadata": { "fiscal": null }
  },
  "orderLines": [{ "selectedCurrency": "VES", "metadata": { "fiscal": null } }]
}

Tabela de referência rápida

País	`country.code`	Moeda efetiva	`govIdType` (formato)	Agregados fiscais
Brasil	`BR`	`BRL`	`CNPJ` (14 dígitos)	Sim — agregados SEFAZ completos
Argentina	`AR`	`ARS`	`CUIT` (`XX-XXXXXXXX-X`)	Não — `null` / vazio
Chile	`CL`	`CLP`	`RUT` (`XXXXXXXX-X`)	Não
Colombia	`CO`	`COP`	`NIT` (`XXXXXXXXX-X`)	Não
Ecuador	`EC`	`USD` (moeda oficial do Equador)	`RUC` (13 dígitos)	Não
Venezuela	`VE`	`VES`	`RIF` (`J-XXXXXXXX-X`)	Não
Outros países	varia	varia	varia	Não

À medida que mais países tiverem um pipeline fiscal dedicado, seus eventos fiscais chegarão como fiscal.*.{cc} (ex.: fiscal.authorized.co, fiscal.authorized.ec). Até lá, apenas order.completed e order.cancelled disparam para lojas não-BR — os blocos fiscais permanecem null / vazios.

Handler de exemplo

async function onOrderCompleted(data) {
  const {
    orderId,
    externalOrderId,
    store,
    payments,
    orderLines,
    fulfillment,
    createdAt,
  } = data;

  // 1. Persiste para contabilidade / analítica
  await db.orders.upsert({
    where: { fireOrderId: orderId },
    create: {
      fireOrderId: orderId,
      externalOrderId,
      storeCode: store.code,
      country: store.locationInfo.country.code,
      currency: store.locationInfo.currencyCode,
      // payments.totals[0].total é "229000" está escalado ×10.000 → 22,9
      totalMinorUnits: BigInt(payments.totals[0]?.total ?? "0"),
      completedAt: new Date(createdAt ?? Date.now()),
      service: fulfillment.service.code,
    },
    update: {},
  });

  // 2. Se fiscal-enabled, despache para o pipeline fiscal
  if (store.storeFiscalConfig?.enabled) {
    await fiscalPipeline.enqueue({
      orderId,
      country: store.locationInfo.country.code,
      emitter: store.storeFiscalConfig.company,
      aggregates: payments.metadata?.fiscal,
      lines: orderLines.map((l) => ({
        itemId: l.itemId,
        ncm: l.metadata?.fiscal?.ncm,
        cfop: l.metadata?.fiscal?.cfop,
      })),
    });
  }

  // 3. Se delivery, despache para logística
  if (fulfillment.service.code === "DELIVERY" && fulfillment.delivery) {
    await dispatcher.send({
      orderId,
      address: fulfillment.delivery,
      items: orderLines,
    });
  }
}

`data.policy` e `data.lastKnown`

Todos os eventos de pedido carregam estes dois blocos, não só este. Foram adicionados junto com o ciclo de pagamento diferido e são adicionados na v1.1, aditivos: consumidores existentes continuam funcionando sem alteração.

Bloco	O que é	Confiar?
`policy.deferredPayment`	Se o pedido pode ser trabalhado antes do pagamento. Resolvido uma vez na injeção e carimbado imutável — todos os eventos seguintes repetem o mesmo valor.	Sim. É uma decisão, não um estado.
`lastKnown`	Foto orientativa do estado de cozinha (`kds`) e fiscal na emissão do evento. Pode vir `null` ou desatualizado.	Não. Nunca condicione uma ação irreversível a isto.

"policy": { "deferredPayment": { "eligible": true, "resolvedAt": "2026-08-02T15:55:42.407Z",
    "configVersion": "fnv1a:3144c6fb",
    "resolvedFrom": { "channelCode": "APP", "fulfillmentCode": "DELIVERY", "paymentMethod": "CASH" } } },
"lastKnown": { "kds": null, "fiscal": { "status": "processing", "sourceEvent": "fiscal.callback" } }

O detalhe campo a campo está em order.opened, o evento onde estes blocos mais importam.

Erros comuns

Decimais como strings × 10000. payments.totals[0].total === "229000" significa 22.9 BRL. Use uma biblioteca decimal; nunca com parseFloat.
O casing é misto em payments.totals[] e partes de paymentMethods[]. Leia tanto currencyCode quanto currencyCode defensivamente. O builder V4 transforma a maior parte do snapshot mas passa os objetos de payment sem alteração.
fulfillment.delivery pode estar presente mesmo para serviços non-delivery com zeros placeholder. Sempre ramifique em fulfillment.service.code.
client pode ser um placeholder “FINAL_CONSUMER” populado em qualquer país — não é null. Trate govIdType === "FINAL_CONSUMER" como anônimo para analítica.
event.id é o ID de execução do flow, não o ID do pedido. Use event.id para idempotência (muda por entrega), e orderId como chave de negócio.
Routing multi-tenant. Use store.account.uid, store.vendor.uid e store.code para rotear ao tenant correto no seu sistema, mesmo que o Fire já dê escopo ao flow do lado dele.

Eventos relacionados

order.cancelled

Dispara quando este pedido é cancelado depois.

order.invoiced

Apenas Brasil — dispara quando a SEFAZ autoriza o documento fiscal do pedido.

`data.fiscalRepresentation`

A numeração fiscal que o ponto de venda obteve antes de injetar o pedido: cobra, pede os identificadores, imprime o comprovante e só então injeta. Por isso viaja no pedido e não em um evento fiscal separado — quando o pedido nasce, isso já aconteceu.

A presença deste bloco NÃO significa que o comprovante esteja autorizado. São os números impressos no caixa; o veredito do órgão está em lastKnown.fiscal.status. Um ticket que diga “autorizado” só porque o bloco está presente declara algo que pode não ter acontecido.

A chave viaja sempre. Chega em null quando não se tentou numerar — agregadores, países sem representação fiscal, ou comércios com a numeração desativada — e traz o bloco quando houve tentativa. Trazer o bloco significa que se tentou numerar, não que foi numerado: numberingStatus diz como a tentativa terminou, e failure por quê quando não terminou bem. Ramifique pelo valor, não pela presença da chave:

if (data.fiscalRepresentation) {
  // houve tentativa de numeração — veja numberingStatus para saber como saiu
}

Campo	O que é
`numberingStatus`	Como terminou o ato de numerar: `GENERATED`, `PENDING`, `FAILED_RETRYABLE`, `FAILED_FINAL`, `UNAVAILABLE`. Não é o veredito do órgão — esse está em `lastKnown.fiscal.status`.
`documentNumber`	Número visível do comprovante, composto conforme o país (`005-004-000000042`). É apresentação e quem o monta é o Fire, não o órgão: para conciliar use `countryData`.
`issuedAt`	Quando foi numerado. Não é a data de autorização.
`authorizationMode`	`ONLINE`, `OFFLINE` ou `BATCH`. Conceito do provedor, não universal.
`providerCode`	Identificador do adaptador que numerou.
`countryData`	Os identificadores do órgão, no vocabulário do país que numerou — e só os desse país. Equador: `numeroComprobante` (o número visível do comprovante, já montado pelo provedor), `claveAcceso`, `establecimiento`, `puntoEmision`, `secuencial`, `ambiente`. Venezuela: `numeroControl`, `numeroFactura`, `serie`. Percorra-o; não o indexe às cegas — uma chave nova não é uma mudança que quebra. É o mesmo bloco que o endpoint de numeração devolve e que o callback do órgão traz. A referência por país, com as chaves de cada regime, está em `countryData` por país.
`graphic`	O artefato imprimível que o provedor devolveu (QR e afins), tal como veio. `null` se não devolveu nenhum.
`failure`	Por que não há comprovante. `null` quando a numeração deu certo.
`providerIdentity`	Quem numerou, do lado do provedor: `{ "name": "hio.fiscalization", "version": "2026.08.1", "reference": "HIO-91f3c2" }`. Diferente da bolsa abaixo, tem forma: os três campos estão no contrato e sempre chegam, com `null` quando não se aplicam. `reference` é a referência de suporte do provedor — o identificador que se cita a ele para encontrar a operação nos registros dele; não é a `Idempotency-Key` que o canal enviou. Não leva `providerCode`: esse é nosso e viaja acima.
`providerMetadata`	A bolsa de diagnóstico do provedor, tal como ele a devolveu: no Equador com a HIO chega `{ "deviceUid": "4B8E…", "externalStoreCode": "K000" }`. É opaca — as chaves são do provedor e podem mudar sem aviso, então não programe contra elas; serve para colar num ticket, não para ramificar. É exatamente o mesmo campo que o endpoint de numeração devolve, com o mesmo nome e o mesmo conteúdo: os três campos do provedor se leem igual nos dois extremos.
`environment`	Em qual ambiente o Fire numerou: `SANDBOX` ou `PRODUCTION`. É nosso, não do órgão — o do órgão viaja dentro de `countryData` com o código do país.
`compensates`	Qual documento este anula. Presente apenas quando `documentType` é `CREDIT_NOTE`; `null` nos demais. Traz `documentNumber`, `issuedAt` e `reason` (o código canônico — o texto impresso é redigido por empresa e resolvido na resposta do endpoint de numeração).
`history`	Os documentos anteriores do pedido, do mais antigo ao mais novo. Vazio enquanto houve apenas um; quando um cancelamento numera, a nota de venda desce para cá e a nota de crédito fica no topo. Cada entrada tem a mesma forma do bloco acima, então se leem igual. Somente documentos: uma tentativa de numeração que falhou não entra.

"fiscalRepresentation": {
  "numberingStatus": "GENERATED",
  "documentNumber": "005-004-000000042",
  "countryData": {
    "numeroComprobante": "005-004-000000042",
    "claveAcceso": "1208202601000000000000110050040000000421234567810",
    "establecimiento": "005",
    "puntoEmision": "004",
    "secuencial": "000000042",
    "ambiente": "2"
  },
  "authorizationMode": "ONLINE",
  "issuedAt": "2026-08-13T08:11:29.744Z",
  "providerCode": "hio",
  "graphic": { "qr": "1208202601000000000000110050040000000421234567810" },
  "failure": null,
  "providerIdentity": { "name": "hio.fiscalization", "version": "2026.08.1", "reference": "HIO-91f3c2" },
  "providerMetadata": { "deviceUid": "4B8E21F9A0D35C7A", "externalStoreCode": "K004" },
  "environment": "PRODUCTION",
  "compensates": null,
  "history": []
}

O veredicto do órgão não o altera. O que o cliente levou impresso não muda porque o órgão depois autorize ou rejeite — para isso existe lastKnown.fiscal, que é o que de fato se move. O que o substitui é um documento novo. O bloco carrega o documento fiscal vigente do pedido. Enquanto houve apenas um, era sempre a nota de venda; quando um cancelamento produz uma nota de crédito, é ela que fica no topo — documentType diz qual é — e a nota de venda desce para history, inteira e com seus próprios identificadores do órgão. Não se perde: se move. compensates aponta para ela pelo número, então a relação fica explícita.

Quando a numeração falha

Uma venda pode ser cobrada e ficar sem comprovante fiscal. Esse caso também viaja, e precisa ser tratado: os identificadores vêm null e o motivo em failure.

"fiscalRepresentation": {
  "numberingStatus": "FAILED_FINAL",
  "documentNumber": null,
  "issuedAt": null,
  "providerCode": "hio",
  "graphic": null,
  "failure": { "code": "RUC_INVALIDO", "scope": "FUNCTIONAL", "message": "CNPJ não habilitado" }
}

Ramifique por failure.scope:

TECHNICAL — imprima “em trâmite” e siga. Pode se resolver sozinho.
FUNCTIONAL — há um dado errado e repetir não resolve. Precisa correção. O que muda é lastKnown.fiscal.

lastKnown.fiscal.sourceEvent agora informa a procedência real. Antes era deduzida do status, e um processing semeado na injeção era reportado como fiscal.callback sem que nenhum callback tivesse ocorrido. Esse caso agora diz order.injected. Se você ramifica por este campo, contemple o valor novo.

Conceitos

Catálogo

Condição de disparo

O que tem em `trigger.data`

Exemplo — payload real de produção (BR, sanitizado)

Referência de campos

Identificadores top-level

`data.store`

`data.client`

`data.payments`

`data.fulfillment`

`data.kds`

`data.device` e `data.operator`

`data.orderLines`

`data.marketing`, `data.metadata`, `data.channel`

Dados fiscais

1. `data.store.storeFiscalConfig` — identidade do emissor e config do provedor

2. `data.payments.metadata.fiscal` — agregados fiscais a nível de pedido

3. `data.orderLines[n].metadata.fiscal` — classificação fiscal por linha

Variações por país

Tabela de referência rápida

Handler de exemplo

`data.policy` e `data.lastKnown`

Erros comuns

Eventos relacionados

order.cancelled

order.invoiced

`data.fiscalRepresentation`

Quando a numeração falha

​Condição de disparo

​O que tem em trigger.data

​Exemplo — payload real de produção (BR, sanitizado)

​Referência de campos

​Identificadores top-level

​data.store

​data.client

​data.payments

​data.fulfillment

​data.kds

​data.device e data.operator

​data.orderLines

​data.marketing, data.metadata, data.channel

​Dados fiscais

​1. data.store.storeFiscalConfig — identidade do emissor e config do provedor

​2. data.payments.metadata.fiscal — agregados fiscais a nível de pedido

​3. data.orderLines[n].metadata.fiscal — classificação fiscal por linha

​Variações por país

​Tabela de referência rápida

​Handler de exemplo

​data.policy e data.lastKnown

​Erros comuns

​Eventos relacionados

order.cancelled

order.invoiced

​data.fiscalRepresentation

​Quando a numeração falha

Condição de disparo

O que tem em `trigger.data`

Exemplo — payload real de produção (BR, sanitizado)

Referência de campos

Identificadores top-level

`data.store`

`data.client`

`data.payments`

`data.fulfillment`

`data.kds`

`data.device` e `data.operator`

`data.orderLines`

`data.marketing`, `data.metadata`, `data.channel`

Dados fiscais

1. `data.store.storeFiscalConfig` — identidade do emissor e config do provedor

2. `data.payments.metadata.fiscal` — agregados fiscais a nível de pedido

3. `data.orderLines[n].metadata.fiscal` — classificação fiscal por linha

Variações por país

Tabela de referência rápida

Handler de exemplo

`data.policy` e `data.lastKnown`

Erros comuns

Eventos relacionados

`data.fiscalRepresentation`

Quando a numeração falha