Skip to content

Sales General Settings ​

Backlog fieldValue
Story IDAP-SAL-010
EpicSales
Story typeMaster data / configuration
Review statusDraft - business analyst and business owner review required
Source evidenceAppsPortal.Apis controller, application command/query handlers, validators, domain entities, and matching MFE workflow where available
Last source review2026-07-10

User story ​

As sales administrators, I want to configure sales defaults, accounts, credit, and transaction policies so that sales workflows behave consistently.

Acceptance criteria ​

  1. Only authorized users can view or execute the feature's actions.
  2. Required business data, active dependencies, tenant/branch scope, and current document state are validated.
  3. Invalid requests return actionable validation errors without applying a partial change.
  4. Search, list, view, print, and export operations use the same authorized business scope.
  5. Material create, edit, status, approval, posting, reversal, and integration actions are auditable where applicable.
  6. Financial or stock effects are applied atomically and no more than once.

Business rules ​

Required ​

Enabled sales workflows require default accounts, taxes, warehouses, payment terms, credit/discount policies, sequences, and return rules they consume.

Optional or conditional ​

Unused defaults and optional tolerances are not required.

Action behavior ​

Save changes future Sales behavior; posted records remain unchanged.

Blocking rule or downstream effect ​

Missing consumed settings blocks Save/Post with a named configuration error.

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/pageComponentModeRoute permission/guardMapping confidenceSource
general-setting-salesGeneralSettingSalesComponentList/navigationPermission: AppSalesPermissions.SalesGeneralSettings_View , AppSalesPermissions.SalesGeneralSettings_Edit; Guards: PolicyAuthGuardFeature token matchapps/sales/src/app/remote-entry/sales/sales.module.ts:278
general-setting-sales/general-formGeneralSettingSalesComponentList/navigationPermission: AppSalesPermissions.SalesGeneralSettings_View , AppSalesPermissions.SalesGeneralSettings_Edit; Guards: PolicyAuthGuardFeature token matchapps/sales/src/app/remote-entry/sales/sales.module.ts:283

Observed frontend fields and validation ​

ComponentControlObserved frontend ruleComponent source
GeneralSettingSalesComponentdefaultWarehouseIdVisible control; optional or API-dependentapps/sales/src/app/remote-entry/sales/pages/general-setting-sales/general-setting-sales.component.ts
GeneralSettingSalesComponentintegrateWithGeneralLedgerVisible control; optional or API-dependentapps/sales/src/app/remote-entry/sales/pages/general-setting-sales/general-setting-sales.component.ts
GeneralSettingSalesComponentinvoiceOverdueBlockedVisible control; optional or API-dependentapps/sales/src/app/remote-entry/sales/pages/general-setting-sales/general-setting-sales.component.ts

Observed frontend actions ​

ComponentClick action/handlerBusiness review requirementComponent source
--No direct (click) handler was found; review shared toolbar/table commands and form submission bindings.Route sources above

Page-specific frontend acceptance criteria ​

  1. general-setting-sales - 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: AppSalesPermissions.SalesGeneralSettings_View , AppSalesPermissions.SalesGeneralSettings_Edit; Guards: PolicyAuthGuard
  2. general-setting-sales/general-form - 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: AppSalesPermissions.SalesGeneralSettings_View , AppSalesPermissions.SalesGeneralSettings_Edit; Guards: PolicyAuthGuard

Internal Documentation — Microtec