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: branches are an entity of their own, not a warehouse type. Every warehouse belongs to a branch, and a branch can hold several. Do not create one warehouse per location expecting it to act as a branch: create the branch, then the warehouses it needs inside it. The warehouse type (main, branch, vehicle, virtual) is a descriptive label only and does not decide which branch it belongs to. See "Inventory is per branch too" and "Branches: what they are, who works in each one, and how many your plan allows".

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). The stock balance is kept per product and section, not per warehouse: each product has its quantity inside a specific section.

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

Besides the business default warehouse you just configured, each product can have its own. On the product record (Operations → Products), Inventory section, there is a Default warehouse field: it is the warehouse used on that product's document lines when no other one is chosen. Leave it empty if you prefer to pick the warehouse manually every time.

The order in which Mosce ERP decides a line's warehouse, from highest to lowest priority:

1. The warehouse chosen on the document line.
2. The product's default warehouse.
3. The business default warehouse.

Where that order applies: when creating and editing sales orders, when selling at the point of sale, and when converting a quote into an order.

Why it is worth filling in. A line that resolves no warehouse neither sets aside nor deducts inventory, so the merchandise leaves the business without coming down in the system. That is why converting a quote into an order requires every product to resolve a warehouse: if one does not, the conversion stops and tells you which product to configure, instead of letting through lines that would never move stock. Filling in the product's default warehouse is how you stop that conversion from asking.

Purchases and adjustments and transfers do not use this field: when receiving you pick the destination section by hand, and in an adjustment or a transfer you pick warehouse and section in the form itself.

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. When you delete it, the products that had it as their default warehouse are left without one and will fall back to the business default warehouse.

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
• Lots, serial numbers and variants
• Products