Spoolis docs

Discrepancies

Record, explain, review, and resolve differences between expected and observed outcome figures.

What a discrepancy means

A discrepancy says that two sources do not currently reconcile. It does not assume either source is wrong. Expected and observed figures remain verbatim, including their units and currency.

Effect on commercial state

An open amount, count, or definition discrepancy makes the affected unit uncertain. An open dispute makes it disputed and therefore not currently final or payable under policy. These are statements about the record, never balances or custody.

Spoolis maintains the canonical accepted commercial state under the agreement's rules and authority model.

API

Open a discrepancy

POST /api/v1/spools/{id}/discrepancies
{
  "kind": "count",
  "expected": { "value": 10, "unit": "outcomes" },
  "observed": { "value": 9, "unit": "outcomes" },
  "explanation": "The source counts differ.",
  "links": { "match_ids": [] }
}

List discrepancies on the Spool. Resolve or dismiss one through its dsc_ resource. The same actions are available through MCP and the CLI.