Purchases

Purchases

Everything to do with buying stock: who you buy from, what you ordered, what arrived, and what you still owe.

Last updated 2026-10-13

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

Requires subscriptionpurchase.manage5,000 IQD / month

Overview

The purchasing side mirrors the selling side. A supplier is the counterpart of a customer, a purchase invoice the counterpart of a sale, and a supplier balance the counterpart of customer debt — except it is money you owe rather than money owed to you.

Purchases — Purchases screen
Purchases screen
Purchases screen — Purchase invoices with supplier, total, paid and remaining amounts.

The purchasing features

Purchase module — monthly price in IQD
ParameterTypeRequiredDescription
purchase.manage5,000 IQDOptionalPurchase invoices — the core of the module.
purchase.suppliers2,000 IQDOptionalSupplier records and their balances.
purchase.orders3,000 IQDOptionalPurchase orders raised before goods arrive.
purchase.receive2,000 IQDOptionalReceiving goods against an order.
purchase.payments1,500 IQDOptionalRecording payments to suppliers.

Two ways to buy

You do not have to raise an order. Both routes are supported, and which you use depends on how far ahead you buy.

  • Order first — raise a purchase order, send it to the supplier, then receive goods against it as they arrive. Best when there is a gap between ordering and delivery.
  • Invoice directly — record a purchase invoice when the goods and the paperwork turn up together. Best for cash-and-carry buying.

Suppliers

A supplier record carries their details and a running balance of what you owe them. Buying on credit increases it; paying them reduces it. Suppliers have their own screen — see Suppliers.

Requires subscriptionpurchase.suppliers2,000 IQD / month

What a purchase line can carry

  • A new product — a product that does not exist yet can be created on the line, with its selling price, so it is sellable as soon as it arrives.
  • Packing — the unit, Items per Unit, barcode, image and carton size, recorded on this purchase only; the product card is not changed.
  • Freight by volume — a cost per CBM, which becomes a landed cost on the goods.
  • Cost mode— whether the receipt blends into the product's average cost, uses a cost you type, or leaves the cost alone.

The last three are covered in Receiving Goods and Landed Costs & Cost Mode.

Owner permissions on purchases

My Account → Team → Permissions → Purchases
ParameterTypeRequiredDescription
Void a purchaseoff by defaultOptionalCancel a purchase invoice, reversing its stock and the supplier balance.
Purchase returnson by defaultOptionalSend goods back to the supplier.
Set product cost by hand on a receiptoff by defaultOptionalUse the “Enter the cost myself” and “Keep the current cost” modes.

Purchase invoices

Purchase invoice
ParameterTypeRequiredDescription
purchase_idintegerOptionalInternal identifier.
invoice_nostringOptionalInvoice number.
supplier_idintegerRequiredWho supplied the goods.
po_idintegerOptionalLinked purchase order, when the invoice came from one.
purchase_datetimestampOptionalDate of the purchase.
subtotaldecimalOptionalTotal of all lines before invoice discount.
discount_amtdecimalOptionalInvoice-level discount.
totaldecimalOptionalAmount payable after discount.
paid_amountdecimalOptionalAmount already paid.
remainingdecimalOptionalStill owed on this invoice.
payment_typestring= cashOptionalCash or credit.
total_returneddecimalOptionalValue returned to the supplier against this invoice.
is_voidbooleanOptionalWhether the invoice has been voided.
WarningReceiving goods raises your stock and increases what you owe the supplier. Both happen together — there is no way to take the stock without the liability.

Returns to supplier

Faulty or surplus goods can be returned. The return reduces stock and reduces what you owe, and is recorded against the original purchase invoice. Each return can be printed.

Voiding a purchase

Voiding reverses the stock and the supplier balance. The stock is taken back out at what it actually cost — including any customs or transport it absorbed — so the product's average returns to where it was.

WarningOne thing a void does not undo: the part of a landed cost that was already booked as an expense, because those goods had already been sold. That month is closed, so the expense stays and its description is annotated instead. The screen warns you of the amount before you confirm. The owner can restore a voided purchase from the recycle bin.

Money out for goods

NoteIn finance, cash paid for goods is what has been paid on purchase invoices— whether at the time or later. Paying an invoice later raises its paid amount and also writes a payment record; only the first is counted, so nothing is charged twice. See Cash Flow.

In this section