QUINCE API. Ціни товарів

Список методів

Отримання списку цін

Назва методу: /api/v2/price/list

Повертає список цін товарів і послуг. Для навігації використовується номер сторінки page. Розмір сторінки фіксований і дорівнює 100 елементам.

Параметри запиту

Якщо filter.Date, filter.PriceType або filter.Product передані в некоректному форматі, API повертає success: false з текстом помилки.

Метод повертає актуальну ціну на дату filter.Date:

• дата початку Date має бути не пізніше дати фільтра;
• DateTo має бути порожньою або не раніше дати фільтра;
• якщо підходить кілька записів, повертається запис із найпізнішою датою початку.

Дата завершення включається в період дії ціни. Прострочені та ще не активні записи до відповіді не потрапляють.

Основні поля відповіді

Приклад запиту

{
  "filter": {
    "PriceType": [110],
    "Product": [204, 205]
  },
  "page": 1
}

Створення цін

Назва методу: /api/v2/price/add

Метод додає ціни пакетами до 100 елементів.

Параметри запиту

Оновлення цін

Назва методу: /api/v2/price/update

Метод оновлює ціни пакетами до 100 елементів. Оновлення можна виконати двома способами:

1. Передати Id ціни.
2. Не передавати Id, але передати комбінацію Product, PriceType і Date. Якщо Date не передати, використовується поточна дата.

Дата DateTo не може бути раніше Date. Поля DateTo і Memo змінюються лише тоді, коли вони явно присутні в об’єкті. Щоб зняти дату завершення або очистити примітку, передайте відповідне поле зі значенням null.

Параметри оновлення за Id

Параметри оновлення за товаром і типом ціни

Приклад тимчасової акційної ціни

{
  "array": [
    {
      "Product": 204,
      "PriceType": 110,
      "Date": "2026-07-06",
      "DateTo": "2026-07-12",
      "Price": 850,
      "Memo": "Літня акція"
    }
  ]
}

Такий запис діє з 6 до 12 липня включно. Після 12 липня API знову повертає попередню активну ціну цього товару й типу ціни, якщо вона є.

Формат відповіді для створення та оновлення