---
id: TST-COM-ORD-026
title: Tax through the preview and the placement
kind: api-lifecycle
product_area: commerce
module: orders
revision: 1
status: draft
source_sha:
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
repository: services-commerce
files:
  - modules/checkout/tests/e2e/checkout-tax.e2e.spec.js
implements:
  - ATS-COM-ORD-003-05
  - ATS-COM-ORD-003-06
environment: local
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 2
isolation: The suite creates its own test workspace records and removes them using the fixture cleanup.
evidence:
  - provenance: test
    source: 'services-commerce:modules/checkout/tests/e2e/checkout-tax.e2e.spec.js'
    test_cases:
      - >-
        taxes each line at the most specific zone: state and city on the T-shirts, state alone on the
        membership
      - 'stores the snapshot with each item’s tax, the tax record and the totals with the tax in them'
      - 'freezes the tax on the lines and the order, and writes the tax line on the tax product, last'
      - writes an obligation for each item line and none for the tax line
      - 'taxes nothing at an address no zone matches, and says so'
      - >-
        refuses a buyer with no preferred address while a zone could tax the line: a no_tax_address problem on
        the preview, a 409 on the placement
      - 'refuses the placement 503 TAX_PROVIDER_UNAVAILABLE, placing nothing'
scenario_coverage:
  - scenario: ATS-COM-ORD-003-05
    test_cases:
      - >-
        refuses a buyer with no preferred address while a zone could tax the line: a no_tax_address problem on
        the preview, a 409 on the placement
    scope: >-
      The cited cases exercise the scenario’s listed fixture outcomes; this register makes no verified
      conformance claim.
  - scenario: ATS-COM-ORD-003-06
    test_cases:
      - >-
        taxes each line at the most specific zone: state and city on the T-shirts, state alone on the
        membership
      - 'stores the snapshot with each item’s tax, the tax record and the totals with the tax in them'
      - 'taxes nothing at an address no zone matches, and says so'
    scope: >-
      The cited cases exercise the scenario’s listed fixture outcomes; this register makes no verified
      conformance claim.
dependency_evidence:
  provenance: test
  source: 'services-commerce:modules/checkout/tests/e2e/checkout-tax.e2e.spec.js'
  declared_by_test: >-
    the composed handler, the routes, the workflows, the tax port and its zone-table adapter, the persistence
    services and PostgreSQL. Doubled: the signing key pair and the other services' tables (local stand-ins,
    CRM's addresses among them).
---

# Tax through the preview and the placement

## Verification Boundary

The suite drives the composed local API dispatcher and its registered routes.

## What This Suite Proves

The registered cases check tax through the preview and the placement with their fixture records and assertions. Scenario bindings name only the examples those cases exercise.

## What It Does Not Prove

A registered file supplies no run result or verified conformance by itself. Local fixtures do not establish deployed cross-service behavior or complete browser journeys.

## Real Dependencies and Test Doubles

PostgreSQL and the exercised Commerce persistence or workflow code are real. Remote service records, clocks and transports follow the suite’s fixtures.

## Must Not Be Doubled

The database constraints, role restrictions, locks and transactions exercised by this suite must use PostgreSQL.