Purchases

Manage vendor bills / purchase orders (accounts payable). Use for money owed or paid to suppliers — NOT buyer checkout. Use action=“create” for a draft header (requires title). Use purchase_items to add lines. Use action=“register_payment” to record a supplier payment.

Input Schema

Parameter	Type	Description
action	string	Action to perform: create, list, get, update, delete, register_payment
id	string	Purchase UUID (required for get, update, delete, register_payment)
site_id	string	Site UUID
title	string	Bill / PO title (required for create)
vendor_company_id	string	Vendor company UUID
status	string	Purchase status: draft, pending, completed, cancelled
amount_due	number	Amount still due to the vendor
currency	string	Currency code (e.g. USD, MXN)
purchase_date	string	Purchase date (YYYY-MM-DD)
location_id	string	Location UUID (warehouse / site location)
notes	string	Notes for the purchase
amount	number	Payment amount (required for register_payment)
method	string	Payment method (required for register_payment)
payment_notes	string	Optional notes for register_payment
limit	number	Limit results for list
offset	number	Offset results for list

Example


{
  "action": "create",
  "title": "Vendor bill - office supplies",
  "vendor_company_id": "YOUR_COMPANY_ID",
  "currency": "USD"
}