Księgowość

List the chart of accounts (COA) for this connection's business profile.

Set up the starter chart of accounts (28-row Polish COA) for a business profile that doesn't have one yet, plus the account-key map (resolves semantic keys like BANK_MAIN/AR_CUSTOMERS/VAT_OUTPUT to specific account codes) that other posting tools rely on. Safe to call defensively before drafting journal entries for a new business - if a chart of accounts already exists, returns alreadyExists:true instead of an error. Requires draft_write or full_post permission tier.

Add a new account to this business profile's chart of accounts. Use setup_chart_of_accounts first if the profile has no chart of accounts at all. Requires draft_write or full_post permission tier.

Edit an existing chart-of-accounts entry (partial update - only pass fields you want to change). Also used to reactivate a previously deactivated account (isActive: true). Requires draft_write or full_post permission tier.

Soft-delete (deactivate) a chart-of-accounts entry - it stops appearing for new postings but its historical postings are unaffected and it can be reactivated later via update_chart_account. Blocked if the account is still referenced by any DRAFT (unposted) journal entry lines - resolve those first. Requires draft_write or full_post permission tier.

Per-account balances (current, month-to-date change, year-to-date change) as of a given date - the raw data behind the balance sheet / trial balance. Only includes posted journal entries. Cross-reference with get_chart_of_accounts for account codes/names/types (asset/liability/equity/revenue/expense).

Create a manual journal entry (debits/credits must balance to within 0.01) for something not covered by a bank transaction or invoice - e.g. a correction, accrual, or depreciation entry. Requires draft_write or full_post permission tier. ALWAYS created as entry_status='draft' - never auto-posted, regardless of tier. Use preview_journal_entry_posting then post_journal_entry (with explicit user confirmation) to actually post it to the ledger.

Dry-run preview of posting a draft journal entry - shows the entry and its lines, but posts NOTHING. Required before post_journal_entry will succeed (same journalEntryId, within 15 minutes). Show this briefing to the user and get their explicit go-ahead before calling post_journal_entry - never chain straight from preview to post without the user confirming in between.

Post a draft journal entry to the ledger - a REAL, immediate write, not reversible via this tool. Requires a connection with full_post permission tier, AND a matching preview_journal_entry_posting call for the exact same journalEntryId within the last 15 minutes, AND the user has explicitly confirmed after seeing that preview. Never call this speculatively or without the user's explicit go-ahead. After posting, give the user a short briefing of exactly what was posted.