---
id: TST-COM-FUL-015
title: Error classification
kind: unit
product_area: commerce
module: fulfillment
revision: 1
status: draft
source_sha:
  services-commerce: c8b66a98e2490617aec38ba5c8165dd9bd0a8f9b
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
repository: services-commerce
files:
  - modules/data-operations/tests/unit/operations/error-classification.spec.js
implements:
  - ATS-COM-FUL-020-06
environment: mock
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 1
isolation: 'In-memory inputs, recorded calls and test-owned doubles; no shared customer records.'
evidence:
  - repository: services-commerce
    path: modules/data-operations/tests/unit/operations/error-classification.spec.js
    test_titles:
      - >-
        blocks an item whose reference nobody has loaded, on the engine’s dependency_missing, at the
        field that names it
      - rejects under the stable code a typed refusal carries
      - 'rejects an invalid request or object as invalid_value, a record not found as not_found'
      - answers a locked record and a stale version as conflicts
      - 'names a unique violation by its constraint alone, never by the colliding value'
      - >-
        rejects a foreign-key, a check and a Commerce rule refusal as invalid_value, naming the
        constraint
      - >-
        reports a connection reset as a transient systemic failure, and an unknown error as one that
        is not
    scenario_anchors:
      - >-
        services-commerce:modules/data-operations/tests/unit/operations/error-classification.spec.js#blocks
        an item whose reference nobody has loaded, on the engine’s dependency_missing, at the field
        that names it
      - >-
        services-commerce:modules/data-operations/tests/unit/operations/error-classification.spec.js#rejects
        under the stable code a typed refusal carries
      - >-
        services-commerce:modules/data-operations/tests/unit/operations/error-classification.spec.js#names
        a unique violation by its constraint alone, never by the colliding value
      - >-
        services-commerce:modules/data-operations/tests/unit/operations/error-classification.spec.js#reports
        a connection reset as a transient systemic failure, and an unknown error as one that is not
---

# Error classification

## Verification Boundary

This suite checks error classification with controlled inputs and recorded dependencies. Its entry points remain within the process.

## What This Suite Proves

The bound scenarios identify the assertions this suite contributes. Source anchors retain the exact test cases; where a capability scenario has several contributing suites, a single binding does not imply that every branch runs here.

## What It Does Not Prove

Controlled inputs do not establish database enforcement, deployed integration or browser behavior. A recorded call is evidence about the adapter contract rather than a remote operation.

## Real Dependencies and Test Doubles

The imported logic is real; test inputs and dependency responses are controlled.

## Must Not Be Doubled

Keep the imported production logic and its request construction real. Record dependency calls and refusals rather than replacing the behavior being asserted.