RoboLedger: Analytical Views

Preview Consolidation Entries

The consolidating entries a group's month needs, computed from the books and posting nothing. For each member consolidated in full: the parent's investment eliminated against the member's capital (its contributions net of distributions), the outside owners' share of that capital as noncontrolling interest, the intercompany balances, the month's intercompany income against the matching expense, and the outside owners' share of the month's result; for each member on the equity method, the parent's share of its result. Accounts are found by the rs-gaap concept they map to, and an intercompany line by the group entity its event names as counterparty. Each entry is the difference between the balance its kind should hold for the member at the month end and what the consolidation entity already holds, so the entries a person posted with the same kind count. A difference between the parent's investment and its share of a member's capital is returned as a residual and its entry withheld, never plugged; intercompany figures the two sides do not agree on are returned as reconciling items. Rejected on shared-repository graphs.

Idempotency: supply an Idempotency-Key header to make safe retries; replays within 24 hours return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.

post/extensions/roboledger/{graph_id}/operations/preview-consolidation-entries

Request

  • Base URL: https://api.robosystems.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.robosystems.ai/extensions/roboledger/{graph_id}/operations/preview-consolidation-entries
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Headers

Idempotency-Keystring nullable

Request body

periodstring required

The month, as YYYY-MM.

Response

Successful Response

operationstring required

Kebab-case operation name

operationIdstring required

op_-prefixed ULID for audit and SSE correlation

status'completed' | 'pending' | 'failed' required

Operation lifecycle state

atstring required

ISO-8601 UTC timestamp

createdBystring nullable

User ID that initiated the operation

idempotentReplayboolean

True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.

Changes

No recorded changes to this operation across all 1 revision of this API.