create_purchase_payment_line
Mark a purchase document line as paid by linking it to an existing payment.
Instructions
Settle a purchase document line against a payment (settlement line).
Links an existing payment to a payable so the document line is marked
paid. Note the payable is a document line (payable_id), unlike sales
receipts which settle whole documents. Field values are the caller's
responsibility — this tool only builds the documented payload.
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": {
"payment_id": "<payment_id>",
"payable_id": "<payable_id>",
"paid_value": "<paid_value>"
},
"name": "create_purchase_payment_line"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| net_total | No | Net total of the payable line. | |
| paid_value | Yes | Amount of this payment applied to the payable. | |
| payable_id | Yes | Id of the payable being settled — a purchase document LINE id, not the document id. | |
| payment_id | Yes | Parent purchase payment id (from create_purchase_payment). | |
| gross_total | No | Gross total of the payable line. | |
| payable_type | No | Payable kind. `Purchases::DocumentLine` for a purchase document line. | Purchases::DocumentLine |
| retention_total | No | Withholding/retention amount. | |
| cashed_vat_amount | No | Cashed-VAT amount, if applicable. | |
| settlement_amount | No | Early-settlement discount amount. | |
| settlement_percentage | No | Early-settlement discount percentage. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||