RoboLedger: Analytical Views

Consolidation Worksheet

The group's statement for one window with the entity as the column, read live from the tenant's OLTP ledger: the parent and each member consolidated in full, their combined sum, the consolidation entity's adjustments, the consolidated total, and each equity-method or cost member beside the sum, never in it. Every column renders under the group parent's Reporting Style. 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/consolidation-worksheet

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/consolidation-worksheet
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

graph_idstring required

Headers

Idempotency-Keystring nullable

Request body

statement_typestring required

income_statement | balance_sheet | cash_flow_statement | equity_statement.

period_startstring date nullable

Explicit window start. Overrides period_type/fiscal_year.

period_endstring date nullable

Explicit window end. Overrides period_type/fiscal_year.

period_typestring nullable

annual | quarterly | instant (ignored when dates supplied)

fiscal_yearinteger nullable

Fiscal year for annual window (anchored on FiscalCalendar)

limitinteger

Max rows returned. Defaults to the ceiling: the whole statement.

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.