---
title: "Detalhe do produto"
description: "GET /v1/catalog/products/{productId} — detalhe de um produto no cardápio da BeeFood."
method: "GET"
path: "/v1/catalog/products/{productId}"
url: "https://developer.beefood.com.br/docs/catalogo/produto"
group: "Catálogo"
scope: "catalog:read"
lang: "pt"
---
# Detalhe do produto

`GET /v1/catalog/products/{productId}`

- Produção: `https://api.beefood.app/v1/catalog/products/{productId}`
- Sandbox: `https://api-sandbox.beefood.app/v1/catalog/products/{productId}`

Retorna o detalhe de um produto.

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `catalog:read`. Limite: 300 requisições a cada 3 minutos.


## Parâmetros de path

- `productId` *integer* **obrigatório** — Identificador do produto. Exemplo: `131822`.





## Exemplos de requisição

### cURL

```bash
curl -X GET "https://api.beefood.app/v1/catalog/products/{productId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```


## Exemplos de resposta

### 200 OK

```json
{
  "productId": 2515344,
  "storeId": 38311,
  "type": "product",
  "name": "Combo One Classic",
  "description": "Pão brioche, carne 100g, queijo prato fatiado, alface americana, tomate fatiado, cebola roxa e maionese verde artesanal da casa\n(Acompanha batata e bebida)\n\nTags\nX-salada, x salada, cheese salada",
  "unit": "UN",
  "price": 31,
  "featured": false,
  "featuredPrint": false,
  "serviceFeeActive": true,
  "scheduleOnly": false,
  "scaleActive": false,
  "sectorId": 213750,
  "sectorName": "Combos (Burger + Porção + Bebida)",
  "combo": true,
  "cost": {
    "base": 0,
    "supply": 0,
    "total": 0
  },
  "image": {
    "original": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202608180903_6UJ.webp",
    "thumbnail60": "https://beetech-imagens.beefood-r2.work/38311/p/60/202608180903_6UJ.jpg",
    "thumbnail120": "https://beetech-imagens.beefood-r2.work/38311/p/120/202608180903_6UJ.jpg",
    "thumbnailWeb": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202608180903_6UJ.webp"
  },
  "menus": [
    {
      "merchantId": 39202,
      "name": "Restaurante Exemplo",
      "active": true,
      "delivery": true,
      "dineIn": true,
      "totem": true,
      "sortOrder": 5,
      "cashbackEnabled": true
    },
    {
      "merchantId": 50502,
      "name": "Restaurante Exemplo - Sushi",
      "active": false,
      "delivery": true,
      "dineIn": true,
      "totem": true,
      "sortOrder": 5,
      "cashbackEnabled": true
    }
  ],
  "groups": [
    {
      "groupId": 257197,
      "name": "Burger",
      "active": true,
      "delivery": true,
      "dineIn": true,
      "required": true,
      "sortOrder": 1,
      "priceFormation": "gift",
      "minQuantity": 1,
      "maxQuantity": 1,
      "selectionMode": "single",
      "options": [
        {
          "optionId": 5616545,
          "productId": 2515297,
          "name": "One Classic",
          "type": "product",
          "active": true,
          "delivery": true,
          "dineIn": true,
          "minQuantity": 1,
          "maxQuantity": 1,
          "price": 0,
          "sortOrder": 0,
          "image": {
            "original": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202608180910_330.webp",
            "thumbnail60": "https://beetech-imagens.beefood-r2.work/38311/p/60/202608180910_330.jpg",
            "thumbnail120": "https://beetech-imagens.beefood-r2.work/38311/p/120/202608180910_330.jpg",
            "thumbnailWeb": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202608180910_330.webp"
          },
          "deliveryPrice": 0
        }
      ]
    },
    {
      "groupId": 257188,
      "name": "Bebidas",
      "active": true,
      "delivery": true,
      "dineIn": true,
      "required": true,
      "sortOrder": 2,
      "priceFormation": "sum",
      "minQuantity": 1,
      "maxQuantity": 1,
      "selectionMode": "single",
      "options": [
        {
          "optionId": 5616520,
          "productId": 2515308,
          "name": "Coca Cola 350ml",
          "type": "product",
          "active": true,
          "delivery": true,
          "dineIn": true,
          "minQuantity": 1,
          "maxQuantity": 1,
          "price": 8.4,
          "sortOrder": 0,
          "image": {
            "original": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281443_4E3.webp",
            "thumbnail60": "https://beetech-imagens.beefood-r2.work/38311/p/60/202503281443_4E3.jpg",
            "thumbnail120": "https://beetech-imagens.beefood-r2.work/38311/p/120/202503281443_4E3.jpg",
            "thumbnailWeb": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281443_4E3.webp"
          },
          "deliveryPrice": 0
        },
        {
          "optionId": 5616521,
          "productId": 2515311,
          "name": "Coca Zero 350ml",
          "type": "product",
          "active": true,
          "delivery": true,
          "dineIn": true,
          "minQuantity": 1,
          "maxQuantity": 1,
          "price": 8.4,
          "sortOrder": 1,
          "image": {
            "original": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281444_7A0.webp",
            "thumbnail60": "https://beetech-imagens.beefood-r2.work/38311/p/60/202503281444_7A0.jpg",
            "thumbnail120": "https://beetech-imagens.beefood-r2.work/38311/p/120/202503281444_7A0.jpg",
            "thumbnailWeb": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281444_7A0.webp"
          },
          "deliveryPrice": 0
        },
        {
          "optionId": 5616522,
          "productId": 2515310,
          "name": "Fanta Laranja 350ml",
          "type": "product",
          "active": true,
          "delivery": true,
          "dineIn": true,
          "minQuantity": 1,
          "maxQuantity": 1,
          "price": 8.4,
          "sortOrder": 2,
          "image": {
            "original": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281444_WPL.webp",
            "thumbnail60": "https://beetech-imagens.beefood-r2.work/38311/p/60/202503281444_WPL.jpg",
            "thumbnail120": "https://beetech-imagens.beefood-r2.work/38311/p/120/202503281444_WPL.jpg",
            "thumbnailWeb": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281444_WPL.webp"
          },
          "deliveryPrice": 0
        },
        {
          "optionId": 5616523,
          "productId": 2515309,
          "name": "Sprite Zero 350ml",
          "type": "product",
          "active": true,
          "delivery": true,
          "dineIn": true,
          "minQuantity": 1,
          "maxQuantity": 1,
          "price": 8.4,
          "sortOrder": 3,
          "image": {
            "original": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281444_0QF.webp",
            "thumbnail60": "https://beetech-imagens.beefood-r2.work/38311/p/60/202503281444_0QF.jpg",
            "thumbnail120": "https://beetech-imagens.beefood-r2.work/38311/p/120/202503281444_0QF.jpg",
            "thumbnailWeb": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281444_0QF.webp"
          },
          "deliveryPrice": 0
        },
        {
          "optionId": 5616524,
          "productId": 2515327,
          "name": "Suco de uva 290ml Del Valle",
          "type": "complement",
          "active": true,
          "delivery": true,
          "dineIn": true,
          "minQuantity": 1,
          "maxQuantity": 1,
          "price": 8.4,
          "sortOrder": 4,
          "image": {
            "original": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281444_373.webp",
            "thumbnail60": "https://beetech-imagens.beefood-r2.work/38311/p/60/202503281444_373.jpg",
            "thumbnail120": "https://beetech-imagens.beefood-r2.work/38311/p/120/202503281444_373.jpg",
            "thumbnailWeb": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281444_373.webp"
          },
          "deliveryPrice": 0
        },
        {
          "optionId": 5616525,
          "productId": 2515328,
          "name": "Suco Maracujá 290ml Del Valle",
          "type": "product",
          "active": true,
          "delivery": true,
          "dineIn": true,
          "minQuantity": 1,
          "maxQuantity": 1,
          "price": 8.4,
          "sortOrder": 5,
          "image": {
            "original": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281446_I43.webp",
            "thumbnail60": "https://beetech-imagens.beefood-r2.work/38311/p/60/202503281446_I43.jpg",
            "thumbnail120": "https://beetech-imagens.beefood-r2.work/38311/p/120/202503281446_I43.jpg",
            "thumbnailWeb": "https://beetech-imagens.beefood-r2.work/38311/p/webp/202503281446_I43.webp"
          },
          "deliveryPrice": 0
        }
      ]
    }
  ]
}
```


## Campos da resposta

- `productId` *number* — Identificador do produto.

- `storeId` *number* — Identificador da empresa.

- `barcode` *string* — Código de barras.

- `code` *string* — Código interno.

- `type` *string* — Tipo derivado do PDV: "product". Somente leitura.

- `name` *string* — Nome do produto.

- `description` *string* — Descrição do produto.

- `internalNotes` *string* — Observações internas.

- `label` *string* — Selo do cardápio: new, recommended, bestSeller, limitedEdition ou soldOut.

- `unit` *string* — Unidade de medida (Default: UN): UN, KG, G, L, ML, PCT, CX, DZ, FD, BD, SC, PT, CP, PC, FT, PQ, GF, LT ou BN.
  - *Valores:* `UN`, `KG`, `G`, `L`, `ML`, `PCT`, `CX`, `DZ`, `FD`, `BD`, `SC`, `PT`, `CP`, `PC`, `FT`, `PQ`, `GF`, `LT`, `BN`

- `price` *number* — Preço padrão.

- `featured` *boolean* — Indica se está em destaque.

- `featuredPrint` *boolean* — Indica se tem destaque na impressão.

- `serviceFeeActive` *boolean* — Indica se a taxa de serviço está ativa.

- `scheduleOnly` *boolean* — Indica se a venda é apenas por agendamento.

- `scaleActive` *boolean* — Indica se a balança está ativa.

- `scaleShelfLifeDays` *number* — Validade em dias na balança.

- `sectorId` *number* — Identificador de um setor da mesma empresa.

- `sectorName` *string* — Nome do setor. Somente leitura.

- `combo` *boolean* — Indica se é combo. Somente leitura: vira true quando o produto tem ao menos um grupo vinculado e volta a false quando o último é desvinculado.

- `cost` *object* — Custos do produto.

- `cost.base` *number* — Custo base.

- `cost.supply` *number* — Custo da composição, calculado dos insumos. Somente leitura.

- `cost.total` *number* — Soma do custo base com o custo da composição. Somente leitura.

- `image` *object* — URLs da imagem do produto. Somente leitura. Para enviar ou remover, use Enviar imagem e Remover imagem com resourceType = products.

- `image.original` *string* — Campo original.

- `image.thumbnail60` *string* — Campo thumbnail60.

- `image.thumbnail120` *string* — Campo thumbnail120.

- `image.thumbnailWeb` *string* — Campo thumbnailWeb.

- `menus` *array* — Configurações do produto por cardápio.

- `menus[].merchantId` *number* — Cardápio da mesma empresa.

- `menus[].name` *string* — Nome do cardápio. Somente leitura.

- `menus[].active` *boolean* — Indica se está ativo nesto cardápio.

- `menus[].delivery` *boolean* — Indica se aparece no delivery.

- `menus[].deliveryPrice` *number* — Preço no delivery.

- `menus[].dineIn` *boolean* — Indica se aparece no presencial.

- `menus[].dineInPrice` *number* — Preço no presencial.

- `menus[].totem` *boolean* — Indica se aparece no totem.

- `menus[].promotionPrice` *number* — Preço promocional.

- `menus[].sortOrder` *number* — Posição de exibição.

- `menus[].featuredOrder` *number* — Posição entre destaques.

- `menus[].cashbackEnabled` *boolean* — Indica se o cashback está ativo nesto cardápio.

- `menus[].upsell` *array* — Produtos sugeridos nesto cardápio.

- `menus[].upsell[].productId` *number* — Produto sugerido no upsell.

- `menus[].upsell[].name` *string* — Nome do produto sugerido. Somente leitura.

- `restrictions` *object* — Restrições e características alimentares.

- `restrictions.vegetarian` *boolean* — Indica se é vegetariano.

- `restrictions.vegan` *boolean* — Indica se é vegano.

- `restrictions.organic` *boolean* — Indica se é orgânico.

- `restrictions.glutenFree` *boolean* — Indica se não contém glúten.

- `restrictions.sugarFree` *boolean* — Indica se não contém açúcar.

- `restrictions.lactoseFree` *boolean* — Indica se não contém lactose.

- `restrictions.natural` *boolean* — Indica se é natural.

- `restrictions.iced` *boolean* — Indica se é gelado.

- `restrictions.serves` *number* — Número de pessoas servidas.

- `groups` *array* — Grupos já existentes vinculados ao produto, ordenados por sortOrder.

- `groups[].groupId` *number* — Grupo existente da mesma empresa.

- `groups[].name` *string* — Nome do grupo. Somente leitura.

- `groups[].active` *boolean* — Indica se o grupo está ativo.

- `groups[].delivery` *boolean* — Indica se o grupo aparece no delivery.

- `groups[].dineIn` *boolean* — Indica se o grupo aparece no presencial.

- `groups[].required` *boolean* — Indica se a escolha é obrigatória.

- `groups[].sortOrder` *number* — Posição do grupo neste produto; menor valor aparece primeiro. Omitido quando o produto não tem ordem definida para o grupo.

- `groups[].priceFormation` *string* — Regra de preço: gift, highest, proportional ou sum.

- `groups[].minQuantity` *number* — Quantidade mínima de opções.

- `groups[].maxQuantity` *number* — Quantidade máxima de opções.

- `groups[].selectionMode` *string* — Modo de seleção do grupo.

- `groups[].options` *array* — Opções do grupo. Somente leitura nesta entrega.

- `groups[].options[].optionId` *number* — Campo optionId.

- `groups[].options[].productId` *number* — Campo productId.

- `groups[].options[].name` *string* — Campo name.

- `groups[].options[].type` *string* — Campo type.

- `groups[].options[].active` *boolean* — Campo active.

- `groups[].options[].delivery` *boolean* — Campo delivery.

- `groups[].options[].dineIn` *boolean* — Campo dineIn.

- `groups[].options[].minQuantity` *number* — Campo minQuantity.

- `groups[].options[].maxQuantity` *number* — Campo maxQuantity.

- `groups[].options[].price` *number* — Campo price.

- `groups[].options[].deliveryPrice` *number* — Campo deliveryPrice.

- `groups[].options[].dineInPrice` *number* — Campo dineInPrice.

- `groups[].options[].sortOrder` *number* — Campo sortOrder.

- `groups[].options[].image` *object* — Campo image.

- `groups[].options[].image.original` *string* — Campo original.

- `groups[].options[].image.thumbnail60` *string* — Campo thumbnail60.

- `groups[].options[].image.thumbnail120` *string* — Campo thumbnail120.

- `groups[].options[].image.thumbnailWeb` *string* — Campo thumbnailWeb.



## Erros

| Status | Mensagem |
| --- | --- |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the catalog:read scope |
| 429 | Too many requests |
| 404 | Product not found |


## Vocabulários usados neste endpoint

## Catálogo · unit

Valores aceitos no campo unit dos produtos do catálogo.

| Valor | Significado | Uso |
| --- | --- | --- |
| `UN` | Unidade | /v1/catalog/products |
| `KG` | Quilograma | /v1/catalog/products |
| `G` | Grama | /v1/catalog/products |
| `L` | Litro | /v1/catalog/products |
| `ML` | Mililitro | /v1/catalog/products |
| `PCT` | Pacote | /v1/catalog/products |
| `CX` | Caixa | /v1/catalog/products |
| `DZ` | Dúzia | /v1/catalog/products |
| `FD` | Fardo | /v1/catalog/products |
| `BD` | Balde | /v1/catalog/products |
| `SC` | Saco | /v1/catalog/products |
| `PT` | Pote | /v1/catalog/products |
| `CP` | Copo | /v1/catalog/products |
| `PC` | Peça | /v1/catalog/products |
| `FT` | Fátia | /v1/catalog/products |
| `PQ` | Porção | /v1/catalog/products |
| `GF` | Garrafa | /v1/catalog/products |
| `LT` | Lata | /v1/catalog/products |
| `BN` | Bandeja | /v1/catalog/products |