Purchases

Receiving Goods

The moment an order becomes real: stock goes up, and so does what you owe.

Last updated 2026-10-13

DigitalKey ERP — Docs · digital-key.co/docs/purchases/receive-goods

Requires subscriptionpurchase.receive2,000 IQD / month

What receiving does

Recording a receipt does five things in one transaction:

  1. Raises a purchase invoice for the goods received.
  2. Increases stock by the received quantity.
  3. Blends the received cost into each product's weighted-average cost — it does not overwrite it, and it never touches the selling price.
  4. Increases the supplier balance by whatever is unpaid.
  5. Updates qty_received on the linked order and recalculates its status.
Purchases — Receiving against an order
Receiving against an order
Receiving against an order — An order open for receipt, with ordered and received quantities side by side.
  1. 1

    Open the purchase order

    Find the order the delivery relates to and open it.

  2. 2

    Enter what actually arrived

    Record the quantity received per line. This does not have to match what was ordered — enter what is physically in front of you.

  3. 3

    Check the costs

    Unit costs default to what was ordered. If the supplier invoiced differently, correct them here so stock is valued at what you actually paid.

    Purchases — Receipt lines with costs
    Receipt lines with costs
    Receipt lines with costs — Received quantities alongside unit costs and line totals.
  4. 4

    Record any payment

    Enter what you paid on delivery. Anything unpaid becomes part of the supplier balance.

  5. 5

    Save

    Stock rises, the supplier balance updates, and the order status moves to partial or received.

Fields

Purchase invoice raised on receipt
ParameterTypeRequiredDescription
supplier_idintegerRequiredSupplier the goods came from.
po_idintegerOptionalOrder being received against. Omitted for a direct purchase.
payment_typestring= cashRequiredCash or credit.
paid_amountdecimalOptionalPaid on delivery. The remainder becomes supplier debt.
discount_amtdecimalOptionalInvoice-level discount from the supplier.
notesstringOptionalFree text — delivery note number, condition on arrival.
items[].product_idintegerOptionalProduct received.
items[].qtydecimalRequiredQuantity actually received.
items[].unit_costdecimalRequiredCost per unit actually charged, in your main currency. Stays as the supplier billed it.
items[].cost_modestring= averageOptionalaverage, manual or keep — how this line may move the product's cost.
items[].line_totaldecimalRequiredQuantity multiplied by unit cost.

Part deliveries

Receiving less than was ordered is normal and fully supported. Enter what arrived; the order records the shortfall and stays open for the rest.

TipThe order moves to partial on its own while any line still has qty_received below qty_ordered, and to received once everything has arrived. You do not set this by hand.

Quantities: cartons in

On a purchase line, Qty counts cartons— the way the supplier's invoice is written. For a product sold by the piece, with Items per Unit set, the stock rises by Qty × Items per Unit pieces and the carton cost is divided down to a cost per piece.

Cost prices and profit

WarningThe unit cost recorded here is what your profit reporting is built on. Enter what the supplier actually charged. The system blends it with the stock you already hold: 10 on the shelf at 1,000 plus 10 received at 1,200 gives 20 at 1,100.

When a product already has stock at a different cost, the line offers three choices — use the moving average (the default), enter the cost yourself, or keep the current cost. Customs, transport and similar charges are added afterwards as landed costs. Both are explained in Landed Costs & Cost Mode.

Packing and freight by volume

Each line can open a packing row. What is typed there is recorded on this purchase only; the product card is not changed.

Packing row
ParameterTypeRequiredDescription
Unit / Items per Unittext / numberOptionalHow the goods are packed on this shipment.
Barcode / Imagetext / fileOptionalThe carton's barcode and a picture, for the printed purchase.
CBM bychoiceOptionalCarton size — type length, width and height in cm and the volume is worked out; or Type CBM — type the volume of one carton directly.
Cost per CBMdecimalOptionalWhat the shipper charges per cubic metre. May be typed in another currency.
CBM / FreightcalculatedOptionalThe line's volume (one carton × cartons) and its freight (volume × cost per CBM).
NoteFreight by volume is added to the goods' cost as a landed cost. The supplier total is not changed — freight is not money owed to the supplier.

A cost per CBM in another currency

If the shipper quotes in dollars or yuan, type the cost per CBM in that currency. The first time each day you are asked for today's exchange rate for it; every cost typed in that currency that day converts at it. Only your main currency is used in calculations. Rates and their history are under My Account → Currency.

Paying the supplier

Anything left unpaid sits on the supplier balance until a payment is recorded against them, in the same way customer payments work.

Requires subscriptionpurchase.payments1,500 IQD / month

Receiving without an order

Goods bought without a prior order are recorded as a purchase invoice with no po_id. The effect on stock and on the supplier balance is identical — the only difference is that there is no order to reconcile against.

Related