> ## 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).

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

# Призначення

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

Як працюють фіди — у статті [Загальна інформація про роботу з фідами](https://help.pricer24.com/uk/article/zagalna-informaciya-pro-robotu-z-fidami-1nb0aaf/).

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

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

## Приклад (Lite)

```json
[
  {
    "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)

```json
[
  {
    "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-код валюти |