order.completed

v1.2 · actual
v1.1 · anterior
v1 · deprecado
v0 · deprecado

Estás viendo el contrato actual (v1.2) de order.completed. v1.2 agrega data.fiscalRepresentation: la numeración fiscal que el punto de venta obtuvo antes de inyectar la orden. Viaja siempre: en null cuando no se intentó numerar, y con contenido cuando sí —numberingStatus dice cómo terminó—. Que traiga contenido no significa que el comprobante esté autorizado. Solo aditivo — nada de lo que ya leías cambió.El bloque lleva el documento fiscal vigente de la orden: los campos que significan lo mismo en todo país arriba, los identificadores del ente dentro de countryData con el vocabulario de su país, y los documentos anteriores en history. Cuando una anulación numera, la nota de crédito pasa arriba y la factura baja al histórico — con compensates apuntando a ella.

v1.1 agregó data.policy.deferredPayment (¿esta orden puede trabajarse antes del pago?) y data.lastKnown (estado orientativo de cocina/fiscal), más el evento nuevo order.opened. Sigue siendo válido: v1.2 solo suma un bloque.

El contrato v1 está deprecado — se mantiene como referencia histórica. Abrilo acá: order.completed — v1.

order.completed dispara cuando una orden se inyecta exitosamente y está pagada. Lleva el snapshot V4 de la orden como trigger.data — todos los campos que tu flow necesita para actuar sobre la orden sin volver a llamar a Fire.

Condición de disparo

Fire emite order.completed exactamente una vez por orden, la primera vez que ambos son verdaderos en momento de inyección:

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

Las órdenes que siguen en PENDING de pago, o que fallan el pago, nunca producen order.completed. Las cancelaciones después de completar producen un evento separado order.cancelled — no retraen order.completed.


Cobertura	Global (todos los países, todos los canales)
Llave de idempotencia	`event.id` (= `flow_executions.id`)
Dispara más de una vez	No, salvo en reintentos — usa `event.id` para deduplicar
Orden	No garantizado entre órdenes — ordena por `data.createdAt` si necesitas orden
Reintentos	Hasta 5 intentos con backoff exponencial

Qué hay en `trigger.data`

trigger.data es el snapshot V4 de la orden — el mismo objeto que se persiste en flow_queue.trigger_data y se expone a los templates de tu flow. Las claves top-level, en orden:

Clave	Tipo	Siempre presente
`orderId`	`string` (UUID)	sí
`orderCode`	`string \| null`	sí
`businessDayDate`	`string` (`YYYY-MM-DD`)	sí
`externalOrderId`	`string`	sí
`redeemPoints`	`boolean`	sí
`accumulatePoints`	`boolean`	sí
`discount`	`boolean`	sí
`createdAt`	`string \| null` (ISO 8601 UTC)	sí
`orderComment`	`string` (puede ser `""`)	sí
`paymentStatus`	`string` (siempre `"SUCCEEDED"`)	sí
`status`	`string` (siempre `"COMPLETED"`)	sí
`marketing`	`object \| null`	sí
`store`	`object`	sí
`device`	`object`	sí
`channel`	`object`	sí
`operator`	`object`	sí
`client`	`object \| null`	sí
`payments`	`object`	sí
`kds`	`object`	sí
`metadata`	`object` (a menudo `{}`)	sí
`orderLines`	`object[]`	sí
`fulfillment`	`object`	sí

Ejemplo — payload real de producción (BR, sanitizado)

El ejemplo abajo viene de una fila real de flow_queue.trigger_data (tenant sandbox brasileño, canal KIOSK, servicio dine-in). Los campos PII se reemplazan por placeholders; el resto de los campos y formas son 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": "COMPROBANTE CLIENTE\n---------------------------\nMASTERCARD ****0000\nAPROBADO\nAuth: 952001",
        "receiptMerchant": "COMPROBANTE COMERCIO\n---------------------------\nMASTERCARD ****0000\nAPROBADO\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"
    }
  }
}

Los valores monetarios son strings con el importe entero escalado ×10.000 — cuatro decimales fijos. "229000" es 22,9 BRL, no 229.000. Para leerlo, dividí por 10.000.Es la escala con la que FIRE almacena: evita el drift de punto flotante al sumar impuestos a través de varias integraciones. Parseá con una librería decimal, nunca con parseFloat.La excepción es paymentMethods[].totalBill, que el origen a veces manda como número JSON — manejá los dos casos.

No es la escala de todos los caminos. El request de numeración fiscal lleva los importes sin escalar, tal como se cobraron. Si tomás un importe de este evento para declararlo al ente, dividí primero.

Referencia de campos

Identificadores top-level

string

UUID interno de la orden en Fire. Estable a través de entregas; úsalo junto con event.id para trazabilidad.

string | null

Código corto legible mostrado en recibos y pantallas KDS (p. ej. 95K, OC-br-001). null cuando el canal no asigna uno.

string

Día de negocio al que pertenece esta orden, en YYYY-MM-DD. Calculado en hora local de la tienda, así que una orden hecha a las 01:00 puede pertenecer al día de negocio anterior según el corte de fin de día.

string

El ID de orden tal como lo provee el canal/agregador en la inyección. Úsalo para reconciliar con sistemas upstream (POS, dashboards de agregador).

string | null

Timestamp ISO 8601 UTC de cuándo se hizo la orden originalmente. Distinto de event.createdAt, que es cuándo arrancó la ejecución del flow.

string

Siempre "COMPLETED" para este evento.

string

Siempre "SUCCEEDED" para este evento.

boolean

true si se canjearon puntos de fidelidad en esta orden.

boolean

true si el cliente acumuló puntos de fidelidad.

boolean

true si se aplicó algún descuento.

string

Nota free-text del cliente para toda la orden. Empty string cuando no se setea.

`data.store`

object

Snapshot de la tienda en el momento que se completó la orden.

Mostrar store

string | null

UUID de la tienda en Fire.

string | null

ID de la tienda en tu sistema externo, cuando está mapeado.

string | null

Código de tienda (p. ej. BR-SP-001). Úsalo para limitar flows a tiendas específicas.

string | null

Nombre para mostrar de la tienda.

string | null

Teléfono de la tienda.

string | null

Dirección de la tienda.

object

Contexto geográfico.

Mostrar locationInfo

object

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

object

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

object

{ lat, lon } como strings de grados decimales.

string | null

Zona IANA (p. ej. America/Sao_Paulo).

string | null

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

object

{ uid, name, description, loyaltyPlan } — metadata de la marca.

object

{ uid, name, description } — account top-level dueño de la marca.

object | null

Snapshot de la configuración fiscal de la tienda. Solo se incluye cuando la emisión fiscal está habilitada para la tienda. Ver Datos fiscales abajo.

`data.client`

object | null

Cliente que hizo la orden. null para órdenes de canal totalmente anónimas. Cuando la venta no identifica al comprador —en cualquier país— client viaja poblado con el marcador de consumidor final: govIdType: "FINAL_CONSUMER" y govIdNumber en ceros. No llega traducido a la regla de cada régimen — el NIT genérico de la DIAN, por ejemplo, lo resuelve el proveedor fiscal.

Mostrar client

string | null

ID del cliente desde el proveedor de autenticación.

string | null

Nombre.

string | null

Apellido.

string | null

Correo electrónico.

string | null

Teléfono.

string | null

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

string | null

Número de documento del cliente.

string | null

ID del cliente en sistema externo, cuando está mapeado.

object

Mostrar metadata

string | null

Género del cliente cuando se captura (a menudo "").

string | null

Fecha ISO.

object | null

Solo Brasil. Se popula cuando client.govIdType === "CNPJ". Contiene cep, tipoLogradouro, logradouro, numero, bairro, codigoCidade, descricaoCidade, estado.

object

Overrides de facturación. Todos los campos opcionales; pueden ser empty strings en lugar de null.

`data.payments`

object

Desglose de dinero.

Mostrar payments

object[]

Totales a nivel de orden — usualmente una entrada. Todas las claves son camelCase (total, subtotal, taxesValue, currencyCode, discountValue, subtotalBeforeTaxes, más los arrays taxes[] y discounts[]).Cada entrada tiene: total, subtotal, taxes[], discounts[], taxesValue, currencyCode, discountValue, subtotalBeforeTaxes.Forma de taxes[n]: { base, name, rate, amount, metadata }. Ejemplos de name: ICMS, PIS, COFINS, IBS_UF, IBS_MUN, IBS_FED. metadata lleva códigos fiscales por país (cst, cBenef, cClassTrib, reducao, rateNominal, rateEffective).

object[]

Líneas de costo de envío. Vacío para órdenes en tienda.

object[]

Propinas, fees de empaque y otros add-ons.

object[]

Agregado en v1.

Descuentos a nivel de orden. Cada entrada es un objeto Discount:

Mostrar Discount

string

Orden de aplicación cuando hay varios descuentos.

string

FIXED o PERCENTAGE.

string

Monto del descuento (×10000).

string

Neto antes del descuento (×10000).

string

Monto aplicado (×10000).

string

Neto después del descuento (×10000).

El mismo Discount aparece en payments.totals[].discounts y en orderLines[].price.*[].discounts + lineTotals[].discounts (descuentos por producto).

object[]

Métodos usados para pagar. La mayoría de campos son camelCase (totalBill, currencyCode, transactionId, transactionStatus, paymentMethodCode, …) y el sub-objeto card también es 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 nuevos (todos nullable):

idAuth (string | null) — ID de autorización del procesador de pago (ej. SiTef IdAuth). Distinto de authorizationCode.
receiptCustomer (string | null) — Texto completo del comprobante para el cliente; puede ser multilínea (separado por saltos de línea).
receiptMerchant (string | null) — Texto completo del comprobante para el comercio; puede ser multilínea.
acquirer.cnpj (string | null) — CNPJ (ID fiscal) de la credenciadora de pago. Solo se popula para Brasil; null en otros países.

object

Mostrar metadata

object | null

Totales fiscales agregados. Ver Datos fiscales abajo.

`data.fulfillment`

object

Cómo se entrega la orden.

Mostrar fulfillment

object

{ uid, code, metadata } — code es DELIVERY, TAKEAWAY, PICKUP o DINE_IN.

object | null

Se popula para PICKUP/TAKEAWAY/DINE_IN. Contiene prepDate, pickupDate (ambos ISO 8601 UTC), prepTime, prepTimeUnit, propertyId.

object | null

Se popula para DELIVERY. Campos de dirección más deliveryDate. Nota: el objeto delivery puede estar presente (con valores placeholder como latitude: "0") en servicios non-delivery — ramifica por fulfillment.service.code, no por delivery !== null.

string | null

Agregado en v1.

Código de confirmación de entrega/retiro del agregador (ej. iFood / Rappi). Viene de shippingMethod.delivery.metadata.deliveryConfirmationCode.

`data.kds`

object

Contexto del kitchen display.

Mostrar kds

string

Identificador de buzzer o pager. Empty string cuando no se setea.

string

Email del cliente para copia de factura. Empty string cuando no se captura.

boolean | null

Si la cocina debe imprimir la copia de factura.

string

Espeja el orderCode top-level.

object

Extras KDS específicos del canal.

`data.device` y `data.operator`

object

{ uid, name, platform, metadata.ip } — dispositivo de origen. Los campos pueden ser null para canales no físicos.

object

{ uid, name, session.uid } — staff/cajero que procesó la orden. Todos los campos null para canales self-service (kiosko, web).

`data.orderLines`

object[]

Productos pedidos. Totalmente camelCase (transformado por el builder V4).

Mostrar orderLines[n]

string

UUID de la línea.

string

Hash estable para esta línea — útil para deduplicar si haces fan-out de líneas downstream.

string

Identificador del producto.

string

Clasificación del ítem — uno de PRODUCT, COMBO, MODIFIER, PACKAGING.

Enum completo en v1.

Passthrough; cae a PRODUCT si el canal no envía tipo.

Mostrar valores de itemType

enum

Ítem vendible por sí solo — la línea es el producto.

enum

Contenedor/bundle; sus componentes con precio van en modifierGroups[].selectedModifiers[].

enum

Agregado/opción elegido dentro de un producto/combo.

enum

Línea de empaque (bolsa, caja, vaso), itemizada para fines fiscales/inventario.

string

Nombre para mostrar.

string

String entero (p. ej. "1", "2").

string

ISO 4217 (p. ej. BRL).

string

ISO 8601 UTC.

object

{ unitPrice: PriceEntry[], totalPrice: PriceEntry[] }. Ambos son arrays para soportar totales multi-moneda (hoy usualmente una entrada).Claves de PriceEntry: currencyCode, grossPrice, netPrice, subtotalBeforeTaxes, discountValue, discounts[], taxesValue, taxes[]. Las entradas de tax tienen { base, name, rate, amount, metadata }.

object[]

Misma forma que price.totalPrice[].

object[]

Grupos de modificadores seleccionados. Cada uno: { uid, description, selectedModifiers[] }. selectedModifiers[n] se forma recursivamente como una línea de orden (price, modifierGroups, itemDescription, …) hasta unos pocos niveles.

object

Metadata por línea. Puede contener fiscal: { ncm, cfop, csosn, vTotTrib, fiscalCategoryCode } para clasificación fiscal BR, más redeemed, externalCode, referenceUnitPrice, referenceTotalPrice.

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

object | null

Loyalty + cupones. null en la mayoría de países hoy; reservado para uso futuro.

object

Bag free-form para extras a nivel de orden. A menudo {}.

object

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

Datos fiscales

La data fiscal se incluye solo cuando la tienda tiene emisión fiscal habilitada (store.storeFiscalConfig.enabled === true). Para países sin fiscal o tiendas sin configuración, las tres ubicaciones de abajo están ausentes o en null.

order.completed lleva información fiscal en tres ubicaciones distintas. Cada una sirve un propósito distinto:

1. `data.store.storeFiscalConfig` — identidad del emisor y config del proveedor

Identifica la entidad legal que emite el documento y cómo autenticar con el proveedor fiscal. Las credenciales NO están aquí intencionalmente — el nodo fiscal las obtiene por proveedor/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 fiscales a nivel de orden

Totales agregados estilo SEFAZ, listos para enviar al proveedor fiscal (tu proveedor fiscal en Brasil). Los valores son strings escalados ×10.000, igual que el resto del 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` — clasificación fiscal por línea

Códigos fiscales por producto. Usados por el proveedor fiscal para clasificar cada línea en el documento.

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

Además, metadata por impuesto vive dentro de cada taxes[n].metadata (en payments.totals[].taxes[], orderLines[].price.totalPrice[].taxes[] y orderLines[].lineTotals[].taxes[]) con códigos como cst, cBenef, cClassTrib, reducao, rateNominal, rateEffective.

Variaciones por país

El ejemplo de arriba es de una tienda brasileña — el caso más complejo. La forma del V4 es idéntica en todos los países, incluido el desglose granular de taxes[]: cada país popula payments.totals[].taxes[] y los taxes por línea con sus impuestos locales en la misma forma { base, name, rate, amount, metadata }. Lo que cambia por país:

Nombres de impuesto — BR usa ICMS, PIS, COFINS, IBS_UF, IBS_MUN, CBS; otros países llevan sus impuestos locales (ej. IVA) con la misma estructura.
Códigos de metadata — BR lleva códigos SEFAZ (cst, cBenef, cClassTrib, reducao, rateNominal, rateEffective); otros países sus propios códigos.
Emisión fiscal SEFAZ — solo Brasil. payments.metadata.fiscal, orderLines[].metadata.fiscal (ncm/cfop/csosn) y los eventos order.invoiced / order.reversed solo aplican a BR. Los demás países igual llevan su taxes[], pero estos bloques SEFAZ están ausentes.

Las tiendas brasileñas con storeFiscalConfig.enabled === true llevan el payload fiscal completo — ver la sección Datos fiscales arriba. 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_*)

Las tiendas argentinas llevan la forma V4 pero sin agregados fiscales hoy (no dispara ningún fiscal.* para AR). Sample compacto de los campos específicos del 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 que el comportamiento de BR. También puedes leerlo de payments.totals[0].currencyCode o orderLines[0].selectedCurrency si necesitas; todos coinciden.

Misma forma que Argentina con RUT como tipo de gov ID y CLP como moneda:

{
  "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 } }]
}

Tiendas colombianas con NIT como tipo de gov ID y COP como moneda. Sufijo de razón social típicamente SAS. Sin agregados fiscales hoy (la integración DIAN solo existe a nivel 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 } }]
}

Tiendas ecuatorianas con RUC (13 dígitos) como tipo de gov ID. La moneda es USD (moneda oficial de Ecuador, no hay tender local). Sufijo de razón social típicamente Cia. Ltda. o 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 } }]
}

Misma forma con RIF como tipo de gov ID y VES como moneda:

{
  "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 } }]
}

Tabla de referencia rápida

País	`country.code`	Moneda efectiva	`govIdType` (formato)	Agregados fiscales
Brasil	`BR`	`BRL`	`CNPJ` (14 dígitos)	Sí — agregados SEFAZ completos
Argentina	`AR`	`ARS`	`CUIT` (`XX-XXXXXXXX-X`)	No — `null` / vacío
Chile	`CL`	`CLP`	`RUT` (`XXXXXXXX-X`)	No
Colombia	`CO`	`COP`	`NIT` (`XXXXXXXXX-X`)	No
Ecuador	`EC`	`USD` (moneda oficial de Ecuador)	`RUC` (13 dígitos)	No
Venezuela	`VE`	`VES`	`RIF` (`J-XXXXXXXX-X`)	No
Otros países	varía	varía	varía	No

A medida que más países tengan un pipeline fiscal dedicado, sus eventos fiscales llegarán como fiscal.*.{cc} (p. ej. fiscal.authorized.co, fiscal.authorized.ec). Hasta entonces, solo order.completed y order.cancelled disparan para tiendas no-BR — los bloques fiscales se quedan en null / vacíos.

Handler de ejemplo

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

  // 1. Persiste para contabilidad / 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 es "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. Si fiscal-enabled, despacha al 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. Si delivery, despacha a logística
  if (fulfillment.service.code === "DELIVERY" && fulfillment.delivery) {
    await dispatcher.send({
      orderId,
      address: fulfillment.delivery,
      items: orderLines,
    });
  }
}

`data.policy` y `data.lastKnown`

Todos los eventos de orden llevan estos dos bloques, no solo este. Se agregaron junto con el ciclo de pago diferido y son agregados en v1.1, aditivos: los consumidores existentes siguen funcionando sin cambios.

Bloque	Qué es	¿Confiar?
`policy.deferredPayment`	Si la orden puede trabajarse antes del pago. Se resuelve una vez al inyectar y se estampa inmutable — todos los eventos posteriores repiten el mismo valor.	Sí. Es una decisión, no un estado.
`lastKnown`	Foto orientativa del estado de cocina (`kds`) y fiscal al emitir el evento. Puede venir `null` o viejo.	No. Nunca condiciones una acción irreversible a esto.

"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" } }

El detalle campo por campo está en order.opened, el evento donde estos bloques más importan.

Errores comunes

Decimales como strings × 10000. payments.totals[0].total === "229000" significa 22.9 BRL. Usa una librería decimal; nunca con parseFloat.
El casing es mixto en payments.totals[] y partes de paymentMethods[]. Lee tanto currencyCode como currencyCode defensivamente. El builder V4 transforma la mayor parte del snapshot pero pasa los objetos de payment sin cambios.
fulfillment.delivery puede estar presente incluso para servicios non-delivery con ceros placeholder. Ramifica siempre por fulfillment.service.code.
client puede ser un placeholder “FINAL_CONSUMER” populado en BR — no es null. Trata govIdType === "FINAL_CONSUMER" como anónimo para analítica.
event.id es el ID de ejecución del flow, no el ID de la orden. Usa event.id para idempotencia (cambia por entrega), y orderId como llave de negocio.
Routing multi-tenant. Usa store.account.uid, store.vendor.uid y store.code para enrutar al tenant correcto en tu sistema, aunque Fire ya da scope al flow de su lado.

Eventos relacionados

order.cancelled

Dispara cuando esta orden se cancela después.

order.invoiced

Solo Brasil — dispara cuando SEFAZ autoriza el documento fiscal de la orden.

`data.fiscalRepresentation`

La numeración fiscal que el punto de venta obtuvo antes de inyectar la orden: cobra, pide los identificadores, imprime el comprobante y recién después inyecta. Por eso viaja en la orden y no en un evento fiscal aparte — cuando la orden nace, esto ya ocurrió.

Que este bloque exista NO significa que el comprobante esté autorizado. Son los números que se imprimieron en la caja; el veredicto del ente lo da lastKnown.fiscal.status. Un ticket que diga “autorizado” solo porque el bloque está presente declara algo que puede no haber pasado.

La clave viaja siempre. Llega en null cuando no se intentó numerar —agregadores, países sin representación fiscal, o comercios con la numeración desactivada— y con el bloque cuando sí se intentó. Que traiga bloque significa que se intentó numerar, no que se numeró: numberingStatus dice cómo terminó el intento, y failure por qué cuando no terminó bien. Ramificá por valor, no por presencia de la clave:

if (data.fiscalRepresentation) {
  // se intentó numerar — mirá numberingStatus para saber cómo salió
}

Campo	Qué es
`numberingStatus`	Cómo terminó el acto de numerar: `GENERATED`, `PENDING`, `FAILED_RETRYABLE`, `FAILED_FINAL`, `UNAVAILABLE`. No es el veredicto del ente — ese está en `lastKnown.fiscal.status`.
`documentNumber`	Número visible del comprobante, compuesto según el país (`005-004-000000042`). Es presentación y lo arma Fire, no el ente: para conciliar usá `countryData`.
`issuedAt`	Cuándo se numeró. No es la fecha de autorización.
`authorizationMode`	`ONLINE`, `OFFLINE` o `BATCH`. Concepto del proveedor, no universal.
`providerCode`	Identificador del adaptador que numeró.
`countryData`	Los identificadores del ente, con el vocabulario del país que numeró y solo los de ese país. Ecuador: `numeroComprobante` (el número visible del comprobante, ya armado por el proveedor), `claveAcceso`, `establecimiento`, `puntoEmision`, `secuencial`, `ambiente`. Venezuela: `numeroControl`, `numeroFactura`, `serie`. Recorrelo; no lo indexes a ciegas — que aparezca una clave nueva no es un cambio que rompa. Es el mismo bloque que devuelve el endpoint de numeración y que trae el callback del ente. La referencia por país, con las claves de cada régimen, está en `countryData` por país.
`graphic`	El artefacto imprimible que entregó el proveedor (QR y demás), tal cual vino. `null` si no entregó ninguno.
`failure`	Por qué no hay comprobante. `null` cuando la numeración salió bien.
`providerIdentity`	Quién numeró, del lado del proveedor: `{ "name": "hio.fiscalization", "version": "2026.08.1", "reference": "HIO-91f3c2" }`. A diferencia de la bolsa de abajo, tiene forma: los tres campos están en el contrato y siempre vienen, con `null` cuando no aplica. `reference` es la referencia de soporte del proveedor — el identificador que se le cita a él para que encuentre la operación en sus registros; no es la `Idempotency-Key` que mandó el canal. No lleva `providerCode`: ese es nuestro y viaja arriba.
`providerMetadata`	La bolsa de diagnóstico del proveedor, tal como la devolvió: en Ecuador con HIO llega `{ "deviceUid": "4B8E…", "externalStoreCode": "K000" }`. Es opaca — las claves las pone el proveedor y pueden cambiar sin aviso, así que no programes contra ellas; sirve para pegar en un ticket, no para ramificar. Es exactamente el mismo campo que devuelve el endpoint de numeración, con el mismo nombre y el mismo contenido: los tres campos del proveedor se leen igual en los dos extremos.
`environment`	En qué ambiente numeró Fire: `SANDBOX` o `PRODUCTION`. Es nuestro, no del ente — el del ente viaja dentro de `countryData` con el código del país.
`compensates`	A qué documento anula este. Presente solo cuando `documentType` es `CREDIT_NOTE`. Es un puntero, no una copia: buscá su `documentNumber` en `history` si querés el documento entero. `reason` es el código canónico — el texto impreso lo redacta cada empresa y se resuelve en la respuesta del endpoint de numeración.
`history`	Los documentos anteriores de la orden, del más viejo al más nuevo. Vacío mientras hubo uno solo; cuando una anulación numera, la factura baja acá y la nota queda arriba. Cada entrada tiene la misma forma que el bloque de arriba, así que se leen igual. Solo documentos: un intento que falló no 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": []
}

El veredicto del ente no lo altera. Lo que el cliente se llevó impreso no cambia porque el organismo después autorice o rechace; para eso está lastKnown.fiscal, que es lo que sí se mueve. Lo que sí lo reemplaza es un documento nuevo. El bloque lleva el documento fiscal vigente de la orden. Mientras solo hubo uno, era siempre la factura; cuando una anulación produce una nota de crédito, arriba queda la nota — documentType dice cuál es— y la factura baja a history, entera y con sus propios identificadores del ente. No se pierde: se mueve. compensates apunta a ella por su número, así que la relación entre los dos queda explícita.

Cuando la numeración falla

Una venta puede cobrarse y quedarse sin comprobante fiscal. Ese caso también viaja, y hay que contemplarlo: los identificadores vienen en null y el motivo en failure.

"fiscalRepresentation": {
  "numberingStatus": "FAILED_FINAL",
  "documentNumber": null,
  "issuedAt": null,
  "providerCode": "hio",
  "graphic": null,
  "failure": { "code": "RUC_INVALIDO", "scope": "FUNCTIONAL", "message": "RUC no habilitado" }
}

Ramificá por failure.scope:

TECHNICAL — imprimí “en trámite” y seguí. Puede resolverse solo.
FUNCTIONAL — hay un dato mal y reintentar no lo arregla. Requiere corrección.

lastKnown.fiscal.sourceEvent ahora informa la procedencia real. Antes se deducía del estado, y un processing sembrado al inyectar se reportaba como fiscal.callback sin que ningún callback hubiera ocurrido. Ahora ese caso dice order.injected. Si ramificás por este campo, contemplá el valor nuevo.

Conceptos

Catálogo

Condición de disparo

Qué hay en `trigger.data`

Ejemplo — payload real de producción (BR, sanitizado)

Referencia de campos

Identificadores top-level

`data.store`

`data.client`

`data.payments`

`data.fulfillment`

`data.kds`

`data.device` y `data.operator`

`data.orderLines`

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

Datos fiscales

1. `data.store.storeFiscalConfig` — identidad del emisor y config del proveedor

2. `data.payments.metadata.fiscal` — agregados fiscales a nivel de orden

3. `data.orderLines[n].metadata.fiscal` — clasificación fiscal por línea

Variaciones por país

Tabla de referencia rápida

Handler de ejemplo

`data.policy` y `data.lastKnown`

Errores comunes

Eventos relacionados

order.cancelled

order.invoiced

`data.fiscalRepresentation`

Cuando la numeración falla

​Condición de disparo

​Qué hay en trigger.data

​Ejemplo — payload real de producción (BR, sanitizado)

​Referencia de campos

​Identificadores top-level

​data.store

​data.client

​data.payments

​data.fulfillment

​data.kds

​data.device y data.operator

​data.orderLines

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

​Datos fiscales

​1. data.store.storeFiscalConfig — identidad del emisor y config del proveedor

​2. data.payments.metadata.fiscal — agregados fiscales a nivel de orden

​3. data.orderLines[n].metadata.fiscal — clasificación fiscal por línea

​Variaciones por país

​Tabla de referencia rápida

​Handler de ejemplo

​data.policy y data.lastKnown

​Errores comunes

​Eventos relacionados

order.cancelled

order.invoiced

​data.fiscalRepresentation

​Cuando la numeración falla

Condición de disparo

Qué hay en `trigger.data`

Ejemplo — payload real de producción (BR, sanitizado)

Referencia de campos

Identificadores top-level

`data.store`

`data.client`

`data.payments`

`data.fulfillment`

`data.kds`

`data.device` y `data.operator`

`data.orderLines`

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

Datos fiscales

1. `data.store.storeFiscalConfig` — identidad del emisor y config del proveedor

2. `data.payments.metadata.fiscal` — agregados fiscales a nivel de orden

3. `data.orderLines[n].metadata.fiscal` — clasificación fiscal por línea

Variaciones por país

Tabla de referencia rápida

Handler de ejemplo

`data.policy` y `data.lastKnown`

Errores comunes

Eventos relacionados

`data.fiscalRepresentation`

Cuando la numeración falla