Separate Product & Offer

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

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

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

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

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

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

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

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

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

Для управління категоріями продуктів ознайомтеся з даними на сторінці.

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

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

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

Import company products

post

Import company products

Authorizations

jwt

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Internal identifier

Example: 569e7427-14ca-43f1-8d4b-ed3b7f1fd197

Bodyobject[]

application/json

skustringRequiredExample: 0000040367

slugstringOptional

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.

unitstringRequiredExample: caps.

barcodesstring[]OptionalExample: ["3420168800030"]

volumestringOptional

productFormstring · max: 255OptionalExample: liquid

brandstring · max: 255OptionalExample: Roshen

countryOfOriginstring · max: 255OptionalExample: Ukraine

Responses

202

Accepted

application/json

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

post

/v1/merchant/companies/{id}/import/product

HTTPcURLJavaScriptPython

POST /v1/merchant/companies/{id}/import/product HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 506

[
  {
    "sku": "0000040367",
    "slug": "creamy-pumpkin-soup",
    "title": "Creamy Pumpkin Soup",
    "description": "Made with roasted squash, coconut milk and curry spices, it's healthy, comforting and delicious. Vegan.",
    "categories": {
      "mainExternalId": "66742",
      "extraExternalIds": [
        "23456",
        "77280"
      ]
    },
    "media": {
      "main": "https://example.com/berry-main.png",
      "extra": [
        "https://example.com/berry-extra.png"
      ]
    },
    "unit": "caps.",
    "barcodes": [
      "3420168800030"
    ],
    "volume": "30",
    "productForm": "liquid",
    "brand": "Roshen",
    "countryOfOrigin": "Ukraine"
  }
]

{
  "id": "62a718ef7706fa4aab180bf2"
}

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

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

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

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

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

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

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

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

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

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

Поле sortOrder має сортування по ASC. Тобто 0 буде мати найбільшу вагу, такі пропозиції будуть відображатися найвище на вітрині.

Import offers

post

Import offers

Authorizations

jwt

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

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

/v1/merchant/import/offers

HTTPcURLJavaScriptPython

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

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

{
  "id": "62a718ef7706fa4aab180bf2"
}