Золотенков
Выпустить ключ

Завести партию товаров

POST https://mrp.zolotenkov.ru/api/external/v1/products/batch

Требуемое право ключа: write:catalog.product.create

Заводит до 200 карточек одним запросом и расходует одну единицу строгой квоты записи вместо одной на карточку. Отказ построчный: results[i] говорит про строку items[i], и одна отклоненная строка не отменяет заведенные. Обязателен Idempotency-Key: повтор с тем же ключом и тем же телом возвращает прежний ответ и второй партии не создает.

Заголовки

  • Idempotency-Key строка обязателен

    Обязателен, до 200 символов. Повтор с тем же ключом и тем же телом возвращает прежний ответ и вторых карточек не создает. Ответ на повтор помечен заголовком Idempotency-Replayed: true.

Тело запроса

Формат — application/json.

  • items массив объектов обязателен

    Карточки в том же виде, в каком их принимает POST /products. От 1 до MAX_PRODUCT_BATCH_ITEMS штук.

  • items.can_buy флаг необязателен
  • items.can_make флаг необязателен
  • items.can_sell флаг необязателен
  • items.category_id целое число необязателен может быть пустым
  • items.cost_price десятичная дробь необязателен может быть пустым

    Явная плановая себестоимость. Для покупного товара обязательна: отсутствие значения не должно превращаться в неотличимый от настоящего ноль.

  • items.is_kit флаг необязателен

    Пометить товар комплектом. Задается только при создании: у уже заведенной карточки признак этой ручкой не меняется.

  • items.sku строка необязателен может быть пустым
  • items.title строка обязателен
  • items.unit_id целое число необязателен может быть пустым

Ответы

  • 200 Партия разобрана. Исход каждой строки — в results; код ответа говорит только о том, что запрос принят и разобран, а не о том, что легли все строки
  • 400 Некорректное тело запроса, пустой либо слишком длинный items
  • 401 Ключ не передан, недействителен или отозван
  • 402 15 дней без ограничения закончились: пакет, который дал бы больше 30 артикулов, отклонен целиком (SUBSCRIPTION_LIMIT)
  • 403 У ключа нет права write:catalog.product.create
  • 409 Idempotency-Key повторен с другим телом запроса
  • 429 Превышена частота обращений (rate_limited). Задержка до повтора — в заголовке Retry-After