invoicing-service — render from snapshots

Input mode: hand-entered rows JSON snapshot files files in the source

Previous snapshot — the balances the cycle opens from (empty is a first cycle) date

	position_pan	position_type	acquired_from	recovered_to_dca	…_vat	recovered_to_creditor	…_vat	billable	returned	taxable	case_file_pan	name

Current snapshot — the balances the cycle closes with date

	position_pan	position_type	acquired_from	recovered_to_dca	…_vat	recovered_to_creditor	…_vat	billable	returned	taxable	case_file_pan	name

Greyed fields are filled in for you and submitted as shown — a hand-entered scenario has no meaningful choice about them, and nothing downstream reads them. A row with no position_pan is skipped.

S3 snapshot files

One snapshot file per snapshot. Each JSON body is exactly the S3 object — the { contract_version, date, period_start, period_end, account_settings, positions_count, control_totals, positions_snapshots } envelope the service ingests — so it can be copied straight from a bucket. A file states the cycle it closes and its own row count and sums, so a hand-edited body is refused unless they are edited with it.

Previous snapshot — the balances the cycle opens from (empty is a first cycle)

Current snapshot — the balances the cycle closes with

snapshot files in the source

The snapshot files this service itself holds — the bucket it polls, or its local data directory. Only the names travel with the form and the service reads the objects, so this is the mode for a real snapshot file: a body big enough to matter is far past what a form field can carry. Files already taken are marked with the trigger that took them; the rest are in the source but not yet ingested.

Previous snapshot — the balances the cycle opens from (empty is a first cycle)

Current snapshot — the balances the cycle closes with

account_settings

override the files' account_settings — replay the picked/pasted files under the settings below instead of the ones they carry. They apply exactly as shown, unchecked toggles included; only the account name stays the file's.

mode vat_rate (basis points) currency — ISO 4217; every amount is stated in it vat_perspective — net/vat/gross columns and the VAT sentence
name invoicing_cycle

documents — one document each; the account's assigned set. collective_bill is the settlement's netted document: pick it alone, with mode settlement

interest_offsetting cost_offsetting dca_fee_offsetting negative_amounts_offsetting — prints the negative_amounts row (still stubbed) acquired_fees_and_costs_billed_by_origin — bills a bought DCA fee or cost as that fee or cost

invoicing-service — render from snapshots

Rendered documents