Common Product + Offer (deprecated)

Імпортування продуктів та офферів одним запитом

Одночасний імпорт продуктів та офферів

Ми розраховуємо на отримання від наших партнерів повної та актуальної інформації про їх меню для застосунку LOKO. В рамках нашої системи інтеграції, ми порівнюємо нові дані з попередньо наданими, щоб виявити зміни та адаптувати наше відображення меню. У випадку відсутності інформації про конкретний продукт чи його пропозицію, він буде розглядатися як недоступний і, відповідно, відключений від активних пропозицій в нашому додатку.

Product

• companyId – ідентифікатор компанії, який має надати інтегруюча сторона.

• sku – артикул продукта, має завжди бути унікальним значенням в рамках закладу, не може повторюватися.

• title – назва продукту, яка відображатиметься на вітрині.

• type – тип продукту.

  • product – товар, який буде відображатися на вітрині.

  • attribute – інгредієнт (або модифікатор) до товару.

• description – опис продукту.

• category – головна категорія продукту.

• categories – додаткові категорії, до яких відноситься продукт.

Зверніть увагу: ми додали автоматизований функціонал управління категоріями продуктів. Детальніше можна дізнатися тут: https://loko-merchant-api.gitbook.io/merchant-docs/api-reference/menu/common-menu-import

• unit – одиниця вимірювання продукту. Наприклад: шт, упаковка, літр, і т.д.

• media – посилання на зображення продукту.

В LOKO тимчасово відсутній автоматизований функціонал управління інгредієнтами (модифікаторами). Дані про модифікатори можуть бути передані менеджеру LOKO перед інтеграцією. Всі наступні зміни в модифікаторах проводяться із залучення менеджерів LOKO.

Offer

• storeId – ідентифікатор закладу в рамках компанії, який має надати інтегруюча сторона.

• listPrice – ціна, яку сплачує Гість.

• oldPrice – акційна ціна, що відображається на вітрині ( використовується виключно для відображення ).

• sortOrder – значення, за яким будуть сортуватися пропозиції на вітрині.

• stock – кількість продукту в рамках закладу.

• status – може приймати enabled, або disabled.

  • enabled – пропозиція актуальна та відображається на вітрині;

  • disabled – пропозиція неактуальна та не відображається на вітрині.

Import products & offers with one request

post

Import products & offers with one request

Authorizations

Body

skustringRequiredExample: 0000040367

titlestringRequiredExample: Hawthorn Berry 540mg

descriptionstringOptionalExample: Hawthorn berry’s high antioxidant content may help lower blood pressure and cholesterol, reduce inflammation, improve skin health, and aid digestion.

companyIdstringRequiredExample: 018b85b5-6ab6-773c-88eb-36d30aa72d26

categorystringRequiredExample: 1eea62be-98cc-62aa-b0c3-edeb3b29a228

categoriesstring[]OptionalExample: ["1eea62bf-15f1-6d66-8ac7-7d8b228c7acc","1eea62bf-6f34-64aa-a1db-bd35a894488b"]

typestring · enumOptionalExample: productPossible values:

mediastringOptionalExample: https://example.com/berry.png

unitstringOptionalExample: caps.

Responses

202

Accepted

application/json

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

post

HTTPcURLJavaScriptPython

POST /v1/merchant/import/product-offers HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 624

[
  {
    "sku": "0000040367",
    "title": "Hawthorn Berry 540mg",
    "description": "Hawthorn berry’s high antioxidant content may help lower blood pressure and cholesterol, reduce inflammation, improve skin health, and aid digestion.",
    "companyId": "018b85b5-6ab6-773c-88eb-36d30aa72d26",
    "category": "1eea62be-98cc-62aa-b0c3-edeb3b29a228",
    "categories": [
      "1eea62bf-15f1-6d66-8ac7-7d8b228c7acc",
      "1eea62bf-6f34-64aa-a1db-bd35a894488b"
    ],
    "type": "product",
    "media": "https://example.com/berry.png",
    "unit": "caps.",
    "offers": [
      {
        "storeId": "c6036747-f91c-4142-891d-c39104ece507",
        "listPrice": 100,
        "oldPrice": 120,
        "sortOrder": 1,
        "stock": 55,
        "status": "enabled"
      }
    ]
  }
]

{
  "ids": [
    "62a718ef7706fa4aab180bf2"
  ]
}