JavaScript · Track 4 · Tutorial 2 of 4

Send your bills

Send the month's supplier bills - who they're from, what for, and what you still owe.

You will needThe invoices from Send your invoices.
By the endSeptember's bills in BrizoConsol, beside the invoices.

1Bills mirror invoices

Supplier bills are sent exactly like invoices, to …/bills. The party is the supplier, and the lines name cost accounts.

Bills have the same shape as invoices
A bill is an invoice the other way round: the party is the supplier, the lines are costs.

2Write and send the bills

Create bills.mjs:

bills.mjs

// bills.mjs - sends September's supplier bills.
import { call, companyId, show, written } from './brizo.mjs';

const bills = [
    {
        external_id: 'BILL-501',
        number: 'BILL-501',
        party_name: 'Northwind Furniture Supply',
        date: '2026-09-03',
        due_date: '2026-10-03',
        total: 8000.00,
        amount_paid: 3000.00,
        amount_due: 5000.00,
        lines: [
            { line_item_id: 'BILL-501-1', account_code: '5000', description: 'Office chairs, 40 units', amount: 8000.00 },
        ],
    },
];

const request = written(await call('POST', `/organisations/${companyId}/bills`, {
    declarations: {
        source_reference: 'my-ledger',
        period: '2026-09',
        value_basis: 'company_base',
        rate_direction: 'document_to_base',
        base_currency: 'SGD',
    },
    records: bills,
}));

await show('Bills', request);
node bills.mjs

Check

Bills: request 97 - 1 created, 0 updated, 0 unchanged, 0 refused

3What's owed

Send amount_paid and amount_due as your system has them. If you leave amount_due out, BrizoConsol takes the whole total as owed - unless a payment_date says it was settled.

How a part-paid bill's status is decided
Status comes from the amounts and the due date: the same bill reads PARTIAL before its due date and OVERDUE after.

4The same rules as invoices

  • The lines must add up to the total, and name accounts in the chart.
  • Each send replaces this source's bills for the month, unless you send merge.
  • Up to 1,000 bills a month, and 100 lines a bill.

Want more detail? See the documentation