Специфікація фіду даних для синхронізації з вашим каталогом товарів.

1. Призначення документа

Цей документ описує технічні вимоги до JSON-фіду Pricer24. Загальні принципи роботи з фідами та підтримувані формати описані в окремому матеріалі — «Фіди даних Pricer24: загальні принципи та підтримувані формати».

2. Спосіб передачі даних

Протокол та метод

Ви надаєте URL фіду, а Pricer24 регулярно завантажує файл за цим посиланням методом GET.

Аутентифікація.

URL фіду може бути відкритим або захищеним. За потреби ви можете обмежити доступ за IP-адресами Pricer24, через Basic Authentication або обома способами одночасно.

3. Формат файлу

Новий фід не додається до попереднього, а повністю замінює його як поточний стан каталогу.

Новий фід повністю визначає, які товари вважаються актуальними на даний момент..

4. Структура фіду

На верхньому рівні JSON-фід складається з трьох масивів: категорій, типів цін і товарів.

• categories: структура категорій товарів
• price_types: довідник типів цін 
• products: детальний каталог товарів

{
"categories": [ ... ],
"price_types": [ ... ],
"products": [ ... ]
}

Масив categories[ ]:

Масив categories[ ] потрібен для передачі всіх товарних категорій у тій ієрархії, у якій вони існують у вашому каталозі, наприклад: Корм для тварин > Корм для котів > Сухий корм для котів > … 

Глибина вкладеності - як у вашому власному каталогу.

Зв’язок між категоріями різних рівнів задається через parent_id.

Формат даних масиву categories[ ]:

Приклад масиву categories[ ]:

"categories": 
[
  { "id": "1000", "parent_id": null, "name": "Бакалея" },
  { "id": "1001", "parent_id": "1000", "name": "Кондитерські вироби" },
  { "id": "1002", "parent_id": "1001", "name": "Торти" },
    ...
    ...
  { "id": "100Х", "parent_id": "100(Х-1)", "name": "Каштан"},
  { "id": "100(Х+1)", "parent_id": "100Х", "name": "Каштан 500 г пластик" }
]

Масив price_types[ ]:

У масиві price_types[ ] ви визначаєте, які саме ціни будуть передаватися для кожного товару.

Це можуть бути як типи цін, так і окремі торгові точки або канали продажу - залежно від того, у якому розрізі ви передаєте ціни. 

Наприклад:

• роздрібна
• рекомендована роздрібна
• акційна
• оптова 
• закупівельна
• перелік всіх цін товару по торгових точках.

Формат даних масиву price_types[ ]:

Приклади масиву price_types[ ]:

[ { "id": "1", "name": "Моя ціна" } ]

[ { "id": "1", "name": "Роздрібна ціна" }, 
  { "id": "2", "name": "Акційна ціна" }, 
  { "id": "3", "name": "РРЦ" } ]

[ { "id": "XXXX", "name": "Магазин Харків" }, `
  { "id": "YYYY", "name": "Онлайн" } ]

Масив products[ ]:

Масив products[ ] є основною частиною фіду: саме тут передаються товари, їх характеристики та ціни.

Формат даних масиву products[ ]:

Саме за id система визначає, чи потрібно оновити існуючий запис, чи створити новий.

У товара може змінитися назва, наприклад:

• Samsung Galaxy -> Samsung Galaxy Black 128 Gb
• Purina Pro Adult turkey 85g -> Корм для дорослих котів Purina Pro з індичкою 85г. 

але id , який визначає суть товару чи категорії, має залишитися тим же самим.

Масив prices[ ] всередині масиву products[ ]:

У масиві products.prices[ ] передаються конкретні значення цін товару.

Кожен елемент цього масиву посилається на одну з цінових категорій, описаних у кореневому масиві price_types[ ].

Спочатку ви описуєте всі цінові категорії в основному масиві price_types[ ] **, а потім у кожному товарі (у **products.prices[ ]) передаєте ціни з посиланням на відповідний id з довідника price_types[ ].

products.prices.price_type_id <- price_types.id

Формат даних масиву products.prices[ ]:

Поле availability - правила передачі

Ви можете передавати availability у тому вигляді, у якому це зберігається у вашій системі, наприклад:

Повний приклад фіду

 {
  "categories": [
    { "id": "1000", "parent_id": null, "name": "Бакалея" },
    { "id": "1001", "parent_id": "1000", "name": "Кондитерські вироби" },
    { "id": "1002", "parent_id": "1001", "name": "Цукерки" }
  ],
  "price_types": [
    { "id": "1", "name": "Магазин Київ 1" },
    { "id": "2", "name": "Магазин Київ 2" },
    { "id": "3", "name": "Магазин Харків 1" },
    { "id": "4", "name": "Онлайн" }
  ],
  "products": [
    {
      "id": "153",
      "category_id": "1002",
      "name": "Цукерки Bonjour Десерт 500г",
      "vendor": "Konti",
      "vendor_code": "08013914",       
      "barcode": "4820000356848",
      "link": "https://example.com/products/konti-bonjour-dessert-500",
      "image_link": "https://example.com/products/konti-bonjour-dessert-500.jpg",
      "availability": "+",
      "prices": [
        		{ "price_type_id": "1", "price": 189.90, "currency": "UAH" },
        		{ "price_type_id": "2", "price": 189, "currency": "UAH" }
      ],
    },
    {
      "id": "154",
      "category_id": "1002",
      "name": "Шоколад Milka Oreo 100г",
      "vendor": "Milka",
      "vendor_code": "7622210578266",
      "barcode": "7622210951182",
      "link": "https://example.com/products/milka-oreo-100",
      "image_link": "https://example.com/products/milka-oreo-100.jpg",
      "availability": "-",
      "prices": [
      ]
    }
  ]
}

Оновлено: 05/05/2026