Очередь и приёмка

Проверить ключ

Возвращает площадку, которой принадлежит ключ. Первый запрос при настройке.

Признак «основная площадка» важен: основная дополнительно получает товары, не закреплённые ни за одной площадкой.

{
  "facility": { "id": 3, "name": "Основной цех", "is_default": true }
}

Очередь на изготовление

Что и в каком количестве нужно произвести прямо сейчас.

Очередь нигде не хранится — она считается на лету из текущих остатков, порога и размера партии. Поэтому она всегда актуальна, но и меняется от запроса к запросу: продали вещь — позиция появилась в очереди.

curl -s https://api.amarix.ru/production-api/queue \
  -H "Authorization: Bearer $КЛЮЧ_ПЛОЩАДКИ"

{
  "facility": { "id": 3, "name": "Основной цех", "is_default": true },
  "count": 2,
  "items": [
    {
      "product_id": 341,
      "product_name": "ДЖЕРСИ «LIGHT CLASSIC» BLACK",
      "product_slug": "dzhersi-light-classic-black",
      "brand_code": "casher",
      "chestny_znak": "04600000000017",
      "size": "M",
      "quantity_to_produce": 5,
      "batch_size": 5,
      "stock": 1,
      "threshold": 2,
      "on_demand": false,
      "link_only": false
    }
  ]
}

Каталог бренда

Справочник товаров с размерами, остатками и настройками производства.

В отличие от очереди отдаёт все товары, а не только те, что надо шить. Нужен для поиска, карточки товара и сопоставления позиций в вашем приложении.

Один товар

Тот же объект, что в каталоге, но без обёртки.

Приёмка готовой продукции

Сообщает, что произведено столько-то штук. Остаток на складе увеличивается.

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

curl -s -X POST https://api.amarix.ru/production-api/receive \
  -H "Authorization: Bearer $КЛЮЧ_ПЛОЩАДКИ" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 341, "size": "M", "quantity": 5}'