product.availability_changed

product.availability_changed é emitido quando a disponibilidade de um ou mais produtos muda — por exemplo, quando um restaurante marca um produto como esgotado ou o reativa. Controla se o produto aparece no menu e está disponível para compra. Suporta múltiplos produtos em um único evento. Quando a mudança afeta várias lojas, o Fire emite um único evento com todas as lojas afetadas listadas em targets.

Payload

{
  "event": {
    "id": "evt_mno345",
    "type": "product.availability_changed",
    "executionId": "exec_mno123",
    "createdAt": "2025-01-15T14:40:00.000Z",
    "timezone": "America/Sao_Paulo"
  },
  "data": {
    "account": "1",
    "country": "BR",
    "groupId": "a3f7c2d1-84be-4e10-9b3a-2c5d6e7f8091",
    "targets": [
      {
        "storeId": "b3d2a1f0-6e21-4c3a-9f5d-7a8b9c0d1e2f",
        "storeName": "Laboratorio Brasil",
        "vendorId": "100.6.1350",
        "timezone": "America/Sao_Paulo",
        "channels": [
          {
            "channelId": "d5f4c3b2-8043-4e5c-9b7f-9c0d1e2f3a4b",
            "channelReferenceName": "iFood"
          }
        ]
      },
      {
        "storeId": "c4e3b2a1-7f32-4d4b-8a6e-8b9c0d1e2f3a",
        "storeName": "Vila Olimpia",
        "vendorId": "100.6.1351",
        "timezone": "America/Sao_Paulo",
        "channels": [
          {
            "channelId": "d5f4c3b2-8043-4e5c-9b7f-9c0d1e2f3a4b",
            "channelReferenceName": "iFood"
          }
        ]
      }
    ],
    "products": [
      {
        "productId": "e925f6b0-15bf-dc39-2e3f-1a2b284310c6",
        "active": false
      },
      {
        "productId": "prod_size_small",
        "active": true
      }
    ]
  }
}

Campos

`data`

Campo	Tipo	Descrição
`account`	string	Identificador da conta — necessário para sistemas externos
`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
`targets`	object[]	Lojas onde a mudança de disponibilidade deve ser aplicada
`products`	object[]	Produtos cuja disponibilidade mudou

`data.targets[n]`

Mesma estrutura que em product.updated, sem o campo listName em channels[n].

Campo	Tipo	Descrição
`storeId`	string	UUID interno da loja (PK `stores.id`) — não é o `store_number`
`storeName`	string	Nome operacional da loja
`vendorId`	string	Identificador da marca da loja
`timezone`	string	Fuso horário IANA da loja (ex.: `America/Sao_Paulo`)
`channels`	object[]	Canais de vendas onde a alteração deve ser aplicada

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

Campo	Tipo	Descrição
`channelId`	string	UUID interno do canal de vendas (PK `channels.id`) — não é o `channel_id` externo do agregador
`channelReferenceName`	string	Nome legível do canal de vendas (ex.: `iFood`, `Rappi`)

`data.products[n]`

Campo	Tipo	Descrição
`productId`	string	Identificador do produto (UUID)
`active`	boolean	`true` para ativar, `false` para desativar

Comportamento

Definir active: false oculta o produto do menu e o marca como indisponível para compra. Definir active: true o restaura. Este evento não modifica nenhum outro dado do produto — nome, preço, imagens e modificadores permanecem inalterados. Desativar um produto não é removê-lo do menu: ele continua sendo membro, apenas deixa de estar disponível. Por isso sua data de atribuição ao menu (additionalInfo.assignedAt) não muda com active: false nem é reiniciada ao voltar para active: true, e este evento não a transmite. Ela chega em product.updated e em menu.updated.

`active` é a disponibilidade EFETIVA, não um único interruptor

products[n].active não reflete um único campo: é o resultado de combinar a visibilidade do produto com a de cada categoria em que ele aparece. Um produto pode viver em várias categorias do menu, e o evento é plano por produto, então se aplica o OR entre elas:

active = true se existir AO MENOS UMA categoria onde (a categoria está visível E o produto está visível nela).

Duas consequências importantes ao processar o evento:

Ocultar uma categoria inteira chega como N entradas de produto, uma para cada produto cuja disponibilidade efetiva mudou — não como uma alteração de categoria. Este evento não tem como expressar categorias; a estrutura do menu viaja em menu.updated (categories[n].displayInList).
Um produto que também vive em outra categoria visível NÃO aparece no evento, porque sua disponibilidade efetiva não mudou. Está correto, mas significa que a ausência de um produto em products[] não implica que sua categoria não tenha sido tocada.

Somente os produtos cuja disponibilidade efetiva mudou em relação ao estado anterior são emitidos. Um produto novo no menu não aparece aqui: ele chega com menu.updated / product.updated.

Uso

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

Visão geral

Loja

Menu

Produto

Pedido

Métodos de pagamento

product.availability_changed

Payload

Campos

`data`

`data.targets[n]`

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

`data.products[n]`

Comportamento

`active` é a disponibilidade EFETIVA, não um único interruptor

Uso

​Payload

​Campos

​data

​data.targets[n]

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

​data.products[n]

​Comportamento

​active é a disponibilidade EFETIVA, não um único interruptor

​Uso

Payload

Campos

`data`

`data.targets[n]`

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

`data.products[n]`

Comportamento

`active` é a disponibilidade EFETIVA, não um único interruptor

Uso