---
title: "Report-to-General-Ledger Reconciliation"
method: POST
path: "/v1/tools/reconcile_report_to_general_ledger"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# Report-to-General-Ledger Reconciliation

`POST /v1/tools/reconcile_report_to_general_ledger`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/reconcile_report_to_general_ledger`
- Auth: none declared

Ties a caller-declared reported figure to a caller-declared general-ledger figure, by account -- the only node in this reconciliation programme checked against an independent book of record rather than a second declared value. A designed plug (for example FR 2052a field S.B.6 Carrying Value Adjustment) is a first-class declared input, netted before the residual and never counted as a break. Appendix and supplemental-schedule semantics are versioned policy inputs, never hardcoded. Refuses to run where the requested reporting cadence is finer than the underlying GL schedule's own cadence, and treats a general ledger not yet declared closed as a distinct did_not_run outcome from a genuine tie-out break -- the failure that otherwise surfaces only at quarter-end. Emits a §27.4 gate-policy value plus a sibling execution_state at a predictable output_payload pointer. Clause: BCBS 239 §36(c), ECB RDARR Guide §3.5(1)/(2). Not a transaction matcher and not a filing tool.

**Tool URL:** https://ainumbers.co/chaingraph/art-526-report-gl-reconciliation.html

## Request body

- object
  - `accounts` unknown[], required
    - unknown
  - `appendix_schedule_source` string, required
  - `appendix_schedule_version` string, required
  - `as_of` unknown, required
  - `currency` string, required
  - `gl_as_of` unknown, required
  - `gl_closed` boolean, required
  - `reporting_cadence` unknown
  - `schedule_cadence` unknown
  - `tolerance_minor_units` number, required

## Response `200`

Successful tool execution result

- object
  - `as_of` string
  - `currency` string
  - `appendix_schedule_version` string
  - `appendix_schedule_source` string
  - `reporting_cadence` string
  - `schedule_cadence` string
  - `cadence_refused` boolean
  - `gl_closed_declared` boolean
  - `gl_closed` boolean
  - `gl_as_of` string
  - `account_count` integer
  - `accounts` object[]
    - `account_id` string
    - `reported_figure_minor_units` integer
    - `gl_figure_minor_units` integer
    - `designed_plug_minor_units` integer
    - `designed_plug_display` string
    - `designed_plug_reason_code` string
    - `tolerance_minor_units` integer
    - `residual_minor_units` integer
    - `residual_display` string
    - `within_tolerance` boolean
  - `breaking_account_count` integer
  - `plugged_account_count` integer
  - `decision` object
    - `gate_policy` string
    - `execution_state` string
    - `reason` string
  - `rejected_inputs` unknown[]
    - unknown
  - `rationale` string[]
  - `note` string

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)