--- id: ATS-COM-ORD-018 scope: CAP-COM-ORD-018 product_area: commerce module: orders revision: 1 status: proposed approved_by: null approved_at: null source_sha: services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b react-console: baf6dae382d6f41dce976c7f848667ccc37e076f scenarios: - id: ATS-COM-ORD-018-01 title: Receipt replay retains the first delivery record level: api proves: - BR-CAP-COM-ORD-018-01 preconditions: A keyed receipt is accepted against an issued purchase order. steps: Submit the same receipt key again. expected: The response identifies the existing receipt without duplicate stock or cost writes. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#answers the retried receipt as found under its key, writing nothing twice - >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#answers the retried first receipt as the same receipt, lists the receipts by order and reads one with its lines provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#answers the retried receipt as found under its key, writing nothing twice - id: ATS-COM-ORD-018-02 title: Receipt validation prevents excess or unexplained cost level: api proves: - BR-CAP-COM-ORD-018-02 preconditions: The open line has forty units left and a separate order is already received. steps: >- Attempt excess quantity, another receipt on the completed order and changed cost without and with a reason. expected: Invalid receipt cases write nothing and only the explained cost variance proceeds. negative: true data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#refuses a receipt beyond what the line has open (over_receipt) and a receipt against a received order, writing nothing - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#refuses a receipt line whose cost differs from the order line’s without a reason, and takes one with a reason provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#refuses a receipt beyond what the line has open (over_receipt) and a receipt against a received order, writing nothing - id: ATS-COM-ORD-018-03 title: Receiving commits quantity and capitalization together level: api proves: - BR-CAP-COM-ORD-018-03 preconditions: Two backorders wait for a sixty-unit delivery at ten dollars per unit. steps: 'Record the delivery and inspect stock, layers, posting facts and claims.' expected: >- The fixture creates sixty units at cost, a six-hundred-dollar capitalization fact and ordered backorder fill with fifty-eight units available. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#writes, in the receipt’s transaction, the receipt movement naming the line, the layer of 60 @ 1000 and the capitalize_receipt fact of 60000 - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#fills the two backorders at the first receipt, oldest first, converting them to committed; the shelf shows 58 available after provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#writes, in the receipt’s transaction, the receipt movement naming the line, the layer of 60 @ 1000 and the capitalize_receipt fact of 60000 - id: ATS-COM-ORD-018-04 title: Landed-cost allocation retains the minor-unit total level: unit proves: - BR-CAP-COM-ORD-018-04 preconditions: Receipt lines have different quantities and values. steps: Allocate freight by each supported basis and derive layer unit cost. expected: Shares preserve the total through the final-line remainder and unit cost includes the allocated portion. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#shares by quantity to the minor unit, the last line taking the rounding remainder - >- services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#shares by value: a line worth three times another takes three times the landed cost - >- services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#is the line’s cost plus its landed share per unit, to the nearest minor unit provenance: test source: >- services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#shares by quantity to the minor unit, the last line taking the rounding remainder - id: ATS-COM-ORD-018-05 title: Method switching leaves earlier cost history intact level: api proves: - BR-CAP-COM-ORD-018-05 preconditions: Two layers have different dates and costs with no initial business-unit setting. steps: 'Relieve under default FIFO, switch to LIFO and relieve again.' expected: 'FIFO uses earlier units, LIFO uses later units and the earlier relief records remain unchanged.' negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves under FIFO while the business unit has no setting: 4 @ 1000 from the older layer, recorded fifo - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves a LIFO business unit’s 12 over two layers newer first: 10 @ 1200 from the newer, then 2 @ 1000 from the older, recorded lifo - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#rewrites nothing made before the switch: the FIFO relief rows read back unchanged, the receipt layers still record fifo provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves under FIFO while the business unit has no setting: 4 @ 1000 from the older layer, recorded fifo - id: ATS-COM-ORD-018-06 title: Costing settings require current version and allowed method level: api proves: - BR-CAP-COM-ORD-018-06 preconditions: The business unit has no configured setting. steps: 'Read defaults, write LIFO, try stale replacement and invalid method or unit inputs.' expected: 'Defaults expose version zero, the valid write succeeds and stale or malformed requests fail.' negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#reads a business unit with no settings at the defaults: FIFO at version 0, not configured - >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#writes LIFO at version 0, replaces it with the record read sent back, and refuses the stale version 409 - >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#refuses a method that is neither FIFO nor LIFO 400, and a body naming another business unit 400 provenance: test source: >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#reads a business unit with no settings at the defaults: FIFO at version 0, not configured - id: ATS-COM-ORD-018-07 title: Uncovered relief is explicitly flagged level: api proves: - BR-CAP-COM-ORD-018-07 preconditions: The shipped quantity exceeds available cost-layer coverage. steps: Relieve the shipped units. expected: Uncovered units carry zero cost with an uncosted_relief exception. negative: true data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves units no layer covers at cost zero under no layer and raises uncosted_relief, so the books say so provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves units no layer covers at cost zero under no layer and raises uncosted_relief, so the books say so - id: ATS-COM-ORD-018-08 title: Return cost reverses the shipment basis level: api proves: - BR-CAP-COM-ORD-018-08 preconditions: Shipment relief used identified layers at retained costs. steps: Restore five returned units. expected: Restore rows identify their reliefs and original-cost layers with a matching cost-restoration fact. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#restores 5 returned units at the relieved cost and place: a restore row naming the relief it reverses, a layer at that cost dated with the original layer, a restore_cogs fact of 5 × that cost provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#restores 5 returned units at the relieved cost and place: a restore row naming the relief it reverses, a layer at that cost dated with the original layer, a restore_cogs fact of 5 × that cost - id: ATS-COM-ORD-018-09 title: Cost corrections preserve the consumed record level: api proves: - BR-CAP-COM-ORD-018-09 preconditions: A costed layer has remaining units and needs a lower unit cost. steps: Correct its remaining cost basis. expected: >- The remainder moves into a successor layer, the original is consumed and the value difference becomes a cost-adjustment fact. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#moves the unconsumed remainder to a layer at the corrected cost, leaves the original consumed, and writes the cost_adjustment of the difference - >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#corrects the second layer’s cost to 1100: the remainder on a correction layer, the original consumed, a cost_adjustment of 10 × 150, the valuation reconciled provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#moves the unconsumed remainder to a layer at the corrected cost, leaves the original consumed, and writes the cost_adjustment of the difference - id: ATS-COM-ORD-018-10 title: Valuation reconciles quantities beside their assigned cost level: api proves: - BR-CAP-COM-ORD-018-10 preconditions: The fixture layers contain three zero-cost units and two ten-unit priced layers. steps: Read valuation and business-unit summaries. expected: The item reports twenty-three units and 225 dollars with reconciliation and its costing setting. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#values the shirt L item at Σ the layers (3 at zero from the movement route, 10 × 1000, 10 × 1250 = 22500), reconciled with 23 on hand - >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#shows the products’ business unit and its method beside the valuation’s totals: faa, FIFO, not configured provenance: test source: >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#values the shirt L item at Σ the layers (3 at zero from the movement route, 10 × 1000, 10 × 1250 = 22500), reconciled with 23 on hand - id: ATS-COM-ORD-018-11 title: Posting acknowledgement is stable by reference level: api proves: - BR-CAP-COM-ORD-018-11 preconditions: Two receipt facts remain unposted. steps: 'List them, acknowledge a reference, replay it and attempt another reference.' expected: >- The same reference replays without changing history, another reference fails and acknowledged facts leave intake. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#lists the unposted facts by date, stamps them posted once under Accounting’s reference, and refuses another reference on a posted fact - >- services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#lists the facts unposted (the two receipts’), stamps them posted under Accounting’s reference, and lists none unposted after provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#lists the unposted facts by date, stamps them posted once under Accounting’s reference, and refuses another reference on a posted fact - id: ATS-COM-ORD-018-12 title: Posting kinds expose their debit and credit purposes level: unit proves: - BR-CAP-COM-ORD-018-12 preconditions: 'Inputs cover receipt, shipment, restore, loss, scrap and gain.' steps: Resolve account purposes for each fact kind. expected: 'The returned inventory, clearing, cost-of-goods and adjustment directions match the supplied fact kind.' negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#debits inventory and credits GRNI for a receipt, debits COGS and credits inventory for a handoff, the reverse for a restore - >- services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#debits the adjustment account for a loss or a write-off and credits it for a gain provenance: test source: >- services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#debits inventory and credits GRNI for a receipt, debits COGS and credits inventory for a handoff, the reverse for a restore - id: ATS-COM-ORD-018-13 title: 'Supply flow connects waiting orders, valuation and posting' level: api proves: - AS-JNY-COM-ORD-006-01 - AS-JNY-COM-ORD-006-02 - AS-JNY-COM-ORD-006-03 preconditions: A vendor supplies stock with existing backorders. steps: 'Issue the commitment, receive deliveries and inspect valuation and posting acknowledgement.' expected: 'The demonstrated components fill waiting claims, reconcile layer value and acknowledge each fact once.' negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#fills the two backorders at the first receipt, oldest first, converting them to committed; the shelf shows 58 available after - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#values the item after at 30 × 1200 = 36000, reconciled with the ledger’s on-hand of 30 - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#lists the unposted facts by date, stamps them posted once under Accounting’s reference, and refuses another reference on a posted fact provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#fills the two backorders at the first receipt, oldest first, converting them to committed; the shelf shows 58 available after - id: ATS-COM-ORD-018-14 title: Transfers preserve value without inventing uncovered cost level: api proves: - BR-CAP-COM-ORD-018-14 preconditions: >- A transfer contains covered stock whose total cost has a rounding remainder and additional stock without an acquisition layer. steps: 'Transfer the units and inspect source relief, destination layers and posting facts.' expected: >- Covered value is preserved exactly across weighted destination layers, uncovered units create no destination cost layer, and the transfer creates no financial posting fact. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: [] provenance: proposed source: 'services-commerce:modules/purchasing/services/cost/transfer-cost.ts:costTransfer' - id: ATS-COM-ORD-018-15 title: Count and staff movements retain the proper cost facts level: api proves: - BR-CAP-COM-ORD-018-15 preconditions: Inventory has receipt cost history and count or staff changes. steps: 'Record gains, losses and scrap in the fixture flows.' expected: >- Gains create receipt-based cost, losses consume layers and each movement records its demonstrated adjustment or write-off purpose. negative: false data_needs: Use the controlled records and transports established by the cited tests. bound_to: - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves a scrap FIFO with a write_off fact, and a negative adjustment with an adjustment_loss fact - >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#values a count gain at the last receipt cost (adjustment_gain) and relieves a count loss (adjustment_loss), each fact naming the count line provenance: test source: >- services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves a scrap FIFO with a write_off fact, and a negative adjustment with an adjustment_loss fact evidence: - >- Examined reference: services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#answers the retried first receipt as the same receipt, lists the receipts by order and reads one with its lines - >- Examined reference: services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#corrects the second layer’s cost to 1100: the remainder on a correction layer, the original consumed, a cost_adjustment of 10 × 150, the valuation reconciled - >- Examined reference: services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#lists the facts unposted (the two receipts’), stamps them posted under Accounting’s reference, and lists none unposted after - >- Examined reference: services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#reads a business unit with no settings at the defaults: FIFO at version 0, not configured - >- Examined reference: services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#refuses a method that is neither FIFO nor LIFO 400, and a body naming another business unit 400 - >- Examined reference: services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#shows the products’ business unit and its method beside the valuation’s totals: faa, FIFO, not configured - >- Examined reference: services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#values the shirt L item at Σ the layers (3 at zero from the movement route, 10 × 1000, 10 × 1250 = 22500), reconciled with 23 on hand - >- Examined reference: services-commerce:modules/purchasing/tests/e2e/purchasing.e2e.spec.js#writes LIFO at version 0, replaces it with the record read sent back, and refuses the stale version 409 - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#answers the retried receipt as found under its key, writing nothing twice - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#fills the two backorders at the first receipt, oldest first, converting them to committed; the shelf shows 58 available after - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#lists the unposted facts by date, stamps them posted once under Accounting’s reference, and refuses another reference on a posted fact - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#moves the unconsumed remainder to a layer at the corrected cost, leaves the original consumed, and writes the cost_adjustment of the difference - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#refuses a receipt beyond what the line has open (over_receipt) and a receipt against a received order, writing nothing - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#refuses a receipt line whose cost differs from the order line’s without a reason, and takes one with a reason - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves a LIFO business unit’s 12 over two layers newer first: 10 @ 1200 from the newer, then 2 @ 1000 from the older, recorded lifo - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves a scrap FIFO with a write_off fact, and a negative adjustment with an adjustment_loss fact - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves under FIFO while the business unit has no setting: 4 @ 1000 from the older layer, recorded fifo - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#relieves units no layer covers at cost zero under no layer and raises uncosted_relief, so the books say so - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#restores 5 returned units at the relieved cost and place: a restore row naming the relief it reverses, a layer at that cost dated with the original layer, a restore_cogs fact of 5 × that cost - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#rewrites nothing made before the switch: the FIFO relief rows read back unchanged, the receipt layers still record fifo - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#values a count gain at the last receipt cost (adjustment_gain) and relieves a count loss (adjustment_loss), each fact naming the count line - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#values the item after at 30 × 1200 = 36000, reconciled with the ledger’s on-hand of 30 - >- Examined reference: services-commerce:modules/purchasing/tests/integration/services/receiving/purchasing-flow.integration.spec.js#writes, in the receipt’s transaction, the receipt movement naming the line, the layer of 60 @ 1000 and the capitalize_receipt fact of 60000 - >- Examined reference: services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#carries the remainder on a second layer one minor unit dearer, so Σ the layers is Σ the draws - >- Examined reference: services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#debits inventory and credits GRNI for a receipt, debits COGS and credits inventory for a handoff, the reverse for a restore - >- Examined reference: services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#debits the adjustment account for a loss or a write-off and credits it for a gain - >- Examined reference: services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#is the line’s cost plus its landed share per unit, to the nearest minor unit - >- Examined reference: services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#shares by quantity to the minor unit, the last line taking the rounding remainder - >- Examined reference: services-commerce:modules/purchasing/tests/unit/cost/cost-rules.spec.js#shares by value: a line worth three times another takes three times the landed cost --- # Receive inventory and retain its cost: Acceptance Test Set ## Coverage | Rule | Scenario or Finding | |---|---| | `BR-CAP-COM-ORD-018-01` | `ATS-COM-ORD-018-01` | | `BR-CAP-COM-ORD-018-02` | `ATS-COM-ORD-018-02` | | `BR-CAP-COM-ORD-018-03` | `ATS-COM-ORD-018-03` | | `BR-CAP-COM-ORD-018-04` | `ATS-COM-ORD-018-04` | | `BR-CAP-COM-ORD-018-05` | `ATS-COM-ORD-018-05` | | `BR-CAP-COM-ORD-018-06` | `ATS-COM-ORD-018-06` | | `BR-CAP-COM-ORD-018-07` | `ATS-COM-ORD-018-07` | | `BR-CAP-COM-ORD-018-08` | `ATS-COM-ORD-018-08` | | `BR-CAP-COM-ORD-018-09` | `ATS-COM-ORD-018-09` | | `BR-CAP-COM-ORD-018-10` | `ATS-COM-ORD-018-10` | | `BR-CAP-COM-ORD-018-11` | `ATS-COM-ORD-018-11` | | `BR-CAP-COM-ORD-018-12` | `ATS-COM-ORD-018-12` | | `BR-CAP-COM-ORD-018-13` | no scenario: `FND-COM-ORD-033` | | `BR-CAP-COM-ORD-018-14` | `ATS-COM-ORD-018-14` | | `BR-CAP-COM-ORD-018-15` | `ATS-COM-ORD-018-15` |