Create bill
Enter a supplier invoice as a bill with its lines and tax.
MCP tool myob_write → create_bill
write Confirm
Creates an open bill and returns its number, tax, total and balance due. Pass the supplier's own invoice number so a later call to list_bills can spot a duplicate. Layout service takes free-text lines and item takes item codes. The bill changes your books and your payables, so it asks first. 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. |
| supplier_invoice_number string | string | The number on the supplier's own invoice. |
| date date | date | Bill date. Default: today. |
| due_date date | date | Due date. Default: from the supplier terms. |
| layout enum | enum | service or item. Default: service. |
| lines array required | array | Objects with description or item_code, amount and tax_code, e.g. GST. |
| tax_inclusive boolean | boolean | true if amounts include tax. Default: false. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "myob_write",
"arguments": {
"operation": "create_bill",
"arguments": {
"supplier_id": "SUP000004",
"supplier_invoice_number": "INV-8841",
"date": "2026-10-10",
"lines": [
{
"description": "Office rent, October",
"amount": 2000,
"tax_code": "GST"
}
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"bill_number": "00000311",
"supplier_id": "SUP000004",
"supplier": "Bayside Property",
"supplier_invoice_number": "INV-8841",
"status": "open",
"date": "2026-10-10",
"due_date": "2026-11-09",
"subtotal": 2000,
"tax": 200,
"total": 2200,
"balance_due": 2200
},
"isError": false
}