> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pricer24.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Отримання цін на товари

# Вступ

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

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

# Параметри

* Інформація про всі доступні query-параметри міститься у [Swagger](https://api.pricer24.com/swagger/index.html)
* Доступні 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** містить об’єкти з інформацією про ваші ціни на ваш товар:
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_qw7g5t.png)
* **price** – ціна
* **currencyId** – валюта ціни
* **priceType** – інформація про мою ціну

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

### Масив ContractorsPrices

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

Масив **contractorsPrices** містить об’єкти з інформацією про ціни контрагентів на ваш товар:
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_1yr6hc9.png)
* **name** – назва товару у контрагента (як він називається на сайті або у прайс-листі)
* **isAvail** – флаг: товар в наявності чи ні
* **url** – посилання на товар
* **parsedOn** – дата та час у UTC, коли інформацію про товар було зібрано
* **contractor** – об’єкт з інформацією про контрагента
* **prices** – масив із цінами товару
* **avails** – масив із наявністю товару

###### Об’єкт Сontractor
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_1m1rv6n.png)
* **name** – назва контрагента
* **externalId** – код товару в системі клієнта (по цьому полю ви можете синхронізувати дані з вашою обліковою системою)
* **id** – код контрагента Pricer24

###### Об’єкт масиву Prices
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_a7w5bq.png)
* **price** – ціна
* **currency** – валюта ціни
* **ext** – об’єкт із розширеною інформацією про ціну
* **priceType** – інформація про ціну контрагента

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

###### Об’єкт масиву Avails
![](https://storage.crisp.chat/users/helpdesk/website/c264ea040288d800/image_cvokzg.png)
* **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}`