Inventory Requests

What this is & why it matters

A product in your catalog has zero stock until you put quantity into a warehouse. You do that with an Inventory Request. This is the bridge between having a product and being able to sell it — and it is a multi-party flow: you submit, an admin approves, and a storage company confirms before the stock counts.

Step by step: submit an inventory request

Go to Inventory Requests (/admin/inventory-requests) and click New Request.
Select the Product (required).
(Optional) Select a Color, Size, and/or Shape if this batch is a specific variant.
Enter the Quantity (required; from 1 up to 99,999).
Enter the Purchase price (required; your cost per unit).
(Optional) Select the Currency.
(Optional) Add Notes (up to 500 characters).
Submit. The request starts at pending.

(The warehouse is assigned during the storage workflow; admins route the request to a storage company that confirms it into a specific warehouse.)

Field reference

Field	Meaning	Required?	Rules
Product	Which catalog item to stock	Required	Must be one of your products
Color / Size / Shape	The specific variant	Optional	Must be an existing option
Quantity	How many units to add	Required	1 to 99,999
Purchase price	Your cost per unit	Required	0 or more
Currency	Currency of the price	Optional	Existing currency
Notes	Anything for the reviewer	Optional	Up to 500 chars

Lifecycle — what to expect

pending — submitted, awaiting admin review.
approved — approved by an admin.
assigned_to_storage — routed to a storage company.
confirmed_by_storage — confirmed by the storage company. Stock is added to your balances only at this step.

Alternative outcomes:

rejected — rejected by an admin.
rejected_by_storage — rejected by the storage company.

There is no fixed timer — the request waits on admin and storage action, so plan ahead and don’t expect to sell brand-new stock the same minute you submit it.

Tips & common mistakes

Stock is not usable until confirmed_by_storage. A pending or even approved request cannot be ordered against.
Quantity must be at least 1. Zero or negative quantities are rejected.
Pick the right variant. If you sell by color/size/shape, set them now so balances track per variant.

Where to look

Screen: Inventory Requests at /admin/inventory-requests. Open any request to see its current status and history.

Managing Products — create the product first.
Creating Orders — sell the confirmed stock.
Client / Merchant role — permissions for this screen.