Import categories

Імпорт категорій окремим запитом

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

• externalId – ідентифікатор вашої категорії

• name – назва категорії

• position – порядок, у якому категорія відображається на вітрині

• parentExternalId – ідентифікатор батьківської категорії

• workSchedule – графік доступності товарів категорії на вітрині. Може мати лише один із двох параметрів: dailyWorkingHours або weeklyWorkingHours.

  • dailyWorkingHours – години доступності товарів категорії у визначені дні тижня:

    • weekDay – день тижня;

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

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

  • weeklyWorkingHours – години, у які товари категорії доступні щодня:

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

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

  • start – дата початку роботи категорії;

  • end – дата завершення роботи категорії.

  *start та end використовуються лише разом із weeklyWorkingHours.

Щоб мати змогу імпортувати категорії, зверніться до свого акаунт-менеджера — він надасть необхідні права доступу.

Import company categories

post

Import company categories

Authorizations

Path parameters

idstring · uuidRequired

Internal identifier

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

Body

externalIdstringRequiredExample: 1234ABCD

namestringRequiredExample: Burgers

positioninteger | nullableRequiredExample: 1

parentExternalIdstring | nullableOptionalExample: 1234ABCD

Responses

202

Accepted

application/json

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

post

HTTPcURLJavaScriptPython

POST /v1/merchant/companies/{id}/import/categories HTTP/1.1
Host: 
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 466

[
  {
    "externalId": "66742",
    "name": "Burgers",
    "position": 1,
    "parentExternalId": null
  },
  {
    "externalId": "23456",
    "name": "Salads",
    "position": 2,
    "parentExternalId": null
  },
  {
    "externalId": "77280",
    "name": "Soups",
    "position": 3,
    "parentExternalId": null
  },
  {
    "externalId": "68510",
    "name": "Cream soups",
    "position": 1,
    "parentExternalId": "77280"
  },
  {
    "externalId": "11490",
    "name": "Broth",
    "position": 2,
    "parentExternalId": "77280"
  },
  {
    "externalId": "78901",
    "name": "Vegan",
    "position": 4,
    "parentExternalId": null
  }
]

{
  "id": "62a718ef7706fa4aab180bf2"
}