Цены и остатки: синхронизация каталога

Каталог отдаётся в двух видах: компактном (артикул, внутренний код, цена, остаток — для частого обновления) и полном (вся карточка: описание, штрихкоды, коды ОКПД2 и ТН ВЭД, признак маркировки, габариты, характеристики, галерея фото, нормы заказа). Все цены — в рублях (число с двумя знаками).

Запрос — компакт, до 200 позиций за раз:

curl "https://avstorg.ru/api/ext/v1/products?view=offers&limit=200" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Ответ:

{
  "items": [
    { "sku": "A40854S", "code": "480021", "price": 114.00, "base_price": 120.00,
      "qty": 96, "qty_primary": 96 }
  ],
  "next_cursor": "QTQwODU0Uw",
  "as_of": "2026-07-21T12:34:56Z"
}

Листайте каталог, передавая next_cursor из ответа, пока он не станет null. Точечный запрос по артикулам:

curl "https://avstorg.ru/api/ext/v1/products?view=offers&sku=A40854S,A80782S" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Полная карточка (view=full) — фрагмент ответа:

{
  "sku": "A40854S",
  "code": "480021",
  "name": "Размораживатель замков 75 мл AVS",
  "short_description": "Быстро размораживает замки и личинки дверей.",
  "description": "Назначение\n\nРазмораживает замки за 30 секунд.\nНе вредит смазке.\n\n• работает до −40 °C\n• с силиконом",
  "description_html": "<h2>Назначение</h2>\n<p>Размораживает замки за 30 секунд.<br>Не вредит смазке.</p>\n<ul><li>работает до −40 °C</li><li>с силиконом</li></ul>",
  "barcode": "4607147352519", "brand": "AVS", "unit": "шт",
  "okpd2": "20.59.43.110", "tn_ved": "3820000000", "is_marked": false,
  "image_url": "https://cdn.avstorg.ru/..._medium.webp",
  "images": [
    "https://cdn.avstorg.ru/..._medium.webp",
    "https://cdn.avstorg.ru/..._medium.webp"
  ],
  "attributes": [{ "name": "Объём", "value": "75", "unit": "мл" }],
  "price": { "price": 114.00, "base_price": 120.00, "discount_percent": 5 },
  "order_rules": { "min_qty": 1, "max_qty": null, "qty_step": 12 },
  "stock": { "qty": 96, "qty_primary": 96, "qty_secondary": 0, "next_delivery_days": null }
}

Как часто обновлять

• Раз в сутки — полный проход view=full (карточки, нормы заказа)
• Каждые 15–60 минут — полный проход view=offers (цены и остатки)
• Товар пропал из выдачи — снят с продажи или недоступен в вашем регионе

Поля товара

• sku — артикул; code — внутренний код на сайте (6 цифр). По любому удобно сопоставлять номенклатуру
• price — ваша персональная цена (в рублях), base_price — до постоянной скидки
• order_rules — нормы заказа: min_qty, max_qty, qty_step (шаг). Заказ должен им соответствовать
• short_description — краткое описание текстом; description — полное описание (то же, что во вкладке «Описание» на сайте) текстом без разметки; description_html — оно же в HTML для вашего магазина, только безопасные теги и полные адреса ссылок и картинок. Описания нет — null. Правка описания на сайте меняет updated_at товара
• images — галерея фото в среднем размере; image_url — главное фото
• okpd2 — код ОКПД2, tn_ved — код ТН ВЭД; строками, как в карточке товара. Кода нет — null
• is_marked — подлежит ли товар обязательной маркировке (Честный ЗНАК и т. п.): true или false. Тот же признак, по которому сайт показывает значок маркированного товара и выделяет такие позиции в отдельную отгрузку. Поля описания, okpd2, tn_ved и is_marked есть только в view=full

Как читать остаток

qty — сколько доступно всего в вашем регионе; qty_primary — на основном складе (обычно ближайшая отгрузка), qty_secondary — на остальных складах региона. next_delivery_days — ожидаемый подвоз, если остатка не хватает.

Точечно по внутренним кодам

Кроме артикулов, товары можно запрашивать по внутренним кодам сайта (поле code) — через запятую, как и sku:

curl "https://avstorg.ru/api/ext/v1/products?view=offers&code=480021,570024" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"