Вступ

Якщо ви хочете завантажувати в свою систему інформацію про ціни на товари, найзручніше використовувати GET-метод products.

Метод підтримує «пагінацію»
За замовчуванням метод віддає лише активні товари
Приклад запиту: GET https://api.pricer24.com/v1/products?Include=...&MaxResultCount={PageSize}&SkipCount={PageSize}*{Page-1}&ApiKey={key}

Параметри

Інформація про всі доступні query-параметри міститься у Swagger
Доступні Include параметри: Availability, Category, Prices, ContractorsPrices,Tags

На даний момент існує ще один параметр ContractorPrices (без "s" після Contractor). Використовувати його не рекомендовано, так як він буде видалений у майбутньому

Опис відповіді

Масив items містить інформацію про ваші товари:
id – код товару Pricer24
externalId – код товару в системі клієнта (по цьому полю ви можете синхронізовати дані з вашою обліковою системою)
name – назва товару
vendor – виробник товару
vendorCode – артикул товару
link – посилання на товар
barcode – штрих-код товару
stateId – код статусу товару (1 – активний, 2 – архівний)
availability – об’єкт із інформацією про наявність товару (для отримання необхідно запитати в Include)
category – об’єкт із інформацією про категорію товару (для отримання необхідно запитати в Include)
prices – масив з моїми цінами (для отримання необхідно задати в Include)
contractorsPrices – масив із цінами контрагентів (для отримання необхідно задати в Include)
tags – масив з тегами товару (для отримання необхідно задати в Include)

Масив Prices

Масив prices містить об’єкти з інформацією про ваші ціни на ваш товар:

price – ціна
currencyId – валюта ціни
priceType – інформація про мою ціну

Об’єкт priceType:
id – код типу ціни товару Pricer24
name – назва ціни

Масив ContractorsPrices

Ціни віддаються лише за активними товарами

Масив contractorsPrices містить об’єкти з інформацією про ціни контрагентів на ваш товар:

name – назва товару у контрагента (як він називається на сайті або у прайс-листі)
isAvail – флаг: товар в наявності чи ні
url – посилання на товар
parsedOn – дата та час у UTC, коли інформацію про товар було зібрано
contractor – об’єкт з інформацією про контрагента
prices – масив із цінами товару
avails – масив із наявністю товару

Об’єкт Сontractor

name – назва контрагента
externalId – код товару в системі клієнта (по цьому полю ви можете синхронізувати дані з вашою обліковою системою)
id – код контрагента Pricer24

Об’єкт масиву Prices

price – ціна
currency – валюта ціни
ext – об’єкт із розширеною інформацією про ціну
priceType – інформація про ціну контрагента

Об’єкт priceType:
code – код ціни контрагента
name – назва ціни контрагента
priceSetId – код "Групи цін" Pricer24
id – код ціни контрагента Pricer24

Об’єкт масиву Avails

avail – текстова наявність на складі (як вона відображається у контрагента)
isAvail – флаг: товар в наявності на цьому складі чи ні
warehouse – інформація про склад контрагента

Об’єкт warehouse:
code – код складу контрагента
name – назва складу контрагента
id – код складу контрагента Pricer24

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

Приклад запиту для отримання перших 100 товарів з моїми цінами і цінами контрагентів:
GET https://api.pricer24.com/v1/products?Include=Prices,ContractosPrices&MaxResultCount=100&SkipCount=0&ApiKey={key}

Оновлено: 28/08/2024