Struct ChartOfAccounts 

pub struct ChartOfAccounts {
    pub coa_id: String,
    pub name: String,
    pub country: String,
    pub industry: IndustrySector,
    pub accounts: Vec<GLAccount>,
    pub complexity: CoAComplexity,
    pub account_format: String,
    pub accounting_framework: Option<String>,
    /* private fields */
}

Complete Chart of Accounts structure.

Contains all GL accounts for an entity along with metadata about the overall structure.

Fields

coa_id: String

Unique identifier for this CoA

name: String

Name/description

country: String

Country/region code

industry: IndustrySector

Industry sector this CoA is designed for

accounts: Vec<GLAccount>

All accounts in this CoA

complexity: CoAComplexity

Complexity level

account_format: String

Account number format (e.g., “######” for 6 digits)

accounting_framework: Option<String>

v4.4.1+ accounting framework for this CoA — “us_gaap”, “ifrs”, “french_gaap”, “german_gaap”, or “dual_reporting”. Populated by the orchestrator from config.accounting_standards.framework when accounting_standards.enabled = true; None otherwise. SDK consumers previously reported this field as null across the board — before v4.4.1 it simply didn’t exist.

Implementations

impl ChartOfAccounts

pub fn new( coa_id: String, name: String, country: String, industry: IndustrySector, complexity: CoAComplexity, ) -> Self

Create a new empty Chart of Accounts.

pub fn with_accounting_framework(self, framework: impl Into<String>) -> Self

v4.4.1+ builder for the accounting framework label (e.g. "us_gaap", "ifrs"). Typically invoked by the orchestrator from the parsed AccountingFrameworkConfig.

pub fn add_account(&mut self, account: GLAccount)

Add an account to the CoA.

pub fn rebuild_index(&mut self)

Rebuild the account index (call after deserialization).

pub fn get_account(&self, account_number: &str) -> Option<&GLAccount>

Get an account by number.

pub fn get_postable_accounts(&self) -> Vec<&GLAccount>

Get all postable accounts.

pub fn get_accounts_by_type(&self, account_type: AccountType) -> Vec<&GLAccount>

Get all accounts of a specific type.

pub fn get_accounts_by_sub_type( &self, sub_type: AccountSubType, ) -> Vec<&GLAccount>

Get all accounts of a specific sub-type.

pub fn get_suspense_accounts(&self) -> Vec<&GLAccount>

Get suspense/clearing accounts.

pub fn pick_subaccount_for_document( &self, parent_account: &str, document_id: Uuid, ) -> Option<String>

v5.7.0 — pick a postable sub-account for a parent canonical account, deterministic per document_id.

When the COA was generated with expand_industry_subaccounts: true, each canonical parent (e.g. "4000") is non-postable and its real postings target one of its 6-digit sub-accounts ("400010", "400020", …). This helper deterministically selects one of those sub-accounts based on a stable hash of document_id and the configured weights:

1. If parent_account doesn’t exist in the COA, returns None.
2. If no sub-accounts (children with parent_account == parent) exist, returns parent_account itself (legacy behaviour — expansion was not enabled or this parent is not in the industry pack).
3. Otherwise hashes document_id to a position in the cumulative weight distribution and returns that sub-account number.

Determinism: the same (parent_account, document_id) pair always returns the same sub-account, across regenerations and across platforms.

pub fn get_industry_weighted_accounts( &self, account_type: AccountType, ) -> Vec<(&GLAccount, f64)>

Get accounts weighted by industry relevance.

pub fn account_count(&self) -> usize

Get total account count.

pub fn postable_count(&self) -> usize

Get count of postable accounts.

Trait Implementations

impl Clone for ChartOfAccounts

fn clone(&self) -> ChartOfAccounts

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ChartOfAccounts

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ChartOfAccounts

fn default() -> ChartOfAccounts

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ChartOfAccounts

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ChartOfAccounts

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.