List or read purchase orders
Purchase orders, newest first, by status, supplier or date; or one order in full.
Free*
*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.
An example
Which supplier orders are still open?
Your agent callspurchasing_list_ordersFree*
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"status": "open"
}Use it when
Someone asks what is on order, or a delivery is due.
What it does
With order: that order in full (lines with what was received and billed, its PDF link, its bills and history). Otherwise orders newest first, filtered by status (draft, sent, partial, received, closed, cancelled; open means sent or partial), supplier, or created from-to.
What comes back
orders: each with its order_id, number, supplier, status, totals and dates; and the total. With order: that order in full with its lines, PDF link, bills and history. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
order | string | The order_id, or the order's number like "PO-0007". 1 to 40 characters. |
status | string | One of: draft,sent,partial,received,closed,cancelled,open. |
supplier | integer or string | A supplier_id, or the supplier's name. 1 to 200 characters, at least 1. |
from | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
to | string | YYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$. |
limit | integer | 1 to 200. Default: 50. |
offset | integer | At least 0. Default: 0. |
The call
Over MCP, call purchasing_list_orders on https://api.conecto.chat/mcp/purchasing. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/purchasing_list_orders \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"status":"open"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No purchase order has that order_id or number. | Find it with purchasing_list_orders. |
not_found404 | No supplier of the business has that supplier_id or name. | Call purchasing_list_suppliers, or add the supplier with purchasing_save_supplier. |
invalid_input400 | A date or currency is not valid. | Send dates like 2026-11-02 and currencies like EUR. |
More Purchasing tools
All 25 tools- Add or change a supplier
purchasing_save_supplierAdds a supplier or changes one: contact, email for orders, address, currency, payment terms and the book account their bills go to.$0.01 a call - List suppliers
purchasing_list_suppliersSuppliers by name, each with what is owed to them on open bills and how many orders are open.Free* - Say what a supplier sells
purchasing_save_supplier_itemsSays which Inventory items a supplier sells: their code, cost, pack size, minimum order, lead time and a fixed reorder quantity.$0.005 per item saved - List what suppliers sell
purchasing_list_supplier_itemsWhat suppliers sell: codes, costs, packs, minimums, lead times and the preferred supplier, for one supplier or one SKU.Free* - Draft reorders for low stock
purchasing_draft_reordersDrafts one purchase order per supplier for every item at or below its reorder point, counting what is already on order.$0.01 per draft order - Draft a purchase order
purchasing_create_orderDrafts a purchase order to a supplier: lines (with Inventory SKUs if you like), currency, delivery date and stock location.$0.01 a call - Change a draft order, or mark it sent
purchasing_update_orderChanges a draft order, or records it as sent without emailing it.$0.01 a call - Email a purchase order
purchasing_send_orderEmails an order to the supplier with a link to its PDF; a draft takes the next number first.$0.10 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md