Busflow Docs

Internal documentation portal

Skip to content

Tax Engine โ€” ยง 25 UStG Steuer-Engine โ€‹

Implementation stub. Full specification lives in the Tax Engine Protocol.

Module Structure โ€‹

apps/api/src/
โ”œโ”€โ”€ backoffice/
โ”‚   โ””โ”€โ”€ services/
โ”‚       โ””โ”€โ”€ tax-resolver.service.ts     # EIGEN/FREMD + Geography โ†’ tax_strategy
โ”œโ”€โ”€ commerce/
โ”‚   โ””โ”€โ”€ services/
โ”‚       โ”œโ”€โ”€ tax-calculator.service.ts   # Actuals โ†’ TaxLedgerEntry (ยง 25 Abs. 5 fields)
โ”‚       โ”œโ”€โ”€ invoice.service.ts          # TaxLedgerEntry โ†’ Invoice
โ”‚       โ””โ”€โ”€ period-lock.service.ts      # Immutability enforcement
โ””โ”€โ”€ shared/
    โ””โ”€โ”€ tax/
        โ”œโ”€โ”€ tax-strategy.enum.ts        # STANDARD_VAT | MARGIN_SCHEME_25
        โ”œโ”€โ”€ geography.enum.ts           # EU | THIRD_COUNTRY
        โ”œโ”€โ”€ schemas.ts                  # Valibot: CostComponent, TaxRule, MarginResult
        โ”œโ”€โ”€ margin-calculator.ts        # ยง 25 UStG: dynamic rate, split, Negativmarge
        โ””โ”€โ”€ vat-calculator.ts           # Standard VAT: configurable rate

Internal documentation โ€” Busflow