PHP · Track 4 · Tutorial 3 of 4

Send documents in another currency

Send invoices and bills in the currency they were raised in, with the rate your system used - and tell BrizoConsol which way that rate runs.

You will needThe invoices from Send your invoices.
By the endA foreign-currency invoice in BrizoConsol, beside the company's own-currency ones.

1Documents can be in any currency

Your customers and suppliers may be billed in their own currency. Send the document in that currency, with the rate your system used.

2Say how amounts and rates are stated

Two declarations cover every document in the request:

  • value_basis - document when amounts are in each document's own currency, company_base when they're already in the company's.
  • rate_direction - document_to_base when the rate turns the document's currency into the company's (1 USD = 1.35 SGD), base_to_document for the other way round.
A foreign-currency invoice and how it's read
A foreign-currency invoice states its own currency and rate; the declarations say which way the rate runs.

3Send September's invoices, one in US dollars

Create foreign-invoice.php. It sends both September invoices - the month is sent whole - and the second is in US dollars:

foreign-invoice.php

<?php
// foreign-invoice.php - sends September's invoices, one of them in US dollars.
require __DIR__ . '/brizo.php';

$invoices = [
    [
        'external_id' => 'INV-1001',
        'number' => 'INV-1001',
        'party_name' => 'Harbour Trading Pte Ltd',
        'date' => '2026-09-08',
        'due_date' => '2026-10-08',
        'total' => 10000.00,
        'amount_paid' => 5000.00,
        'amount_due' => 5000.00,
        'lines' => [
            ['line_item_id' => 'INV-1001-1', 'account_code' => '4000', 'description' => 'Office chairs', 'amount' => 10000.00],
        ],
    ],
    [
        'external_id' => 'INV-1002',
        'number' => 'INV-1002',
        'party_name' => 'Pacific Desk Co',
        'party_country' => 'United States',
        'date' => '2026-09-21',
        'due_date' => '2026-10-21',
        'currency_code' => 'USD',
        'exchange_rate' => 1.35,   // 1 USD = 1.35 SGD
        'total' => 1000.00,        // in USD
        'lines' => [
            ['line_item_id' => 'INV-1002-1', 'account_code' => '4000', 'description' => 'Standing desks', 'amount' => 1000.00],
        ],
    ],
];

$request = written(call('POST', "/organisations/$companyId/invoices", [
    'declarations' => [
        'source_reference' => 'my-ledger',
        'period' => '2026-09',
        'value_basis' => 'document',          // amounts are in each invoice's own currency
        'rate_direction' => 'document_to_base', // the rate turns USD into SGD
        'base_currency' => 'SGD',
    ],
    'records' => $invoices,
]));

show('Invoices', $request);
php foreign-invoice.php

Check

Invoices: request 98 - 1 created, 0 updated, 1 unchanged, 0 refused

INV-1002 is created. INV-1001 is unchanged: its total, payments, status and customer are the same as before.

4The rules about rates

When a rate is needed
The two rules about rates: another currency needs one; the company's own takes 1 or none.

Each refuses just that document.

Want more detail? See the documentation