Purchases

Purchase Orders

A purchase order is what you send a supplier to say what you want. It affects nothing in your books until the goods arrive.

Last updated 2026-10-13

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

Requires subscriptionpurchase.orders3,000 IQD / month

Overview

A purchase order records intent to buy. It does not change stock and does not create a liability — those happen when goods are received against it.

Purchases — Purchase orders list
Purchase orders list
Purchase orders list — Orders with their supplier, expected date, status and total.
  1. 1

    Start an order

    Go to Purchases, open Purchase Orders and create a new one.

  2. 2

    Choose the supplier

    Pick who you are buying from. Required.

  3. 3

    Add the items

    Add each product with the quantity you want and the unit cost you expect to pay. Items not in your catalogue can be added by name.

    Purchases — Purchase order lines
    Purchase order lines
    Purchase order lines — The item table with ordered quantity, unit cost and line total.
  4. 4

    Set the expected date

    When you expect delivery. Optional but useful for chasing.

  5. 5

    Save and send

    The order is created as a draft. Move it to sent once it has gone to the supplier.

Order fields

POST /api/v1/purchase-orders
ParameterTypeRequiredDescription
supplier_idintegerRequiredSupplier the order is placed with.
expected_datedateOptionalWhen delivery is expected.
notesstringOptionalFree text for the supplier or your own reference.
itemsarrayRequiredThe order lines.
Each entry in items[]
ParameterTypeRequiredDescription
product_idintegerOptionalProduct being ordered. Omitted for a free-text line.
custom_namestringOptionalItem name where there is no product record.
qty_ordereddecimalRequiredQuantity ordered.
unit_costdecimalRequiredExpected cost per unit, in your main currency.
line_totaldecimalRequiredQuantity multiplied by unit cost.

Statuses

ParameterTypeRequiredDescription
draftstatusOptionalBeing prepared. Not yet sent to the supplier.
sentstatusOptionalIssued to the supplier and awaiting delivery.
partialstatusOptionalSome but not all of the ordered quantity has been received.
receivedstatusOptionalEverything ordered has arrived.
cancelledstatusOptionalThe order will not be fulfilled.

Allowed transitions

Purchase order status flow
draft   ──►  sent, cancelled
sent    ──►  received, partial, cancelled
partial ──►  received, cancelled

received  — final
cancelled — final
Notereceived and cancelled are end states with no transitions out. An order cannot go backwards — a sent order cannot return to draft.
PUT /api/v1/purchase-orders/{id}/status
ParameterTypeRequiredDescription
statusstringRequiredThe new status.
reasonstringOptionalWhy. Stored when cancelling.

Tracking what has arrived

Each line tracks ordered and received quantities separately:

ParameterTypeRequiredDescription
qty_ordereddecimalOptionalHow many you asked for.
qty_receiveddecimalOptionalHow many have actually arrived so far.
TipReceiving a part delivery updates qty_received and moves the order to partial automatically. You do not need to set the status by hand as deliveries trickle in.

Printing

An order or purchase can be printed to send to the supplier. Its layout has its own settings — title, logo, columns, signature labels and footer — separate from your sales invoice. Anything left blank falls back to your invoice settings. See PO Print Settings.

Related