> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pricer24.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Автоматична передача цін з Pricer24 на ваш сайт

Pricer24 має функціонал, що дозволяє повідомити вашу систему про зміну ціни чи наявності товару.

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

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

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

# Контракт

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

Приклад запиту:

```json
{
	"secret": "secret",
	"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,
				"currencyId": "UAH"
			}
		},
		{
			"entityType": "ProductPrice",
			"entityId": "019bfb55-bf57-7773-ae14-1be7cabfea28_24c7164d-050b-4891-908b-58e61fc58400",
			"entity": {
				"externalId": "420085",
				"priceTypeId": "24c7164d-050b-4891-908b-58e61fc58400",
				"price": 349,
				"currencyId": "UAH"
			}
		},
		{
			"entityType": "ProductPrice",
			"entityId": "019bfb55-bf59-726f-84f5-04eea8cb8acf_24c7164d-050b-4891-908b-58e61fc58400",
			"entity": {
				"externalId": "412464",
				"priceTypeId": "24c7164d-050b-4891-908b-58e61fc58400",
				"price": 699,
				"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
			}
		}
	]
}
```

Інформація про зміни міститься у масиві **data**.
* **entityType **– тип об’єкту, що був змінений
* **entityId** – код об’єкту в Pricer24
* **entity** – інформація про сам об’єкт

**secret** – секретний ключ, який потрібен, щоб можна було валідувати запити, які приймає ваш end-point (щоб ви могли бути впевнені, що запити надходять саме від нас).

|| У цій статті ми розглядаємо виключно запити для об'єкту ProductPrice (ціна товару)

### Об’єкт Entity
* **externalId** – код товару в вашій системі
* **priceTypeId** – внутрішній Id типу ціни в Pricer24
* **price** – ціна (nullable)
* **currencyId** – ISO-код валюти ціни (nullable)