الكتالوج

{
  "schema": "aurmap.menu/1",
  "currency": "SAR",
  "default_language": "ar",
  "languages": ["ar", "en"],
  "menu_url": "https://order.partner.example/al-rayhan-olaya",
  "identity": {
    "name": { "ar": "مطعم الريحان", "en": "Al Rayhan" },
    "tagline": { "ar": "برجر وعصائر طازجة", "en": "Burgers and fresh juice" },
    "logo": "https://cdn.partner.example/logo.png",
    "cover": "https://cdn.partner.example/cover.jpg",
    "slider": ["https://cdn.partner.example/slide-1.jpg"],
    "template": "classic",
    "theme": "custom",
    "colors": { "background": "#F2F4F7", "text": "#041731", "card": "#FFFFFF", "accent": "#C8102E", "on_accent": "#FFFFFF" },
    "font": "Tajawal",
    "button_shape": "rounded"
  },
  "tax": { "prices_include_vat": true, "vat_percent": 15, "service_charge_percent": 0 },
  "aurmap_ordering": { "enabled": true, "pickup": true, "delivery": false, "cash": true },
  "sections": [
    { "id": "burgers", "parent_id": null, "name": { "ar": "البرجر", "en": "Burgers" }, "image": null, "sort": 0, "schedule_id": null },
    { "id": "juices", "parent_id": null, "name": { "ar": "العصائر", "en": "Juices" }, "image": null, "sort": 1, "schedule_id": null },
    { "id": "desserts", "parent_id": null, "name": { "ar": "الحلى", "en": "Desserts" }, "image": null, "sort": 2, "schedule_id": "evening" },
    { "id": "meals", "parent_id": null, "name": { "ar": "الوجبات", "en": "Meals" }, "image": null, "sort": 3, "schedule_id": null }
  ],
  "items": [
    {
      "id": "chicken-burger",
      "type": "menu_item",
      "section_id": "burgers",
      "sort": 0,
      "name": { "ar": "برجر دجاج", "en": "Chicken burger" },
      "description": { "ar": "صدر دجاج مقرمش، خس، صوص البيت", "en": "Crispy chicken breast, lettuce, house sauce" },
      "image": "https://cdn.partner.example/img/chicken-burger.jpg",
      "price_minor": 2300,
      "original_price_minor": null,
      "calories": 540,
      "prep_min": 10,
      "prep_max": 15,
      "label": { "name": { "ar": "الأكثر طلبا", "en": "Best seller" } },
      "warnings": [ { "id": "gluten", "name": { "ar": "يحتوي على الغلوتين", "en": "Contains gluten" }, "icon": null } ],
      "sizes": [
        { "id": "m", "name": { "ar": "وسط", "en": "Medium" }, "price_minor": 2300, "original_price_minor": null, "calories": 540 },
        { "id": "l", "name": { "ar": "كبير", "en": "Large" }, "price_minor": 2990, "original_price_minor": null, "calories": 720 }
      ],
      "group_ids": ["sauce", "extras"],
      "order_types": { "pickup": true, "delivery": true, "dine_in": true },
      "recommended_ids": ["orange-juice"],
      "schedule_id": null,
      "order_url": null
    },
    {
      "id": "orange-juice",
      "type": "menu_item",
      "section_id": "juices",
      "sort": 1,
      "name": { "ar": "عصير برتقال", "en": "Orange juice" },
      "price_minor": 920,
      "sizes": [
        { "id": "s", "name": { "ar": "صغير", "en": "Small" }, "price_minor": 920 },
        { "id": "l", "name": { "ar": "كبير", "en": "Large" }, "price_minor": 1380 }
      ],
      "group_ids": [],
      "order_types": { "pickup": true, "delivery": true, "dine_in": true }
    },
    {
      "id": "kunafa",
      "type": "menu_item",
      "section_id": "desserts",
      "sort": 2,
      "name": { "ar": "كنافة", "en": "Kunafa" },
      "price_minor": 1840,
      "sizes": [],
      "group_ids": [],
      "order_types": { "pickup": true, "delivery": true, "dine_in": true }
    },
    {
      "id": "chicken-burger-meal",
      "type": "menu_item",
      "section_id": "meals",
      "sort": 3,
      "name": { "ar": "وجبة برجر دجاج", "en": "Chicken burger meal" },
      "price_minor": 3000,
      "original_price_minor": 3220,
      "sizes": [],
      "group_ids": ["sauce"],
      "order_types": { "pickup": true, "delivery": true, "dine_in": true }
    }
  ],
  "groups": [
    {
      "id": "sauce", "name": { "ar": "الصوص", "en": "Sauce" }, "required": true, "min": 1, "max": 1,
      "options": [
        { "id": "hot", "name": { "ar": "صوص حار", "en": "Hot sauce" }, "price_minor": 230, "image": null },
        { "id": "none", "name": { "ar": "بدون صوص", "en": "No sauce" }, "price_minor": 0, "image": null }
      ]
    },
    {
      "id": "extras", "name": { "ar": "إضافات", "en": "Extras" }, "required": false, "min": 0, "max": 2,
      "options": [
        { "id": "cheese", "name": { "ar": "جبن إضافي", "en": "Extra cheese" }, "price_minor": 345, "image": null },
        { "id": "no-onion", "name": { "ar": "بدون بصل", "en": "No onion" }, "price_minor": 0, "image": null },
        { "id": "pickles", "name": { "ar": "مخلل إضافي", "en": "Extra pickles" }, "price_minor": 0, "image": null }
      ]
    }
  ],
  "combos": [
    { "item_id": "chicken-burger-meal", "components": [ { "item_id": "chicken-burger", "quantity": 1 }, { "item_id": "orange-juice", "quantity": 1 } ] }
  ],
  "schedules": [
    { "id": "evening", "days": [0, 1, 2, 3, 4, 5, 6], "from": "16:00", "to": "02:00" }
  ],
  "state": {
    "paused": false,
    "sold_out": { "items": ["kunafa"], "sizes": [], "options": [] },
    "prices": { "items": [], "sizes": [], "options": [] }
  }
}

{
  "error": {
    "code": "MENU_INVALID",
    "message": "The menu has 2 problems.",
    "request_id": "req_01JAA2",
    "details": [
      { "path": "items[0].section_id", "code": "UNKNOWN_SECTION", "message": "Section breakfast does not exist." },
      { "path": "groups[1]", "code": "MIN_ABOVE_MAX", "message": "min is above max." }
    ]
  }
}

IDEMPOTENCY_KEY="menu-olaya-2026-10-14-01" \
aurmap PUT /v1/places/plc_9q3w7e/menu "$(cat menu.json)"

{ "place_id": "plc_9q3w7e", "version": 42, "prev_version": 41, "kind": "full", "status": "processing", "hash": "9f2c4be1d07a65e3c1f8a2b4d6e8f0a1b3c5d7e9f1a3b5c7d9e1f3a5b7c9d1e3", "warnings": [] }

import { readFile } from 'node:fs/promises';

const menu = JSON.parse(await readFile('menu.json', 'utf8'));
const res = await aurmap('PUT', '/v1/places/plc_9q3w7e/menu', menu, 'menu-olaya-2026-10-14-01');
console.log(res.version, res.hash);

$menu = json_decode(file_get_contents('menu.json'), true);
$res = aurmap('PUT', '/v1/places/plc_9q3w7e/menu', $menu, 'menu-olaya-2026-10-14-01');
echo $res['version'], ' ', $res['hash'];

aurmap PATCH /v1/places/plc_9q3w7e/menu '{"base_version":43,"upsert":[{"id":"mint-lemonade","type":"menu_item","section_id":"juices","sort":4,"name":{"ar":"ليموناضة بالنعناع","en":"Mint lemonade"},"price_minor":1150,"sizes":[],"group_ids":[],"order_types":{"pickup":true,"delivery":true,"dine_in":true}}],"remove":["kunafa"],"groups":[{"id":"extras","name":{"ar":"إضافات","en":"Extras"},"required":false,"min":0,"max":3,"options":[{"id":"cheese","name":{"ar":"جبن إضافي","en":"Extra cheese"},"price_minor":345,"image":null},{"id":"no-onion","name":{"ar":"بدون بصل","en":"No onion"},"price_minor":0,"image":null},{"id":"pickles","name":{"ar":"مخلل إضافي","en":"Extra pickles"},"price_minor":0,"image":null},{"id":"jalapeno","name":{"ar":"هالبينو","en":"Jalapeno"},"price_minor":230,"image":null}]}]}'

{ "place_id": "plc_9q3w7e", "version": 44, "prev_version": 43, "kind": "structure", "status": "processing", "hash": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2", "warnings": [] }

aurmap POST /v1/menus/reconcile '{"places":[{"place_id":"plc_9q3w7e","version":44,"hash":"b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2"}]}'

{ "stale": [] }

{
  "schema": "cp/1",
  "id": "tshirt-basic",
  "name": { "ar": "تيشيرت قطن", "en": "Cotton T-shirt" },
  "category_ids": ["men", "tshirts"],
  "images": [ { "url": "https://cdn.partner.example/p/tshirt.jpg" } ],
  "option_axes": [
    { "id": "size", "name": { "ar": "المقاس", "en": "Size" }, "values": [ { "id": "m", "name": { "ar": "M", "en": "M" } }, { "id": "l", "name": { "ar": "L", "en": "L" } } ] }
  ],
  "variants": [
    { "id": "tshirt-basic-m", "sku": "TS-M-BLK", "barcode": "6281234567890", "options": { "size": "m" }, "price_minor": 7900, "stock": { "tracked": true, "quantity": 12 } },
    { "id": "tshirt-basic-l", "sku": "TS-L-BLK", "options": { "size": "l" }, "price_minor": 7900, "stock": { "tracked": true, "quantity": 0 } }
  ],
  "status": "active"
}