Синхронізація цін та наявності вашого сайту з Pricer24
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 (щоб ви могли бути впевнені, що запити надходять саме від нас).
Об’єкт 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
Дякуємо!