Appearance
Fund Transfers
| Backlog field | Value |
|---|---|
| Story ID | AP-FIN-003 |
| Epic | Finance |
| 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 treasury users, I want to move funds between controlled treasury or bank accounts so that both sides of an internal transfer remain balanced.
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 state, open period, positive amount, different source/target hubs, currencies/rates, sufficient source balance, and Finance Fund Transfer Contra account.
- Delegate a source Payment Out: Debit Contra, Credit source Bank/Treasury.
- Delegate a destination Payment In: Debit target Bank/Treasury, Credit Contra.
- Link both payment and hub-transaction records to the Fund Transfer and mark it Posted.
- Both legs commit together and the Contra account nets to zero in local value. Failure of either leg rolls back the other.
General ledger posting
| Leg | Debit | Credit | Effect |
|---|---|---|---|
| Source Payment Out | Fund Transfer Contra | Source Bank/Treasury GL | Reduces source hub. |
| Destination Payment In | Target Bank/Treasury GL | Fund Transfer Contra | Increases target hub; contra nets to zero in local value. |
Other module and document effects
| Area | Effect | Conditional/no effect |
|---|---|---|
| Finance hubs | Creates linked Payment Out/In and two hub transactions. | Neither leg remains if the other fails. |
| Customer/vendor/inventory | No party due balance or stock effect. | Internal funds movement only. |
Core acceptance scenarios
- Given a Draft transfer with different valid source/target hubs and a contra account, when the treasury user clicks Post, then source Payment Out and target Payment In are created and the contra nets to zero.
- Given either delegated leg fails, when the operation is attempted, then neither leg nor the Fund Transfer is committed.
- 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 and conditional data
Draft transfer, date/open period, different From and To destinations, amount greater than zero, currency/rates, payment methods, and source/destination treasury or bank accounts are required. Bank reference is conditional for bank movement; notes/reference are optional.
Clicking Post
Post requires Finance General Settings Fund Transfer Contra Account. It creates the outbound payment side from the source and inbound payment side to the destination, using the contra account between them, creates bank/treasury transaction records, links both results, marks Posted, and commits atomically. Source balance must be sufficient and both destination accounts/currencies must be valid.
GL intent: credit source bank/treasury and debit contra; debit destination bank/treasury and credit contra. Contra must net to zero after currency/local-value handling.
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) | FundTransferListComponent | List/navigation | Permission: AppFinancePermissions.FundTransfer_List; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/finance/src/app/remote-entry/transactions/fund-transfer/fund-transfer-routing.module.ts:28 |
| (module default) | MainFundTransferComponent | List/navigation | Permission: AppFinancePermissions.FundTransfer_List; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/finance/src/app/remote-entry/transactions/fund-transfer/fund-transfer-routing.module.ts:18 |
| add | AddFundTransferComponent | Add | Permission: AppFinancePermissions.FundTransfer_Add; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/finance/src/app/remote-entry/transactions/fund-transfer/fund-transfer-routing.module.ts:39 |
| edit/:id | EditFundTransferComponent | Edit | Permission: AppFinancePermissions.FundTransfer_Edit; Guards: PolicyAuthGuard, preventPostedGuard | Explicit frontend feature rule | apps/finance/src/app/remote-entry/transactions/fund-transfer/fund-transfer-routing.module.ts:50 |
| fund-transfer | Lazy-loaded route | List/navigation | No route-level permission/guard found in source window | Explicit frontend feature rule | apps/finance/src/app/remote-entry/transactions/transactions.module.ts:171 |
| sequence | SequenceComponent | Sequence | No route-level permission/guard found in source window | Explicit frontend feature rule | apps/finance/src/app/remote-entry/transactions/fund-transfer/fund-transfer-routing.module.ts:73 |
| view/:id | ViewFundTransferComponent | View/detail | Permission: AppFinancePermissions.FundTransfer_View; Guards: PolicyAuthGuard | Explicit frontend feature rule | apps/finance/src/app/remote-entry/transactions/fund-transfer/fund-transfer-routing.module.ts:62 |
Observed frontend fields and validation
| Component | Control | Observed frontend rule | Component source |
|---|---|---|---|
| AddFundTransferComponent | amount | Required in component validator | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/add-fund-transfer/add-fund-transfer.component.ts |
| AddFundTransferComponent | date | Required in component validator | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/add-fund-transfer/add-fund-transfer.component.ts |
| AddFundTransferComponent | description | Visible control; optional or API-dependent | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/add-fund-transfer/add-fund-transfer.component.ts |
| AddFundTransferComponent | rateFrom | Required in component validator | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/add-fund-transfer/add-fund-transfer.component.ts |
| AddFundTransferComponent | reference | Visible control; optional or API-dependent | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/add-fund-transfer/add-fund-transfer.component.ts |
| EditFundTransferComponent | amount | Visible control; optional or API-dependent | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/edit-fund-transfer/edit-fund-transfer.component.ts |
| EditFundTransferComponent | date | Visible control; optional or API-dependent | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/edit-fund-transfer/edit-fund-transfer.component.ts |
| EditFundTransferComponent | description | Visible control; optional or API-dependent | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/edit-fund-transfer/edit-fund-transfer.component.ts |
| EditFundTransferComponent | rateFrom | Visible control; optional or API-dependent | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/edit-fund-transfer/edit-fund-transfer.component.ts |
| EditFundTransferComponent | reference | Visible control; optional or API-dependent | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/edit-fund-transfer/edit-fund-transfer.component.ts |
Observed frontend actions
| Component | Click action/handler | Business review requirement | Component source |
|---|---|---|---|
| AddFundTransferComponent | onSelectPaymentHub | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/add-fund-transfer/add-fund-transfer.component.ts |
| AddFundTransferComponent | onSelectTransferTo | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/add-fund-transfer/add-fund-transfer.component.ts |
| AddFundTransferComponent | onSendToPaymentMethodSelect | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/add-fund-transfer/add-fund-transfer.component.ts |
| EditFundTransferComponent | onSelectPaymentHub | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/edit-fund-transfer/edit-fund-transfer.component.ts |
| EditFundTransferComponent | onSelectTransferTo | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/edit-fund-transfer/edit-fund-transfer.component.ts |
| EditFundTransferComponent | onSendToPaymentMethodSelect | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/edit-fund-transfer/edit-fund-transfer.component.ts |
| FundTransferListComponent | navigateHelpPageComponent | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/fund-transfer-list/fund-transfer-list.component.ts |
| FundTransferListComponent | 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/finance/src/app/remote-entry/transactions/fund-transfer/pages/fund-transfer-list/fund-transfer-list.component.ts |
| FundTransferListComponent | 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/finance/src/app/remote-entry/transactions/fund-transfer/pages/fund-transfer-list/fund-transfer-list.component.ts |
| FundTransferListComponent | 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/finance/src/app/remote-entry/transactions/fund-transfer/pages/fund-transfer-list/fund-transfer-list.component.ts |
| FundTransferListComponent | onRedirectToPaymentIn | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/fund-transfer-list/fund-transfer-list.component.ts |
| FundTransferListComponent | onRedirectToPaymentOut | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/fund-transfer-list/fund-transfer-list.component.ts |
| FundTransferListComponent | 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/finance/src/app/remote-entry/transactions/fund-transfer/pages/fund-transfer-list/fund-transfer-list.component.ts |
| FundTransferListComponent | printRecord | 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/finance/src/app/remote-entry/transactions/fund-transfer/pages/fund-transfer-list/fund-transfer-list.component.ts |
| ViewFundTransferComponent | cancel | Leave or close without persisting; warn when the current form has unsaved changes and restore the prior list/filter context. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/view-fund-transfer/view-fund-transfer.component.ts |
| ViewFundTransferComponent | onRedirectToPaymentIn | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/view-fund-transfer/view-fund-transfer.component.ts |
| ViewFundTransferComponent | onRedirectToPaymentOut | Document the enabled state, permission, input context, resulting API or navigation effect, success refresh, and concrete failure behavior for this handler. | apps/finance/src/app/remote-entry/transactions/fund-transfer/pages/view-fund-transfer/view-fund-transfer.component.ts |
Page-specific frontend acceptance criteria
- (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: AppFinancePermissions.FundTransfer_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: AppFinancePermissions.FundTransfer_Add; Guards: PolicyAuthGuard
- 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: AppFinancePermissions.FundTransfer_Edit; Guards: PolicyAuthGuard, preventPostedGuard
- fund-transfer - 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
- 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: AppFinancePermissions.FundTransfer_View; Guards: PolicyAuthGuard