JavaScript · Track 6 · Tutorial 1 of 2

Send operational data

Send the numbers behind the money - headcount, volumes, hours - so they sit beside the financial figures.

You will needThe client from Make your first call.
By the endSeptember's headcount by department in BrizoConsol, as a dataset of its own.

1What operational data is

The numbers behind the money: headcount, units sold, hours worked, square metres. BrizoConsol keeps them beside the financial figures, so you can put them side by side - revenue per head, cost per unit.

2Shape your rows

Each row is one figure for one month, described by up to five dimensions - department, location, product, whatever your figure is broken down by. A row is identified by its month, scenario, dimensions and account, so sending the same row again updates its value.

What a row of operational data holds
A row of operational data: a month, up to five dimensions that describe it, and a value.

3Send September's headcount

Create operational.mjs:

operational.mjs

// operational.mjs - sends September's headcount by department.
import { call, companyId, show, written } from './brizo.mjs';

const rows = [
    { period: '2026-09', dimension_1: 'Sales', value: 12 },
    { period: '2026-09', dimension_1: 'Operations', value: 8 },
    { period: '2026-09', dimension_1: 'Finance', value: 3 },
];

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

await show('Headcount', request);
node operational.mjs

Check

Headcount: request 100 - 3 created, 0 updated, 0 unchanged, 0 refused
Each source becomes a dataset
Each source_reference becomes a dataset of its own, named after it.

4The source becomes the dataset

The first send from a source_reference creates a dataset for the company named API: and the source - API: headcount here. Send other figures under other source names, and each becomes a dataset of its own.

5Sending a month again

  • Each send replaces this source's figures for the month and scenario: a row you leave out is removed. Send "mode": "merge" to add and update only.
  • Figures are kept as you send them; they aren't converted to another currency.
  • A company holds up to 1,000 rows a month.

Want more detail? See the documentation