AgentSkillsCN

commerce-general-ledger

管理总账、科目表、日记账分录以及财务报表。当您进行记账处理、结账核算，或生成试算表与财务报告时使用。

SKILL.md
--- frontmatter
name: commerce-general-ledger
description: Manage the general ledger, chart of accounts, journal entries, and financial statements. Use when posting transactions, closing periods, or generating trial balance and financial reports.

Commerce General Ledger

Double-entry accounting with chart of accounts, journal entries, period management, and financial statement generation.

How It Works

  1. •Set up the chart of accounts with account hierarchy.
  2. •Open accounting periods (monthly, quarterly, yearly).
  3. •Post journal entries with balanced debits and credits.
  4. •Configure auto-posting rules for commerce transactions.
  5. •Generate trial balance, balance sheet, and income statement.
  6. •Close periods to lock posted entries.

Usage

  • •MCP tools: list_gl_accounts, create_gl_account, update_gl_account, list_gl_periods, create_gl_period, close_gl_period, create_journal_entry, post_journal_entry, void_journal_entry, get_trial_balance, get_balance_sheet, get_income_statement, configure_auto_posting.
  • •Writes require --apply.

Account Types

  • •Asset (normal debit), Liability (normal credit), Equity (normal credit), Revenue (normal credit), Expense (normal debit)
  • •25+ subtypes: Cash, AccountsReceivable, Inventory, FixedAssets, AccountsPayable, SalesRevenue, COGS, etc.

Period Statuses

  • •Future -> Open -> Closed -> Locked

Journal Entry Statuses

  • •Draft -> Pending -> Posted (or Voided/Reversed)

Journal Entry Sources

  • •Manual, AutoInvoice, AutoPayment, AutoBill, AutoBillPayment, AutoInventory, AutoWriteOff, SystemClosing, Import

Output

json
{"status":"posted","journal_entry_id":"JE-2025-0100","period":"2025-01","total_debits":1500.00,"total_credits":1500.00}

Present Results to User

  • •Journal entry number and posting status.
  • •Debit/credit totals (must balance).
  • •Affected accounts and running balances.
  • •Period status and closing readiness.

Troubleshooting

  • •Entry won't post: verify debits equal credits.
  • •Period locked: cannot post to a locked period; use adjusting entries in the next open period.
  • •Account inactive: reactivate account or use a different posting account.

References

  • •references/gl-accounts.md
  • •/home/dom/stateset-icommerce/crates/stateset-core/src/models/general_ledger.rs
  • •/home/dom/stateset-icommerce/crates/stateset-embedded/src/general_ledger.rs