Assign accounts to standard posting purposes

Purpose

Controllers provide fallback destinations for posting when a document leaves its account unspecified.

How It Works

The controller opens the default-account drawer from the unit’s chart. The drawer groups choices by their posting purpose. Staff choose the appropriate account from the unit’s chart and save the assignments. Empty choices remain visible so configuration gaps can be reviewed. The console narrows offered account types more than the service does. Invoice entry can continue before all defaults are complete. Posting reports the missing destination when it needs an account that configuration does not provide.

Relationships

Posting combines document-specific choices with these unit defaults.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes: A posting purpose selects no more than one active account of its unit.The chart highlights important unassigned defaults.Account configuration gaps are addressed during posting without blocking invoice issue.
Surfaces: consoleapi
Intent sources: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R2services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#D12services-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-1

Controls

23 controls apply, from the corpus control catalogue.

TC-IAM-001 TC-IAM-002 TC-IAM-004 TC-IAM-005 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-AZ-005 TC-AZ-006 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-TEN-004 TC-DAT-001 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-PI-001 TC-PI-003 TC-PI-005

Permissions

Key	Checked at	Scope
`accounting.business-units.read`	api	tenant
`accounting.business-units.update`	api	tenant
`accounting.application.access`	api	tenant

Business Rules

8 rules, 4 to be proved before approval. A rule's product intent is derived from its origin: 8 confirmed by a product decision, the rest inheriting this capability's confirmed.

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Confirmed	The default-purpose vocabulary returns fifteen purposes in display order: nine legacy purposes, four reconciliation purposes, sales tax payable and doubtful-account allowance, with expected types supplied as guidance. origin: services-accounting:docs/milestones/plans/ACCT-M1-plan.md#D12 proved by `ATS-ACC-BKS-006-01`, `TST-ACC-BKS-049`, `TST-ACC-BKS-064`	policy	database, api	test services-accounting:modules/books/tests/e2e/default-gl-accounts.e2e.spec.js#answers all fifteen purposes in display order, with the count
`02`must prove Confirmed	Each purpose has at most one assigned active GL account of its own unit; a new assignment replaces the previous one and cross-unit choices identify both units in the refusal. proved by `ATS-ACC-BKS-006-02`, `ATS-ACC-BKS-006-06`, `ATS-ACC-BKS-013-09`, `TST-ACC-BKS-017`, `TST-ACC-BKS-049`, `TST-ACC-BKS-078`	validation	api, service, database	test services-accounting:modules/books/tests/e2e/default-gl-accounts.e2e.spec.js#answers 400 to another unit’s GL account, naming both units
`03`must prove Confirmed	Reading defaults requires business-unit read permission, while assignment and clearing require business-unit update permission. proved by `ATS-ACC-BKS-006-03`, `TST-ACC-BKS-049`	permission	api	test services-accounting:modules/books/tests/e2e/default-gl-accounts.e2e.spec.js#refuses that principal an assignment 403 permission_missing
`04` Confirmed	Clearing a purpose removes its assignment and succeeds even when the assignment is already absent. proved by `ATS-ACC-BKS-005-09`, `ATS-ACC-BKS-006-05`, `TST-ACC-BKS-007`	lifecycle	service	test services-accounting:modules/books/tests/integration/services/persistence/default-gl-accounts.integration.spec.js#answers the purpose with no account when clearing a purpose the unit has no default for
`05` Confirmed	The service accepts a default account whose type differs from the purpose’s expected types. origin: services-accounting:docs/milestones/plans/ACCT-M1-plan.md#D12	policy	service, database	observed services-accounting:modules/books/db/default-gl-account-purposes.table.ts:defaultGlAccountPurposes
`06` Confirmed	Missing default accounts do not prevent invoice issue; posting resolves them later and reports a document error if neither the document nor the unit supplies the needed account. origin: services-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-1 proved by `ATS-ACC-BKS-003-11`, `ATS-ACC-BKS-006-07`, `ATS-ACC-BKS-006-08`, `TST-ACC-BKS-003`, `TST-ACC-BKS-017`	policy	service	documented services-accounting:docs/architecture/accounting-2.0/02-decisions.md#A-1
`07`must prove Confirmed	The Chart of Accounts page offers the assignment drawer and displays Default Accounts Needed while receivables, deferred revenue, bad-debt expense, missing-product revenue or sales tax payable is unassigned. origin: services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R2 proved by `ATS-ACC-BKS-006-04`, `TST-ACC-BKS-007`	policy	console	documented services-accounting:docs/milestones/ACCT-M1-books-and-invoices.md#R2
`08` Confirmed	The console offers only active accounts in the selected unit with types expected by the purpose.	policy	console	observed react-console:components/configuration/accounting/business-unit-default-gl-accounts.tsx:activeOptionsFor

Scenarios

Id	Given	When	Then	Provenance
`01`	A chapter has GL accounts but no assigned defaults.	The controller visits the chapter’s chart.	The missing-default notice identifies the gaps; completing the assignment drawer removes the notice.	test react-console:acceptance/accounting/playwright/journeys/configuration/ACT-ACC-0008.spec.ts#ACT-ACC-0008
`02`	A user has business-unit read permission only.	They inspect defaults and request clearing of an assignment.	Reading succeeds, but clearing is refused without changing the assignment.	test services-accounting:modules/books/tests/e2e/default-gl-accounts.e2e.spec.js#leaves accounts_receivable assigned after the refused clear

Planning

Implementation

Assign accounts to standard posting purposes ​

Purpose ​

How It Works ​

Relationships ​