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.

You will needThe month script from Send a month's trial balance.
By the endA budget month in BrizoConsol, and a script you can point at any month and either scenario.

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.php

Check

Budget: request 95 - 3 created, 0 updated, 0 unchanged, 0 refused

3How 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.
How a plan month differs from an actual one
Budget and forecast months are sent account by account, unlike actual months.

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).

The group setting that decides whether a company takes plan figures
Whether a company accepts budget and forecast figures depends on the group's Budget & Forecast Input setting.

Want more detail? See the documentation