Статьи по теме: Разработчикам
Эта статья также доступна на:

Синхронизация цен и наличия вашего сайта с Pricer24

Pricer24 имеет функционал, позволяющий уведомлять вашу систему об изменении цены или наличия товара.



Для подключения услуги, Вам необходимо реализовать end-point, который будет обрабатывать запросы от Pricer24 и сообщить его адрес в нашу тех. поддержку.



Принцип работы


  • При изменении цены или наличия в Pricer24, система добавляет информацию об этом в очередь.
  • По-умолчанию раз в 2 минуты запускается служба, которая группирует изменения по 100 штук и последовательно отправляет POST-запросы на end-point по протоколу HTTP/HTTPS.
  • При получении кода ответа 200, изменения помечаются как обработанные и система отправляет следующий пакет с изменениям. В противном случае служба прерывается и при следующем запуске изменения будут отправлены повторно, и так до тех пор пока код ответа не будет 200.
  • Лимит на обработку запроса - 1 минута, после чего служба будет остановлена, а обработка запроса будет считаться неуспешной.



Запросы формируются не только при изменении цены, но и при изменении любого свойства товара, например, названия или тегов.


Контракт

Система формирует и отправляет POST-запросы на ваш end-point.


Пример запроса:

{
"Data": [
{
"EntityType": "product",
"EntityId": "273555",
"Entity": {
"Id": "2db16c12-40a6-4e6c-848d-0f139bd8ef54",
"ExternalId": "273555",
"Name": "1stPlayer B7-R1 Color LED без БП Black",
"Availability": {
"Id": "eda9817f-9c2a-4aa1-9caa-5a12fa90cfcc",
"UnifiedName": "in_stock",
"IsAvailable": true
},
"Tags": [
{
"Id": "de71e492-b4dd-4d97-b88a-372358a1ed8f",
"Name": "new",
"Color": "#000000"
}
],
"Prices": [
{
"Id": "500aea54-e841-4778-9777-9c2b39236291",
"Name": "Главная",
"UnifiedName": "price",
"IsMain": true,
"Price": 1328.0,
"Currency": "UAH"
},
{
"Id": "1bd3c67f-de03-482b-a507-b852053000dd",
"Name": "TEST_PRICE",
"UnifiedName": "test",
"IsMain": false,
"Price": 52.0,
"Currency": "USD"
}
]
}
}
],
"Secret": ""
}


Информация об изменениях содержится в массиве Data.

  • EntityType - тип объекта, который был изменен
  • EntityId - код объекта (товара) в системе клиента
  • Entity - информация о самом объекте (товаре)


Secret - секретный ключ, для того, чтобы можно было валидировать запросы, которые принимает ваш end-point (чтобы быть уверенным, что запросы от нас).


В данной статье мы рассматриваем исключительно запросы для объекта product (товар)


Объект Entity

  • Id - код товара в Pricer24
  • ExternalId - код товара в системе клиента
  • **Name **- название товара
  • **Availability **- наличие товара
  • **Tags **- массив тегов товара
  • Prices - массив цен товара



Объект Availability
  • Id - код наличия в Pricer24
  • UnifiedName - псевдоним наличия
  • IsAvailable - товар в наличии или нет



Объект Tag
  • Id - Код тега в Pricer24
  • UnifiedName - псевдоним тега
  • **Color **- цвет тега в формате HEX



Объект Price
  • Id - код типа цены в Pricer24
  • **Name **- название типа цены в Pricer24
  • UnifiedName - псевдоним типа цены
  • **IsMain **- является ли тип цены основным
  • Price - цена (nullable)
  • Currency - ISO-код валюты цены (nullable)





Последнее изменение: 28/08/2024

Была ли эта статья полезна?

Поделиться отзывом

Отменить

Спасибо!