PHP · 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.php:
budget.php
<?php
// budget.php - sends a month of budget.
require __DIR__ . '/brizo.php';
$request = written(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"]));
show('Budget', $request);php budget.phpCheck
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