Builder's guide · Appendix C

Glossary and further reading

TermMeaning
ConsoleYour application: the screens, people, workflow and controls
Writer (source system)A registered application allowed to call GAAPcore, with a code, a role, a company scope and API keys
Control accountA GL account whose balance is the total of a subledger (receivables, payables, inventory, bank cash)
SubledgerThe detail behind a control account: open invoices, open bills, FIFO layers, assets, leases
Tie-outThe check that a control account equals its subledger, or a bank equals its statement
FIFO layerA quantity of stock at the cost it was received at; issues consume the oldest first
Conversion periodThe earliest period, ending on the cut-over date, where the opening balance is posted
Idempotency keyA unique key per write, so a retry returns the first result instead of posting twice
ReversalA new posting that undoes a posted document, linked to it; posted documents are never edited
Company groupRelated companies that trade with each other and report consolidated statements

Where to read more

FileWhat it holds
Acctgheadless/docs/overview.mdWhat GAAPcore is and what it covers
Acctgheadless/api/README.mdInstalling and running the API
Acctgheadless/api/openapi.yamlEvery route and field
Acctgheadless/docs/api-conventions.mdHeaders, money, errors, idempotency, restricted accounts
Acctgheadless/docs/authentication-design.mdWriters, roles, scope, keys
Acctgheadless/catalog/One specification per transaction type
gaapcore-console/docs/patterns.mdThe 33 integration patterns behind this guide, each pointing at the code that shows it
gaapcore-console/docs/build-notes/What each chunk built, and what to try