Accounting Categories — Proposed Guide

Planned API — Reference Only

Accounting Categories: Accounting categories group coding options for a business purpose. They are distinct from employee-facing expense categories and…

Overview

Accounting categories group coding options for a business purpose. They are distinct from employee-facing expense categories and may require entity-specific mapping.

Key concepts

Represent the source category, target account and effective mapping version. Keep defaults separate from reviewed selections.

Implementation considerations

A category match is a proposed coding choice, not a completed reconciliation. Resolve ambiguous mappings through authorized review.

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 Categories",
  "category_id": "category_example_123",
  "account_id": "acct_example_123",
  "subsidiary_id": "sub_example_123",
  "mapping_version": 1
}

Design review checklist

Document which organization owns the accounting categories representation and which actor may view or change it.
Test the boundaries of category id, account id, subsidiary id, mapping version 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
category_id	string	Stable fictional category 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.
mapping_version	integer	Revision of the source-to-target field transformation used for this representation.

Chart of Accounts

Accounting & Finance

Accounting Policies