qbo_purchases_update
Update an existing purchase in QuickBooks Online via sparse update: only provided fields change. Supply purchase ID and current SyncToken to modify account, payment type, lines, date, vendor, or note.
Instructions
Sparse-update an existing Purchase record. Only provided fields are changed; Id and SyncToken are required.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"purchaseId": "<purchaseId>",
"SyncToken": "<SyncToken>",
"AccountRef": "<AccountRef>",
"PaymentType": "<PaymentType>",
"Line": "<Line>"
},
"name": "qbo_purchases_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Line | Yes | Expense lines, same shape as Bill.Line: {Amount, DetailType: "AccountBasedExpenseLineDetail" | "ItemBasedExpenseLineDetail", ...}. | |
| TxnDate | No | Purchase date (YYYY-MM-DD) | |
| DocNumber | No | Reference number | |
| EntityRef | No | Optional payee reference, e.g. {"value": "56", "type": "Vendor"} or with type "Customer"/"Employee" | |
| SyncToken | Yes | Current SyncToken of the record (required by QBO for sparse updates; fetch the record first to obtain it) | |
| AccountRef | Yes | Bank, credit card, or cash account the purchase was paid from, e.g. {"value": "35"} | |
| purchaseId | Yes | The Purchase ID to update | |
| PaymentType | Yes | Payment method: "Cash", "Check", or "CreditCard" | |
| PrivateNote | No | Private note |