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

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

Запрос — компакт, до 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",
  "barcode": "4607147352519", "brand": "AVS", "unit": "шт",
  "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 }
}

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

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

Поля товара

• sku — артикул; code — внутренний код на сайте (6 цифр). По любому удобно сопоставлять номенклатуру
• price — ваша персональная цена (в рублях), base_price — до постоянной скидки
• order_rules — нормы заказа: min_qty, max_qty, qty_step (шаг). Заказ должен им соответствовать
• images — галерея фото в среднем размере; image_url — главное фото

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

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 ВАШ_ТОКЕН"