JavaScript · Track 3 · Tutorial 4 of 6
Send a budget or forecast
Send your budget or forecast the same way as a month of actuals - and learn the three ways a plan month behaves differently.
1Plans go in like a month
A budget or a forecast is sent the same way as a month's trial balance, with one more declaration: scenario, set to Budget or Forecast. Without it, a month is Actual.
2Send October's budget
Create budget.mjs:
budget.mjs
// budget.mjs - sends a month of budget.
import { call, companyId, show, written } from './brizo.mjs';
const request = written(await call('POST', `/organisations/${companyId}/trial-balances`, {
declarations: {
source_reference: 'my-budget',
period: '2026-10',
scenario: 'Budget',
value_basis: 'company_base',
rate_direction: 'document_to_base',
base_currency: 'SGD',
},
records: [
{ account_code: '4000', debit: 0, credit: 32000.00 },
{ account_code: '5000', debit: 8500.00, credit: 0 },
{ account_code: '6000', debit: 2000.00, credit: 0 },
],
}, { 'Idempotency-Key': `${companyId}-2026-10-budget-v1` }));
await show('Budget', request);node budget.mjsCheck
Budget: request 95 - 3 created, 0 updated, 0 unchanged, 0 refused3How a plan month differs
- Only the accounts you send are replaced. A plan is entered account by account, so a send that names three accounts leaves the rest of the month's plan alone.
- The reporting month doesn't move.
- Any month can be planned, even beyond the history your plan keeps. A locked month is still refused.
4Check where your group enters plans
Each group decides whether budgets and forecasts are entered for each company, for the group as a whole, or both. Sending a plan to a company is refused if the group only takes them at consolidated level: Plan movement is entered at group level for this group…
The setting is Budget & Forecast Input on the group's Organisation Details page (Settings → Organisation Settings → Organisation Details, with the group selected).
Want more detail? See the documentation