QUINCEFIN
Відкрити меню

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

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

МетодОпис
/api/v2/price/listОтримання списку цін
/api/v2/price/addСтворення цін
/api/v2/price/updateОновлення цін

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

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

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

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

ПолеТипОпис
filterobjectНеобов’язковий фільтр. Поля фільтра працюють з логікою AND.
filter.PriceTypearrayІдентифікатори типів цін. Має бути масивом.
filter.ProductarrayІдентифікатори товарів або послуг. Має бути масивом, максимум 400 елементів.
filter.DatestringДата, на яку треба отримати ціни. Формат: yyyy-mm-dd. Якщо не передати, використовується поточна дата.
filter.MobileAppbooleanЯкщо true, API використовує збільшений ліміт вибірки.
pageintegerНомер сторінки. Якщо не передати, використовується перша сторінка.

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

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

ПолеОпис
IdІдентифікатор ціни.
DateДата початку дії ціни.
PriceTypeІдентифікатор типу ціни.
ProductІдентифікатор товару або послуги.
PriceЗначення ціни.
CurrencyКод валюти.

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

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

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

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

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

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

ПолеОпис
arrayМасив цін. Обов’язковий.
array[].ProductІдентифікатор товару або послуги. Обов’язковий.
array[].PriceTypeІдентифікатор типу ціни. Обов’язковий.
array[].DateДата початку дії ціни у форматі yyyy-mm-dd. Обов’язкова.
array[].PriceЗначення ціни. Обов’язкове.

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

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

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

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

Якщо переданий Id не знайдено, пакет не оновлюється і API повертає перелік не знайдених ідентифікаторів.

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

ПолеОпис
arrayМасив цін. Обов’язковий.
array[].IdІдентифікатор ціни. Обов’язковий.
array[].DateДата початку дії ціни. Якщо не передати, використовується поточна дата й час.
array[].PriceЗначення ціни. Обов’язкове.

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

ПолеОпис
arrayМасив цін. Обов’язковий.
array[].ProductІдентифікатор товару або послуги. Обов’язковий.
array[].PriceTypeІдентифікатор типу ціни. Обов’язковий.
array[].DateДата початку дії ціни у форматі yyyy-mm-dd.
array[].PriceЗначення ціни. Обов’язкове.

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

ПолеОпис
successtrue або false.
dataМасив ідентифікаторів створених або оновлених цін.
errorКод і текст помилки, якщо success = false.