Додаткові ціни через API

Додаткові ціни - це типи цін, які компанія створює самостійно в Skynum. API дозволяє читати їх, щоб зовнішня система могла правильно передавати або інтерпретувати custom_prices у товарах.

Повʼязані інструкції:

• Додаткові ціни;
• Товари через API.

Endpoint-и

Метод	Endpoint	Призначення
GET	/v1/custom_prices	отримати список додаткових цін
GET	/v1/custom_prices/:id	отримати одну додаткову ціну

Створення, оновлення й видалення додаткових цін через API V1 не описані.

Поля у відповіді

Поле	Призначення
id	ID додаткової ціни.
title	Назва ціни.
code	Код ціни.
created_at	Дата створення.
updated_at	Дата оновлення.

Як використовувати з товарами

У ресурсі товарів додаткові ціни передаються в полі custom_prices.

{
  "product": {
    "custom_prices": {
      "custom-price-id": 2300
    }
  }
}

Ключем є id додаткової ціни, значенням - ціна товару.

інформація

Системні ціни Skynum - це price_supply, price_retail, price_wholesale, price_min, price_old. Усі інші ціни, створені компанією, є додатковими й передаються через custom_prices.

Чеклист

Перед синхронізацією додаткових цін перевірте:

• які додаткові ціни створені в компанії;
• які з них потрібні зовнішній системі;
• чи зберігає інтеграція id ціни, а не тільки її назву;
• що робити, якщо додаткову ціну перейменували;
• як інтеграція обробляє відсутнє значення ціни в товарі.

Підсумок

API додаткових цін потрібен для правильної роботи з custom_prices у товарах. Самі значення цін товару передаються через Товари через API.