Finance — Domain events
Product version: 1.0.0+1
Last updated: 2026-10-07
Audience: Integrators, operators debugging postings
Finance publishes and consumes RabbitMQ domain events through the shared Outbox / consumer pattern. Canonical catalog: engineering SoT docs/product/EVENT_CATALOG.md (not duplicated here as a second authority).
Emitted by Finance (implemented)
| Event | Consumers (typical) | Notes |
|---|---|---|
FinanceJournalPostedEvent |
Audit, Dashboard | Raised every time a journal is posted (manual, opening balance, automated, year close, restore); includes posting_kind for sales KPI mapping |
FinanceCashTransferPostedEvent |
Audit | Cash book transfer (follows its journal posted event) |
FinanceFiscalYearClosedEvent |
Audit | Year close |
FinanceExpenseRecordedEvent |
Audit | Expense JE (follows its journal posted event) |
FinanceOtherRevenueRecordedEvent |
Audit (Dashboard ACKs; not Sales MTD) | Other revenue (follows its journal posted event) |
FinanceCashSettlementSubmittedEvent |
Audit | A representative's cash hand-over was submitted |
FinanceCashSettlementPostedEvent |
Audit, Notifications (to the representative) | Finance confirmed the hand-over (follows its journal posted event) |
FinanceCashSettlementCancelledEvent |
Audit, Notifications (to the representative, unless they cancelled it) | Open hand-over cancelled |
Consumed by Finance (implemented)
| Event | Effect |
|---|---|
TenantCreatedEvent |
Bootstrap CoA / fiscal year |
TenantHardDeletedEvent |
Hard erase finance tables |
SalesInvoiceCreatedEvent / Voided / payment / return / refund / payment reversed |
Journal postings |
SalesInvoiceCreatedEvent / SalesReturnCompletedEvent / SalesInvoiceVoidedEvent |
E-invoicing: track the invoice or credit note; a void cancels a not-yet-accepted e-invoice |
InventoryTransactionCreatedEvent |
COGS or inventory adjustment from cost snapshot |
TenantDataExportPartRequestedEvent |
Finance part of a tenant data export (no e-invoicing credentials) |
Dashboard KPI map (posting_kind)
posting_kind |
Sales KPI effect |
|---|---|
sale_revenue |
+Revenue, +sales count |
sale_void |
−Revenue, −sales count |
sale_return |
−Revenue |
inventory_cogs |
+COGS |
inventory_cogs_return |
−COGS |
sale_payment / inventory_adjustment / inventory_opening_stock / cash_settlement |
Not sales KPI drivers |
Related: Lifecycle · Boundaries · Audit · Dashboard KPIs