Цей документ містить повні технічні вимоги до структури JSON-файлу для передачі вашого каталогу товарів у систему Pricer24.

Загальні принципи роботи з каталогом, способи передачі та підтримувані протоколи описані у статті Передача каталогу: загальні принципи.

Загальні технічні вимоги

• Формат даних: валідний JSON у кодуванні UTF-8
• Спосіб передачі: пряме постійне посилання (URL) на файл через протокол HTTPS/HTTP (за потреби — з Basic Auth або обмеженням за IP)
• Стиснення: необов'язкове; для великих файлів (> 10 000 позицій) рекомендується gzip (.json.gz)
• Обсяг файлу: без обмежень на кількість товарів чи розмір
• Повнота: фід має містити повний актуальний зріз каталогу на момент формування

Повний приклад структури JSON-фіду

{
  "categories": [
    { "id": "1000", "parent_id": null, "name": "Бакалія" },
    { "id": "1001", "parent_id": "1000", "name": "Кондитерські вироби" },
    { "id": "1002", "parent_id": "1001", "name": "Цукерки" }
  ],
  "price_types": [
    { "id": "1", "name": "Роздрібна ціна" },
    { "id": "2", "name": "Акційна ціна" },
    { "id": "3", "name": "РРЦ" },
    { "id": "4", "name": "Онлайн" }
  ],
  "properties": [
    { "id": "weight", "name": "Вага (кг)", "type": "decimal" },
    { "id": "stock", "name": "Залишок на складі", "type": "int" },
    { "id": "follow_rrp", "name": "Чи контролюємо РРЦ", "type": "bool" },
    { "id": "category_manager", "name": "Категорійний менеджер", "type": "string" }
  ],
  "products": [
    {
      "id": "153",
      "category_id": "1002",
      "name": "Цукерки Konti 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": true,
      "prices": [
        { "price_type_id": "1", "price": 189.90, "currency": "UAH" },
        { "price_type_id": "2", "price": 169.00, "currency": "UAH" }
      ],
      "properties": {
        "weight": 0.500,
        "stock": 25,
        "follow_rrp": true,
        "category_manager": "Олена Шевченко"
      }
    },
    {
      "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": false,
      "prices": [
        { "price_type_id": "1", "price": 49.50, "currency": "UAH" }
      ],
      "properties": {
        "weight": 0.100,
        "stock": 0,
        "follow_rrp": false,
        "category_manager": "Олена Шевченко"
      }
    }
  ]
}

Структура кореневого об'єкта

На верхньому рівні JSON складається з 4 масивів:

1. categories — довідник ієрархії категорій
2. price_types — довідник типів ваших цін
3. properties — декларація кастомних характеристик товарів
4. products — основний масив ваших товарів

1. Масив категорій: categories[]

Передає повну ієрархію категорій вашого магазину. Глибина вкладеності не обмежується. Зв'язок задається через parent_id.

"categories": [
  { "id": "100", "parent_id": null, "name": "Побутова техніка" },
  { "id": "110", "parent_id": "100", "name": "Техніка для кухні" },
  { "id": "112", "parent_id": "110", "name": "Кавомашини" }
]

2. Масив типів цін: price_types[]

Визначає типи цін, які ви передаєте в Pricer24: роздрібні, акційні, РРЦ, ціни окремих міст, каналів продажу тощо.

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

3. Масив додаткових властивостей: properties[]

Оголошує кастомні поля товарів, яких немає у стандартній структурі (залишки, собівартість, менеджер, габарити тощо). Усі оголошені поля можна виводити у звіти та використовувати у формулах ціноутворення.

"properties": [
  { "id": "stock", "name": "Залишок", "type": "int" },
  { "id": "cost_price", "name": "Собівартість", "type": "decimal" },
  { "id": "is_exclusive", "name": "Ексклюзивний товар", "type": "bool" },
  { "id": "brand_country", "name": "Країна бренду", "type": "string" }
]

• Усі передані параметри автоматично відображаються в інтерфейсі платформи. Детальніше про те, як працювати з ними в кабінеті, читайте в інструкції Створення та редагування товарів.
• За цими характеристиками та тегами ви зможете групувати асортимент, будувати фільтри в звітах та налаштовувати сегменти. Детальніше див. статтю Теги товарів.

4. Масив товарів: products[]

Містить повний список ваших товарів та їхніх атрибутів.

Масив цін товару: products[].prices[]

Кожна ціна товару повинна посилатися на відповідний price_type_id із довідника price_types[]:

"prices": [
  { "price_type_id": "1", "price": 1250.00, "currency": "UAH" },
  { "price_type_id": "2", "price": 999.00, "currency": "UAH" }
]

Об'єкт властивостей товару: products[].properties{}

Містить значення оголошених у масиві properties[] характеристик:

"properties": {
  "stock": 14,
  "cost_price": 750.50,
  "is_exclusive": true,
  "brand_country": "Німеччина"
}

Поле availability (наявність)

Поле підтримує будь-який зручний формат із зазначених:

Що далі

• Передайте готовий URL фіду вашому персональному менеджеру або на support@pricer24.com
• Дізнайтеся, як забирати зібрані ціни конкурентів у вашу систему через Фід цін контрагентів або REST API

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