Create a draft purchase order (WRITE)
finale_create_draft_purchase_orderDestructive
WRITE. Creates a purchase order for a supplier in status ORDER_CREATED, i.e. an editable draft. It is NOT locked (committed), received, completed or emailed, no stock changes and no money moves: review and commit it in Finale. Products are looked up first (one single read each; products whose resource URL differs from the SKU cost collection reads, bounded to 3 or one full product-list read), then ONE POST creates the order; the call is never retried, so check finale_list_orders before repeating it after an error. POST /{account}/api/order/.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Order lines. | |
| order_id | No | Order id (max 20 ASCII characters; must be unique). Omit to let Finale number it. | |
| public_notes | No | Notes to the supplier. | |
| private_notes | No | Internal notes. | |
| reference_number | No | Supplier reference number (max 60 characters). | |
| supplier_party_id | Yes | Supplier partyId (from finale_list_parties). | |
| destination_facility_url | No | Receiving location's facilityUrl (from finale_list_facilities; not a sublocation). Omit for 'Multiple / unspecified'. |