bexio Purchase Orders
bexio_purchase_ordersList, get, create, update, and delete purchase orders. Supports positions, taxes, and document details via the bexio 3.0 API.
Instructions
Manage purchase orders (bexio 3.0 API; numeric ids). Status (kb_item_status_id) is read-only: 22 Draft, 23 Open, 24 Partly, 25 Done, 26 Canceled. Actions: "list" (optional limit/offset and order_by: id, total, total_net, total_gross or updated_at; append "_desc" for descending), "get" (purchase order by numeric id), "create" (payload; all fields optional but typically contact_id, user_id and positions grouped as required/optional/discount arrays), "update" (id + payload of fields to change; positions are create-only — the update endpoint does not accept them and they are not sent), "delete" (id; permanently deletes the purchase order — cannot be undone).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Purchase order id (required for get/update/delete) | |
| limit | No | Maximum number of results (default 500, max 2000) | |
| action | Yes | Operation to perform | |
| offset | No | Number of results to skip (pagination) | |
| payload | No | Purchase order fields (bexio 3.0 API; all fields optional — bexio applies defaults). Typically set at least contact_id, user_id and positions on create. | |
| order_by | No | Field to order by; append "_desc" for descending (e.g. "id_desc") |