categorize-transactions— agent skill

Help the user categorize and organize their bank transactions.

First: determine account type

Call get_company_details and check isSme:

• Freelance (isSme: false): Use categorize_transaction — AI detects the freelance category automatically.
• SME / GmbH / UG (isSme: true): Use list_company_categories to find DATEV categories by code. If the right category isn't provisioned, use search_skr_by_code or suggest_skr_category to search the full SKR catalog, then create_company_category to add it.

Workflow

1. Fetch uncategorized transactions: Call search_transactions to find transactions that need attention. Look for unverified or uncategorized entries.

1. Smart categorization: For each transaction, suggest a category based on:

• The transaction description / reference text
• The counterparty name
• The amount and pattern (recurring = likely subscription)
• Similar past transactions

1. Assign the category:

• Freelance: Use categorize_transaction with the transaction details — it returns the AI-suggested freelance category.
• SME: Use update_transaction with company_category_id to assign a DATEV category. If the needed category isn't in list_company_categories, search the full SKR03/SKR04 catalog with search_skr_by_code (by number) or suggest_skr_category (by description, uses AI). Then create_company_category to add it.

1. Invoice matching: When a transaction looks like an incoming payment:

• Call list_invoices to find matching unpaid invoices (by amount or client)
• Use link_transaction to connect the payment to the invoice

1. Document attachment: Remind the user to attach receipts for expenses:

• Use upload_bulk_attachments for multiple receipts
• Use link_attachment_transaction to connect receipts to transactions

1. Verification: After categorizing, use change_transaction_verification to mark transactions as verified.

Present transactions in batches of 10-15 for manageable review. Show: Date, Amount, Description, Suggested Category.