product.updated

product.updated is an incremental event. The products in the payload are added or updated in each target downstream system — existing products not included in the payload are left untouched. To remove a product, send a menu.updated event with the full menu excluding that product. When a product change affects multiple stores, Fire emits a single event with all affected stores listed in targets. Your system iterates the targets and applies the same product data to each one.

Payload

{
  "event": {
    "id": "evt_ghi789",
    "type": "product.updated",
    "executionId": "exec_ghi123",
    "createdAt": "2025-01-15T14:32:00.000Z",
    "timezone": "America/Guayaquil"
  },
  "data": {
    "account": "1",
    "country": "EC",
    "groupId": "a3f7c2d1-84be-4e10-9b3a-2c5d6e7f8091",
    "targets": [
      {
        "storeId": "b3d2a1f0-6e21-4c3a-9f5d-7a8b9c0d1e2f",
        "storeName": "Laboratorio Brasil",
        "vendorId": "100.6.1350",
        "timezone": "America/Guayaquil",
        "channels": [
          {
            "channelId": "d5f4c3b2-8043-4e5c-9b7f-9c0d1e2f3a4b",
            "channelReferenceName": "iFood",
            "listName": "Menu App"
          }
        ]
      },
      {
        "storeId": "c4e3b2a1-7f32-4d4b-8a6e-8b9c0d1e2f3a",
        "storeName": "Vila Olimpia",
        "vendorId": "100.6.1351",
        "timezone": "America/Guayaquil",
        "channels": [
          {
            "channelId": "d5f4c3b2-8043-4e5c-9b7f-9c0d1e2f3a4b",
            "channelReferenceName": "iFood",
            "listName": "Menu App"
          }
        ]
      }
    ],
    "products": [
      {
        "productId": "prod_001",
        "name": "Classic Burger",
        "description": "Beef patty, lettuce, tomato, pickles",
        "standardTime": true,
        "featured": false,
        "active": true,
        "type": "PRODUCTO",
        "priceInfo": {
          "pointPrice": 0,
          "price": 1000,
          "referencePrice": 1200,
          "suggestedPrice": 1200
        },
        "taxInfo": [
          { "vatRatePercentage": 12 }
        ],
        "productModifiers": [
          {
            "modifierId": "mod_001",
            "position": 1
          }
        ],
        "schedules": [
          {
            "day": "FRIDAY",
            "startDate": "2025-01-01",
            "endDate": "2025-12-31",
            "startTime": "10:00",
            "endTime": "22:30"
          }
        ],
        "images": [
          {
            "imageCategoryId": "img_prod_001",
            "fileUrl": "https://cdn.example.com/products/classic-burger.jpg"
          }
        ],
        "upselling": ["prod_002"],
        "crossSelling": ["prod_003"],
        "tags": ["bestseller"],
        "additionalInfo": {
          "assignedAt": "2025-01-10T09:15:00Z"
        }
      },
      {
        "productId": "prod_size_small",
        "name": "Small",
        "description": "Small size",
        "standardTime": true,
        "featured": false,
        "active": true,
        "type": "MODIFIER",
        "priceInfo": {
          "pointPrice": 0,
          "price": 0,
          "referencePrice": 0,
          "suggestedPrice": 0
        },
        "taxInfo": [],
        "productModifiers": [],
        "schedules": [],
        "images": [],
        "upselling": [],
        "crossSelling": [],
        "tags": [],
        "additionalInfo": {}
      }
    ],
    "modifierGroups": [
      {
        "modifierId": "mod_001",
        "modifier": "Choose your size",
        "minOptions": 1,
        "maxOptions": 1,
        "type": "RADIO",
        "modifierOptions": [
          {
            "optionId": "opt_001",
            "productId": "prod_size_small",
            "name": "Small",
            "position": 1
          }
        ]
      }
    ],
    "categories": [
      {
        "productCategoryId": "cat_001",
        "name": "Burgers",
        "displayInList": true,
        "featured": false,
        "position": 1,
        "images": [],
        "assignedAt": "2025-01-10T09:15:00Z",
        "productListing": [
          {
            "productId": "prod_001",
            "position": 1
          }
        ],
        "schedules": []
      }
    ]
  }
}

Fields

`data`

Field	Type	Description
`account`	string	Account identifier — required by downstream systems
`country`	string	ISO 3166-1 alpha-2 country code (e.g. `EC`, `BR`, `CO`) — required by downstream systems
`groupId`	string	UUID correlating events from the same publication or sync batch
`targets`	object[]	Stores where the products must be updated
`products`	object[]	Products to add or update
`modifierGroups`	object[]	Modifier groups referenced by the products
`categories`	object[]	Categories affected by the product changes

`data.targets[n]`

Field	Type	Description
`storeId`	string	Internal store UUID (PK `stores.id`) — not the `store_number`
`storeName`	string	Store operational name
`vendorId`	string	Store brand identifier
`timezone`	string	Store IANA timezone (e.g. `America/Guayaquil`)
`channels`	object[]	Sales channels where the products must be updated

`data.targets[n].channels[n]`

Field	Type	Description
`channelId`	string	Internal sales channel UUID (PK `channels.id`) — not the aggregator’s external `channel_id`
`channelReferenceName`	string	Name of the sales channel (e.g. `iFood`, `Rappi`) — not the fulfillment
`listName`	string	Display name of the menu in that store/channel

`data.products[n]`

Field	Type	Description
`productId`	string	Product identifier
`name`	string	Product name
`description`	string	Product description
`standardTime`	boolean	Whether standard preparation time applies
`featured`	boolean	Whether the product is featured
`active`	boolean	Menu visibility; does not reflect stock or operational availability (that travels in `product.availability_changed`)
`type`	string	Item type: `PRODUCTO`, `MODIFIER`, `COMPLEMENT`, or `COMBO`
`priceInfo`	object	Resolved product prices
`priceInfo.pointPrice`	number	Points price
`priceInfo.price`	number	Resolved price (`0` for combos)
`priceInfo.referencePrice`	number	Reference price when applicable in the catalog — for `COMBO` this is the actual value
`priceInfo.suggestedPrice`	number	Suggested price when applicable in the catalog
`taxInfo`	object[]	Tax information — `{ vatRatePercentage }`
`productModifiers`	object[]	Modifier group references — `{ modifierId, position, overrides? }`. `position` is per product (the same group can sit at a different position on another product), and `overrides[]` carries the option’s price for this product on this menu. Same structure as in `menu.updated`
`schedules`	object[]	Time-based availability
`images`	object[]	Product images
`upselling`	string[]	Product IDs suggested as upsells
`crossSelling`	string[]	Product IDs suggested as cross-sells
`tags`	string[]	Product tags
`additionalInfo`	object	Extra metadata
`additionalInfo.assignedAt`	string \| null	Date the product joined the menu, in ISO 8601 UTC. See Menu assignment date

`data.modifierGroups[n]`

Same structure as in menu.updated.

`data.categories[n]`

Same structure as in menu.updated, including assignedAt — the date the category joined the menu, with the same semantics as the product’s. additionalInfo.assignedAt (product) and categories[n].assignedAt (category) indicate when the entity joined the menu — membership data, not edit data. Full semantics, format, and edge cases in menu.updated → Menu assignment date, the canonical reference for the field. It does not travel in product.price_updated or product.availability_changed: those events only carry their delta.

Incremental behavior

Situation	Result
Product in payload, exists downstream	Updated
Product in payload, doesn’t exist downstream	Created
Product not in payload, exists downstream	Left untouched

product.updated never removes products — there’s no way to express “delete” within this event. To remove a product, use menu.updated sending the full menu without it.

Usage

See Product publication for the full handling guide.

Overview

Channel

Store

Menu

Product

Order

Payment methods

Payload

Fields

`data`

`data.targets[n]`

`data.targets[n].channels[n]`

`data.products[n]`

`data.modifierGroups[n]`

`data.categories[n]`

Menu assignment date

Incremental behavior

Usage

​Payload

​Fields

​data

​data.targets[n]

​data.targets[n].channels[n]

​data.products[n]

​data.modifierGroups[n]

​data.categories[n]

​Menu assignment date

​Incremental behavior

​Usage

Payload

Fields

`data`

`data.targets[n]`

`data.targets[n].channels[n]`

`data.products[n]`

`data.modifierGroups[n]`

`data.categories[n]`

Menu assignment date

Incremental behavior

Usage