open a purchase order

Opens one purchase order and returns it. The body names the destination location_id (required) and, optionally, order_type, supplier_id, source_location_id, recommended_quantity, order_date, expected_delivery_date and commitment_id.

It takes no line items. An order opened here is empty, and total_line_items on the response is 0; bulk_create_purchase_orders is the door that creates orders together with their lines, one order per supplier and location, and update_purchase_order is the one that adds lines to an order that already exists.

commitment_id records which Commitment the order is placed against, and an id this organisation does not have is refused 400. Send it only when it came from a Commitments read.

A transfer (order_type=TRANSFER, source_location_id required) opened here is empty like every other order this door opens, so it draws no quantity and no source shelf is read. The shortfall refusal belongs to bulk_create_purchase_orders, the door that sends line items, and is documented there. A purchase order is never checked against a shelf on either door, because a buy asks a supplier for units nobody holds yet.

Scope: purchase_orders:write, which includes purchase_orders:read.