bus-filing-vero — produce Vero export bundles

bus-filing-vero — produce Vero export bundles

Synopsis

bus filing vero [global flags] <subcommand> [subcommand flags]

bus-filing-vero [global flags] <subcommand> [subcommand flags]

Description

Command names follow CLI command naming.

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

It consumes VAT/report outputs and closed-period data. Path resolution uses module path accessors, so reports/ and vat/ folders are optional.

Prerequisites

Export expects canonical workspace layout from upstream modules. Run bus config init, bus invoices init, and bus vat init so VAT datasets/schemas exist at workspace root.

When bundle requires reports, generate them first. No manual reports/ or vat/ directory creation is required.

Each CSV input requires beside-the-CSV schema. Both name.schema.json and name.csv.schema.json are accepted.

Options

Use standard global flags (see Standard global flags). Global flags appear before subcommand.

Subcommands: export accepts --bundle <dir> and optional --dry-run. verify accepts --bundle <dir>.

Defaults: default bundle path is filing/vero/bundle, and default format is tsv.

Unknown subcommands/flags and empty --bundle are usage errors (2). For full flag matrix and edge-case semantics, see Module reference: bus-filing-vero.

Files

Reads validated datasets and VAT and report outputs from the canonical layout, with root-level VAT files by default per bus vat. vat/ and reports/ are optional and are used only when the path accessors return those locations. For each CSV input, the command accepts name.schema.json and name.csv.schema.json. Writes Vero-specific bundle directories or archives with manifests and hashes.

Examples

bus filing vero export --bundle filing/vero/2026-01
bus filing vero verify --bundle filing/vero/2026-01
bus filing vero export --bundle filing/vero/2026-01 --format json --output ./out/vero-export.json
bus filing vero export --bundle filing/vero/2026-01 --dry-run

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-vero export --bundle filing/vero/2026-02
filing-vero export --bundle filing/vero/2026-02

# same as: bus filing-vero verify --bundle filing/vero/2026-02 --format tsv
filing-vero verify --bundle filing/vero/2026-02 --format tsv