bus-filing-prh — produce PRH export bundles

bus-filing-prh — produce PRH export bundles

Synopsis

bus filing prh [module-specific parameters] [-C <dir>] [-o <file>] [--color <mode>] [-v] [-q] [-h] [-V]

Description

Command names follow CLI command naming.

bus filing prh converts validated workspace data into PRH-ready export bundles. Packaging, manifests, and hashes are deterministic.

It is usually invoked as bus filing prh. Inputs come from closed-period data and upstream reporting/VAT outputs.

Options

Module-specific parameters are documented in command help. Global flags are defined in Standard global flags. For the full list, run bus filing prh --help.

Files

Reads validated datasets and report outputs; writes PRH-specific bundle directories or archives with manifests and hashes.

Examples

bus filing prh --help
bus filing prh --format json
bus filing prh --output ./out/prh-export.json --format json
bus filing -C ./workspace prh

Exit status

0 on success. Non-zero on invalid usage or missing prerequisites.

Using from .bus files

Inside a .bus file, write this module target without the bus prefix.

# same as: bus filing-prh --format json
filing-prh --format json

# same as: bus filing-prh --output ./out/prh-export.tsv
filing-prh --output ./out/prh-export.tsv

Development state

Value promise: Produce PRH (Finnish Business Register) export bundles from closed-period data when invoked as the prh target of bus-filing.

Use cases: Finnish bookkeeping and tax-audit compliance.

Completeness: High — Validate and bundle are verified by e2e and unit tests. Bundles include PRH-required content (journal, reports, voucher references, attachments metadata) per FR-PRH-002 and full PRH SBR taxonomy in iXBRL (balance sheet, income statement, cash flow statement, notes placeholder). Parameter set is stable (OQ-PRH-001 closed). Remaining work: extended bundle metadata and any future filing-target spec updates; see module README and roadmap.

Use case readiness: Finnish bookkeeping and tax-audit compliance: High — validate, bundle, PRH-required content (FR-PRH-002), and PRH SBR taxonomy in iXBRL are implemented and covered by e2e; module is ready for PRH filing within the current bundle contract. Depends on bus-filing bundle contract stability.

Current: Validate and bundle flows, deterministic packaging, and global-flag behavior are test-verified. Detailed test matrix and implementation notes are maintained in Module SDD: bus-filing-prh.

Planned next: Extended bundle metadata when filing-target specs are available; README and doc links alignment; any follow-ups from bus-filing bundle contract. FR-PRH-002 and full PRH SBR iXBRL are implemented.

Blockers: bus-filing bundle contract must be stable for target consumption.

Depends on: bus-filing (invoked as target); bus-period closed.

Used by: bus-filing invokes this module when the target is prh.

See Development status.