Merchant (estabelecimento)

A Ordering Application gera o identificador do merchant. Na Prefiro Delivery, cada merchant corresponde a um estabelecimento (unidade operacional) do tenant.

Bloco merchant no GET order

Campo	Descrição
merchant.id	UUID estável gerado pela Prefiro para o estabelecimento
merchant.name	Nome comercial da unidade
merchant.externalCode	Identificador numérico do estabelecimento — use para mapear a loja no seu PDV

Persista no seu sistema o par (tenant, externalCode) ou (tenant, merchant.id) para reconciliar pedidos com a loja correta.

Autorização por estabelecimento

A credencial OAuth pode estar autorizada para todos os estabelecimentos do tenant ou para um subconjunto. Se o app estiver restrito:

• GET /orders/{id} retorna 403 para pedidos de estabelecimentos não autorizados
• Webhooks de pedidos desses estabelecimentos não são enviados

Escopo tenant vs merchant

Dados de Customer e Loyalty são do tenant (não filtrados por merchant). O parâmetro merchantId na listagem de clientes é ignorado.

Produtos e cardápio

Mapeamento de produtos usa os identificadores retornados no payload do pedido (items, complementos e variações).

Especificação: Merchant — Open Delivery.