Ця стаття також доступна на:

Вебхук: автоматична передача ваших цін з Pricer24

Вебхук дозволяє автоматично передавати змінені ціни ваших товарів із Pricer24 безпосередньо у вашу систему (сайт, CMS, ERP чи модуль ціноутворення).

Замість постійного опитування API ваша система пасивно очікує вхідні HTTP POST-сповіщення при зміні даних.

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

Фіксація змін: коли в Pricer24 перераховується або змінюється ціна товару (наприклад, за результатами виконання Динамічного ціноутворення або ручного редагування), запис додається в чергу відправки.
Пакетизація: службовий процес раз на 2 хвилини формує пакети до 100 змін у кожному.
POST-запит: система надсилає HTTP/HTTPS POST-запит із пакетом змін на попередньо узгоджену адресу (endpoint) вашого сервера.
Підтвердження (200 OK):
- Якщо ваш сервер відповів HTTP-статусом 200 OK, зміни вважаються успішно доставленими, і черга переходить до наступного пакета.
- Якщо ваш сервер повернув код помилки (наприклад, 500, 502) або не відповів протягом 60 секунд, відправка зупиняється. При наступному циклі (через 2 хвилини) той самий пакет надсилається повторно до успішного отримання 200 OK.

Ваш endpoint повинен повертати HTTP 200 якомога швидше (до 5 секунд). Тривала обробка може призвести до тайм-ауту та повторної відправки тих самих даних.

Формат запиту (Контракт)

Pricer24 відправляє запит із тілом у форматі JSON:

{
  "secret": "your_webhook_secret_key",
  "data": [
    {
      "entityType": "ProductPrice",
      "entityId": "019bfb55-bf56-7100-9dd5-7346a86d6353_24c7164d-050b-4891-908b-58e61fc58400",
      "entity": {
        "externalId": "420087",
        "priceTypeId": "24c7164d-050b-4891-908b-58e61fc58400",
        "price": 1249.00,
        "currencyId": "UAH"
      }
    },
    {
      "entityType": "ProductPrice",
      "entityId": "019bfb55-bf5b-7005-baef-8ade15664fce_24c7164d-050b-4891-908b-58e61fc58400",
      "entity": {
        "externalId": "409725",
        "priceTypeId": "24c7164d-050b-4891-908b-58e61fc58400",
        "price": null,
        "currencyId": null
      }
    }
  ]
}

Опис полів

secret — секретний рядок (токен), узгоджений під час підключення. Ваш сервер повинен перевіряти це значення, щоб переконатися, що запит надійшов саме від Pricer24.
data[] — масив змін:
- entityType — тип зміненої сутності (для цін використовується ProductPrice).
- entityId — унікальний складений ідентифікатор запису в Pricer24.
- entity — об'єкт з детальною інформацією про ціну:
- - externalId — ідентифікатор товару у вашій обліковій системі (значення id з вашого фіду каталогу);
  - priceTypeId — внутрішній ID типу ціни в Pricer24;
  - price — нове числове значення ціни. Якщо значення null — ціну було видалено або скасовано;
  - currencyId — трилітерний код валюти (UAH, EUR, USD) або null.

Безпека та валідація

Використовуйте тільки захищений протокол HTTPS для вашого endpoint.
При отриманні запиту обов'язково перевіряйте співпадіння поля secret:
- Якщо секретний ключ не збігається, повертайте 401 Unauthorized або 403 Forbidden.
- Якщо ключ вірний — записуйте зміни у внутрішню чергу своєї системи та негайно відповідайте 200 OK.

Як підключити вебхук

Реалізуйте на своєму сервері endpoint (наприклад, https://api.myshop.ua/webhooks/pricer24), що приймає POST-запити за описаним контрактом.
Згенеруйте секретний рядок (secret key).
Надішліть URL вашого endpoint та ключ secret вашому менеджеру або на support@pricer24.com.
Ми надішлемо тестовий запит для перевірки з'єднання та активуємо службу відправки.

Що далі

Дізнайтеся, як налаштувати автоматичний перерахунок цін, у статті Синтаксис скриптів
Якщо вам потрібен періодичний забір усіх цін за розкладом замість миттєвих пуш-повідомлень, скористайтеся Фід цін контрагентів або Робота з API

Оновлено: 04/11/2026

Чи була ця стаття корисною?

Дякуємо!