Skip to main content
A warehouse is a place where supplies are stored and counted. Every box of stock sits in exactly one warehouse, every order is delivered to a warehouse, and every stock movement says which warehouse it left or reached. The API calls it a warehouse too.

​
Central and express warehouses

The ownership rule is strict:
  • An express warehouse always belongs to one location, chosen when it is created.
  • A central warehouse never belongs to a location.
  • The type and the location of a warehouse cannot be changed after it is created.

​
Who can do it

In Team, settings.manage is shown as Manage clinic configuration. A member without it sees the list in read only mode: no New warehouse button and no Actions column. See Roles and permissions.

​
Where

Main navigation, Warehouses (console.muveya.com/warehouses).

​
The Warehouses list

The list shows every warehouse of the account, in the order they were created. Search warehouses filters by warehouse name, ignoring upper and lower case and accents. Empty states:
  • No warehouses yet: No warehouses yet. Managers read Create a central warehouse or connect an express warehouse to a location.; everyone else reads Ask your clinic administrator to add a warehouse.
  • A search with no match: No matching results and Try a different search.
This list is not filtered by warehouse access: every member sees every warehouse here. Warehouse access decides whose stock a member can see and move in Inventory, not what this list shows.

​
Create a warehouse

1

Open the form

In Warehouses, select New warehouse. A dialog titled New warehouse opens.
2

Name it

Type the Warehouse name, for example Bodega Central Santiago or Clínica Norte stock.
3

Choose the type

In Warehouse type, choose Central (the default) or Express.
4

Choose the location (express only)

If you chose Express, a Location field appears. Open Choose a location and pick the location the warehouse belongs to. Only active locations are offered.
5

Save

Select Save warehouse. When it finishes, the dialog closes and the warehouse appears in the list as Active.
Select Cancel to close without creating anything.

​
Fields and rules

  • If the account has no active location, the form shows Create an active location before adding an express warehouse. Create or activate a location first. See Locations.
  • A new warehouse always starts as Active.
  • There is no rename, no change of type or location, and no delete. If a warehouse was created wrong, create the correct one, move its boxes there (see Use and move stock) and deactivate the old one.

​
Warehouses created for you

  • First setup from Home. The card Create the first location creates a location and then opens New warehouse with the name Main warehouse already filled in. When the account already has a location but no warehouse, the card Create a warehouse opens the same dialog with the same name. See Locations.
  • Stock point of a counted room. When you create a room or area with Counted stock and leave Create automatically, muveya creates an express warehouse of that location with the same name as the room. It appears in this list like any other express warehouse. See Rooms and areas.

​
Statuses

To change it, select Deactivate or Activate in the warehouse’s row. The change applies immediately, can be reversed, and has no confirmation step.

​
What deactivating a warehouse does

Deactivating a warehouse never moves, removes or adjusts stock and writes nothing in the ledger.

​
How warehouses are used

​
Orders

When you create an order (see Create and track orders):
  • Deliver to warehouse lists the active express warehouses of the location chosen in Clinic, limited to the warehouses in your warehouse access. If the location has none, the screen says This clinic has no active warehouse yet. Create one in Warehouses first. If it has some but none is in your access, it says You have no warehouse of this clinic assigned. Ask an administrator for access.
  • Take stock from offers Any central warehouse or one specific active central warehouse.
With Any central warehouse, the order names no source warehouse. When stock is reserved for it, muveya looks for usable boxes of each supply without limiting the search to one warehouse, so the boxes can come from any warehouse that holds that supply, not only central ones. Choose a specific central warehouse when the stock must come from it.

​
Inventory

  • Every box belongs to one warehouse. The stock list can be filtered by Warehouse.
  • Receiving puts new boxes in an active warehouse you have access to. See Receive stock.
  • Moving a box changes its warehouse and records the move in the ledger. See Use and move stock.
  • Minimum stock and replenishment are set per supply and warehouse. See Replenishment and alerts.
  • Counts are done per warehouse. See Counts.
  • When stock leaves a box toward a room or area, the box’s warehouse decides which rooms can be chosen: from a central warehouse, the rooms of every location; from an express warehouse, only the rooms of its own location. See Rooms and areas.

​
Deliveries

Boxes reserved for an order are picked and dispatched from the warehouse they are in. When the receipt is confirmed, accepted boxes are credited to the order’s destination warehouse and disputed boxes go back to the warehouse they came from. See Deliveries overview and Delivery and receipt.

​
How warehouse access narrows what a member sees

Each member has Warehouse access: All warehouses in this account (including warehouses created later), Selected warehouses or No warehouse. It is managed from Team; see Team. A member with No warehouse reads You have no warehouses assigned. Ask an administrator for access. in Inventory.
When a member’s access lists specific warehouses, new warehouses are not added automatically. This includes the stock point muveya creates for a counted room. Open the member in Team and add the new warehouse, or they will not be able to move boxes into it or use stock from it.

​
What the system records

  • Creating a warehouse stores its name, type, location (express only) and the active status. Changing the status updates that same record.
  • These changes never write stock movements, and no separate audit entry is written for them.
  • Warehouses are never deleted, so movements and boxes that name one keep resolving to it.

​
From the API and MCP

  • The public API lists warehouses with GET /v1/warehouses (scope clinics:read). Each item has warehouseId, name, kind, status and, for express warehouses only, clinicId. The API cannot create or change warehouses. See Scopes.
  • The MCP tool clinics.list lists locations and warehouses. See MCP tools.

​
What can go wrong

Locations

The sites that express warehouses belong to.

Rooms and areas

Counted rooms and their stock points.

Use and move stock

Record usage and move boxes between warehouses.

Team

Assign warehouse access to each member.