menu.updated v2

Um menu no Fire é a definição completa do catálogo para uma combinação específica de loja e canal — incluindo categorias, produtos, grupos de modificadores e horários. O payload é autocontido e pronto para ser encaminhado a sistemas externos. Trate-o como um upsert: crie o menu se não existir ou substitua-o inteiramente se já existir.

Payload

{
  "event": {
    "id": "evt_def456",
    "type": "menu.updated",
    "executionId": "exec_abc123",
    "createdAt": "2025-01-15T14:31:00.000Z"
  },
  "data": {
    "account": "1",
    "country": "EC",
    "groupId": "a3f7c2d1-84be-4e10-9b3a-2c5d6e7f8091",
    "menu": {
      "list": {
        "listId": "805-iFood-delivery",
        "listName": "iFood - Store 805",
        "vendorId": "100.6.1350",
        "stores": [
          {
            "storeId": "b3d2a1f0-6e21-4c3a-9f5d-7a8b9c0d1e2f",
            "storeName": "Laboratorio Brasil",
            "timezone": "America/Sao_Paulo",
            "channels": [
              {
                "channelId": "0E049503-85CF-E511-80C6-000D3A3261F3",
                "channelReferenceName": "iFood",
                "schedules": [
                  { "day": "MONDAY",    "startTime": "07:00", "endTime": "23:00" },
                  { "day": "TUESDAY",   "startTime": "07:00", "endTime": "23:00" },
                  { "day": "WEDNESDAY", "startTime": "07:00", "endTime": "23:00" },
                  { "day": "THURSDAY",  "startTime": "07:00", "endTime": "23:00" },
                  { "day": "FRIDAY",    "startTime": "07:00", "endTime": "23:30" },
                  { "day": "SATURDAY",  "startTime": "08:00", "endTime": "23:30" },
                  { "day": "SUNDAY",    "startTime": "08:00", "endTime": "22:00" }
                ]
              }
            ]
          },
          {
            "storeId": "c4e3b2a1-7f32-4d4b-8a6e-8b9c0d1e2f3a",
            "storeName": "Vila Olimpia",
            "timezone": "America/Sao_Paulo",
            "channels": [
              {
                "channelId": "0E049503-85CF-E511-80C6-000D3A3261F3",
                "channelReferenceName": "iFood",
                "schedules": []
              }
            ]
          }
        ]
      },
      "categories": [
        {
          "productCategoryId": "cat_001",
          "name": "Hambúrgueres",
          "displayInList": true,
          "featured": false,
          "position": 1,
          "images": [
            {
              "imageCategoryId": "img_cat_001",
              "fileUrl": "https://cdn.example.com/categories/burgers.jpg"
            }
          ],
          "assignedAt": "2025-01-10T09:15:00Z",
          "productListing": [
            { "productId": "prod_001", "position": 1 }
          ],
          "schedules": [
            { "day": "MONDAY",    "startTime": "11:00", "endTime": "23:00" },
            { "day": "TUESDAY",   "startTime": "11:00", "endTime": "23:00" },
            { "day": "WEDNESDAY", "startTime": "11:00", "endTime": "23:00" },
            { "day": "THURSDAY",  "startTime": "11:00", "endTime": "23:00" },
            { "day": "FRIDAY",    "startTime": "11:00", "endTime": "23:30" },
            { "day": "SATURDAY",  "startTime": "11:00", "endTime": "23:30" },
            { "day": "SUNDAY",    "startTime": "11:00", "endTime": "22:00" }
          ]
        },
        {
          "productCategoryId": "cat_002",
          "name": "Café da Manhã",
          "displayInList": true,
          "featured": false,
          "position": 2,
          "images": [],
          "assignedAt": "2025-02-03T16:40:00Z",
          "productListing": [
            { "productId": "prod_002", "position": 1 }
          ],
          "schedules": null
        }
      ],
      "products": [
        {
          "productId": "prod_001",
          "name": "X-Burguer Clássico",
          "description": "Hambúrguer bovino, alface, tomate, picles",
          "active": true,
          "type": "PRODUCTO",
          "priceInfo": {
            "pointPrice": 0,
            "price": 1000,
            "referencePrice": 1200,
            "suggestedPrice": 1200
          },
          "productModifiers": [
            {
              "modifierId": "mod_001",
              "position": 1,
              "overrides": [
                {
                  "productId": "prod_size_small",
                  "priceInfo": { "price": 800 }
                }
              ]
            }
          ],
          "schedules": [
            { "day": "MONDAY",    "startTime": "11:00", "endTime": "23:00" },
            { "day": "TUESDAY",   "startTime": "11:00", "endTime": "23:00" },
            { "day": "WEDNESDAY", "startTime": "11:00", "endTime": "23:00" },
            { "day": "THURSDAY",  "startTime": "11:00", "endTime": "23:00" },
            { "day": "FRIDAY",    "startTime": "11:00", "endTime": "23:30" },
            { "day": "SATURDAY",  "startTime": "11:00", "endTime": "23:30" },
            { "day": "SUNDAY",    "startTime": "11:00", "endTime": "22:00" }
          ],
          "images": [
            {
              "imageCategoryId": "img_prod_001",
              "fileUrl": "https://cdn.example.com/products/classic-burger.jpg"
            }
          ],
          "taxInfo": [
            { "vatRatePercentage": 12 }
          ],
          "additionalInfo": {
            "externalCode": "11019#23211#231",
            "ncm": "21.00.21.32",
            "assignedAt": "2025-01-10T09:15:00Z"
          }
        },
        {
          "productId": "prod_002",
          "name": "Panquecas",
          "description": "Panquecas fofas com calda de bordo",
          "active": true,
          "type": "PRODUCTO",
          "priceInfo": {
            "pointPrice": 0,
            "price": 800,
            "referencePrice": 800,
            "suggestedPrice": 800
          },
          "productModifiers": [],
          "schedules": null,
          "images": [],
          "taxInfo": [
            { "vatRatePercentage": 12 }
          ],
          "additionalInfo": {
            "externalCode": "11019",
            "ncm": "19.05.90.90",
            "assignedAt": "2025-02-03T16:40:00Z"
          }
        },
        {
          "productId": "prod_size_small",
          "name": "Pequeno",
          "description": "Tamanho pequeno",
          "active": true,
          "type": "MODIFIER",
          "priceInfo": {
            "pointPrice": 0,
            "price": 0,
            "referencePrice": 0,
            "suggestedPrice": 0
          },
          "productModifiers": [],
          "schedules": null,
          "images": [],
          "additionalInfo": {
            "externalCode": "11020",
            "ncm": "21.00.21.32"
          }
        },
        {
          "productId": "prod_size_large",
          "name": "Grande",
          "description": "Tamanho grande",
          "active": true,
          "type": "MODIFIER",
          "priceInfo": {
            "pointPrice": 0,
            "price": 200,
            "referencePrice": 200,
            "suggestedPrice": 200
          },
          "productModifiers": [],
          "schedules": null,
          "images": [],
          "additionalInfo": {
            "externalCode": "11021",
            "ncm": "21.00.21.32"
          }
        }
      ],
      "modifierGroups": [
        {
          "modifierId": "mod_001",
          "modifier": "Escolha o tamanho",
          "minOptions": 1,
          "maxOptions": 1,
          "type": "RADIO",
          "modifierOptions": [
            { "optionId": "opt_001", "productId": "prod_size_small", "name": "Pequeno", "position": 1 },
            { "optionId": "opt_002", "productId": "prod_size_large", "name": "Grande", "position": 2 }
          ]
        }
      ]
    }
  }
}

Campos

`data`

Campo	Tipo	Descrição
`account`	string	Identificador da conta
`country`	string	Código do país ISO 3166-1 alpha-2 (ex.: `EC`, `BR`, `CO`) — necessário para sistemas externos
`groupId`	string	UUID que correlaciona eventos do mesmo batch de publicação ou sincronização. Vários eventos `menu.updated` emitidos juntos compartilham o mesmo `groupId`.
`menu`	object	Definição completa do menu

Campo	Tipo	Descrição
`list`	object	Metadados do menu e associação canal/loja
`categories`	object[]	Categorias do menu
`products`	object[]	Catálogo de produtos
`modifierGroups`	object[]	Grupos de modificadores e opções

Campo	Tipo	Descrição
`listId`	string	Identificador composto: `{storeNumber}-{channelCode}-{fulfillmentType}`
`listName`	string	Rótulo autogerado `{channelCode} - Store {storeNumber}` (ex.: `"iFood - Store 805"`). Não é o nome do menu nem o nome operacional da loja. O nome do menu viaja em `channels[n].listName` de `product.price_updated`
`vendorId`	string \| number	Código da marca
`stores`	object[]	Lojas às quais este menu se aplica

Campo	Tipo	Descrição
`storeId`	string	UUID interno da loja (PK `stores.id`) — não é o `store_number`. Mesma convenção que `targets[n].storeId` de `product.price_updated` e `product.availability_changed`. O `store_number` só aparece dentro de `list.listId` e como fallback de `storeName`
`storeName`	string	Nome operacional da loja. Fallback: `"Store #{store_number}"`
`timezone`	string \| null	Fuso horário IANA da loja (ex.: `America/Sao_Paulo`). `null` se não configurado
`channels`	object[]	Canais de vendas nos quais esta loja é publicada

Campo	Tipo	Descrição
`channelId`	string	UUID interno do canal de vendas (PK `channels.id`) — não é o `channel_id` externo do agregador. Mesma convenção que `targets[n].channels[n].channelId` dos eventos de produto
`channelReferenceName`	string	Nome de referência do fulfillment (ex.: `delivery`, `pickup`) — não do canal de vendas. ⚠️ Não forma par com `channelId`, que é do canal de vendas: nos eventos de produto (`targets[n].channels[n]`) `channelReferenceName` é o canal (`iFood`, `Rappi`)
`schedules`	object[]	Janelas de tempo em que este canal está ativo para esta loja. Um array vazio (`[]`) indica que o canal opera 24 horas.

Campo	Tipo	Descrição
`day`	string	Dia da semana: `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY`, `SUNDAY`
`startTime`	string	Horário de abertura no formato `HH:mm`
`endTime`	string	Horário de fechamento no formato `HH:mm`

Campo	Tipo	Descrição
`productCategoryId`	string	Identificador da categoria
`name`	string	Nome de exibição
`displayInList`	boolean	Se a categoria está visível
`featured`	boolean	Se a categoria está em destaque
`position`	number	Ordem de exibição
`images`	object[]	Imagens da categoria — `{ imageCategoryId, fileUrl }`
`assignedAt`	string \| null	Data em que a categoria entrou no menu, em ISO 8601 UTC. Ver Data de atribuição ao menu
`productListing`	object[]	Produtos desta categoria com suas posições — `{ productId, position }`
`schedules`	object[] \| null	Horário próprio da categoria. Sempre presente; `null` se não houver horário configurado

Campo	Tipo	Descrição
`productId`	string \| number	Identificador do produto (`externalId` ou UUID)
`name`	string	Nome do produto
`description`	string	Descrição do produto
`active`	boolean	Visibilidade no menu (`visible`); não reflete estoque nem disponibilidade operacional
`type`	string	Tipo de item: `PRODUCTO`, `MODIFIER`, `COMPLEMENT`, `COMBO`
`priceInfo`	object	Preços resolvidos do produto
`priceInfo.pointPrice`	number	Preço em pontos
`priceInfo.price`	number	Preço resolvido (`resolved_price` / `final_price`; `0` para combos)
`priceInfo.referencePrice`	number	Preço de referência quando aplicável no catálogo
`priceInfo.suggestedPrice`	number	Preço sugerido quando aplicável no catálogo
`productModifiers`	object[]	Referências de grupos de modificadores — `{ modifierId, position, overrides? }`
`schedules`	object[] \| null	Horário customizado do produto. Sempre presente em todos os itens de `products[]` (incl. stubs de opções modifier); `null` se usa horário da loja ou não tem horário customizado
`images`	object[]	Imagens do produto
`taxInfo`	object[]	Informação fiscal — `{ vatRatePercentage }`
`upselling`	string	Produto sugerido para upselling (opcional)
`additionalInfo`	object	Metadados extras opcionais do produto
`additionalInfo.externalCode`	string	Código externo que identifica o produto em um sistema de terceiros. Pode ser um código simples (ex.: `11019`) ou uma chave composta com `#` como separador (ex.: `11019#23211#231`).
`additionalInfo.ncm`	string	Código de classificação fiscal NCM (Nomenclatura Comum do Mercosul, ex.: `21.00.21.32`).
`additionalInfo.assignedAt`	string \| null	Data em que o produto entrou no menu, em ISO 8601 UTC. Ausente nos itens que só existem como opção de um grupo de modificadores. Ver Data de atribuição ao menu

Campo	Tipo	Descrição
`productId`	string	Opção do modificador à qual este override se aplica
`priceInfo`	object	Override de preço para esta opção específica neste produto e menu
`priceInfo.price`	number	Único campo. O override é um preço pontual e contextual: os demais preços da opção (referência, sugerido, pontos) não têm valor próprio dentro de um produto específico — são lidos da opção como produto em `products[]`

Campo	Tipo	Descrição
`modifierId`	string	Identificador do grupo de modificadores
`modifier`	string	Nome de exibição do grupo
`minOptions`	number	Número mínimo de seleções obrigatórias
`maxOptions`	number	Número máximo de seleções permitidas
`type`	string	Tipo de seleção: `RADIO` (single) ou `CHECKBOX` (multiple)
`modifierOptions`	object[]	Opções individuais do grupo — cada `productId` deve existir em `products`

Campo	Tipo	Descrição
`optionId`	string	Identificador da opção
`productId`	string	Produto usado como esta opção
`name`	string	Nome da opção
`position`	number	Ordem de exibição

categories[n].assignedAt e products[n].additionalInfo.assignedAt indicam quando a entidade entrou no menu. É um dado de pertencimento, não de edição: não muda ao editar o preço, o nome, a descrição, a imagem, os modificadores, a ordem nem a visibilidade. Formato: ISO 8601 com precisão de segundos e sufixo Z — "2026-08-04T12:30:00Z". Sempre em UTC, nunca no fuso da loja: o valor é o mesmo fato para todas as lojas do menu, que podem estar em países diferentes. Para exibir em horário local, use o timezone que viaja por loja em list.stores[n]. Sem milissegundos — diferente de event.createdAt, que os leva.

Situação	Valor
Produto ou categoria adicionado ao menu	Data da inclusão
Qualquer edição posterior (preço, nome, imagem, ordem, `active`)	Sem alteração
Produto removido do menu e adicionado novamente	Data nova — o campo descreve o pertencimento vigente, não o primeiro da história
Produto presente em várias categorias do mesmo menu	A mais antiga de suas inclusões (em `products[n]` vai um único valor, mesmo que o produto apareça em vários `productListing`)
Produto ou categoria herdado de um menu pai	A data do pai, não a do menu filho
Item que só existe como opção de um grupo de modificadores (`type: MODIFIER`)	Ausente — não é membro do menu por si só
Categoria que ficou sem produtos e depois volta a ter	Data nova — a categoria é recriada
Menu publicado antes de o campo existir	Ausente até a primeira republicação daquela loja/canal

Não existe assignedAt no nível list nem list.stores[n]: o campo descreve quando a entidade entrou no menu, não quando uma loja passou a recebê-lo. O mesmo campo, com a mesma semântica, viaja em product.updated. Não viaja em product.price_updated nem em product.availability_changed: esses eventos transmitem apenas seu delta, e o assignedAt que você já tem registrado continua válido.

Notas

O payload é um menu completo — não um diff. Substitua o menu inteiro no sistema externo.
Cada menu.modifierGroups[n].modifierOptions[n].productId deve referenciar um produto definido em menu.products.
stores[n].channels[n].schedules: janelas de tempo em que o canal está ativo para aquela loja. Um array vazio ([]) indica que o canal opera 24 horas — sem restrições.
categories[].schedules: horário próprio da categoria se existir; null se não houver.
products[].schedules: apenas quando o produto tem schedule mode: custom; null se usa horário da loja ou não tem horário customizado.

O Fire não emite um evento de exclusão separado para menus. Para remover um menu de um sistema externo, o Fire envia um evento menu.updated com menu.categories, menu.products e menu.modifierGroups como arrays vazios. Seu sistema deve interpretar um menu vazio como sinal para desativar ou remover o menu externamente. Esse esvaziamento remove categorias e produtos do menu. Se o menu for publicado de novo, eles são reincorporados: chegam com assignedAt novo, não com a data original — mesma regra de “produto removido do menu e adicionado novamente”.

{
  "event": {
    "id": "evt_def459",
    "type": "menu.updated",
    "executionId": "exec_abc124",
    "createdAt": "2025-01-15T14:31:00.000Z"
  },
  "data": {
    "account": "1",
    "country": "EC",
    "groupId": "a3f7c2d1-84be-4e10-9b3a-2c5d6e7f8091",
    "menu": {
      "list": { "..." : "..." },
      "categories": [],
      "products": [],
      "modifierGroups": []
    }
  }
}

Uso

Consulte o guia Publicação de menu para o fluxo completo de processamento.

Visão geral

Loja

Menu

Produto

Pedido

Métodos de pagamento

Payload

Campos

`data`

`data.menu`

`data.menu.list`

`data.menu.list.stores[n]`

`data.menu.list.stores[n].channels[n]`

`data.menu.list.stores[n].channels[n].schedules[n]`

`data.menu.categories[n]`

`data.menu.products[n]`

`data.menu.products[n].productModifiers[n].overrides[n]`

`data.menu.modifierGroups[n]`

`data.menu.modifierGroups[n].modifierOptions[n]`

Data de atribuição ao menu

Notas

Remover um menu externamente

Uso

​Payload

​Campos

​data

​data.menu

​data.menu.list

​data.menu.list.stores[n]

​data.menu.list.stores[n].channels[n]

​data.menu.list.stores[n].channels[n].schedules[n]

​data.menu.categories[n]

​data.menu.products[n]

​data.menu.products[n].productModifiers[n].overrides[n]

​data.menu.modifierGroups[n]

​data.menu.modifierGroups[n].modifierOptions[n]

​Data de atribuição ao menu

​Notas

​Remover um menu externamente

​Uso

Payload

Campos

`data`

`data.menu`

`data.menu.list`

`data.menu.list.stores[n]`

`data.menu.list.stores[n].channels[n]`

`data.menu.list.stores[n].channels[n].schedules[n]`

`data.menu.categories[n]`

`data.menu.products[n]`

`data.menu.products[n].productModifiers[n].overrides[n]`

`data.menu.modifierGroups[n]`

`data.menu.modifierGroups[n].modifierOptions[n]`

Data de atribuição ao menu

Notas

Remover um menu externamente

Uso