Отримання цін на товари
Вступ
Якщо ви хочете завантажувати в свою систему інформацію про ціни на товари, найзручніше використовувати 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
Опис відповіді
Масив 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
Дякуємо!