Как устроено

Площадка и её ключ#

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

Товары могут быть закреплены за конкретной площадкой. Тогда в очереди у этой площадки будут только её товары, и приёмку чужого товара она провести не сможет.

Как считается очередь#

Очередь нигде не хранится. Она пересчитывается на каждый запрос из трёх величин: текущего остатка, порога и размера партии.

• Остаток берётся не физический, а за вычетом резервов — то есть сколько вещей реально свободно. Он может быть отрицательным: это значит, что заказов принято больше, чем есть товара.
• Порог — граница, ниже которой позиция попадает в очередь.
• Партия — сколько штук шьют за раз.

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

остаток = 1, порог = 2, партия = 5   → шить 5
остаток = 5, порог = 2, партия = 5   → в очередь не попадает
остаток = -3, порог = 2, партия = 5  → шить 8 (партия плюс недостача)
партия = 0                           → не попадает никогда

Пошив под заказ#

Часть позиций не хранится на складе вовсе, а шьётся под конкретный заказ. Такие помечены признаком «под заказ», и количество для них равно недостаче, а не партии.

Приёмка#

Когда партия готова, вы сообщаете об этом платформе, и остаток на складе увеличивается. Приходовать можно по одной позиции или сразу пачкой — пачка применяется целиком либо не применяется вовсе.

Коды маркировки#

У размера может быть код Честного знака. Он приходит и в очереди, и в каталоге, чтобы цех мог напечатать этикетку. Платформа хранит его как строку и не проверяет ни длину, ни контрольную сумму — за корректность отвечает тот, кто заполняет.

Список эндпоинтов с параметрами и примерами — в разделе «Очередь и приёмка».