factur-x-builder 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73b17dce8190b48d61b4b2f1d521396374ef906351888926d986fb45268f0226
-  data.tar.gz: a35e0da9ed5066ef58d5ba29adf2168d86de8d16c3ec8bfee0d5503aae282de2
+  metadata.gz: ac6a0f9f68bea474096e87b73b676318343d3aff63d83dbc452f742a67ebb8f8
+  data.tar.gz: 7c07d34573f36f5f16ce094ab8f84df948d288ab052e3a3c69ea1370176b1470
 SHA512:
-  metadata.gz: ca76d2866e7950a772f07b2dc4b17ea2390a1ea8f1b450b2daff5d21347662b0f32cc8bb2e33bc020c39e12d9a5a40096e33b1912a56bdd7ebc5d1a9fc50ca28
-  data.tar.gz: d5661ef43aad892fd4bb67a56714455c1b959545e13cbf4ecb6d88292e41d5bf8e1087277d0999fe4473b0e941010d60a7f34b6d0215ba5e1cc214c84f90c981
+  metadata.gz: 3cff2a09eae0ec30028c99e5453a5149154b9b45869dfa4bd88950e4803aeb58af4455f49b154f2e1b715ffe5877e38cdff482b0e190a57bab9fc4cc9af1afdd
+  data.tar.gz: 7376dda081fe40784a55c71554215951cf7ec4d0f2a2f67e76e0370bbf0b8b927da565e1754722e2890b8591becb670ce3472d523f0040569f05a9d65e56e72e

data/.gitignore

@@ -11,3 +11,4 @@
 .ruby-version
 .nvmrc
 .DS_Store
+*.gem

data/CHANGELOG.md

@@ -1,6 +1,22 @@
+## [Unreleased]
+
+### Fixed
+
+- The vendored XSD files were renamed without updating the `schemaLocation` of the files that
+  import them, which made every `FacturX.build` raise `Nokogiri::XML::SyntaxError`. A test now
+  checks that the schema compiles and that every `schemaLocation` resolves to an existing file.
+
+### Added
+
+- `Party#legal_information` (BT-33, seller additional legal information), emitted as
+  `SellerTradeParty/Description`: legal form, share capital, RCS registration, or a registered
+  office that differs from the invoicing establishment. EN 16931 allows a single postal address
+  per party, so this is the only structured place for a second one.
+
 ## [0.1.0] - 2026-08-05
 
 - Initial release
+
 ### Added
 
 - `FacturX.build` generates an EN 16931 `factur-x.xml` document from invoicing domain objects:

data/README.md

@@ -112,6 +112,32 @@ FacturX.violations(invoice)  # => ["...", "..."]
 FacturX.valid?(invoice)      # => false
 ```
 
+### One address per party
+
+EN 16931 gives each party exactly one `PostalTradeAddress`, and it must be the address of the
+establishment identified by the SIRET carried in `GlobalID`. There is no second slot: the element
+that would hold a registered office, `SpecifiedLegalOrganization/PostalTradeAddress`, exists in the
+`extended` XSD but the French CTC schematron forbids it (`CII-SR-225`), as it forbids
+`ShipFromTradeParty` (`CII-SR-166`).
+
+When the registered office differs from the invoicing establishment, it belongs in BT-33:
+
+```ruby
+FacturX::Party.new(
+  name: "OFFICE DE TOURISME DES MONTS FICTIFS - Établissement de Chambéry",
+  legal_information: "SARL au capital de 50 000 € - RCS Clermont-Ferrand 398 765 438 - " \
+                     "Siège social : 4 boulevard des Sources, 63240 LE MONT-FICTIF",
+  siret: "39876543800005",
+  siren: "398765438",
+  vat_number: "FR79398765438",
+  address: FacturX::Address.new(line_one: "8 rue des Entrepôts", postcode: "73000",
+                                city: "Chambéry", country_code: "FR")
+)
+```
+
+BT-33 is free text — the counterpart of `cbc:CompanyLegalForm` in UBL. Receivers display it, they do
+not parse it.
+
 ### Profiles
 
 By default the French e-invoicing rules apply on top of EN 16931: an invoicing mode (BT-23) and the

data/lib/factur_x/document.rb

@@ -306,6 +306,7 @@ module FacturX
       xml["ram"].send(element_name) do
         text(xml, :GlobalID, party.global_id, scheme_attribute(party.global_id_scheme))
         text(xml, :Name, party.name)
+        text(xml, :Description, party.legal_information)
         emit_legal_organization(xml, party)
         emit_contact(xml, party)
         emit_address(xml, party.address)

data/lib/factur_x/party.rb

@@ -9,18 +9,26 @@ module FacturX
   # (scheme 0009), `siren` the legal organization ID (scheme 0002), and
   # `routing_id` the electronic address (scheme 0225) used to route the
   # invoice through the PPF, defaulting to the SIRET.
+  #
+  # `legal_information` is BT-33, the seller's additional legal information:
+  # legal form, share capital, RCS registration, and any other statement the
+  # printed invoice must carry. A party holds a single postal address, so this
+  # is also where a registered office that differs from the invoicing
+  # establishment belongs.
   class Party
-    attr_reader :name, :trading_name, :siret, :siren, :vat_number, :tax_id,
+    attr_reader :name, :trading_name, :legal_information, :siret, :siren, :vat_number, :tax_id,
                 :address, :contact, :global_id, :global_id_scheme,
                 :legal_id, :legal_id_scheme, :routing_id, :routing_id_scheme
 
     def initialize(name:, address: nil, contact: nil, trading_name: nil,
+                   legal_information: nil,
                    siret: nil, siren: nil, vat_number: nil, tax_id: nil,
                    global_id: nil, global_id_scheme: nil,
                    legal_id: nil, legal_id_scheme: nil,
                    routing_id: :derive_from_siret, routing_id_scheme: nil)
       @name = name
       @trading_name = trading_name
+      @legal_information = legal_information
       @address = address
       @contact = contact
       @siret = siret

data/lib/factur_x/schemas/Factur-X_1.09_EN16931_ReusableAggregateBusinessInformationEntity_100.xsd

@@ -5,8 +5,8 @@
     xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100"
     targetNamespace="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"
     elementFormDefault="qualified">
-  <xs:import namespace="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" schemaLocation="Factur-X_1.09_EN16931_urn_un_unece_uncefact_data_standard_QualifiedDataType_100.xsd"/>
-  <xs:import namespace="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" schemaLocation="Factur-X_1.09_EN16931_urn_un_unece_uncefact_data_standard_UnqualifiedDataType_100.xsd"/>
+  <xs:import namespace="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" schemaLocation="Factur-X_1.09_EN16931_QualifiedDataType_100.xsd"/>
+  <xs:import namespace="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" schemaLocation="Factur-X_1.09_EN16931_UnqualifiedDataType_100.xsd"/>
   <xs:complexType name="CreditorFinancialAccountType">
     <xs:sequence>
       <xs:element name="IBANID" type="udt:IDType" minOccurs="0"/>

data/lib/factur_x/schemas/Factur-X_EN16931.xsd

@@ -6,9 +6,9 @@
     xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100"
     targetNamespace="urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
     elementFormDefault="qualified">
-  <xs:import namespace="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" schemaLocation="Factur-X_1.09_EN16931_urn_un_unece_uncefact_data_standard_QualifiedDataType_100.xsd"/>
-  <xs:import namespace="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" schemaLocation="Factur-X_1.09_EN16931_urn_un_unece_uncefact_data_standard_ReusableAggregateBusinessInformationEntity_100.xsd"/>
-  <xs:import namespace="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" schemaLocation="Factur-X_1.09_EN16931_urn_un_unece_uncefact_data_standard_UnqualifiedDataType_100.xsd"/>
+  <xs:import namespace="urn:un:unece:uncefact:data:standard:QualifiedDataType:100" schemaLocation="Factur-X_1.09_EN16931_QualifiedDataType_100.xsd"/>
+  <xs:import namespace="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100" schemaLocation="Factur-X_1.09_EN16931_ReusableAggregateBusinessInformationEntity_100.xsd"/>
+  <xs:import namespace="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100" schemaLocation="Factur-X_1.09_EN16931_UnqualifiedDataType_100.xsd"/>
   <xs:element name="CrossIndustryInvoice" type="rsm:CrossIndustryInvoiceType"/>
   <xs:complexType name="CrossIndustryInvoiceType">
     <xs:sequence>

data/lib/factur_x/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FacturX
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: factur-x-builder
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Hotentic
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-09 00:00:00.000000000 Z
+date: 2026-08-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri