Business Concepts Documentation
Overview
This section contains business-friendly explanations of key financial and accounting concepts in the ERP system. These guides are written in plain language without technical jargon, code examples, or implementation details.
Who Should Read These Guides?
- Business Users: Accountants, bookkeepers, data entry staff
- Managers: Finance managers, controllers, department heads
- Clients: Decision-makers evaluating or implementing the system
- Trainers: Staff training new users on system concepts
- Business Analysts: Understanding business requirements
What You'll Find Here
Each guide explains:
- What the concept is (with real-world analogies)
- Why it matters to your business
- How it's used in practice (with business examples)
- When to use different options
- Common configurations and best practices
- Mistakes to avoid
What You Won't Find Here
- Code examples or technical implementation details
- Database schemas or system architecture
- Developer-focused workflows
- API documentation
For technical documentation, see the /docs/concepts/ and /docs/domain/ sections.
Documentation by Category
Core Financial Concepts
These are fundamental building blocks of the accounting system that every user should understand.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Main Accounts | What Main Accounts are, account types, and how they structure your financial data | 7 minutes |
| Understanding Vouchers | How vouchers group accounting entries, numbering strategies, and reversal process | 6 minutes |
| Understanding Number Sequences | Automatic numbering for documents, format patterns, and lifecycle management | 5 minutes |
Journal and Transaction Processing
Learn how transactions are recorded and processed in the general ledger.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Journal Names | Journal templates, voucher generation strategies, and offset account configuration | 5 minutes |
| Understanding General Journals | The primary tool for recording financial transactions in the General Ledger | 15 minutes |
| Understanding Journal Posting | How journals move from draft to posted, validation rules, and period controls | Coming Soon |
| Understanding Reversals | How to correct posted transactions while maintaining audit trail | 6 minutes |
Dimensional Accounting
Understand how the system tracks transactions across multiple business perspectives.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Financial Dimensions | What dimensions are, how they differ from Main Accounts, and common dimension types | 8 minutes |
| Understanding Account Structures | How dimension requirements are defined for different Main Accounts | 7 minutes |
| Understanding Default Dimensions | How to automatically apply dimensional information to transactions | 6 minutes |
| Understanding Dimension Combinations | How the system stores and reuses dimensional account structures | Coming Soon |
Fiscal Management
Learn how the system manages time-based financial controls.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Fiscal Calendars | How fiscal years and periods control transaction posting | 5 minutes |
| Understanding Period-End Closing | The process of closing financial periods and fiscal years | Coming Soon |
Chart of Accounts
Understand how your financial structure is organized.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Chart of Accounts | How Main Accounts are organized into a hierarchical structure | Coming Soon |
| Understanding Account Categories | Grouping accounts for reporting and financial statement presentation | Coming Soon |
Tax Management
Learn how the system handles sales tax and VAT calculations.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Sales Tax and VAT | Tax calculation, tax groups, tax item groups, and intersection logic | 10 minutes |
| UAE VAT Setup and Reporting | Configure legal entity VAT information for UAE FTA compliance and electronic VAT returns | 8 minutes |
| Understanding Tax Codes | Tax rates, calculation methods, and posting accounts | Coming Soon |
| Understanding Tax Groups | Entity-based tax classification (customers, vendors) | Coming Soon |
| Understanding Tax Item Groups | Product-based tax classification | Coming Soon |
Accounts Receivable
Concepts specific to customer invoicing and payments.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Customer Accounts | Customer master data and default dimensions | Coming Soon |
| Understanding Sales Invoices | Invoice creation, posting, and GL integration | Coming Soon |
| Understanding Customer Payments | Payment application and cash discount handling | Coming Soon |
Accounts Payable
Concepts specific to vendor invoicing and payments.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Vendor Accounts | Vendor master data and default dimensions | Coming Soon |
| Understanding Purchase Invoices | Invoice processing, matching, and posting | Coming Soon |
| Understanding Vendor Payments | Payment processing and check printing | Coming Soon |
Cash Management
Concepts specific to payment processing, scheduling, and cash flow management.
| Guide | Description | Reading Time |
|---|---|---|
| Understanding Payment Schedules | How to split payments into installments, allocation methods (Fixed, Fixed Quantity, Custom), payment frequencies, and automated payment calculations | 25 minutes |
| Understanding Payment Methods | Payment instrument types (Cash, Cheque, Electronic, Bank), customer vs vendor payment methods, and payment processing workflows | 18 minutes |
| Understanding Bank Accounts | Bank account setup, reconciliation, and statement processing | Coming Soon |
| Understanding Cash Flow Forecasting | Cash position tracking and forecasting | Coming Soon |
How to Use These Guides
For New Users
Recommended Reading Order:
- Understanding Main Accounts (foundation)
- Understanding Vouchers (transaction grouping)
- Understanding Journal Names (how to enter transactions)
- Understanding Number Sequences (automatic numbering)
- Additional guides based on your role
Time Investment: 30-45 minutes for core concepts
For Administrators
Essential Reading:
- All Core Financial Concepts
- Journal and Transaction Processing
- Dimensional Accounting
- Tax Management (if applicable)
Focus On:
- Configuration decisions sections
- Best practices
- Common mistakes to avoid
For End Users
Focus On:
- Core Financial Concepts (what you work with daily)
- Your specific area (AR, AP, GL)
- FAQs and practical examples
Skip:
- Administrative configuration details
- Advanced concepts not relevant to your role
For Managers
Recommended Reading:
- All Core Financial Concepts (understand the fundamentals)
- "Why it matters" sections (business impact)
- Benefits summary sections
- Common mistakes to avoid
Focus On:
- Strategic decisions
- Business impact
- Control points
Additional Resources
Related Documentation
For Step-by-Step Instructions:
- See User Guides for detailed UI walkthroughs with screenshots
For Technical Understanding:
- See Technical Concepts for developer-focused workflows and integration
- See Domain Documentation for technical implementation details
For API Integration:
- See API Documentation for REST endpoint specifications
Getting Help
If a concept is unclear:
- Check the FAQ section of the specific guide
- Review related guides (linked at bottom of each document)
- Consult the step-by-step User Guide for that feature
- Contact your system administrator or training team
If you need to perform a task:
- Start with the Business Concept guide (understand what and why)
- Move to the User Guide (step-by-step how)
- Practice in a test environment before working with live data
Documentation Standards
What Makes These "Business Concepts"?
All guides in this section follow these principles:
Language:
- Plain language, no technical jargon
- Real-world analogies and examples
- Business-focused explanations
Content:
- Why the concept matters (business value)
- How it works in practice (business scenarios)
- When to use different options (decision frameworks)
- What to avoid (common mistakes)
Format:
- Clear section headings
- Scannable tables and lists
- Practical examples
- FAQ sections
What's Excluded:
- No code examples
- No technical implementation details
- No developer-focused architecture
- No database or system internals
Feedback and Improvements
These guides are living documents that improve based on user feedback.
Help us improve:
- What concepts need clearer explanation?
- What business scenarios should we add?
- What questions aren't answered in the FAQs?
- What analogies work well (or don't work)?
Contact: Your system administrator or training coordinator
Quick Reference
Most Frequently Referenced Guides
Based on user feedback, these are the most helpful starting points:
- Understanding Main Accounts - Essential for everyone
- Understanding Journal Names - Critical for transaction entry
- Understanding Vouchers - Important for audit trail
- Understanding Number Sequences - Key for administrators
Common Question → Guide Mapping
| Question | See This Guide |
|---|---|
| "What account should I use?" | Understanding Main Accounts |
| "Why is it asking for a voucher?" | Understanding Vouchers |
| "How do I configure journals?" | Understanding Journal Names |
| "What are these number formats?" | Understanding Number Sequences |
| "What's the difference between dimensions and accounts?" | Understanding Financial Dimensions |
| "Why can't I post this journal?" | Understanding Journal Posting |
| "How do I fix a posted entry?" | Understanding Reversals |
| "What are these fiscal period errors?" | Understanding Fiscal Calendars |
Contributing to This Documentation
For Documentation Team:
When creating new Business Concept guides:
- Use the Template (see
/docs/templates/business-concept-template.md) - Follow Naming Convention:
understanding-[concept].mdorwhat-is-[concept].md - Test with Non-Technical Users: Ask a business user to review
- Include Real Examples: Use actual business scenarios from your organization
- Keep It Concise: 5-8 minutes reading time maximum
- Link to Related Guides: Help users navigate to related concepts
- Update This Index: Add your new guide to the appropriate category above
Quality Checklist:
- No code examples or technical jargon
- Includes real-world analogy
- Explains business value clearly
- Provides practical examples
- Includes FAQ section
- Links to related resources
- Reading time estimate provided
- Reviewed by non-technical user
Version History
| Date | Changes | Author |
|---|---|---|
| 2025-01-15 | Initial creation with 5 core concept guides | Documentation Team |
| - Understanding Main Accounts | ||
| - Understanding Vouchers | ||
| - Understanding Number Sequences | ||
| - Understanding Journal Names | ||
| - README index created |
This documentation is maintained by the ERP Implementation Team. For questions or suggestions, contact your system administrator.