Finance agent

Status

Stable — six tools live, in daily production use.

The Finance agent is the most-used agent in BOS. It answers questions about your accounts: cashflow, balances, invoices, vendor bills, reconciliation, GL movements.

What it knows about

Domain	Specifics
Cash position	Bank balances, cash-on-hand, currency breakdown
GL balances	Any account in the chart of accounts at any point in time
Bank transactions	Imported via PSD2 — reads through the same data BOS Banking surfaces
Reconciliation status	Which transactions are reconciled, which await action
Cashflow over time	Daily series for the period you ask about

Tools it can call

Six tools, each scoped to read-only Odoo queries:

Tool	What it does
GetGLBalance	Balance of a GL account at a date
ListGLAccounts	The chart of accounts hierarchy
GetCashFlow	Cash position by date over a range
GetBankBalance	Per-journal bank balance
GetBankTransactions	Transactions from a journal in a date range
ReconcileAccount	Read-only — suggested reconciliations

ReconcileAccount is read-only at the moment — it shows what would match without actually reconciling. Write-back reconciliation will open up once Shadow Mode is disabled per-agent.

Sample dialogues

"What is my cash today?"

You:      What's our cash position today?

Finance:  🔧 GetCashFlow(date="today")
          Cash is BGN 142,567 across three bank journals:
            · Revolut BGN  — BGN 87,422
            · UBB EUR (BGN equivalent) — BGN 38,910
            · Cash in hand — BGN 16,235
          You're up BGN 8,200 vs last Friday, mostly from customer
          payments on invoices INV-2026-04-118 and INV-2026-04-125.

"Which invoices are overdue?"

You:      Which invoices are overdue more than 30 days?

Finance:  🔧 GetGLBalance(account="account_receivable", date="today")
          🔧 GetBankTransactions(date_from="-30d")
          You have 7 overdue invoices totalling BGN 28,450:
            · Acme Corp — INV-2026-03-22 — BGN 12,500 — 38d
            · Beta Ltd  — INV-2026-03-30 — BGN  4,800 — 30d
            · Gamma OOD — INV-2026-04-04 — BGN  3,200 — 25d
            ...

          Click each one to open the invoice in PLANA Business Cloud.

"Reconcile this transaction with this invoice"

You:      Is the BGN 12,500 from Acme Corp matching INV-2026-03-22?

Finance:  🔧 ReconcileAccount(transaction_id=12345)
          Yes — that transaction matches INV-2026-03-22 exactly:
            · Amount: BGN 12,500.00 (exact match)
            · Reference: "INV-2026-03-22" in the transaction memo
            · Counterparty: ACME CORP EOOD (matches the customer)

          In Shadow Mode, I'm not reconciling for you. Open the
          transaction in PLANA Business Cloud → Accounting → Bank
          to confirm the match.

What the Finance agent CANNOT do (today)

• Post a journal entry — agents do not write to the GL
• Issue an invoice — invoicing is in PLANA Business Cloud
• Send a payment reminder — that lives in the ERP
• Reconcile a transaction (apply the match) — Shadow Mode

When write actions ship, they will be opt-in per-tool from Settings → Workspace.

What works well, what works less well

Works well

• "How is cash compared to last week / last month?"
• "What's the GL balance on account X at date Y?"
• "Which invoices are overdue?" / "Which bills are due in the next 7 days?"
• "Which transactions are unreconciled?"
• "What's our biggest cost category this month?"

Works less well

• Currency conversion for non-Bulgarian currencies — works for EUR/USD/GBP against BGN; for exotics, the agent will say "I don't have rates"
• Year-end closing questions — period closing is a workflow, not a query. Use PLANA Business Cloud's period-closing screen instead.
• Forecasting — the agent answers about the past and present. It does NOT forecast cashflow. (Forecasting is on the roadmap.)
• Compliance questions ("are we VAT-compliant for May?") — the agent shows you the data; it does not validate compliance. Use the Bulgarian fiscal reports for that.

Tips

• Pin the period in the TabBar before asking time-bound questions — "this month" inherits the active period.
• Ask follow-ups — once the agent fetches a list of overdue invoices, you can ask "show me the top 3" or "who is the worst payer over the last quarter?"
• Use the Execution log — every tool call is captured; if you want to see the raw data the agent saw, open the Execution log.

Where to read more

• How agents work
• Warehouse agent
• Sales agent
• Workflows → Reconcile the bank
• BOS → Banking — the same PSD2 data the agent reads from
• Execution log — audit trail