---
id: JNY-ACC-BAT-004
title: Staff resolve a failed posting and its dependent work
feature: FEAT-ACC-BAT-03
product_area: accounting
module: batches
revision: 1
status: draft
product_intent: proposed
implementation_evidence: observed
supersedes:
- ACT-ACC-0521
- ACT-ACC-0522
- ACT-ACC-0526
- ACT-ACC-0546
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
actor: ACT-ACC-012
goal: Identify the blocking prerequisite, correct it and complete accounting for the source and dependent collections.
capabilities:
- CAP-ACC-BAT-013
- CAP-ACC-BAT-012
- CAP-ACC-BAT-014
- CAP-ACC-BAT-004
- CAP-ACC-BAT-002
- CAP-ACC-BAT-015
screens:
- /console/{tenantId}/accounting/batches/{batchId}
steps:
- n: 1
  surface: postBatches
  action: Submit October’s invoices and November’s payments together.
  capability: CAP-ACC-BAT-013
  expected: October reports the missing product revenue account and affected line; November reports its dependency
    and neither writes entries.
  provenance: test
  source: react-console:acceptance/accounting/playwright/journeys/batches-posting/ACT-ACC-0521.spec.ts#ACT-ACC-0521
- n: 2
  surface: /console/{tenantId}/accounting/batches/{batchId} (Validation card)
  action: Inspect the source collection’s validation result.
  capability: CAP-ACC-BAT-012
  expected: The generation preview identifies the same account problem as posting.
  provenance: test
  source: services-accounting:modules/batches/tests/integration/services/posting/gl-resolution-at-posting.integration.spec.js#names
    the same reason in the preview
- n: 3
  surface: /console/{tenantId}/configuration/accounting/products (the product's accounting setup, Products module)
  action: Have an administrator supply the missing product revenue account.
  capability: CAP-ACC-BAT-014
  expected: The new configuration is available without changing existing posted results.
  provenance: test
  source: react-console:acceptance/accounting/playwright/journeys/batches-posting/ACT-ACC-0522.spec.ts#ACT-ACC-0522
- n: 4
  surface: /console/{tenantId}/accounting/batches/{batchId} (More Actions › Reopen)
  action: Reopen the source collection to include a forgotten document.
  capability: CAP-ACC-BAT-004
  expected: October becomes Open and its old errors clear.
  provenance: test
  source: services-accounting:modules/batches/tests/integration/services/persistence/batches.integration.spec.js#clears
    the errors of an errored batch on reopen, so the open batch carries none (journey ACT-ACC-0521)
- n: 5
  surface: getDependentBatches (the readiness line)
  action: Look up collections downstream of October.
  capability: CAP-ACC-BAT-002
  expected: The dependency result includes the errored November collection.
  provenance: observed
  source: services-accounting:modules/batches/services/persistence/batches.ts#dependentBatchesOf
- n: 6
  surface: postBatches
  action: Submit both collections again.
  capability: CAP-ACC-BAT-015
  expected: The source completes before its dependent, using the configured revenue account and source receivable.
  provenance: test
  source: react-console:acceptance/accounting/playwright/journeys/batches-posting/ACT-ACC-0521.spec.ts#ACT-ACC-0521
alternates:
- from_step: 4
  condition: The source needs no additional document.
  path: Retry accounting directly after correcting configuration.
  outcome: The Error batch completes without a separate reopening.
  provenance: test
  source: services-accounting:modules/batches/tests/unit/rules/batch-repost-rules.spec.js#ends posted with no errors
    when the second posting succeeds
failures:
- from_step: 6
  condition: Another generation prerequisite is still missing.
  path: The repeated attempt records only its current failure reasons.
  outcome: Staff correct the remaining prerequisite before another submission.
  provenance: test
  source: services-accounting:modules/batches/tests/unit/rules/batch-repost-rules.spec.js#ends error with the new
    errors alone when the second posting fails too
rules_in_play:
- BR-CAP-ACC-BAT-013-10
- BR-CAP-ACC-BAT-012-03
- BR-CAP-ACC-BAT-014-03
- BR-CAP-ACC-BAT-014-05
- BR-CAP-ACC-BAT-004-03
- BR-CAP-ACC-BAT-013-05
- BR-CAP-ACC-BAT-015-10
assertions:
- id: AS-JNY-ACC-BAT-004-01
  statement: A failed collection retains neither partial entries nor frozen account snapshots.
  provenance: test
  source: 'services-accounting:modules/batches/tests/integration/services/posting/gl-resolution-at-posting.integration.spec.js#leaves
    nothing partially posted: no entry, no snapshot, the documents issued and unposted'
- id: AS-JNY-ACC-BAT-004-02
  statement: A dependent collection identifies the failed prerequisite when it cannot complete.
  provenance: test
  source: react-console:acceptance/accounting/playwright/journeys/batches-posting/ACT-ACC-0526.spec.ts#ACT-ACC-0526
- id: AS-JNY-ACC-BAT-004-03
  statement: After configuration is corrected, both collections complete without old errors using the accounts resolved
    at posting.
  provenance: test
  source: services-accounting:modules/batches/tests/integration/services/posting/gl-resolution-at-posting.integration.spec.js#posts
    both once the gala product is configured and the batch posted again
e2e_policy: required
e2e_reason: Browser acceptance is required to show how staff investigate a generation failure, correct configuration
  and complete dependent work.
evidence:
- 'Inspected references: Examined pinned react-console (baf6dae3): acceptance/accounting/journeys/batches-posting/ACT-ACC-0521.json,
  0522, 0526, 0546 and the Playwright specs of 0521, 0522, 0526; components/accounting/batches/batch-validation-card.tsx,
  batch-posting-readiness.tsx.'
- services-accounting at f47cb263: 'Inspected references: step-level capability citations.'
proved_by: []
---

# Staff resolve a failed posting and its dependent work

## Story

Identify the blocking prerequisite, correct it and complete accounting for the source and dependent collections. The cited steps show how the relevant capabilities connect. Documented walkthrough expectations remain distinct from tested behavior, and the alternative paths identify where staff need a different workflow.
