Post opening balances (EB values)

Posts opening balances from a trial balance into the general ledger as opening-balance values. Each opening balance is booked against account 9000 (general-ledger opening balances). Only balance-sheet accounts (assets, liabilities, equity) are allowed — no P&L accounts. Total debit must equal total credit. All entries share a common intent ID; reversal is possible via reverse_booking.

post_opening_balances

Authorization

Authorization string header required API key in the format ll_.... Pass as a Bearer token in the OAuth flow.

Scopes

journal:write

Parameters

booking_date string required Booking date (YYYY-MM-DD), typically the first day of the new fiscal year

balances array required Opening balances. Each entry has exactly one amount > 0 (either debit or credit). Assets typically debit, liabilities/equity credit.

Response

200

Success

MCP post_opening_balances

JSON

{
  "tool": "post_opening_balances",
  "params": {
    "booking_date": "<string>",
    "balances": [
      {
        "account_number": "<string>",
        "account_name": "<string>",
        "debit": 1,
        "credit": 1
      }
    ]
  }
}

200 Response

JSON

{
  "status": "<string>",
  "intent_id": "<string>",
  "event_count": 1,
  "total_debit": 1,
  "total_credit": 1,
  "booking_date": "<string>",
  "contra_account": "<string>"
}