Kraal Docs

Appearance

Client Detail Page — User Guide ​

The Client Detail page is the configuration hub for each accounting client in Kraal. Access it via Settings > Clients > [click a client].

This guide covers every section on the page so you know what each one does and how to use it.

Page Header ​

  • Client Name & Status Badge — Shows the client name and current status: active, not_started, or offboarded.
  • Action Buttons:
    • Overview — Opens the workspace view for this client
    • Actions — Shows next actions to take
    • Open ERPNext — Opens the client's ERPNext instance in a new tab
    • Edit — Edit client details
    • Delete — Remove the client (requires confirmation)
  • Provisioning Banner — Appears while Kraal sets up the client's ERPNext instance. Shows progress or failure status. Wait for provisioning to complete before proceeding with setup.

Main Content (Left Column) ​

1. COA Status Card ​

Shows the current Chart of Accounts source and template, along with the total account count.

Status badges:

StatusMeaning
ReadyCOA is loaded and usable
PendingCOA setup is in progress
Upload neededNo COA has been configured yet
SyncingCOA is syncing from ERPNext
ErrorSomething went wrong — check the error message

TIP

Your COA is the backbone of all accounting. It must show "Ready" before transactions can be categorized or posted.

2. Bank Feed (Plaid Integration) ​

A three-step wizard to connect bank accounts:

  1. Connect — Links your bank through Plaid. Bank credentials are never stored on Kraal servers.
  2. Map — Maps each bank account to an account in your chart of accounts. On a multi-entity client, you also confirm which entity's books each account belongs to; you can't save the mapping until you choose. Single-entity clients skip this. See Working with Multiple Entities.
  3. Sync — Automatically imports transactions on a recurring basis.

Click Connect Bank Account to start. Plaid supports 12,000+ financial institutions.

3. Chart of Accounts Configuration ​

Two options for setting up a COA:

MethodBest for
Apply Standard TemplateNew businesses or clients with a standard chart structure. Select an industry-specific template (E-commerce/Retail, SaaS, Professional Services, etc.) and click Apply Template.
Build with AIClients with existing transaction history. Upload a CSV, XLS, or PDF of transactions or bank statements and Kraal's AI will generate a tailored COA.

TIP

Use templates for a quick start. Use the AI builder if you have existing transaction history that should inform the account structure.

4. Accounting Dimensions (ERPNext only) ​

Accounting dimensions are additional categorization axes — such as Department, Project, or Cost Center — that are applied to transactions.

  • Synced from your ERPNext configuration
  • Shows each dimension's name, whether it is Required or Optional, and its default value
  • Warning badges appear when required dimensions are missing defaults — transactions may fail without them
  • Refresh from ERPNext — Re-syncs dimension configuration from ERPNext

What to do: Ensure all required dimensions have defaults set. Use the "Configure" links to set defaults in ERPNext.

5. Close Configuration ​

Assign a close template to define the monthly close workflow for this client. Close templates are managed in Settings > Close Templates.

The template controls which steps appear in each monthly close period — accruals, reconciliation, review, and so on. Steps are dependency-gated, meaning each step waits for its prerequisites to complete.

6. Close Readiness ​

A pre-flight checklist that verifies four requirements before you can start an automated close:

CheckWhat it verifies
COA presentCOA status is Ready
ERP connection verifiedERPNext is configured and reachable
Accounting dimensions loadedDimensions have been synced successfully
Close template assignedClient has an active close template
  • Ready — All checks pass. You can start a close period.
  • Blocked — One or more checks failed. The specific failures are listed.

What to do: Resolve all listed blockers before attempting to start a close kickoff.

TIP

For a detailed walkthrough of setting up automated close, see the Automated Close: Client Setup guide.

7. Accrual Schedules ​

Configure recurring accrual entries for items like rent, insurance, or prepaid expenses. These entries are automatically generated during each close period.

Click + Add Schedule to create your first recurring accrual. Define the accounts, amounts, and frequency.

8. Cost Centers ​

Manage cost centers (departments, business units) for ERPNext. You can:

  • Create new cost centers
  • Rename existing ones
  • Nest them under parent cost centers
  • Mark as group or leaf
  • Disable unused cost centers

Cost centers enable departmental P&L reporting in ERPNext.

9. Pending Docs & Transactions ​

Quick metrics showing the count of pending documents and total transactions. This gives a snapshot of the current processing workload for the client.

10. Details ​

  • Contact Email — Primary contact for this client
  • Backend System — ERPNext, QuickBooks, or None
  • Created On — Date the client was created
  • Description — Optional description (if set)

11. Quick Access ​

Shortcuts to common actions:

  • View Documents — Navigate to documents for this client
  • Banking Intake — Jump to statement upload or optional Plaid setup
  • Manual COA Entry — Manually add accounts to the chart of accounts
  • Start Close Kickoff — Opens Monthly Close. Only enabled when Close Readiness shows "Ready"
  • Launch Readiness — Review the client setup checks Kraal verifies before launch

12. Automation ​

Controls for automating transaction processing:

  • Readiness status — Shows whether Kraal has verified the prerequisites needed for safe automation:

    • Ready — Setup is validated and automation can be enabled
    • Needs action — A business step is still required
    • Kraal is checking — Kraal is verifying or repairing a setup item in the background

  • Autonomy mode — Choose how much Kraal does on its own for this client:

    • Supervised — Kraal may post low-risk routine entries on its own, within the guardrails below. Everything it posts is logged in Auto-Posted Entries and can be undone.
    • Approval-first (Locked Down) — Kraal posts nothing without your explicit approval. Use this for new or sensitive clients.
    • Automatic posting is also disabled whenever readiness detects setup drift that could make posting unsafe.

  • Posting guardrails — In Supervised mode, an entry only auto-posts if it clears every guardrail: risk tier (high-risk families such as tax provisions and equity always wait), per-entry / per-account / monthly amount caps, a daily volume limit, an evidence-confidence minimum, new-vendor holds, restricted categories (for example Payroll), materiality, and duplicate detection. Choose a preset (Conservative or Trusted) and adjust the caps here; the active limits are always shown.

    ➡️ See Autonomy & Safety for the complete model and the default limits.

  • Default ERPNext Company — Required for posting. Set this to avoid errors when entries are posted.

13. Entities (ERPNext only) ​

Manage the companies and legal entities linked to this client, and record how they roll up in the Ownership & structure panel:

  • View entity details: abbreviation, currency, country, parent company
  • Set the primary entity
  • Add or attach an entity and set its relationship — subsidiary (consolidated), branch/division (same legal entity), or affiliate/investment (not consolidated) — plus ownership % and an effective from date
  • Edit a relationship later; edits are effective-dated, so earlier history is preserved
  • A "details still needed" note calls out any missing ownership details to fill in

Use this for businesses with multiple legal entities under one client account. For the full walkthrough, see Working with Multiple Entities.

14. ERPNext Readiness ​

  • Connection readiness — Kraal verifies ERPNext connectivity automatically
  • Sync ERPNext COA — Re-sync the chart of accounts from ERPNext to Kraal when needed

A warning is shown if ERPNext provisioning or chart readiness has not completed.

15. ERP Status ​

A summary indicator showing the overall ERPNext readiness:

StatusMeaning
ERP-readyEverything is configured and working
ERP needs COAChart of accounts must be set up before automation works
ERP syncingCOA is currently syncing
ERP setupERPNext connection needs to be configured

Common Workflows ​

Setting up a new accounting client ​

  1. Create the client and let Kraal provision ERPNext automatically.
  2. Follow guided setup until ERPNext and chart readiness are verified.
  3. Choose banking intake: upload statements or connect optional Plaid bank feeds.
  4. If the client uses QuickBooks Online, connect QuickBooks and let Kraal verify first sync.
  5. Set up accounting dimensions when needed.
  6. Assign a Close Template.
  7. Verify Close Readiness shows "Ready".
  8. Configure automation settings only after readiness is clear.

Kraal — AI-powered accounting for modern firms

Copyright © 2026 Kraal AI