Sales

Manage sales transactions. Use action=“create” to record a new sale. Use action=“update” to modify a sale record. Use action=“list” to search sales history. Use action=“delete” to remove a sale record.

Input Schema

Parameter	Type	Description
action	string	Action to perform on sales. Enum: create, list, update, delete
customer_id	string	Customer UUID
sale_id	string	Sale UUID (required for update/delete)
product_ids	array	Array of product UUIDs
payment_method	string	Payment method (e.g. card, transfer)
total_amount	number	Total amount
status	string	completed, pending, cancelled, etc.
notes	string	Sales notes
discount	number	Discount amount
tax	number	Tax amount
shipping_address	object	Shipping address
site_id	string	Site UUID
limit	number	Limit results
offset	number	Offset results

REST Endpoint

Actions map to sub-routes: create → /create, list → /get, update → /update, delete → /delete.


POST /api/agents/tools/sales/create
POST /api/agents/tools/sales/get
POST /api/agents/tools/sales/update
POST /api/agents/tools/sales/delete


POST /api/agents/tools/sales/create
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
 
{
  "site_id": "YOUR_SITE_ID",
  "customer_id": "CUSTOMER_UUID",
  "product_ids": ["PRODUCT_UUID"],
  "total_amount": 299.00,
  "payment_method": "card",
  "status": "completed"
}

Response:


{
  "success": true,
  "sale": { "id": "...", "total_amount": 299.00, "status": "completed" }
}