---
id: TST-ACC-BKS-053
title: Exchange Rates API suite
kind: api-lifecycle
product_area: accounting
module: books
revision: 1
status: draft
source_sha:
  services-accounting: f47cb263875bbc0c5640fba7dae6785ec32695f8
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
repository: services-accounting
files:
  - modules/books/tests/e2e/exchange-rates.e2e.spec.js
implements:
  - ATS-ACC-BKS-002-04
  - ATS-ACC-BKS-004-01
  - ATS-ACC-BKS-004-03
  - ATS-ACC-BKS-004-05
environment: local
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 5
isolation: >-
  The suite owns isolated workspace identities and database fixtures; cleanup
  removes only its seeded records.
assertion_bindings:
  - scenario: ATS-ACC-BKS-002-04
    source: >-
      services-accounting:modules/books/tests/e2e/exchange-rates.e2e.spec.js#refuses
      a source that is neither the table nor a provider, naming the field
  - scenario: ATS-ACC-BKS-004-01
    source: >-
      services-accounting:modules/books/tests/e2e/exchange-rates.e2e.spec.js#refuses
      a rate sent as a number, a malformed day, the base currency and a currency
      the unit is not enabled for
  - scenario: ATS-ACC-BKS-004-01
    source: >-
      services-accounting:modules/books/tests/e2e/exchange-rates.e2e.spec.js#answers
      200 with the rate to ten places, source manual, version 1
  - scenario: ATS-ACC-BKS-004-03
    source: >-
      services-accounting:modules/books/tests/e2e/exchange-rates.e2e.spec.js#resolves
      the rate in force on a day, with the currency’s settings, and none for EUR
      with its provider default
  - scenario: ATS-ACC-BKS-004-05
    source: >-
      services-accounting:modules/books/tests/e2e/exchange-rates.e2e.spec.js#refuses
      the fill 409 provider_unavailable while no platform client exists, writing
      nothing
unmapped: false
evidence:
  - provenance: test
    source: 'services-accounting:modules/books/tests/e2e/exchange-rates.e2e.spec.js'
execution_notes: >-
  The file exists at the pinned revision; this registration records no execution
  result.
---

# Exchange Rates API suite

## Verification Boundary

The suite sends requests through the local Accounting handler and enforcing route dispatcher. PostgreSQL stores the run-owned configuration and applies its database safeguards.

## What This Suite Proves

The individual assertion references identify the acceptance outcomes this file exercises. When a scenario spans several suites, this file supplies only its listed assertions; qualification must include the other bindings and any recorded coverage finding.

## What It Does Not Prove

Local database execution does not prove deployed infrastructure, external provider availability or console behavior. No result is claimed for the pinned revision until the suite runs and its evidence is reviewed.

## Real Dependencies and Test Doubles

PostgreSQL, migrations and the exercised persistence paths are real. Test-owned execution contexts, clocks and local Platform records supply deterministic setup; the file’s imports and fixtures identify any additional doubles.

## Must Not Be Doubled

The database constraints, transaction paths and production persistence functions named by the assertions must remain real. A memory store cannot establish the recorded database proof.