C# · 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.cs:
Budget.cs
// Budget.cs - sends a month of budget.
public static class Budget
{
public static async Task Run(string[] args)
{
var request = Brizo.Written(await Brizo.Call("POST", $"/organisations/{Brizo.CompanyId}/trial-balances", new
{
declarations = new
{
source_reference = "my-budget",
period = "2026-10",
scenario = "Budget",
value_basis = "company_base",
rate_direction = "document_to_base",
base_currency = "SGD",
},
records = new[]
{
new { account_code = "4000", debit = 0.00, credit = 32000.00 },
new { account_code = "5000", debit = 8500.00, credit = 0.00 },
new { account_code = "6000", debit = 2000.00, credit = 0.00 },
},
}, new() { ["Idempotency-Key"] = $"{Brizo.CompanyId}-2026-10-budget-v1" }));
await Brizo.Show("Budget", request);
}
}dotnet run -- BudgetCheck
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