Skip to content
ContractSpec
Start here

Package manual · domains

·Billing, finance and economic evidence

lib.billing-france

France-specific BillingOS readiness contracts and deterministic e-invoicing/e-reporting checks.

domainslibraryv2.0.4experimentalservernode
@lssm-tech/lib.billing-france
bun add @lssm-tech/lib.billing-france
Package source ↗Manifest ↗

Manifest 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.

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/validTo and 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/Paris fiscal 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.
  • SirenSiretVatValidationPort for 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

THIS PACKAGElib.billing-france15 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

1 declarations

Declared capabilities

Lib Billing France

France-specific BillingOS readiness contracts and deterministic e-invoicing/e-reporting checks.

Scripts

  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lintbun lint:fix
  • lint:fixnode ../../../../scripts/biome.cjs check --write .
  • lint:checknode ../../../../scripts/biome.cjs check .
  • testbun test
  • prebuildcontractspec-bun-build prebuild
  • typechecktsgo --noEmit