LOKO Merchant API
  • Getting Started
    • 🔌Процес інтеграції
    • 💂Отримання токену
    • 🪃Опрацювання Callback(Webhook)
  • General Terms & Conditions
    • 🔓Scope
    • ⚙️Environment
    • 🔑Company & Store
  • API Reference
    • Orders
    • Stores
    • Menu
      • Separate Product & Offer
      • Common Product + Offer (deprecated)
      • Common Menu Import
      • Stop-list
      • Import categories
    • Callbacks (webhooks)
Powered by GitBook
On this page
  1. API Reference
  2. Menu

Separate Product & Offer

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

PreviousMenuNextCommon Product + Offer (deprecated)

Last updated 10 months ago

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

Імпорт продуктів

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

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

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

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

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

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

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

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

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

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

Імпорт офферів

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

  • sku – артикул імпортованого продукту;

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

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

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

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

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

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

  • Імпорт продуктів
  • POSTImport products
  • Імпорт офферів
  • POSTImport offers

Import products

post

Import products

Authorizations
Body
companyIdstringRequiredExample: 018b85b5-6ab6-773c-88eb-36d30aa72d26
Responses
202
Accepted
application/json
400
Bad request
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
post
POST /v1/merchant/import/products HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 480

{
  "companyId": "018b85b5-6ab6-773c-88eb-36d30aa72d26",
  "items": [
    {
      "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.",
      "category": "1eea62be-98cc-62aa-b0c3-edeb3b29a228",
      "categories": [
        "1eea62bf-15f1-6d66-8ac7-7d8b228c7acc",
        "1eea62bf-6f34-64aa-a1db-bd35a894488b"
      ],
      "unit": "caps.",
      "media": "https://example.com/berry.png"
    }
  ]
}
{
  "id": "62a718ef7706fa4aab180bf2"
}

Import offers

post

Import offers

Authorizations
Body
storeIdstringRequiredExample: c6036747-f91c-4142-891d-c39104ece507
Responses
202
Accepted
application/json
400
Bad request
application/json
401
Unauthorized
application/json
403
Forbidden
application/json
post
POST /v1/merchant/import/offers HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 142

{
  "storeId": "c6036747-f91c-4142-891d-c39104ece507",
  "items": [
    {
      "sku": "0000040367",
      "listPrice": 100,
      "oldPrice": 120,
      "stock": 55,
      "status": "enabled"
    }
  ]
}
{
  "id": "62a718ef7706fa4aab180bf2"
}