ERP HRM · WORD DOCUMENT VIEW · V1.0c

عرض الـUser Stories بنفس ملف الـWord

طريقة عرض إضافية لا تستبدل التحليل الحالي: اختر الإدارة ثم الـEpic، وستظهر كل القصص تحته بنفس ترتيب الصفوف وألوان المصدر.

العودة للتحليل الفني

171 Story معتمدة في V1.0c2 إضافة نظام خارج الملف1 · 3 · 5 Epics مذكورة في سجل تحديث V1.0c

الإدارةEpic / Module

EPIC DOCUMENT · كل القصص في صفحة واحدة

Import Engine

0 من المصدر المعتمد

User StoryDescriptionAcceptance CriteriaField ValidationJourneyScenarios

SAME DOCUMENT LAYOUT

As a Finance User, I want to import company expenses from Online Account bills or Payee Bills, so that I can create expenses in bulk with valid source linking.

Import Engine

IMP-BILL-CompanyExpense-006Canonical SRS Graph

As a Finance User, I want to import company expenses from Online Account bills or Payee Bills, so that I can create expenses in bulk with valid source linking.

User Story

As a Finance User, I want to import company expenses from Online Account bills or Payee Bills, so that I can create expenses in bulk with valid source linking.

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to import company expenses from Online Account bills or Payee Bills, so that I can create expenses in bulk with valid source linking.

Description

Acceptance Criteria

Source Type must be Online Account or Payee Bill.
If Online Account, Online Account Bills field is required and Payee Bills is ignored.
If Payee Bill, Payee Bills field is required and Online Account Bills is ignored.
Online Account bills must be unpaid, deserved, and bill date less than or equal to today.
Payee bills must be unpaid, deserved, type in both/service, and bill date less than or equal to today while considering payment_deadline_date.
Paid Date must be greater than or equal to selected bill start date.
Safe must have an available balance greater than zero.
Data mapping uses bill names, amount, currency, exchange rate, and payee when applicable.
If Payee Bill: Paid Date ≥ bill start date
If Online Account: Paid Date ≥ public bill start date
Changes on Excel button inside company expense page
Add new option called “Company Expenses from Online Accounts (Public Bills) /Payee Bills template”

Field Validation

Record ID	UUID / String	No	Unique and immutable after creation
Company	Reference	Yes	Required and must match the user scope
Branch	Reference	No	Must be active and permitted for the user
Status	Enum	No	Allowed enum only; transitions require permission
Created By	User Reference	No	Server-generated; client value is rejected
Created At	UTC DateTime	No	Stored in UTC and displayed in user timezone
Correlation ID	String	No	Unique per run and propagated across steps
Source System	Enum / Reference	Yes	Active integration with supported contract version
External ID	String	Yes	Unique per source system and never reused for another record
Schema Version	Semantic Version	Yes	Unsupported versions are quarantined without writes
Idempotency Key	String	Yes	Unique per operation; replay returns the same result

Dropdown / Select Options (DDL)

—

User Journey

ينفذ Finance User سيناريو Import Company Expenses from Online Accounts or Payee Bills ويطابق النتيجة مع Acceptance Criteria في ERP_SRS، مع UI/API/Data/Audit evidence.

Scenarios

ERP_SRS acceptance test: Source Type must be Online Account or Payee Bill.
ERP_SRS acceptance test: If Online Account, Online Account Bills field is required and Payee Bills is ignored.
ERP_SRS acceptance test: If Payee Bill, Payee Bills field is required and Online Account Bills is ignored.
ERP_SRS acceptance test: Online Account bills must be unpaid, deserved, and bill date less than or equal to today.
ERP_SRS acceptance test: Payee bills must be unpaid, deserved, type in both/service, and bill date less than or equal to today while considering payment_deadline_date.
ERP_SRS acceptance test: Paid Date must be greater than or equal to selected bill start date.

Alternative Path

—

Edge Cases

—

SAME DOCUMENT LAYOUT

As a Finance User, I want to import cash reservations from Excel, so that I can create multiple reservations at once.

Import Engine

IMP-CashReservation-010Canonical SRS Graph

As a Finance User, I want to import cash reservations from Excel, so that I can create multiple reservations at once.

User Story

As a Finance User, I want to import cash reservations from Excel, so that I can create multiple reservations at once.

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to import cash reservations from Excel, so that I can create multiple reservations at once.

Description

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to import cash reservations from Excel, so that I can create multiple reservations at once.

Acceptance Criteria

Invalid rows are rejected with clear row-level messages.
Valid rows are created.
The system validates category, cash account, currency, amount, due date, and available balance.
If a category requires approval, imported reservation becomes Pending Approval.
If a category does not require approval, imported reservation becomes Active.
Active imported reservations affect available balance.
Import must not create journal entries by default.
Template Structure

Field Validation

Record ID	UUID / String	No	Unique and immutable after creation
Company	Reference	Yes	Required and must match the user scope
Branch	Reference	No	Must be active and permitted for the user
Status	Enum	No	Allowed enum only; transitions require permission
Created By	User Reference	No	Server-generated; client value is rejected
Created At	UTC DateTime	No	Stored in UTC and displayed in user timezone
Correlation ID	String	No	Unique per run and propagated across steps
Amount	Decimal(18,4)	Yes	Greater than zero, within approval limit and currency precision
Currency	Reference	Yes	Active currency enabled for the company
Exchange Rate	Decimal(18,8)	Yes	Positive, effective on transaction date; overrides require permission and reason
Transaction Date	Date	Yes	Must belong to an open fiscal period and not exceed close date
Reason	Text 3..1000	Yes	Trimmed length 3–1000 with unsafe markup rejected

Dropdown / Select Options (DDL)

—

User Journey

ينفذ Finance User سيناريو Import Cash Reservations ويطابق النتيجة مع Acceptance Criteria في ERP_SRS، مع UI/API/Data/Audit evidence.

Scenarios

ERP_SRS acceptance test: Invalid rows are rejected with clear row-level messages.
ERP_SRS acceptance test: Valid rows are created.
ERP_SRS acceptance test: The system validates category, cash account, currency, amount, due date, and available balance.
ERP_SRS acceptance test: If a category requires approval, imported reservation becomes Pending Approval.
ERP_SRS acceptance test: If a category does not require approval, imported reservation becomes Active.
ERP_SRS acceptance test: Active imported reservations affect available balance.

Alternative Path

—

Edge Cases

—

SAME DOCUMENT LAYOUT

As a Finance User, I want to import company expenses from approved custody expenses, so that I can create expenses in bulk with correct financial behavior.

Import Engine

IMP-CompanyExpense-CustodyExpenses-003Canonical SRS Graph

As a Finance User, I want to import company expenses from approved custody expenses, so that I can create expenses in bulk with correct financial behavior.

User Story

As a Finance User, I want to import company expenses from approved custody expenses, so that I can create expenses in bulk with correct financial behavior.

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to import company expenses from approved custody expenses, so that I can create expenses in bulk with correct financial behavior.

Description

Acceptance Criteria

Only approved, unpaid, type Expense custody expenses are allowed.
Data is auto-mapped from custody expenses: value, discount, taxable, taxes, note, currency, exchange rate, safe, payment type.
Status depends on a chart of accounts and flexible payment approval rules.
Safe is not affected directly for custody-related records.
Import may create accounting entries based on configuration.
Changes on Excel button inside company expense page
Add new option called “Company expense for Custody Expense template”
Rename the old option that called “download template” to “ Company expense directly template”
Add icon download before each template on this dropdown
Template Structure
Data Mapping from Custody Expense to use on create company expense when importing
Business Logic

Field Validation

Record ID	UUID / String	No	Unique and immutable after creation
Company	Reference	Yes	Required and must match the user scope
Branch	Reference	No	Must be active and permitted for the user
Status	Enum	No	Allowed enum only; transitions require permission
Created By	User Reference	No	Server-generated; client value is rejected
Created At	UTC DateTime	No	Stored in UTC and displayed in user timezone
Correlation ID	String	No	Unique per run and propagated across steps
Amount	Decimal(18,4)	Yes	Greater than zero, within approval limit and currency precision
Currency	Reference	Yes	Active currency enabled for the company
Exchange Rate	Decimal(18,8)	Yes	Positive, effective on transaction date; overrides require permission and reason
Transaction Date	Date	Yes	Must belong to an open fiscal period and not exceed close date
Reason	Text 3..1000	Yes	Trimmed length 3–1000 with unsafe markup rejected
Custody Owner	Employee Reference	Yes	Active employee in scope and eligible for custody
Safe	Safe Reference	Yes	Active permitted safe with matching currency and sufficient balance
Start Date	Date	Yes	Must not exceed end date and must be in an allowed period
End Date	Date	Yes	On/after start date and within policy limit

Dropdown / Select Options (DDL)

—

User Journey

ينفذ Finance User سيناريو Import Company Expenses from Custody Expenses ويطابق النتيجة مع Acceptance Criteria في ERP_SRS، مع UI/API/Data/Audit evidence.

Scenarios

ERP_SRS acceptance test: Only approved, unpaid, type Expense custody expenses are allowed.
ERP_SRS acceptance test: Data is auto-mapped from custody expenses: value, discount, taxable, taxes, note, currency, exchange rate, safe, payment type.
ERP_SRS acceptance test: Status depends on a chart of accounts and flexible payment approval rules.
ERP_SRS acceptance test: Safe is not affected directly for custody-related records.
ERP_SRS acceptance test: Import may create accounting entries based on configuration.
ERP_SRS acceptance test: Changes on Excel button inside company expense page

Alternative Path

—

Edge Cases

—

SAME DOCUMENT LAYOUT

As a Finance User, I want to import currencies from Excel, so that I can create multiple currencies at once.

Import Engine

IMP-Currency-009Canonical SRS Graph

As a Finance User, I want to import currencies from Excel, so that I can create multiple currencies at once.

User Story

As a Finance User, I want to import currencies from Excel, so that I can create multiple currencies at once.

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to import currencies from Excel, so that I can create multiple currencies at once.

Description

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to import currencies from Excel, so that I can create multiple currencies at once.

Acceptance Criteria

Valid rows are created and invalid rows are rejected with clear messages.
Currency code must be unique.
Only one base currency can be imported as base unless configuration allows otherwise.
Template Structure

Field Validation

Record ID	UUID / String	No	Unique and immutable after creation
Company	Reference	Yes	Required and must match the user scope
Branch	Reference	No	Must be active and permitted for the user
Status	Enum	No	Allowed enum only; transitions require permission
Created By	User Reference	No	Server-generated; client value is rejected
Created At	UTC DateTime	No	Stored in UTC and displayed in user timezone
Correlation ID	String	No	Unique per run and propagated across steps
Amount	Decimal(18,4)	Yes	Greater than zero, within approval limit and currency precision
Currency	Reference	Yes	Active currency enabled for the company
Exchange Rate	Decimal(18,8)	Yes	Positive, effective on transaction date; overrides require permission and reason
Transaction Date	Date	Yes	Must belong to an open fiscal period and not exceed close date
Reason	Text 3..1000	Yes	Trimmed length 3–1000 with unsafe markup rejected

Dropdown / Select Options (DDL)

—

User Journey

ينفذ Finance User سيناريو Import Currencies ويطابق النتيجة مع Acceptance Criteria في ERP_SRS، مع UI/API/Data/Audit evidence.

Scenarios

ERP_SRS acceptance test: Valid rows are created and invalid rows are rejected with clear messages.
ERP_SRS acceptance test: Currency code must be unique.
ERP_SRS acceptance test: Only one base currency can be imported as base unless configuration allows otherwise.
ERP_SRS acceptance test: Template Structure

Alternative Path

—

Edge Cases

—

SAME DOCUMENT LAYOUT

As a Custody Owner or permitted Finance User, I want to import custody expenses, so that many expense lines can be created in one action.

Import Engine

IMP-CustodyExpenses-002Canonical SRS Graph

As a Custody Owner or permitted Finance User, I want to import custody expenses, so that many expense lines can be created in one action.

User Story

As a Custody Owner or permitted Finance User, I want to import custody expenses, so that many expense lines can be created in one action.

طبقًا للمصدر الأساسي ERP_SRS: As a Custody Owner or permitted Finance User, I want to import custody expenses, so that many expense lines can be created in one action.

Description

طبقًا للمصدر الأساسي ERP_SRS: As a Custody Owner or permitted Finance User, I want to import custody expenses, so that many expense lines can be created in one action.

Acceptance Criteria

Financial Custody must be In Progress or Extended.
Date must fall within the custody period using extend_end_date when available.
Taxable Yes requires taxes; Taxable No ignores taxes.
Custody owner can only import pending status; any other status returns validation error.
Expenses do not affect safe balance, only custody totals.
Invalid rows are rejected with clear messages.
Template Structure

Field Validation

Record ID	UUID / String	No	Unique and immutable after creation
Company	Reference	Yes	Required and must match the user scope
Branch	Reference	No	Must be active and permitted for the user
Status	Enum	No	Allowed enum only; transitions require permission
Created By	User Reference	No	Server-generated; client value is rejected
Created At	UTC DateTime	No	Stored in UTC and displayed in user timezone
Correlation ID	String	No	Unique per run and propagated across steps
Amount	Decimal(18,4)	Yes	Greater than zero, within approval limit and currency precision
Currency	Reference	Yes	Active currency enabled for the company
Exchange Rate	Decimal(18,8)	Yes	Positive, effective on transaction date; overrides require permission and reason
Transaction Date	Date	Yes	Must belong to an open fiscal period and not exceed close date
Reason	Text 3..1000	Yes	Trimmed length 3–1000 with unsafe markup rejected
Custody Owner	Employee Reference	Yes	Active employee in scope and eligible for custody
Safe	Safe Reference	Yes	Active permitted safe with matching currency and sufficient balance
Start Date	Date	Yes	Must not exceed end date and must be in an allowed period
End Date	Date	Yes	On/after start date and within policy limit

Dropdown / Select Options (DDL)

—

User Journey

ينفذ Custody Owner or permitted Finance User سيناريو Import Custody Expenses ويطابق النتيجة مع Acceptance Criteria في ERP_SRS، مع UI/API/Data/Audit evidence.

Scenarios

ERP_SRS acceptance test: Financial Custody must be In Progress or Extended.
ERP_SRS acceptance test: Date must fall within the custody period using extend_end_date when available.
ERP_SRS acceptance test: Taxable Yes requires taxes; Taxable No ignores taxes.
ERP_SRS acceptance test: Custody owner can only import pending status; any other status returns validation error.
ERP_SRS acceptance test: Expenses do not affect safe balance, only custody totals.
ERP_SRS acceptance test: Invalid rows are rejected with clear messages.

Alternative Path

—

Edge Cases

—

SAME DOCUMENT LAYOUT

As a Finance User, I want to download and upload a finance custody template, so that I can create multiple custodies at once.

Import Engine

IMP-FinancialCustody-001Canonical SRS Graph

As a Finance User, I want to download and upload a finance custody template, so that I can create multiple custodies at once.

User Story

As a Finance User, I want to download and upload a finance custody template, so that I can create multiple custodies at once.

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to download and upload a finance custody template, so that I can create multiple custodies at once.

Description

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to download and upload a finance custody template, so that I can create multiple custodies at once.

Acceptance Criteria

All fields are required except Attachment URL.
Users must be active and safe must be valid with available balance greater than zero and not related to credit cards.
Dates must be valid and start date must be before or equal to end date.
After successful import, is_reserved = 1 and reserved amount equals amount multiplied by exchange rate “Reserved amount = amount × exchange_rate”.
Safe balance decreases and reserved balance increases.
Invalid rows are rejected with clear row-level error messages.
Template Structure
Impact on Safe

Field Validation

Record ID	UUID / String	No	Unique and immutable after creation
Company	Reference	Yes	Required and must match the user scope
Branch	Reference	No	Must be active and permitted for the user
Status	Enum	No	Allowed enum only; transitions require permission
Created By	User Reference	No	Server-generated; client value is rejected
Created At	UTC DateTime	No	Stored in UTC and displayed in user timezone
Correlation ID	String	No	Unique per run and propagated across steps
Amount	Decimal(18,4)	Yes	Greater than zero, within approval limit and currency precision
Currency	Reference	Yes	Active currency enabled for the company
Exchange Rate	Decimal(18,8)	Yes	Positive, effective on transaction date; overrides require permission and reason
Transaction Date	Date	Yes	Must belong to an open fiscal period and not exceed close date
Reason	Text 3..1000	Yes	Trimmed length 3–1000 with unsafe markup rejected
Custody Owner	Employee Reference	Yes	Active employee in scope and eligible for custody
Safe	Safe Reference	Yes	Active permitted safe with matching currency and sufficient balance
Start Date	Date	Yes	Must not exceed end date and must be in an allowed period
End Date	Date	Yes	On/after start date and within policy limit

Dropdown / Select Options (DDL)

—

User Journey

ينفذ Finance User سيناريو Import Financial Custodies ويطابق النتيجة مع Acceptance Criteria في ERP_SRS، مع UI/API/Data/Audit evidence.

Scenarios

ERP_SRS acceptance test: All fields are required except Attachment URL.
ERP_SRS acceptance test: Users must be active and safe must be valid with available balance greater than zero and not related to credit cards.
ERP_SRS acceptance test: Dates must be valid and start date must be before or equal to end date.
ERP_SRS acceptance test: After successful import, is_reserved = 1 and reserved amount equals amount multiplied by exchange rate “Reserved amount = amount × exchange_rate”.
ERP_SRS acceptance test: Safe balance decreases and reserved balance increases.
ERP_SRS acceptance test: Invalid rows are rejected with clear row-level error messages.

Alternative Path

—

Edge Cases

—

SAME DOCUMENT LAYOUT

I want to control whether payment completion depends on GA approval or only on journal entry creation

Import Engine

IMP-Payment-005Canonical SRS Graph

I want to control whether payment completion depends on GA approval or only on journal entry creation

User Story

I want to control whether payment completion depends on GA approval or only on journal entry creation

طبقًا للمصدر الأساسي ERP_SRS: I want to control whether payment completion depends on GA approval or only on journal entry creation

Description

طبقًا للمصدر الأساسي ERP_SRS: I want to control whether payment completion depends on GA approval or only on journal entry creation

Acceptance Criteria

Case 1 — Skip GA Approval = No (Default Behavior)
- Status = Pending by GA
- System creates accrual journal entry
- Paid Date is ignored
- Appears in Non Cash Management after GA approval
- Payment is blocked until GA approval
Case 2 — Skip GA Approval = Yes (New Behavior)
System creates payment journal entry immediately
- Paid Date is required and saved
- Payment is completed without waiting for GA approval
- Status becomes Closed (Paid) or Paid - JE Pending Approval,will the new status “Paid - JE Pending Approval” on each purchase invoice and company expense statues
Business Logic

Field Validation

Record ID	UUID / String	No	Unique and immutable after creation
Company	Reference	Yes	Required and must match the user scope
Branch	Reference	No	Must be active and permitted for the user
Status	Enum	No	Allowed enum only; transitions require permission
Created By	User Reference	No	Server-generated; client value is rejected
Created At	UTC DateTime	No	Stored in UTC and displayed in user timezone
Correlation ID	String	No	Unique per run and propagated across steps
Amount	Decimal(18,4)	Yes	Greater than zero, within approval limit and currency precision
Currency	Reference	Yes	Active currency enabled for the company
Exchange Rate	Decimal(18,8)	Yes	Positive, effective on transaction date; overrides require permission and reason
Transaction Date	Date	Yes	Must belong to an open fiscal period and not exceed close date
Reason	Text 3..1000	Yes	Trimmed length 3–1000 with unsafe markup rejected

Dropdown / Select Options (DDL)

—

User Journey

ينفذ Business / System User سيناريو Flexible payment approval during imports ويطابق النتيجة مع Acceptance Criteria في ERP_SRS، مع UI/API/Data/Audit evidence.

Scenarios

ERP_SRS acceptance test: Case 1 — Skip GA Approval = No (Default Behavior)
ERP_SRS acceptance test: - Status = Pending by GA
ERP_SRS acceptance test: - System creates accrual journal entry
ERP_SRS acceptance test: - Paid Date is ignored
ERP_SRS acceptance test: - Appears in Non Cash Management after GA approval
ERP_SRS acceptance test: - Payment is blocked until GA approval

Alternative Path

—

Edge Cases

—

SAME DOCUMENT LAYOUT

As a Finance User, I want to import safes from Excel, so that I can create multiple safes at once.

Import Engine

IMP-Safe-008Canonical SRS Graph

As a Finance User, I want to import safes from Excel, so that I can create multiple safes at once.

User Story

As a Finance User, I want to import safes from Excel, so that I can create multiple safes at once.

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to import safes from Excel, so that I can create multiple safes at once.

Description

طبقًا للمصدر الأساسي ERP_SRS: As a Finance User, I want to import safes from Excel, so that I can create multiple safes at once.

Acceptance Criteria

Valid rows are created and invalid rows are rejected with clear messages.
Name English, name Arabic, type, payment type, currency, start date, company, and status are required.
Credit Card safe rows must include required credit card fields.
Duplicate safe names are rejected according to the company/branch uniqueness rule.
Imported safes do not create financial transactions unless opening balance import is explicitly supported.
Safe serial numbers are generated automatically during import using the Serial Number Configuration rules.
A responsible person is required and will be used for safe notification routing.
Template Structure

Field Validation

Record ID	UUID / String	No	Unique and immutable after creation
Company	Reference	Yes	Required and must match the user scope
Branch	Reference	No	Must be active and permitted for the user
Status	Enum	No	Allowed enum only; transitions require permission
Created By	User Reference	No	Server-generated; client value is rejected
Created At	UTC DateTime	No	Stored in UTC and displayed in user timezone
Correlation ID	String	No	Unique per run and propagated across steps
Amount	Decimal(18,4)	Yes	Greater than zero, within approval limit and currency precision
Currency	Reference	Yes	Active currency enabled for the company
Exchange Rate	Decimal(18,8)	Yes	Positive, effective on transaction date; overrides require permission and reason
Transaction Date	Date	Yes	Must belong to an open fiscal period and not exceed close date
Reason	Text 3..1000	Yes	Trimmed length 3–1000 with unsafe markup rejected

Dropdown / Select Options (DDL)

—

User Journey

ينفذ Finance User سيناريو Import Safes ويطابق النتيجة مع Acceptance Criteria في ERP_SRS، مع UI/API/Data/Audit evidence.

Scenarios

ERP_SRS acceptance test: Valid rows are created and invalid rows are rejected with clear messages.
ERP_SRS acceptance test: Name English, name Arabic, type, payment type, currency, start date, company, and status are required.
ERP_SRS acceptance test: Credit Card safe rows must include required credit card fields.
ERP_SRS acceptance test: Duplicate safe names are rejected according to the company/branch uniqueness rule.
ERP_SRS acceptance test: Imported safes do not create financial transactions unless opening balance import is explicitly supported.
ERP_SRS acceptance test: Safe serial numbers are generated automatically during import using the Serial Number Configuration rules.

Alternative Path

—

Edge Cases

—

QPENTASCOPE

جاري تجهيز مساحة العمل

بنحمّل الواجهة والبيانات المطلوبة فقط.

Record ID

UUID / String

Unique and immutable after creation

Company

Reference

Yes

Required and must match the user scope

Branch

Reference

Must be active and permitted for the user

Status

Enum

Allowed enum only; transitions require permission

Created By

User Reference

Server-generated; client value is rejected

Created At

UTC DateTime

Stored in UTC and displayed in user timezone

Correlation ID

String

Unique per run and propagated across steps

Source System

Enum / Reference

Yes

Active integration with supported contract version

External ID

String

Yes

Unique per source system and never reused for another record

Schema Version

Semantic Version

Yes

Unsupported versions are quarantined without writes

Idempotency Key

String

Yes

Unique per operation; replay returns the same result

Record ID

UUID / String

Unique and immutable after creation

Company

Reference

Yes

Required and must match the user scope

Branch

Reference

Must be active and permitted for the user

Status

Enum

Allowed enum only; transitions require permission

Created By

User Reference

Server-generated; client value is rejected

Created At

UTC DateTime

Stored in UTC and displayed in user timezone

Correlation ID

String

Unique per run and propagated across steps

Amount

Decimal(18,4)

Yes

Greater than zero, within approval limit and currency precision

Currency

Reference

Yes

Active currency enabled for the company

Exchange Rate

Decimal(18,8)

Yes

Positive, effective on transaction date; overrides require permission and reason

Transaction Date

Date

Yes

Must belong to an open fiscal period and not exceed close date

Reason

Text 3..1000

Yes

Trimmed length 3–1000 with unsafe markup rejected

Record ID

UUID / String

Unique and immutable after creation

Company

Reference

Yes

Required and must match the user scope

Branch

Reference

Must be active and permitted for the user

Status

Enum

Allowed enum only; transitions require permission

Created By

User Reference

Server-generated; client value is rejected

Created At

UTC DateTime

Stored in UTC and displayed in user timezone

Correlation ID

String

Unique per run and propagated across steps

Amount

Decimal(18,4)

Yes

Greater than zero, within approval limit and currency precision

Currency

Reference

Yes

Active currency enabled for the company

Exchange Rate

Decimal(18,8)

Yes

Positive, effective on transaction date; overrides require permission and reason

Transaction Date

Date

Yes

Must belong to an open fiscal period and not exceed close date

Reason

Text 3..1000

Yes

Trimmed length 3–1000 with unsafe markup rejected

Custody Owner

Employee Reference

Yes

Active employee in scope and eligible for custody

Safe

Safe Reference

Yes

Active permitted safe with matching currency and sufficient balance

Start Date

Date

Yes

Must not exceed end date and must be in an allowed period

End Date

Date

Yes

On/after start date and within policy limit

Record ID

UUID / String

Unique and immutable after creation

Company

Reference

Yes

Required and must match the user scope

Branch

Reference

Must be active and permitted for the user

Status

Enum

Allowed enum only; transitions require permission

Created By

User Reference

Server-generated; client value is rejected

Created At

UTC DateTime

Stored in UTC and displayed in user timezone

Correlation ID

String

Unique per run and propagated across steps

Amount

Decimal(18,4)

Yes

Greater than zero, within approval limit and currency precision

Currency

Reference

Yes

Active currency enabled for the company

Exchange Rate

Decimal(18,8)

Yes

Positive, effective on transaction date; overrides require permission and reason

Transaction Date

Date

Yes

Must belong to an open fiscal period and not exceed close date

Reason

Text 3..1000

Yes

Trimmed length 3–1000 with unsafe markup rejected

Record ID

UUID / String

Unique and immutable after creation

Company

Reference

Yes

Required and must match the user scope

Branch

Reference

Must be active and permitted for the user

Status

Enum

Allowed enum only; transitions require permission

Created By

User Reference

Server-generated; client value is rejected

Created At

UTC DateTime

Stored in UTC and displayed in user timezone

Correlation ID

String

Unique per run and propagated across steps

Amount

Decimal(18,4)

Yes

Greater than zero, within approval limit and currency precision

Currency

Reference

Yes

Active currency enabled for the company

Exchange Rate

Decimal(18,8)

Yes

Positive, effective on transaction date; overrides require permission and reason

Transaction Date

Date

Yes

Must belong to an open fiscal period and not exceed close date

Reason

Text 3..1000

Yes

Trimmed length 3–1000 with unsafe markup rejected

Custody Owner

Employee Reference

Yes

Active employee in scope and eligible for custody

Safe

Safe Reference

Yes

Active permitted safe with matching currency and sufficient balance

Start Date

Date

Yes

Must not exceed end date and must be in an allowed period

End Date

Date

Yes

On/after start date and within policy limit

Record ID

UUID / String

Unique and immutable after creation

Company

Reference

Yes

Required and must match the user scope

Branch

Reference

Must be active and permitted for the user

Status

Enum

Allowed enum only; transitions require permission

Created By

User Reference

Server-generated; client value is rejected

Created At

UTC DateTime

Stored in UTC and displayed in user timezone

Correlation ID

String

Unique per run and propagated across steps

Amount

Decimal(18,4)

Yes

Greater than zero, within approval limit and currency precision

Currency

Reference

Yes

Active currency enabled for the company

Exchange Rate

Decimal(18,8)

Yes

Positive, effective on transaction date; overrides require permission and reason

Transaction Date

Date

Yes

Must belong to an open fiscal period and not exceed close date

Reason

Text 3..1000

Yes

Trimmed length 3–1000 with unsafe markup rejected

Custody Owner

Employee Reference

Yes

Active employee in scope and eligible for custody

Safe

Safe Reference

Yes

Active permitted safe with matching currency and sufficient balance

Start Date

Date

Yes

Must not exceed end date and must be in an allowed period

End Date

Date

Yes

On/after start date and within policy limit

Record ID

UUID / String

Unique and immutable after creation

Company

Reference

Yes

Required and must match the user scope

Branch

Reference

Must be active and permitted for the user

Status

Enum

Allowed enum only; transitions require permission

Created By

User Reference

Server-generated; client value is rejected

Created At

UTC DateTime

Stored in UTC and displayed in user timezone

Correlation ID

String

Unique per run and propagated across steps

Amount

Decimal(18,4)

Yes

Greater than zero, within approval limit and currency precision

Currency

Reference

Yes

Active currency enabled for the company

Exchange Rate

Decimal(18,8)

Yes

Positive, effective on transaction date; overrides require permission and reason

Transaction Date

Date

Yes

Must belong to an open fiscal period and not exceed close date

Reason

Text 3..1000

Yes

Trimmed length 3–1000 with unsafe markup rejected

Record ID

UUID / String

Unique and immutable after creation

Company

Reference

Yes

Required and must match the user scope

Branch

Reference

Must be active and permitted for the user

Status

Enum

Allowed enum only; transitions require permission

Created By

User Reference

Server-generated; client value is rejected

Created At

UTC DateTime

Stored in UTC and displayed in user timezone

Correlation ID

String

Unique per run and propagated across steps

Amount

Decimal(18,4)

Yes

Greater than zero, within approval limit and currency precision

Currency

Reference

Yes

Active currency enabled for the company

Exchange Rate

Decimal(18,8)

Yes

Positive, effective on transaction date; overrides require permission and reason

Transaction Date

Date

Yes

Must belong to an open fiscal period and not exceed close date

Reason

Text 3..1000

Yes

Trimmed length 3–1000 with unsafe markup rejected