Guides

Suppliers and purchasing

Record your suppliers, link them to products, raise purchase orders, receive stock into inventory, and measure supplier performance.

Purchasing in Miridia has three parts. The supplier record holds the trade relationship. The purchase order records what you buy. The receipt puts the stock into inventory.

Suppliers

A supplier record holds:

a title, a code, and a description
a contact person
an origin address, which also puts the supplier on the map view
the payment terms
the default lead time in days
the default currency

Link suppliers to a product

A product can have more than one supplier. Link each supplier to the product and record:

the supplier part number
the last quoted price and its currency
the lead time in days
the minimum order quantity

Mark one link as the primary supplier. When you set a new primary supplier, the old primary link becomes a normal link. A new purchase order line takes its default price and its expected date from the primary supplier.

Link a second supplier to your important raw materials. Then you can change supplier quickly when the first supplier has a problem.

Purchase orders

A purchase order has a supplier, a destination location, a currency, an expected delivery date, and lines. Each line has a product, a quantity, a unit cost, and tax.

The lifecycle

Draft → Ordered → Confirmed → PartiallyReceived → Received → Closed

Status	Meaning
`Draft`	You are still preparing the order.
`Ordered`	You sent the order to the supplier.
`Confirmed`	The supplier accepted the order.
`PartiallyReceived`	Some of the stock arrived.
`Received`	All of the stock arrived.
`Closed`	The order is complete, and no more stock is expected.
`Cancelled`	The order stopped before completion.

To change the status, send a PATCH request with the new status. Miridia moves the order to PartiallyReceived or Received itself when you record a receipt.

Link to a transfer request

A purchase order can have a sourceTransferOrderId. Use this link when a branch requested stock and the warehouse did not have enough. The buyer can then see why the purchase order exists. Read Transfer orders.

Inbound shipments

A purchase order can have one or more inbound shipments. They are normal shipments. Thus they use the same tracking as an outbound delivery.

Receive stock

Receiving is the moment that the stock exists in Miridia. To record a receipt, send the lines that arrived. Each line has:

productId
quantityReceived: the quantity that you accept into stock
quantityRejected: the quantity that you refuse, for example damaged goods
unitCost: the actual cost of each unit

A receipt does these things:

It adds a Purchase movement at the destination location for each line.
It updates the weighted average cost of each product.
It changes the status of the order to PartiallyReceived or Received.

You can receive one order in more than one receipt. Each receipt accepts an effectiveDate, so you can record a delivery that arrived on an earlier day.

Miridia uses the movement ledger as the receipt record. A separate printable goods received note is planned. Non-product cost lines on a purchase order, and the allocation of freight and duties to the unit cost (landed cost), are also planned.

Supplier performance

Miridia calculates supplier performance from the real order and receipt history. Nobody types these numbers, thus they cannot be out of date.

Metric	Meaning
`avgLeadTimeDays`	The average number of days from order to receipt.
`onTimeRate`	The share of receipts on or before the expected date.
`fillRate`	The share of the ordered quantity that arrived.
`defectRate`	The share of the received quantity that you rejected.
`totalSpend`	The value of the purchase orders in the period.
`activePurchaseOrders`	The number of open purchase orders.

The default period is the last 90 days. Use from and to to set a different period.

Notifications and workflows

When a purchase order is fully received, Miridia tells the business. Workflows can start on these triggers: OnPurchaseOrderCreated, OnPurchaseOrderUpdated, OnPurchaseOrderStatusChanged, and OnPurchaseOrderReceived. Read Workflows.

API reference

Inventory

Track stock for each product at each location with an append-only movement ledger. Adjust, transfer, trace, and set reorder points.

Transfer orders

Move stock between your own locations. Use one order type for a warehouse rebalance and for a branch request.