Appearance
Asset Depreciation
| Backlog field | Value |
|---|---|
| Story ID | AP-FA-001 |
| Epic | Fixed Assets |
| Story type | Business workflow |
| Review status | Draft - business analyst and business owner review required |
| Source evidence | AppsPortal.Apis controller, application command/query handlers, validators, domain entities, and matching MFE workflow where available |
| Last source review | 2026-07-10 |
User story
As asset accountants, I want to calculate, review, and post depreciation by period so that book value and expense follow configured policy.
Posting reference: AppsPortal Posting Ledger explains debit/credit construction. Delegation and Interaction Contracts explains module ownership, delegated commands, linked records, commit boundaries, and reversal propagation.
Acceptance criteria
- Only authorized users can view or execute the feature's actions.
- Required business data, active dependencies, tenant/branch scope, and current document state are validated.
- Invalid requests return actionable validation errors without applying a partial change.
- Search, list, view, print, and export operations use the same authorized business scope.
- Material create, edit, status, approval, posting, reversal, and integration actions are auditable where applicable.
- Financial or stock effects are applied atomically and no more than once.
Posting details
- Validate Draft/allowed state, open period, eligible active assets, method/useful life/start date, remaining depreciable value, and configured Expense and Accumulated Depreciation accounts.
- Calculate each asset amount without exceeding depreciable base or duplicating an already-posted period.
- Delegate the journal to Accounting: debit Depreciation Expense and credit Accumulated Depreciation, with applicable cost-center dimensions.
- Update accumulated depreciation, net book value, latest posted period, journal link, and Posted status.
- All asset lines and journal commit together; later depreciation/lifecycle activity controls reversal eligibility.
General ledger posting
| Component | Debit | Credit | Amount basis |
|---|---|---|---|
| Period depreciation | Depreciation Expense | Accumulated Depreciation | Calculated eligible period amount, not above depreciable base. |
Other module and document effects
| Area | Effect | Conditional/no effect |
|---|---|---|
| Asset register | Increases accumulated depreciation, reduces NBV, stores latest period/journal. | Does not change acquisition cost, inventory, payable/receivable, or cash. |
| Lifecycle | Affects later sale/return/disposal calculations. | Duplicate period and ineligible asset are blocked. |
Core acceptance scenarios
- Given eligible active assets with remaining depreciable value and configured expense/accumulated accounts, when the period depreciation is posted, then expense is debited, accumulated depreciation credited, and each net book value updated.
- Given the period is duplicate/closed or value would exceed depreciable base, when the operation is attempted, then Post is rejected.
- Given the same Post request is retried after success, when the source is no longer Draft, then no duplicate journal, stock, balance, payment, or lifecycle effect is created.
Required data and Post
Depreciation period/date, eligible active depreciable assets, useful-life/method/start data, remaining depreciable value, and Asset Group Accumulated Depreciation and Expense accounts are required. Calculation must not exceed depreciable base or duplicate an already-posted period.
Post debits depreciation expense, credits accumulated depreciation, updates each asset's accumulated depreciation and net book value, records latest posted depreciation, links the journal, and marks Posted. Asset/group cost centers are applied where configured. Recalculation or reversal is blocked by later posted depreciation or lifecycle events unless a dedicated reverse workflow permits it.
Frontend page coverage
The following UI coverage is sourced from the pulled MFE route configuration. A Module-level supporting artifact mapping is evidence of a reachable screen, but requires BA confirmation that it belongs to this story rather than a more specific feature story.
| Route/page | Component | Mode | Route permission/guard | Mapping confidence | Source |
|---|---|---|---|---|---|
| (module default) | AssetsDepreciationComponent | List/navigation | Permission: AppFixedAssetsPermissions.AssetsDepreciation_List; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/assets-depreciation-routing.module.ts:12 |
| (module default) | AssetsOpeningaBalanceComponent | List/navigation | Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_List; Guards: PolicyAuthGuard | Feature token match | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/assets-openinga-balance-routing.module.ts:12 |
| (module default) | DashboardComponent | Dashboard | No route-level permission/guard found in source window | Module-level supporting artifact | apps/fixedAssets/src/app/remote-entry/routes.ts:14 |
| (module default) | LayoutPageComponent | List/navigation | No route-level permission/guard found in source window | Module-level supporting artifact | apps/fixedAssets/src/app/remote-entry/routes.ts:6 |
| (module default) | ListAssetsDepreciationComponent | List/navigation | Permission: AppFixedAssetsPermissions.AssetsDepreciation_List; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/assets-depreciation-routing.module.ts:20 |
| (module default) | ListAssetsOpeningaBalanceComponent | List/navigation | Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_List; Guards: PolicyAuthGuard | Feature token match | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/assets-openinga-balance-routing.module.ts:20 |
| add | AddAssetsDepreciationComponent | Add | Permission: AppFixedAssetsPermissions.AssetsDepreciation_Add; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/assets-depreciation-routing.module.ts:29 |
| add | AddAssetsOpeningaBalanceComponent | Add | Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_Add; Guards: PolicyAuthGuard | Feature token match | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/assets-openinga-balance-routing.module.ts:29 |
| assets-depreciation | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Explicit frontend feature rule | apps/fixedAssets/src/app/remote-entry/transactions/transactions-routing.module.ts:27 |
| assets-depreciation-report | AssetsDeprecationReportComponent | Report/print | No route-level permission/guard found in source window | Feature token match | apps/fixedAssets/src/app/remote-entry/reports/reports-routing.module.ts:10 |
| edit/:id | EditAssetsDepreciationComponent | Edit | Permission: AppFixedAssetsPermissions.AssetsDepreciation_Edit; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/assets-depreciation-routing.module.ts:59 |
| edit/:id | EditAssetsOpeningaBalanceComponent | Edit | Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_Edit; Guards: PolicyAuthGuard | Feature token match | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/assets-openinga-balance-routing.module.ts:39 |
| masterdata | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Module-level supporting artifact | apps/fixedAssets/src/app/remote-entry/routes.ts:22 |
| sequence | SequenceComponent | Sequence | Permission: AppFixedAssetsPermissions.AssetsDepreciation_Edit; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/assets-depreciation-routing.module.ts:49 |
| sequence | SequenceComponent | Sequence | No route-level permission/guard found in source window | Feature token match | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/assets-openinga-balance-routing.module.ts:59 |
| transactions | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Module-level supporting artifact | apps/fixedAssets/src/app/remote-entry/routes.ts:29 |
| view/:id | ViewAssetsDepreciationComponent | View/detail | Permission: AppFixedAssetsPermissions.AssetsDepreciation_View; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/assets-depreciation-routing.module.ts:39 |
| view/:id | ViewAssetsOpeningaBalanceComponent | View/detail | Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_View; Guards: PolicyAuthGuard | Feature token match | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/assets-openinga-balance-routing.module.ts:49 |
Observed frontend fields and validation
| Component | Control | Observed frontend rule | Component source |
|---|---|---|---|
| AssetsDeprecationReportComponent | AssetGroupIds | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/assets-depreciation-report/assets-deprecation-report.component.ts |
| AssetsDeprecationReportComponent | FromDate | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/assets-depreciation-report/assets-deprecation-report.component.ts |
| AssetsDeprecationReportComponent | ToDate | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/reports/assets-depreciation-report/assets-deprecation-report.component.ts |
| HeaderAssetsDepreciationComponent | assetsDepreciationSelcetedAssets | Visible control; optional or API-dependent | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/components/header-assets-depreciation/header-assets-depreciation.component.ts |
| HeaderAssetsDepreciationComponent | depreciationDate | Required in component validator | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/components/header-assets-depreciation/header-assets-depreciation.component.ts |
| HeaderAssetsDepreciationComponent | description | Required in component validator | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/components/header-assets-depreciation/header-assets-depreciation.component.ts |
| HeaderOpeningBalanceComponent | accumulatedDepOpeningBalanceJournalEntryLineId | Required in component validator | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/component/header-opening-balance/header-opening-balance.component.ts |
| HeaderOpeningBalanceComponent | assetOpeningBalanceJournalEntryLineId | Required in component validator | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/component/header-opening-balance/header-opening-balance.component.ts |
| HeaderOpeningBalanceComponent | openingBalanceJournalEntryLineId | Required in component validator | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/component/header-opening-balance/header-opening-balance.component.ts |
Observed frontend actions
| Component | Click action/handler | Business review requirement | Component source |
|---|---|---|---|
| AssetsDeprecationReportComponent | printReport | Generate the printout for the selected record and authorized branch/tenant; use posted/current values and surface print, template, ZATCA/ETA, or popup failures without changing transaction state. | apps/fixedAssets/src/app/remote-entry/reports/assets-depreciation-report/assets-deprecation-report.component.ts |
| AssetsDeprecationReportComponent | viewData | Open the authorized record in view mode with its status, totals, lines, source and generated-document links; handle deleted, forbidden, and missing records without exposing stale data. | apps/fixedAssets/src/app/remote-entry/reports/assets-depreciation-report/assets-deprecation-report.component.ts |
| BodyAssetsDepreciationComponent | onDeleteRow | Available only in deletable states with Delete permission; identify the record in confirmation, call delete once, remove/refresh the list row on success, and retain the row with the API reason on failure. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/components/body-assets-depreciation/body-assets-depreciation.component.ts |
| BodyAssetsDepreciationComponent | openDialog | Open the item/lookup/tracking dialog with the current warehouse, item, UOM, and remaining quantity context; accepted values must return to the correct line and cancel must not mutate it. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/components/body-assets-depreciation/body-assets-depreciation.component.ts |
| BodyAssetsDepreciationComponent | openDistributionModal | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/components/body-assets-depreciation/body-assets-depreciation.component.ts |
| BodyOpeningBalanceComponent | deleteAssetsLine | Available only in deletable states with Delete permission; identify the record in confirmation, call delete once, remove/refresh the list row on success, and retain the row with the API reason on failure. | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/component/body-opening-balance/body-opening-balance.component.ts |
| BodyOpeningBalanceComponent | openDialog | Open the item/lookup/tracking dialog with the current warehouse, item, UOM, and remaining quantity context; accepted values must return to the correct line and cancel must not mutate it. | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/component/body-opening-balance/body-opening-balance.component.ts |
| HeaderAssetsDepreciationComponent | openDialog | Open the item/lookup/tracking dialog with the current warehouse, item, UOM, and remaining quantity context; accepted values must return to the correct line and cancel must not mutate it. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/components/header-assets-depreciation/header-assets-depreciation.component.ts |
| ListAssetsDepreciationComponent | onDelete | Available only in deletable states with Delete permission; identify the record in confirmation, call delete once, remove/refresh the list row on success, and retain the row with the API reason on failure. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/pages/list-assets-depreciation/list-assets-depreciation.component.ts |
| ListAssetsDepreciationComponent | onEdit | Open the identified editable record only with Edit permission; posted/locked records remain blocked by route or action state and list context must be recoverable on return. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/pages/list-assets-depreciation/list-assets-depreciation.component.ts |
| ListAssetsDepreciationComponent | onPost | Available only for a postable Draft and Post permission; confirm the document, prevent a second submission, call the posting API, and refresh status, journal/stock links, and row actions. Failure must keep the pre-post state. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/pages/list-assets-depreciation/list-assets-depreciation.component.ts |
| ListAssetsDepreciationComponent | onView | Open the authorized record in view mode with its status, totals, lines, source and generated-document links; handle deleted, forbidden, and missing records without exposing stale data. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/pages/list-assets-depreciation/list-assets-depreciation.component.ts |
| ListAssetsDepreciationComponent | printout | Generate the printout for the selected record and authorized branch/tenant; use posted/current values and surface print, template, ZATCA/ETA, or popup failures without changing transaction state. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/pages/list-assets-depreciation/list-assets-depreciation.component.ts |
| ListAssetsDepreciationComponent | routeToJournalView | Open the authorized record in view mode with its status, totals, lines, source and generated-document links; handle deleted, forbidden, and missing records without exposing stale data. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/pages/list-assets-depreciation/list-assets-depreciation.component.ts |
| ListAssetsOpeningaBalanceComponent | onDelete | Available only in deletable states with Delete permission; identify the record in confirmation, call delete once, remove/refresh the list row on success, and retain the row with the API reason on failure. | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/pages/list-assets-openinga-balance/list-assets-openinga-balance.component.ts |
| ListAssetsOpeningaBalanceComponent | onEdit | Open the identified editable record only with Edit permission; posted/locked records remain blocked by route or action state and list context must be recoverable on return. | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/pages/list-assets-openinga-balance/list-assets-openinga-balance.component.ts |
| ListAssetsOpeningaBalanceComponent | onPost | Available only for a postable Draft and Post permission; confirm the document, prevent a second submission, call the posting API, and refresh status, journal/stock links, and row actions. Failure must keep the pre-post state. | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/pages/list-assets-openinga-balance/list-assets-openinga-balance.component.ts |
| ListAssetsOpeningaBalanceComponent | onUnPost | Available only for a postable Draft and Post permission; confirm the document, prevent a second submission, call the posting API, and refresh status, journal/stock links, and row actions. Failure must keep the pre-post state. | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/pages/list-assets-openinga-balance/list-assets-openinga-balance.component.ts |
| ListAssetsOpeningaBalanceComponent | onView | Open the authorized record in view mode with its status, totals, lines, source and generated-document links; handle deleted, forbidden, and missing records without exposing stale data. | apps/fixedAssets/src/app/remote-entry/transactions/assets-openinga-balance/pages/list-assets-openinga-balance/list-assets-openinga-balance.component.ts |
| ViewAssetsDepreciationComponent | openDistributionModal | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/fixedAssets/src/app/remote-entry/transactions/assets-depreciation/pages/view-assets-depreciation/view-assets-depreciation.component.ts |
Page-specific frontend acceptance criteria
- (module default) - Dashboard: Load authorized summary values consistently with source reports, support exposed date/branch filters, and handle empty/error states. Security observed: No route-level permission/guard found in source window
- (module default) - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_List; Guards: PolicyAuthGuard
- add - Add: Render permitted fields, required indicators, defaults, dependent lookups, validation, Save/Cancel, loading, success, and API-error states. Security observed: Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_Add; Guards: PolicyAuthGuard
- assets-depreciation - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: No route-level permission/guard found in source window
- assets-depreciation-report - Report/print: Expose documented filters, validation, empty/loading/error states, authorized results, totals, drill-through, print, and export behavior where present. Security observed: No route-level permission/guard found in source window
- edit/:id - Edit: Load the identified record, enforce state/permission field locks, preserve concurrency identity, validate changes, and return without losing filters. Security observed: Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_Edit; Guards: PolicyAuthGuard
- masterdata - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: No route-level permission/guard found in source window
- sequence - Sequence: Show current numbering scope and permit only authorized, valid sequence configuration without retroactively renumbering posted documents. Security observed: No route-level permission/guard found in source window
- transactions - List/navigation: Load an authorized paged/searchable list or navigation page; preserve filters/sort/paging and expose only permitted row and bulk actions. Security observed: No route-level permission/guard found in source window
- view/:id - View/detail: Load an authorized immutable/detail representation with status-aware actions, linked records, print/export where exposed, and not-found/forbidden handling. Security observed: Permission: AppFixedAssetsPermissions.AssetsOpeningBalance_View; Guards: PolicyAuthGuard