C# · 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.cs:

Bills.cs

// Bills.cs - sends September's supplier bills.
public static class Bills
{
    public static async Task Run(string[] args)
    {
        var bills = new[]
        {
            new
            {
                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 = new[]
                {
                    new { line_item_id = "BILL-501-1", account_code = "5000", description = "Office chairs, 40 units", amount = 8000.00 },
                },
            },
        };

        var request = Brizo.Written(await Brizo.Call("POST", $"/organisations/{Brizo.CompanyId}/bills", new
        {
            declarations = new
            {
                source_reference = "my-ledger",
                period = "2026-09",
                value_basis = "company_base",
                rate_direction = "document_to_base",
                base_currency = "SGD",
            },
            records = bills,
        }));

        await Brizo.Show("Bills", request);
    }
}
dotnet run -- Bills

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