lib.billing-france
France-specific BillingOS readiness contracts and deterministic e-invoicing/e-reporting checks.
@lssm-tech/lib.billing-francebun add @lssm-tech/lib.billing-franceManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
France-specific BillingOS readiness contracts, deterministic checks, fixtures, exports, and tests.
This package may import country-neutral BillingOS contracts from @lssm-tech/lib.billing-spec. The reverse dependency is forbidden: France identifiers, routing, e-invoicing, and e-reporting readiness must not leak into @lssm-tech/lib.billing-spec or @lssm-tech/lib.billing-runtime.
Scope
- French SME, ETI, and enterprise fiscal-profile readiness inputs.
- B2B domestic e-invoicing, B2C e-reporting, international e-reporting, public-sector readiness, and out-of-scope flow classification.
- 2026/2027 readiness schedule metadata.
- Factur-X, UBL, and CII format-readiness metadata only; this package does not generate invoice documents.
- PA/PDP/provider routing profiles as deterministic mocks/adapters only.
- Financial data-vault evidence contracts for redaction, retention, extraction confidence, evidence chains, and duplicate candidates.
- Replayable fixtures for package tests and examples.
Legal engine
The France pack hosts the deterministic legal engine that core/runtime must not contain:
- TVA rate table — 20 / 10 / 5.5 / 2.1 plus exemption, autoliquidation, and intra-EU, each carrying
validFrom/validToand failing closed on an unknown rate. - Per-rate-group half-up rounding of tax totals.
- Mandatory-mentions validator for required French invoice legal mentions.
- Gapless numbering scoped to a
Europe/Parisfiscal period. - NF203 inalterability hash-chain computed over the canonical invoice bytes.
- Credit-note/avoir derivation with an immutability guard that blocks mutation of issued documents.
SirenSiretVatValidationPortfor INSEE/VIES identifier validation (adapter supplied by the host; live INSEE/VIES is a documented follow-up).
Public entrypoints
@lssm-tech/lib.billing-france— root barrel.@lssm-tech/lib.billing-france/readiness— France flow, schedule, fiscal identifier, format, and readiness-evidence helpers.@lssm-tech/lib.billing-france/provider— provider-neutral mock routing profile and readiness contracts.@lssm-tech/lib.billing-france/data-vault— redacted evidence, retention, extraction, and duplicate-detection contracts.@lssm-tech/lib.billing-france/fixtures— deterministic fixtures.@lssm-tech/lib.billing-france/types— grouped type-only surface.@lssm-tech/lib.billing-france/docs— package boundary doc metadata.
Non-goals
Readiness and routing metadata are not PA accreditation, production PA submission, legal advice, or tax advice. This package contains no provider credentials, network calls, provider SDKs, raw document payload storage, production submission path, or autonomous production billing execution.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
1 declarations
@lssm-tech/lib.billing-specworkspace:^
Read the package manual ↗
Declared capabilities
France-specific BillingOS readiness contracts and deterministic e-invoicing/e-reporting checks.
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolintbun lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .testbun testprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit