order.completed

Deprecado (v0). Contrato anterior, se mantiene solo como referencia histórica. La versión actual es order.completed — v1.1.

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" } }
        ],
        "total": "229000",
        "subtotal": "197400",
        "discounts": [],
        "taxes_value": "31600",
        "currency_code": "BRL",
        "discount_value": "0",
        "subtotal_before_taxes": "197400"
      }
    ],
    "shippingCost": [],
    "extraCharges": [],
    "discounts": [],
    "paymentMethods": [
      {
        "mid": "",
        "tid": "",
        "processor": "CREDIT_CARD",
        "card": {
          "bin": "MASTERCARD",
          "mask": "",
          "brand": "MASTERCARD",
          "holder": "",
          "card_country": "",
          "last_four_digits": "0000"
        },
        "acquirer": { "code": "00000000000000", "name": "ACQUIRER NAME" },
        "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"
      }
    ],
    "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": "PRODUCT",
      "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": [],
            "discountValue": "0",
            "taxesValue": "0",
            "subtotalBeforeTaxes": "229000"
          }
        ],
        "totalPrice": [
          {
            "taxes": [
              { "base": "229000", "name": "ICMS",   "rate": "0.04",   "amount": "9200",
                "metadata": { "cst": "90", "cBenef": "SP040100" } }
            ],
            "netPrice": "197400",
            "grossPrice": "229000",
            "currencyCode": "BRL",
            "discounts": [],
            "discountValue": "0",
            "taxesValue": "31600",
            "subtotalBeforeTaxes": "197400"
          }
        ]
      },
      "lineTotals": [ /* misma forma que price.totalPrice[n] */ ],
      "modifierGroups": [
        {
          "uid": "e247256ad628b0fd9c45453370e247fef1ad173829cc809c9c6930698d62e56b",
          "description": "Selecione: Escolha seus sanduíches!",
          "selectedModifiers": [
            {
              "itemId": "0104fdb2010be9ac14750a950f81c026b35a49a3c32b36281f41ef650d278b72",
              "itemType": "PRODUCT",
              "itemDescription": "CRUNCH SALAD",
              "quantity": "1",
              "selectedCurrency": "BRL",
              "price": { /* arrays unitPrice / totalPrice — misma forma */ },
              "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": ""
    }
  }
}

Los valores monetarios son strings con el importe entero escalado ×10.000 ("229000" son 22,9 BRL, no 229.000). Esto evita drift de punto flotante a través de múltiples integraciones. Parsea con una librería decimal, nunca con parseFloat. La excepción es paymentMethods[].totalBill, que el origen a veces envía como número JSON — maneja ambos.

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.

Show 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.

Show 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. Para órdenes BR de “consumidor final”, client se popula con valores placeholder (govIdType: "FINAL_CONSUMER", govIdNumber: "00000000000").

Show 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

Show 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.

Show payments

object[]

Totales a nivel de orden — usualmente una entrada. Aviso de casing: estos objetos son pass-through del origen. Las claves top-level mezclan camelCase (taxes, discounts) y snake_case (taxes_value, currency_code, discount_value, subtotal_before_taxes). Construye tu handler para leer ambos.Cada entrada tiene: total, subtotal, taxes[], discounts[], taxes_value, currency_code, discount_value, subtotal_before_taxes.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[]

Entradas de descuento por producto o por recompensa.

object[]

Métodos usados para pagar. La mayoría de campos son camelCase (totalBill, currencyCode, transactionId, transactionStatus, paymentMethodCode, …) pero algunos sub-objetos son pass-through con snake_case (card.last_four_digits, card.card_country).Cada entrada: processor, currencyCode, paymentMethodCode, transactionType, transactionId, transactionStatus, exactPayment, totalBill, acquirer, card, transactionDate, metadata, mid, tid, voucher, referenceNumber, authorizationCode, customerCashAmount.

object

Show metadata

object | null

Totales fiscales agregados. Ver Datos fiscales abajo.

`data.fulfillment`

object

Cómo se entrega la orden.

Show 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.

`data.kds`

object

Contexto del kitchen display.

Show 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).

Show 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

PRODUCT, MODIFIER, etc.

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 × 10000.

"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 con emisión fiscal habilitada — el caso más complejo. La forma del V4 es idéntica para todos los países; lo que cambia es cuánta data fiscal está populada. Hoy solo Brasil lleva los agregados por impuesto / por línea (payments.metadata.fiscal, orderLines[n].metadata.fiscal, lineTotals[n].taxes[]). Otros países tienen esos bloques presentes pero null / vacíos.

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[].currency_code: "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": null, "code": null, "name": "Buenos Aires" },
      "country":  { "uid": null, "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": [
      {
        "currency_code": "ARS",
        "total": "100000",
        "subtotal": "100000",
        "taxes": [],
        "taxes_value": "0",
        "discounts": [],
        "discount_value": "0",
        "subtotal_before_taxes": "100000"
      }
    ],
    "metadata": { "fiscal": null }
  },
  "orderLines": [
    {
      "selectedCurrency": "ARS",
      "metadata": { "fiscal": null },
      "lineTotals": [{ "currencyCode": "ARS", "total": "100000", "taxes": [] }]
    }
  ]
}

store.locationInfo.currencyCode está populado (ARS) — igual que el comportamiento de BR. También puedes leerlo de payments.totals[0].currency_code 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": [{ "currency_code": "CLP", "total": "10000", "taxes": [] }],
    "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": [{ "currency_code": "COP", "total": "10000", "taxes": [] }],
    "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": [{ "currency_code": "USD", "total": "10000", "taxes": [] }],
    "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": [{ "currency_code": "VES", "total": "1000", "taxes": [] }],
    "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,
    });
  }
}

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 currency_code 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.

Get started

Configuration

Working with events

Guides

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

Errores comunes

Eventos relacionados

order.cancelled

order.invoiced

​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

​Errores comunes

​Eventos relacionados

order.cancelled

order.invoiced

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

Errores comunes

Eventos relacionados