Data Entry Standards
Conventions for consistent master data naming, coding, validation, and import quality across EGKits SaaS V10 modules.
Data Entry Standards
Inconsistent master data causes failed imports, broken integrations, duplicate customers, and unreliable financial reports. This guide defines naming, coding, and validation standards for EGKits SaaS V10 — apply them before bulk import, API sync, or large-scale manual entry.
#Data governance model
| Role | Responsibility |
|---|---|
| Data steward | Owns code lists and approves new master records |
| Module owner | Defines required fields per business process |
| IT / integration | Enforces formats in API and import pipelines |
| Finance | Approves COA changes and opening balances |
Publish standards internally before go-live and retrain when codes change.
#Universal coding conventions
#General rules
- Use uppercase alphanumeric codes with hyphens —
CUST-1001,SKU-A4-500. - Avoid spaces, special characters (
/,\,#), and leading zeros inconsistency. - Never reuse codes — retire obsolete codes; do not recycle for different entities.
- Keep codes stable — use separate
Namefield for display text that can change. - Maximum practical length: 20 characters unless module template specifies otherwise.
#Prefix standards by entity
| Entity | Prefix | Example |
|---|---|---|
| Customer | CUST- |
CUST-1042 |
| Supplier | SUP- |
SUP-2201 |
| Product / SKU | SKU- or category-based |
SKU-PAPER-A4 |
| GL account | Numeric hierarchy | 1100, 4100-01 |
| Employee | EMP- |
EMP-00987 |
| Fixed asset | FA- |
FA-IT-0042 |
| Branch / site | BR- |
BR-RIYADH |
#Chart of accounts
- Follow a consistent hierarchy — assets 1xxx, liabilities 2xxx, equity 3xxx, revenue 4xxx, expense 5xxx (adapt to local standards).
- Use summary accounts as non-posting parents; post only to leaf accounts.
- Document account purpose in the description field — not in the code.
- Do not delete accounts with history — mark inactive instead.
- Align with Fixed Assets posting rules and tax books before first depreciation run.
#Products and catalog
| Field | Standard |
|---|---|
| SKU | Unique, immutable, matches warehouse labels |
| Name | Customer-facing description; title case |
| Category | Use seeded taxonomy before creating ad-hoc categories |
| UOM | Standard units from system list — do not abbreviate inconsistently |
| Barcode | GTIN when available; validate check digit |
| Tax code | Required on every sellable item |
| Price | Base price in tenant currency; document currency overrides separately |
For bilingual tenants, enter Arabic name in the designated field — do not mix scripts in the SKU or code fields.
#Trading partners (customers and suppliers)
- Legal name must match tax registration documents for e-invoice compliance.
- Tax ID / VAT number — validate format per jurisdiction before save.
- One logical customer = one master record — use Bill-to / Ship-to addresses instead of duplicates.
- Assign payment terms and credit limit at creation for AR automation.
- Use External ID field for mapping to legacy system keys during migration.
#Financial transactions
- Document date must fall in an open fiscal period.
- Reference field — use source document number (
PO-2026-0142, notmisc). - Line descriptions — meaningful text for audit; avoid
testor.in production. - Amounts — two decimal places unless crypto/high-precision module configured.
- Attachments — link supporting documents for journals above approval threshold.
#Import file standards
| Rule | Detail |
|---|---|
| Encoding | UTF-8 with BOM for Arabic content |
| Delimiter | Comma; quote fields containing commas |
| Headers | Exact match to EGKits template — do not rename columns |
| Dates | ISO 8601 (YYYY-MM-DD) |
| Booleans | true / false lowercase |
| Empty values | Leave blank — do not use NULL, -, or N/A |
| Batch size | ≤ 5,000 rows per file for UI import; larger via API |
Always run imports in dependency order: COA → partners → products → opening balances → transactions.
#Validation before production entry
Use this checklist for new records:
- Code unique and follows prefix standard
- Required tax and GL mappings present
- Names free of trailing spaces and double spaces
- Status set to Active only when ready for transactions
- Branch assignment correct for scoped users
- External ID populated for integration mapping
#Common data quality issues
| Symptom | Root cause | Prevention |
|---|---|---|
| Duplicate customers | Manual entry without search-first | Enforce lookup; merge tool for cleanup |
| Import rejects | Wrong header or encoding | Validate template; use UTF-8 |
| GL imbalance | Rounding on multi-line journals | Use system rounding accounts |
| Wrong tax on invoice | Product missing tax code | Mandatory tax on product save |
| Integration mismatch | External ID not set | Populate during migration |
#Ongoing maintenance
- Schedule quarterly data reviews — inactive products, duplicate partners, unused COA.
- Require data steward approval for new GL accounts and customer credit limit increases.
- Document code changes in change log with effective date.
- Train new users on standards during Onboarding.
#Related links
- Catalog Guide — product setup workflows
- Trading Partners Guide — customer and supplier management
- General Ledger Guide — COA and journals
- Sync Errors — import and API diagnostics
- Onboarding Guide — initial data load sequence