Склад и остатки

Склады бренда

Список складов с пометкой, какой из них онлайн-склад и какой производственный.

Онлайн-склад — тот, чей остаток показывается покупателю на витрине. Именно с него списывается товар при отгрузке, если у заказа не указан другой.

Остатки склада

Остатки по каждому размеру: физический, зарезервированный и доступный.

[
  {
    "warehouseId": 4,
    "productSizeId": 1923,
    "quantity": 12,
    "reserved": 3,
    "available": 9,
    "productSize": {
      "id": 1923,
      "size": "M",
      "product": { "id": 341, "name": "ДЖЕРСИ «LIGHT CLASSIC» BLACK" }
    }
  }
]

Установить остаток

Записывает остаток по размерам. Это установка значения, а не прибавка.

Передаётся итоговое количество, а не дельта. Режим physical означает, что вы сообщаете физическое наличие на полке, и платформа сама вычтет из него уже собранные, но не отгруженные заказы.

curl -s -X POST "https://api.amarix.ru/warehouses/4/stock" \
  -H "Authorization: Bearer $AMARIX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "mode": "physical",
        "items": [
          { "productSizeId": 1923, "quantity": 12 },
          { "productSizeId": 1924, "quantity": 0 }
        ]
      }'

История движений

Журнал изменений остатков: кто, когда, на сколько и почему.

Основной инструмент разбора «куда делся товар». Каждая запись содержит знаковое изменение количества и причину.

Резервы

Единицы товара, закреплённые за заказами, с признаком срока годности.

Резерв до оплаты живёт ограниченное время — по умолчанию тридцать минут — и снимается сам, если заказ не оплатили. После оплаты становится бессрочным и снимается только при отгрузке.

Перемещение между складами

Переносит указанные количества с одного склада бренда на другой.