Skip to content

Warehouse

Warehouses are physical or logical locations where your inventory is stored. Every inventory record in ShopSynch belongs to a warehouse — this is the foundation of the stock management system.

How It Fits In

Warehouse ──► Inventory ──► Product (or SKU)
  • A warehouse holds stock.
  • An inventory record links a product (or SKU) to a warehouse with a specific quantity.
  • Product V2 automatically creates inventory records in your default warehouse when a product is created.

Note: Product V2 requires at least one warehouse. If you have not created a warehouse before creating your first V2 product, the system automatically creates a default warehouse called "Main Warehouse" (code: WH-01) for you.

Warehouse Types

The type field describes the nature of the warehouse. This is informational and does not change API behavior.

TypeDescription
OWNEDA warehouse you operate directly.
SUPPLIERStock held at a supplier's location.
CONSIGNMENTStock held on consignment at a partner location.
THIRD_PARTY_LOGISTICSStock managed by a third-party logistics provider (3PL).

Required Permission

All warehouse endpoints require merchant authentication. The calling user must have inventory management permissions enabled for the tenant.

Next Steps

Build with joy