Статті на: Розробникам
Ця стаття також доступна на:

Отримання цін контрагентів через фід

Фід «Ціни контрагентів» передає актуальні ціни та наявність ваших товарів у магазинах конкурентів (контрагентів), з якими вони зіставлені у системі Pricer24.


Загальні принципи роботи з готовими фідами описані у статті Робота з готовими фідами.


Варіанти фіду: Lite та Extended


Фід надається у двох варіантах залежно від глибини необхідних даних:

  • Lite — полегшений файл: містить лише ціну, наявність та посилання на товар у кожного конкурента. Ідеально підходить для швидкої регулярної синхронізації з 1С / BAS або ERP.
  • Extended — розширений файл: окрім цін, містить назву товару у конкурента, рейтинг, кількість відгуків, позицію в категорії, акційні мітки та додаткові характеристики.



Приклад фіду (Lite)


[
  {
    "externalId": "10221",
    "offers": [
      {
        "contractor": "Rozetka",
        "url": "https://rozetka.com.ua/item/10221/",
        "lastParsedOn": "2026-11-03 10:15:30",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 922.00, "currency": "UAH" },
          { "priceType": "price_old", "priceSet": "competitors_old", "price": 1049.00, "currency": "UAH" }
        ]
      },
      {
        "contractor": "Comfy",
        "url": "https://comfy.ua/item/a-10221",
        "lastParsedOn": "2026-11-03 09:40:12",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 899.00, "currency": "UAH" }
        ]
      }
    ]
  }
]



Приклад фіду (Extended)


[
  {
    "externalId": "10221",
    "name": "Наповнювач Trixie Simple and Clean силікагель 8 л",
    "availability": "in_stock",
    "offers": [
      {
        "contractor": "Rozetka",
        "name": "Наповнювач для котячого туалету Trixie Simple'n'Clean силікагель 8 л",
        "feedbackCount": 14,
        "rating": 4.8,
        "position": 12,
        "promo": "Безкоштовна доставка",
        "properties": { "delivery": "Самовивіз, Нова Пошта", "payment_parts": true },
        "imageUrl": "https://rozetka.com.ua/images/10221.jpg",
        "url": "https://rozetka.com.ua/item/10221/",
        "lastParsedOn": "2026-11-03 10:15:30",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 922.00, "currency": "UAH" }
        ]
      },
      {
        "contractor": "Epicentr",
        "name": "Trixie Simple&Clean 8 л",
        "feedbackCount": null,
        "rating": null,
        "position": null,
        "promo": null,
        "properties": null,
        "imageUrl": "https://epicentrk.ua/img/trixie-8l.jpg",
        "url": "https://epicentrk.ua/trixie-8l",
        "lastParsedOn": "2026-11-02 18:20:00",
        "inStock": false,
        "prices": []
      }
    ]
  }
]



Структура полів


Коренем відповіді є масив товарів вашого магазину. У кожному товарі знаходиться масив пропозицій конкурентів (offers), а всередині кожної пропозиції — масив цін (prices).


1. Рівень товару (Product)


Поле

Тип

Lite

Extended

Опис

externalId

string

Так

Так

Код товару у вашій системі (значення id з вашого фіду каталогу).

name

string

—

Так

Назва вашого товару в системі Pricer24.

availability

string

—

Так

Статус наявності вашого товару: in_stock (є в наявності) або not_in_stock (немає).

offers

array

Так

Так

Список зіставлених пропозицій контрагентів.



2. Пропозиція контрагента (offers[])


Поле

Тип

Lite

Extended

Опис

contractor

string

Так

Так

Назва контрагента (магазину конкурента).

url

string

Так

Так

Пряме посилання на сторінку товару на сайті контрагента.

lastParsedOn

string

Так

Так

Дата і час останнього збору пропозиції (YYYY-MM-DD HH:MM:SS) у часовому поясі вашого акаунту.

inStock

boolean

Так

Так

Наявність у конкурента: true — товар у наявності, false — відсутній.

prices

array

Так

Так

Масив цін конкурента. Якщо товару немає в наявності (inStock: false), повертається порожній масив [].

name

string

—

Так

Назва товару так, як вона вказана на сайті конкурента.

imageUrl

string

—

Так

Посилання на зображення товару на сайті конкурента.

rating

number / null

—

Так

Числовий рейтинг товару на сайті конкурента (наприклад, 4.8).

feedbackCount

integer / null

—

Так

Кількість відгуків про товар у конкурента.

position

integer / null

—

Так

Позиція товару у відповідній категорії/видачі конкурента.

promo

string / null

—

Так

Інформація про діючу промо-акцію або подарунок.

properties

object / null

—

Так

Додаткові властивості (умови доставки, оплата частинами тощо).



3. Масив цін (offers[].prices[])


Поле

Тип

Опис

priceSet

string

Код групи цін у вашому акаунті: competitors (поточна ціна), competitors_old (стара/перекреслена ціна), competitors_promo (акційна ціна).

priceType

string

Код типу ціни в обліку контрагента (може відрізнятися для різних сайтів).

price

number

Числове значення ціни.

currency

string

Валюта ціни за стандартом ISO 4217 (UAH, EUR, USD).


Якщо товар у конкурента знятий з продажу або закінчився, масив prices буде порожнім [], оскільки неактуальні цінові пропозиції не виводяться.


Що далі


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

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

Поділіться своїм відгуком

Скасувати

Дякуємо!