Введение

Если вы хотите загружать в свою систему информацию о ценах на товары, удобнее всего использовать 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