---
title: "MCD menu adapter v1"
method: PUT
path: "/adapters/menu-put-mcd-v1/stores/{storeId}"
---

# MCD menu adapter v1

`PUT /adapters/menu-put-mcd-v1/stores/{storeId}`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/adapters/menu-put-mcd-v1/stores/{storeId}`
- Auth: none declared

Valida y acepta un menú MCD para un local específico. La carga se procesa de forma async; usa el jobId para consultar el estado.

## Path parameters

- `storeId` string, required

## Request body

- ApiMcdMenuPayload: Payload de menú MCD compatible con menu-put-mcd-v1.
  - `menus` object[], required
    - `app_menu_id` string
    - `menu_name` string
    - `app_category_ids` string[]: Categorías del menú en orden de visualización. El adapter usa este orden para el índice de categorías.
  - `categories` object[], required
    - `app_category_id` string
    - `category_name` string
    - `head_img` string: URL de la imagen de la categoría.
    - `app_item_ids` string[]: Items contenidos en la categoría en orden de visualización. Los productos visibles reciben prioridad siguiendo este orden.
  - `items` object[], required
    - `app_item_id` string
    - `item_name` string
    - `short_desc` string
    - `head_img` string
    - `price` number: Precio del item; cero es válido. Si no se envía original_price, actualiza el precio base y conserva la oferta, salvo que supere el nuevo precio base: en ese caso elimina el descuento. Un producto sin ninguno de los dos precios queda no disponible y conserva su precio anterior.
    - `original_price` number: Precio original o tachado del producto. Solo aplica a productos vendidos por separado. Si se envían ambos precios y original_price es mayor que price, se actualiza el descuento. Si ambos son iguales o original_price es menor, se elimina el descuento. Si solo viene uno de los precios, se conserva el descuento configurado en Justo salvo que la oferta supere el nuevo precio base. Si no viene ninguno, el producto queda no disponible.
    - `status` number
    - `is_sold_separately` boolean
    - `as_modifier_max_quantity` number: Máximo de unidades seleccionables cuando este item se importa como opción de modificador. Si no viene, Justo usa 1.
    - `app_modifier_group_ids` string[]
  - `modifier_groups` object[], required
    - `app_modifier_group_id` string
    - `modifier_group_name` string
    - `is_required` number
    - `quantity_min_permitted` number
    - `quantity_max_permitted` number
    - `app_mg_items` object[]
      - `app_item_id` string

## Response `202`

Job accepted

- object
  - `success` boolean
  - `data` ApiAsyncJobAcceptedResult: Job async aceptado para procesamiento.
    - `jobId` string
    - `status` 'queued'
    - `service` 'adapters' | 'ecommerce' | 'admin' | 'ordering'
    - `operation` string
    - `storeId` string
    - `attempts` number
    - `maxAttempts` number
    - `preview` object: Resumen validado de la operación antes de ejecutarla.

## Other responses

- `400`: Errors

## Changes

- **2026-06-17** `e5416b00b4eb`: 2 info
  - added the optional property `data/attempts` to the response with the `202` status
  - added the optional property `data/maxAttempts` to the response with the `202` status
- **2026-06-17** `cc5462313ceb`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `202`
- **2026-06-17** `400ae2c0afb9`: 4 info
  - added the new optional request property `items/items/original_price`
  - added the new optional request property `menus/items/app_category_ids`
  - added the new optional request property `menus/items/app_menu_id`
  - added the new optional request property `menus/items/menu_name`
- **2026-05-28** `c391cdba01b8`: 4 info
  - added the new optional request property `categories/items/app_category_id`
  - added the new optional request property `categories/items/app_item_ids`
  - added the new optional request property `categories/items/category_name`
  - added the new optional request property `categories/items/head_img`
- **2026-05-22** `f5b4f3d8c4cd`: 15 info
  - added the new optional request property `items/items/app_item_id`
  - added the new optional request property `items/items/app_modifier_group_ids`
  - added the new optional request property `items/items/as_modifier_max_quantity`
  - added the new optional request property `items/items/head_img`
  - …11 more

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/adapters/menu-put-mcd-v1/stores/:storeId/put.md)

---

[API](https://skmtc.dev/getjusto/apis/justo-api.md) - [All operations](https://skmtc.dev/getjusto/apis/justo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getjusto/apis/justo-api/revisions/c810bd8246fd?raw)