Warehouses

A warehouse in Mosce ERP is any place where you store goods: a storeroom, a branch, a delivery vehicle, or a virtual warehouse for consignments. Within each warehouse you organize the space into hierarchical sections (aisles, shelves, bins).

Reading time: ~4 min

When to use this

Set up warehouses before you start recording inventory. You need them to:

• Receive goods from a purchase order.
• Sell from the POS or from an invoice (each product leaves the warehouse that has it in stock).
• Make adjustments and transfers.
• View stock levels segmented by location.

Important: in Mosce ERP there is no separate "Branches" module. If you have several physical branches, create one warehouse for each with type Branch (BRANCH). Each branch stays as an independent warehouse with its own sections and stock.

Before you start

• Your role must have the warehouses:create, warehouses:update, and warehouses:delete permissions depending on the action.
• Decide which will be your default warehouse. Mosce ERP requires that there is always at least one marked as default and active.
• Have the address of each location ready (optional but recommended for PDFs and reports).

Step by step

1. Create a warehouse

1. Go to Inventory → Warehouses in the side menu.
2. Click New warehouse.
3. Fill in the form:
   • Name - visible in the app, e.g. Central Warehouse.
   • Code - generated automatically from the name (slug). You only need to adjust it if another warehouse is already using it.
   • Type - choose among:
     • Main (MAIN): your central storeroom.
     • Branch (BRANCH): a separate physical store or point of sale.
     • Vehicle (VEHICLE): a mobile unit (truck, delivery motorbike).
     • Virtual (VIRTUAL): consignments, goods in transit, or stock that does not live in a physical location.
   • Default warehouse - turn it on if you want this to be the one Mosce ERP uses when none is specified.
   • Address and Notes are optional.
4. Save. Mosce ERP atomically creates the warehouse and a root section named General so you can start recording stock right away.

2. Create sections within the warehouse

Sections subdivide the physical space (aisles, racks, bins). Each InventoryItem - the stock record per product - lives in a section, not in the warehouse directly.

1. Open the warehouse detail from the list.
2. On the Sections card, click Add section.
3. Fill in:
   • Name, e.g. Aisle A.
   • Code (auto-generated slug).
   • Parent section - leave it empty for a root section, or choose an existing section to nest it.
   • Capacity and unit (units, kg, liters, m³). It is informational: Mosce ERP does not block movements by capacity, it only helps you plan.
4. Save.

You can nest sections up to 5 levels deep. An inactive section cascades deactivation to its subsections (you will not be able to receive into or transfer to them).

3. Assign a product's default warehouse

On the product record (Operations → Products) you can set a default warehouse for that product. When you sell or adjust that product without specifying a location, Mosce ERP uses that warehouse first.

If the product has no default, Mosce ERP uses the tenant's default warehouse.

4. Edit, deactivate, or delete

• Edit - from the warehouse detail, the Edit button (you can change type, address, notes, etc.).
• Deactivate - the activation toggle on the detail. An inactive warehouse does not appear in sale, purchase, or transfer selectors, but keeps its history.
• Delete - the trash button. Only possible if the warehouse has no active stock. If it has stock, you must transfer it or adjust it to zero first.

Expected result

• Every physical or logical location of your business is represented as a warehouse with the correct type.
• Every warehouse has at least one section where you can record stock.
• There is exactly one warehouse marked as active default.
• Your products have a default warehouse assigned (optional but recommended).

Common errors

• Cannot delete: the warehouse has active stock - transfer or adjust the stock to zero before deleting.
• A warehouse with that code already exists - change the name or adjust the slug manually when creating.
• There must be at least one active default warehouse - you cannot deactivate or remove the flag from the only default. Mark another as default first.
• The maximum section depth is 5 levels - reorganize the hierarchy or create the subsection one level higher.

Related

• Inventory and stock
• Purchases
• Products