Skip to content
ContractSpec
Start here

Package manual · integrations

·Integrations and provider selection

integration.provider-einvoicing

French Factur-X (EN16931 CII) generation, EN16931/CIUS-FR conformance (Mustangproject), and PDP submission adapters for ContractSpec BillingOS.

integrationsintegrationv2.0.4experimentalservernode
@lssm-tech/integration.provider-einvoicing
bun add @lssm-tech/integration.provider-einvoicing
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

French Factur-X generation and PDP submission for ContractSpec BillingOS.

  • ./cii — pure EN16931 Cross-Industry Invoice (CII) XML builder.
  • ./facturx — FacturXGeneratorPort + a Mustangproject-backed PDF/A-3 hybrid generator.
  • ./conformance — EN16931 / Factur-X CIUS-FR validation via Mustangproject (JVM).
  • ./pdp — PdpSubmissionPort, a deterministic mock, a fail-closed production stub, and an idempotent submission guard.

Conformance toolchain

Validator: Mustangproject CLI 2.17.0 (vendored at vendor/Mustang-CLI-2.17.0.jar, from Maven Central org.mustangproject:Mustang-CLI:2.17.0). It runs XSD schema validation and EN16931 / Factur-X Schematron business rules over the JVM (OpenJDK 17). Set EINVOICING_JAVA_BIN to override the java binary.

Conformance and embedding are never faked: if the jar or JVM is absent, the generator returns the machine CII XML with embedded:false, and the validator returns available:false with a skip reason.

Depends on @lssm-tech/lib.billing-france (TVA rounding, flow classification) and @lssm-tech/lib.billing-spec (invoice types). This package owns Factur-X generation + PDP submission; the lib stays pure.

Relationships

THIS PACKAGEintegration.provider-einvoicing12 import paths

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

2 declarations

Declared capabilities

Integration Provider Einvoicing

French Factur-X (EN16931 CII) generation, EN16931/CIUS-FR conformance (Mustangproject), and PDP submission adapters for ContractSpec BillingOS.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lint:checknode ../../../scripts/biome.cjs check .
  • lint:fixnode ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .
  • testbun test
  • prebuildcontractspec-bun-build prebuild
  • typechecktsgo --noEmit