Accounting Dimensions — Proposed Guide

Planned API — Reference Only

Accounting Dimensions: Dimensions add reporting axes such as location, project or business unit to accounting lines. Their validity may depend on an…

Overview

Dimensions add reporting axes such as location, project or business unit to accounting lines. Their validity may depend on an entity and account combination.

Key concepts

Model dimension definitions separately from selected values. Specify required combinations and allowed null values.

Implementation considerations

Do not accept arbitrary tags as valid ledger dimensions. A future mapping must validate target-system constraints.

Illustrative data model

This local fixture shows a possible representation for the concepts above. It is not an endpoint response, production configuration or a claim that the described capability is implemented.

JSON fixture

Fictional concept fixture

{
  "reference_only": true,
  "topic": "Accounting Dimensions",
  "dimension_id": "dimension_example_123",
  "dimension_value_id": "dimension_value_example_123",
  "account_id": "acct_example_123",
  "subsidiary_id": "sub_example_123"
}

Design review checklist

Document which organization owns the accounting dimensions representation and which actor may view or change it.
Test the boundaries of dimension id, dimension value id, account id, subsidiary id using synthetic values, including missing or inconsistent references.
Before future implementation, obtain an approved contract and review failure behavior. This documentation does not authorize production activation.

Proposed data types

Illustrative field dictionary
Name	Type	Description
dimension_id	string	Stable fictional dimension reference; not a secret and not evidence that a resource exists.
dimension_value_id	string	Stable fictional dimension value reference; not a secret and not evidence that a resource exists.
account_id	string	Stable fictional account reference; not a secret and not evidence that a resource exists.
subsidiary_id	string	Stable fictional subsidiary reference; not a secret and not evidence that a resource exists.

Cost Centers

Accounting & Finance

Transaction Tags