Синхронизация цен и наличия вашего сайта с Pricer24
Pricer24 имеет функционал, позволяющий уведомлять вашу систему об изменении цены или наличия товара.
Для подключения услуги, Вам необходимо реализовать end-point, который будет обрабатывать запросы от Pricer24 и сообщить его адрес в нашу тех. поддержку.
При изменении цены или наличия в Pricer24, система добавляет информацию об этом в очередь.
По-умолчанию раз в 2 минуты запускается служба, которая группирует изменения по 100 штук и последовательно отправляет POST-запросы на end-point по протоколу HTTP/HTTPS.
При получении кода ответа 200, изменения помечаются как обработанные и система отправляет следующий пакет с изменениям. В противном случае служба прерывается и при следующем запуске изменения будут отправлены повторно, и так до тех пор пока код ответа не будет 200.
Лимит на обработку запроса - 1 минута, после чего служба будет остановлена, а обработка запроса будет считаться неуспешной.
Запросы формируются не только при изменении цены, но и при изменении любого свойства товара, например, названия или тегов.
Система формирует и отправляет POST-запросы на ваш end-point.
Пример запроса:
Информация об изменениях содержится в массиве Data.
EntityType - тип объекта, который был изменен
EntityId - код объекта (товара) в системе клиента
Entity - информация о самом объекте (товаре)
Secret - секретный ключ, для того, чтобы можно было валидировать запросы, которые принимает ваш end-point (чтобы быть уверенным, что запросы от нас).
В данной статье мы рассматриваем исключительно запросы для объекта product (товар)
Id - код товара в Pricer24
ExternalId - код товара в системе клиента
Name - название товара
Availability - наличие товара
Tags - массив тегов товара
Prices - массив цен товара
Id - код наличия в Pricer24
UnifiedName - псевдоним наличия
IsAvailable - товар в наличии или нет
Id - Код тега в Pricer24
UnifiedName - псевдоним тега
Color - цвет тега в формате HEX
Id - код типа цены в Pricer24
Name - название типа цены в Pricer24
UnifiedName - псевдоним типа цены
IsMain - является ли тип цены основным
Price - цена (nullable)
Currency - ISO-код валюты цены (nullable)
Для подключения услуги, Вам необходимо реализовать 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
Спасибо!