Record bill payment
Record a payment to a supplier against one or more open bills.
MCP tool myob_write → record_bill_payment
write Confirm
Records the payment as Purchases > Record supplier payment does and returns the amount applied to each bill with its new balance. It pays from a bank account and does not select Electronic payment, so MYOB sends no money to the supplier. Set send_remittance to email a remittance advice now. An amount above the open bills makes MYOB create a debit note. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| supplier_id string required | string | Supplier card ID, e.g. SUP000004. |
| bank_account string required | string | Account code from list_bank_accounts, the account the money came in to or goes out of. |
| date date | date | Payment date. Default: today. |
| payments array required | array | Objects with bill_number, amount and optional discount. Start with the oldest bill. |
| send_remittance boolean | boolean | Email a remittance advice now. Default: false. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "myob_write",
"arguments": {
"operation": "record_bill_payment",
"arguments": {
"supplier_id": "supplier_8c41d2",
"bank_account": "bank account",
"payments": "payments"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"payment_reference": "00000044",
"supplier_id": "SUP000004",
"bank_account": "1-1110",
"date": "2026-10-14",
"amount_paid": 2200,
"applied": [
{
"bill_number": "00000311",
"amount": 2200,
"balance_due": 0,
"status": "closed"
}
],
"remittance_sent": false
},
"isError": false
}