Ledger Service

service

Records double-entry journal entries for every billing movement.

Owner: Finance Systems
Technology: Java
Runtime: JVM 21
Surface: 6 endpoints · 1 event

kimtu/finance-coredocs/overview.mdce02b98last commit 11 days ago by @arossi

Written by the team in docs/overview.md · rendered by Kimtu, ownership and connections below are generated

Overview

Ledger Service is append-only. It converts billing events into balanced journal entries and is the source of truth for financial reporting.

Responsibilities

Consumes invoice and payment events from the bus
Writes immutable journal entries in double-entry form
Exposes read-only endpoints for trial balance and account history

This repository has no mkdocs.yml, so pages are ordered by folder structure.

Connections

Event Bus

Ledger Service

Billing Warehouse Postgres · ledger

UpstreamLedger ServiceDownstream

Component	Direction	Contract
Billing Warehouse	Calls	cdc · JournalEntry
Event Bus	Consumes	amqp · invoice.finalized, payment.settled
Postgres · ledger	Calls	postgres · JournalEntry

See the whole system·This neighbourhood on the system map

Published events

events/ledger.entry_posted.json

1{
2  "type": "ledger.entry_posted",
3  "version": 1,
4  "data": {
5    "entry": "je_4402",
6    "debit": "1100-receivables",
7    "credit": "4000-revenue",
8    "amount": 48200
9  }
10}

Technology

JavaPostgreSQLKafka

Ledger Service

Overview

Responsibilities

Connections

Published events

Technology

Related documentation