Статті на: Розробникам

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

Призначення


Фід «Ціни контрагентів» передає ціни контрагентів на ваші товари: для кожного вашого товару — пропозиції контрагентів, з якими він зіставлений, їх ціни, наявність і посилання.


Як працюють фіди — у статті Загальна інформація про роботу з фідами.


Фід «Ціни контрагентів» має два варіанти:


  • Lite — показує, за якою ціною і чи є в наявності ваш товар у кожного контрагента. Мінімум полів, легкий файл.
  • Extended — додається додаткова інформація: рейтинг, відгуки, позиція в категорії, картинка і т.д.


Приклад (Lite)


[
  {
    "externalId": "10221",
    "offers": [
      {
        "contractor": "Shop-1.ua",
        "url": "https://shop-1.ua/product/10221",
        "lastParsedOn": "2026-10-23 13:32:03",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 922, "currency": "UAH" },
          { "priceType": "price_old", "priceSet": "competitors_old", "price": 1049, "currency": "UAH" }
        ]
      },
      {
        "contractor": "Shop-2.ua",
        "url": "https://shop-2.ua/item/a-10221",
        "lastParsedOn": "2026-10-23 11:05:47",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 899, "currency": "UAH" }
        ]
      }
    ]
  }
]


Приклад (Extended)


[
  {
    "externalId": "10221",
    "name": "Наповнювач Trixie Simple and Clean силікагель 8 л",
    "availability": "in_stock",
    "offers": [
      {
        "contractor": "Shop-1.ua",
        "name": "Наповнювач для котячого туалету Trixie Simple'n'Clean силікагель 8 л",
        "feedbackCount": 14,
        "rating": 4.8,
        "position": 122,
        "promo": null,
        "properties": null,
        "imageUrl": "https://shop-1.ua/images/10221.jpg",
        "url": "https://shop-1.ua/product/10221",
        "lastParsedOn": "2026-10-23 13:32:03",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 922, "currency": "UAH" }
        ]
      },
      {
        "contractor": "Shop-3.ua",
        "name": "Trixie Simple&Clean 8 л",
        "feedbackCount": null,
        "rating": null,
        "position": null,
        "promo": null,
        "properties": null,
        "imageUrl": "https://shop-3.ua/img/trixie-8l.jpg",
        "url": "https://shop-3.ua/trixie-8l",
        "lastParsedOn": "2026-10-20 09:14:10",
        "inStock": false,
        "prices": []
      }
    ]
  }
]



Структура


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


Товар


Поле

Тип

Lite

Extended

Опис

externalId

string

так

так

Код товару у вашій системі: поле «Код» товару в Pricer24, воно ж id у фіді каталогу

name

string

—

так

Назва вашого товару в Pricer24

availability

string

—

так

Наявність вашого товару: in_stock — в наявності, not_in_stock — немає

offers

array

так

так

Пропозиції контрагентів, зіставлені з цим товаром


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


Поле

Тип

Lite

Extended

Опис

contractor

string

так

так

Назва контрагента

url

string

так

так

Посилання на товар у контрагента

lastParsedOn

string

так

так

Дата й час, коли пропозицію востаннє зібрано, формат YYYY-MM-DD HH:MM:SS. Часова зона - згідно налаштувань вашого акаунта

inStock

bool

так

так

Наявність товару в контрагента: true — в наявності, false — був у наявності, але закінчився

prices

array

так

так

Ціни контрагента. Порожній масив [], якщо товару немає в наявності: ціни для відсутніх товарів не зберігаються

name

string

—

так

Назва товару в контрагента

imageUrl

string

—

так

Посилання на картинку товару в контрагента

rating

number

—

так

Рейтинг товару в контрагента

feedbackCount

int

—

так

Кількість відгуків

position

int

—

так

Позиція товару в категорії контрагента

promo

object

—

так

Інформація про акцію

properties

object

—

так

Властивості пропозиції (наприклад, умови доставки, оплата частинами). null, якщо не налаштовані


Ціна (prices)


Поле

Тип

Опис

priceSet

string

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

priceType

string

Код ціни контрагента. Може відрізнятись у різних контрагентів

price

number

Ціна

currency

string

ISO-код валюти

Оновлено: 28/10/2026

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

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

Скасувати

Дякуємо!