einvoicing 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c103791ffce05b80340cbae5a1b09a00f4b5408edd8a70bfac567898be951ee9
-  data.tar.gz: 7db7faa121b1e2ab57c6ed9d467602eef8771a61acd57d0ea28eb53050ad9301
+  metadata.gz: 7581f06decdc863a7f8c7509a3ff696f73ca8d223579aa4695a3eee160f3e196
+  data.tar.gz: 1355d8b9034f874d7f3bd7c38315428c90477c6f987ef9642e0deca071f17587
 SHA512:
-  metadata.gz: 5812428fa6b471a0cc5a34787e74fd473e3ffd5520226e736ce0fc6b144b054caf70c636f8b8b2a2acd834e4ff0d1f8db4bf47747b934e5dfa29e0d217333117
-  data.tar.gz: 1cf58d2a1cc101430435611c5091510ec62e48d9c2d0e33e01a827853aecf92ed69d1a57b9cc20a1d245e97768014ff350b669bf51c928d9892b18ebb21c13e4
+  metadata.gz: '0146294e7c5ea5515211eabf88d54dde12525052409b69a29aa4206df02762622a96b92bfd2c9e5afef820a50b4c34d939ba2e52baa4c217adf843b324bb90b6'
+  data.tar.gz: 19dac11dd07c6dafb9856fe0878201de2ddc259678bbddef425107413a2d4649058568d6fdae988002df71223b4165b1aee38d3692bf4f7ec390a874b61a8b45

data/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.7.0] - 2026-07-14
+
+### Added
+- `prepaid_amount` on `Invoice` (BT-113 `TotalPrepaidAmount` in CII / `PrepaidAmount` in UBL) so a retained/prepaid amount (e.g. retenue de garantie) reduces the amount due (BR-CO-16: `DuePayableAmount = GrandTotal − TotalPrepaidAmount`) without affecting the taxable base or VAT totals
+- CII profile support: `:chorus_pro` and `:en16931` selectable per invoice
+
+### Fixed
+- CII `schemeID` SIRET correctly emitted for Chorus Pro
+- `PaymentMeans` is now required when generating CII/UBL
+
+## [0.6.0] - 2026-03-14
+
+### Changed
+- Codebase aligned on `rubocop-rails-omakase` standards
+- Locale strings extracted into `config/locales/*.yml` (English + French)
+
 ## [0.5.0] - 2026-03-14
 
 ### Fixed

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SXN Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -55,7 +55,7 @@ seller = Einvoicing::Party.new(
 
 buyer = Einvoicing::Party.new(
   name:         "Gecobat",
-  street:       "12 rue du Bâtiment",
+  street:       "12 Construction Street",
   city:         "Paris",
   postal_code:  "75001",
   country_code: "FR",
@@ -65,13 +65,13 @@ buyer = Einvoicing::Party.new(
 
 lines = [
   Einvoicing::LineItem.new(
-    description: "Développement backend — API REST (forfait)",
+    description: "Backend development — REST API (fixed fee)",
     quantity:    1,
     unit_price:  BigDecimal("2500.00"),
     vat_rate:    0.20
   ),
   Einvoicing::LineItem.new(
-    description: "Intégration Factur-X",
+    description: "Factur-X integration",
     quantity:    5,
     unit_price:  BigDecimal("350.00"),
     vat_rate:    0.20
@@ -86,7 +86,7 @@ invoice = Einvoicing::Invoice.new(
   buyer:              buyer,
   lines:              lines,
   payment_reference:  "FAC-2024-0042",
-  note:               "30 jours net",
+  note:               "Net 30",
   payment_means_code: 30,
   iban:               "FR7630006000011234567890189",
   bic:                "BNPAFRPP"
@@ -175,6 +175,20 @@ ubl = Einvoicing::Formats::UBL.generate(invoice)
 
 Produces a UBL 2.1 `Invoice` document with Peppol BIS Billing 3.0 customization ID.
 
+## Chorus Pro / PPF (France)
+
+When submitting to Chorus Pro (French B2G portal), generate CII XML with the `:chorus_pro` profile:
+
+```ruby
+xml = Einvoicing.xml(invoice, format: :cii, profile: :chorus_pro)
+```
+
+Chorus Pro-specific requirements:
+- `schemeID` for SIRET identifiers must be `"SIRET"` (not the ISO 6523 code `"0002"`)
+- `SpecifiedTradeSettlementPaymentMeans` is mandatory — set `payment_means_code:` on the invoice (30 = credit transfer)
+- Invoice ID (`invoice_number`) must not exceed 20 characters
+- Use `einvoicing-connect` for the actual API submission
+
 ## Rails Integration
 
 Include `Einvoicing::Invoiceable` in your ActiveRecord model and implement three methods:

data/config/locales/einvoicing.en.yml

@@ -10,6 +10,8 @@ en:
         original_invoice_number_missing: "Original invoice number is required for credit notes"
         iban_invalid: "IBAN format or checksum is invalid"
         bic_invalid: "BIC format is invalid (8 or 11 characters)"
+        prepaid_amount_negative: "Prepaid amount cannot be negative"
+        prepaid_amount_exceeds_total: "Prepaid amount cannot exceed the invoice total"
       seller:
         name_missing: "Seller name is required"
         siren_invalid: "Seller SIREN must be 9 digits (Luhn check failed)"
@@ -25,3 +27,9 @@ en:
         quantity_invalid: "Line %{index}: quantity must be positive"
         unit_price_invalid: "Line %{index}: unit price must be non-negative"
         vat_rate_invalid: "Line %{index}: VAT rate must be a known French rate (0%%, 5.5%%, 10%%, 20%%)"
+    formats:
+      unknown_format: "Unknown format: %{fmt}. Use :cii or :ubl"
+      unknown_market: "Unknown market: %{market}. Use :fr"
+      invalid_pdf: "pdf_data does not appear to be a valid PDF (missing %PDF- magic bytes)"
+    tax:
+      invalid_rate: "rate must be >= 0, got %{rate}"

data/config/locales/einvoicing.fr.yml

@@ -10,6 +10,8 @@ fr:
         original_invoice_number_missing: "Le numéro de facture d'origine est requis pour les avoirs"
         iban_invalid: "Le format ou la somme de contrôle de l'IBAN est invalide"
         bic_invalid: "Le format du BIC est invalide (8 ou 11 caractères)"
+        prepaid_amount_negative: "Le montant déjà payé ne peut pas être négatif"
+        prepaid_amount_exceeds_total: "Le montant déjà payé ne peut pas dépasser le total de la facture"
       seller:
         name_missing: "Le nom du vendeur est requis"
         siren_invalid: "Le SIREN du vendeur doit comporter 9 chiffres (vérification Luhn échouée)"
@@ -25,3 +27,9 @@ fr:
         quantity_invalid: "Ligne %{index} : la quantité doit être positive"
         unit_price_invalid: "Ligne %{index} : le prix unitaire doit être non négatif"
         vat_rate_invalid: "Ligne %{index} : le taux de TVA doit être un taux français standard (0%%, 5,5%%, 10%%, 20%%)"
+    formats:
+      unknown_format: "Format inconnu : %{fmt}. Utilisez :cii ou :ubl"
+      unknown_market: "Marché inconnu : %{market}. Utilisez :fr"
+      invalid_pdf: "pdf_data ne semble pas être un PDF valide (octets magiques %PDF- manquants)"
+    tax:
+      invalid_rate: "le taux doit être >= 0, valeur reçue : %{rate}"

data/lib/einvoicing/formats/cii.rb

@@ -16,7 +16,7 @@ module Einvoicing
       UDT_NS = "urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100"
       QDT_NS = "urn:un:unece:uncefact:data:standard:QualifiedDataType:100"
 
-      def self.generate(invoice)
+      def self.generate(invoice, profile: :en16931)
         b = XMLBuilder.new
         b.tag(
           "rsm:CrossIndustryInvoice",
@@ -28,7 +28,7 @@ module Einvoicing
         ) do
           exchanged_document_context(b)
           exchanged_document(b, invoice)
-          supply_chain_trade_transaction(b, invoice)
+          supply_chain_trade_transaction(b, invoice, profile)
         end
         b.to_xml
       end
@@ -53,8 +53,8 @@ module Einvoicing
           end
           if invoice.document_type == :credit_note && invoice.original_invoice_number
             b.tag("ram:IncludedNote") do
-              note = "Avoir sur facture #{invoice.original_invoice_number}"
-              note += " du #{invoice.original_invoice_date.strftime('%d/%m/%Y')}" if invoice.original_invoice_date
+              note = "Credit note for invoice #{invoice.original_invoice_number}"
+              note += " dated #{invoice.original_invoice_date.strftime('%d/%m/%Y')}" if invoice.original_invoice_date
               b.text("ram:Content", note)
             end
           end
@@ -67,12 +67,12 @@ module Einvoicing
       end
       private_class_method :exchanged_document
 
-      def self.supply_chain_trade_transaction(b, invoice)
+      def self.supply_chain_trade_transaction(b, invoice, profile)
         b.tag("rsm:SupplyChainTradeTransaction") do
           invoice.lines.each_with_index do |line, idx|
             trade_line_item(b, line, idx + 1, invoice.currency)
           end
-          header_trade_agreement(b, invoice)
+          header_trade_agreement(b, invoice, profile)
           b.tag("ram:ApplicableHeaderTradeDelivery")
           header_trade_settlement(b, invoice)
         end
@@ -109,21 +109,23 @@ module Einvoicing
       end
       private_class_method :trade_line_item
 
-      def self.header_trade_agreement(b, invoice)
+      def self.header_trade_agreement(b, invoice, profile)
         b.tag("ram:ApplicableHeaderTradeAgreement") do
           # BuyerReference must be first in the sequence (EN 16931 BR-10 / XSD order).
           b.text("ram:BuyerReference", invoice.payment_reference || "")
-          b.tag("ram:SellerTradeParty") { party_xml(b, invoice.seller) }
-          b.tag("ram:BuyerTradeParty")  { party_xml(b, invoice.buyer) }
+          b.tag("ram:SellerTradeParty") { party_xml(b, invoice.seller, profile) }
+          b.tag("ram:BuyerTradeParty")  { party_xml(b, invoice.buyer, profile) }
         end
       end
       private_class_method :header_trade_agreement
 
-      def self.party_xml(b, party)
+      def self.party_xml(b, party, profile)
         b.text("ram:Name", party.name)
-        if party.siren_number
+        legal_id = party.siret || party.siren
+        if legal_id
           b.tag("ram:SpecifiedLegalOrganization") do
-            b.text("ram:ID", party.siren_number, "schemeID" => "0002")
+            scheme = (profile == :chorus_pro && party.siret) ? "SIRET" : "0002"
+            b.text("ram:ID", legal_id, "schemeID" => scheme)
           end
         end
         b.tag("ram:PostalTradeAddress") do
@@ -190,6 +192,7 @@ module Einvoicing
             b.text("ram:TaxTotalAmount",     format_amount(invoice.tax_total),
                    "currencyID" => invoice.currency)
             b.text("ram:GrandTotalAmount",   format_amount(invoice.gross_total))
+            b.text("ram:TotalPrepaidAmount", format_amount(invoice.prepaid_amount)) if invoice.prepaid_amount.positive?
             b.text("ram:DuePayableAmount",   format_amount(invoice.due_amount))
           end
         end

data/lib/einvoicing/formats/facturx.rb

@@ -31,7 +31,7 @@ module Einvoicing
       # @return [String] binary Factur-X PDF/A-3 content
       def self.embed(pdf_data, xml_string, profile: CONFORMANCE)
         unless pdf_data.to_s.b.start_with?("%PDF-")
-          raise ArgumentError, "pdf_data does not appear to be a valid PDF (missing %PDF- magic bytes)"
+          raise ArgumentError, Einvoicing::I18n.t("formats.invalid_pdf")
         end
 
         require "hexapdf"
@@ -66,7 +66,7 @@ module Einvoicing
         names_dict[:EmbeddedFiles][:Names] << FILENAME << filespec
 
         # 3. Set AF array on the catalog.
-        doc.catalog[:AF] = [filespec]
+        doc.catalog[:AF] = [ filespec ]
 
         # 4. Add OutputIntent (required for PDF/A-3 conformance).
         add_output_intent(doc)
@@ -183,7 +183,7 @@ module Einvoicing
           DestOutputProfile:         icc_stream
         })
 
-        doc.catalog[:OutputIntents] = [output_intent]
+        doc.catalog[:OutputIntents] = [ output_intent ]
       end
 
       private_class_method def self.md5(bytes)

data/lib/einvoicing/formats/ubl.rb

@@ -159,6 +159,10 @@ module Einvoicing
                  "currencyID" => invoice.currency)
           b.text("cbc:TaxInclusiveAmount", format_amount(invoice.gross_total),
                  "currencyID" => invoice.currency)
+          if invoice.prepaid_amount.positive?
+            b.text("cbc:PrepaidAmount", format_amount(invoice.prepaid_amount),
+                   "currencyID" => invoice.currency)
+          end
           b.text("cbc:PayableAmount", format_amount(invoice.due_amount),
                  "currencyID" => invoice.currency)
         end

data/lib/einvoicing/i18n.rb

@@ -1,22 +1,33 @@
 # frozen_string_literal: true
 
+require "i18n"
+
 module Einvoicing
-  # Thin wrapper around ::I18n with graceful fallback for standalone use.
-  # When used outside Rails, ::I18n may not be available; in that case the
-  # dotted key string is returned as-is.
+  # Thin wrapper around ::I18n for gem-internal translations.
+  # Loads the gem's own locale files on setup; in Rails apps the engine
+  # already handles the load_path, so duplicates are skipped.
   module I18n
     DEFAULT_LOCALE = :en
+    LOCALES_PATH = File.expand_path("../../config/locales", __dir__)
 
-    def self.t(key, **options)
-      return key.to_s unless defined?(::I18n)
+    def self.setup
+      locale_files = Dir[File.join(LOCALES_PATH, "*.yml")]
+      new_files = locale_files - ::I18n.load_path
+      return if new_files.empty?
+
+      ::I18n.load_path += new_files
+      ::I18n.backend.load_translations
+    end
 
-      locale = options.delete(:locale) { ::I18n.locale rescue DEFAULT_LOCALE }
+    def self.t(key, **options)
+      locale = options.delete(:locale) { ::I18n.locale }
       ::I18n.t("einvoicing.#{key}", locale: locale, **options)
     rescue ::I18n::MissingTranslationData
-      # Fallback to English if translation missing in current locale
       ::I18n.t("einvoicing.#{key}", locale: DEFAULT_LOCALE, **options)
     rescue StandardError
       key.to_s
     end
   end
 end
+
+Einvoicing::I18n.setup

data/lib/einvoicing/invoice.rb

@@ -35,13 +35,15 @@ module Einvoicing
     :bic,
     :document_type,
     :original_invoice_number,
-    :original_invoice_date
+    :original_invoice_date,
+    :prepaid_amount
   ) do
     def initialize(invoice_number:, issue_date:, seller:, buyer:, lines:,
                    due_date: nil, currency: "EUR", tax_currency: nil, tax_breakdown: nil,
                    payment_reference: nil, note: nil,
                    payment_means_code: nil, iban: nil, bic: nil,
-                   document_type: :invoice, original_invoice_number: nil, original_invoice_date: nil)
+                   document_type: :invoice, original_invoice_number: nil, original_invoice_date: nil,
+                   prepaid_amount: BigDecimal(0))
       computed_breakdown = tax_breakdown || compute_tax_breakdown(lines)
       super(
         invoice_number: invoice_number,
@@ -60,7 +62,8 @@ module Einvoicing
         bic: bic,
         document_type: document_type,
         original_invoice_number: original_invoice_number,
-        original_invoice_date: original_invoice_date
+        original_invoice_date: original_invoice_date,
+        prepaid_amount: prepaid_amount.nil? ? BigDecimal(0) : BigDecimal(prepaid_amount.to_s)
       )
     end
 
@@ -80,15 +83,17 @@ module Einvoicing
       lines.sum(BigDecimal("0"), &:gross_amount).round(2, :half_up)
     end
 
-    # Amount due (same as gross_total; override for prepayments).
+    # Amount due after deducting any retained/prepaid amount (BT-113).
+    # VAT remains due on the full gross_total — only the payable balance is reduced
+    # (EN 16931 BR-CO-16: DuePayableAmount = GrandTotal − TotalPrepaidAmount).
     def due_amount
-      gross_total
+      gross_total - prepaid_amount
     end
 
     private
 
     def compute_tax_breakdown(lines)
-      grouped = lines.group_by { |l| [l.vat_rate, l.category] }
+      grouped = lines.group_by { |l| [ l.vat_rate, l.category ] }
       grouped.map do |(rate, category), rate_lines|
         taxable = rate_lines.sum(BigDecimal("0"), &:net_amount).round(2, :half_up)
         tax_amt = rate_lines.sum(BigDecimal("0"), &:vat_amount).round(2, :half_up)

data/lib/einvoicing/party.rb

@@ -27,13 +27,13 @@ module Einvoicing
       resolved_endpoint_id = endpoint_id || siret || email
       resolved_endpoint_scheme = if endpoint_scheme
                                    endpoint_scheme
-                                 elsif endpoint_id
+      elsif endpoint_id
                                    nil  # caller must supply scheme when explicit
-                                 elsif siret
+      elsif siret
                                    "0002"  # SIRET scheme — Peppol EAS FR standard
-                                 elsif email
+      elsif email
                                    "EM"    # email fallback (not in Peppol EAS, use for non-Peppol)
-                                 end
+      end
       super(name: name, street: street, city: city, postal_code: postal_code,
             country_code: country_code, siren: siren, siret: siret,
             vat_number: vat_number, email: email,

data/lib/einvoicing/ppf/client.rb

@@ -46,9 +46,9 @@ module Einvoicing
       end
 
       # POST /v1/soumettre/factures — submit an invoice.
-      # facture_hash: Hash matching the Chorus Pro invoice schema.
-      def submit_invoice(facture_hash)
-        post("/v1/soumettre/factures", facture_hash)
+      # invoice_hash: Hash matching the Chorus Pro invoice schema.
+      def submit_invoice(invoice_hash)
+        post("/v1/soumettre/factures", invoice_hash)
       end
 
       private

data/lib/einvoicing/ppf/invoice_adapter.rb

@@ -8,12 +8,12 @@ module Einvoicing
       # @param invoice [Einvoicing::Invoice]
       # @param id_structure_cpp [Integer] from find_structure()
       # @param code_service [String, nil] from list_services() — optional
-      # @param numero_engagement [String, nil] buyer PO/engagement number — optional for B2B
-      def self.to_chorus_payload(invoice, id_structure_cpp:, code_service: nil, numero_engagement: nil)
+      # @param engagement_number [String, nil] buyer PO/engagement number — optional for B2B
+      def self.to_chorus_payload(invoice, id_structure_cpp:, code_service: nil, engagement_number: nil)
         {
           idStructureCPP:   id_structure_cpp,
           codeService:      code_service,
-          numeroEngagement: numero_engagement,
+          numeroEngagement: engagement_number,
           cadreFacturation: {
             codeCadreFacturation: "FACTURE_FOURNISSEUR",
             codeServiceValideur:  nil

data/lib/einvoicing/ppf/submitter.rb

@@ -12,17 +12,17 @@ module Einvoicing
       #
       # @param invoice [Einvoicing::Invoice]
       # @param code_service [String, nil] optional service code from list_services
-      # @param numero_engagement [String, nil] optional engagement number
-      def submit(invoice, code_service: nil, numero_engagement: nil)
+      # @param engagement_number [String, nil] optional engagement number
+      def submit(invoice, code_service: nil, engagement_number: nil)
         structure    = @client.find_structure(siret: invoice.buyer.siret)
         id_structure = structure["idStructureCPP"] || structure.dig("parametres", "idStructureCPP")
         raise ValidationError, "Buyer SIRET #{invoice.buyer.siret} not found in Chorus Pro" unless id_structure
 
         payload = InvoiceAdapter.to_chorus_payload(
           invoice,
-          id_structure_cpp:  id_structure,
-          code_service:      code_service,
-          numero_engagement: numero_engagement
+          id_structure_cpp: id_structure,
+          code_service:     code_service,
+          engagement_number: engagement_number
         )
 
         @client.submit_invoice(payload)

data/lib/einvoicing/tax.rb

@@ -11,7 +11,7 @@ module Einvoicing
     # @param tax_amount [Numeric] VAT amount for this rate
     # @param category [Symbol, nil] nil for standard/zero, :reverse_charge for AE
     def initialize(rate:, taxable_amount:, tax_amount:, category: nil)
-      raise ArgumentError, "rate must be >= 0, got #{rate}" if rate.to_f.negative?
+      raise ArgumentError, Einvoicing::I18n.t("tax.invalid_rate", rate: rate) if rate.to_f.negative?
 
       super
     end

data/lib/einvoicing/validators/fr.rb

@@ -124,6 +124,13 @@ module Einvoicing
           errors << { field: :bic, error: :bic_invalid,
                       message: Einvoicing::I18n.t("errors.invoice.bic_invalid") }
         end
+        if invoice.prepaid_amount.negative?
+          errors << { field: :prepaid_amount, error: :prepaid_amount_negative,
+                      message: Einvoicing::I18n.t("errors.invoice.prepaid_amount_negative") }
+        elsif invoice.prepaid_amount > invoice.gross_total
+          errors << { field: :prepaid_amount, error: :prepaid_amount_exceeds_total,
+                      message: Einvoicing::I18n.t("errors.invoice.prepaid_amount_exceeds_total") }
+        end
         errors
       end
       private_class_method :validate_invoice_fields
@@ -159,8 +166,8 @@ module Einvoicing
 
       def self.validate_lines(lines)
         if lines.nil? || lines.empty?
-          return [{ field: :lines, error: :lines_empty,
-                    message: Einvoicing::I18n.t("errors.invoice.lines_empty") }]
+          return [ { field: :lines, error: :lines_empty,
+                    message: Einvoicing::I18n.t("errors.invoice.lines_empty") } ]
         end
 
         lines.each_with_index.flat_map do |line, idx|
@@ -178,7 +185,7 @@ module Einvoicing
                { field: :"line_#{n}_unit_price", error: :unit_price_invalid,
                  message: Einvoicing::I18n.t("errors.line.unit_price_invalid", index: n) }
              end),
-            (unless [0.0, 0.055, 0.10, 0.20].include?(line.vat_rate.to_f.round(3))
+            (unless [ 0.0, 0.055, 0.10, 0.20 ].include?(line.vat_rate.to_f.round(3))
                { field: :"line_#{n}_vat_rate", error: :vat_rate_invalid,
                  message: Einvoicing::I18n.t("errors.line.vat_rate_invalid", index: n) }
              end)

data/lib/einvoicing/validators/peppol.rb

@@ -86,18 +86,18 @@ module Einvoicing
       private_class_method :download
 
       def self.run_saxon(xml_string)
-        input  = Tempfile.new(["peppol-input",  ".xml"])
-        output = Tempfile.new(["peppol-output", ".svrl"])
+        input  = Tempfile.new([ "peppol-input",  ".xml" ])
+        output = Tempfile.new([ "peppol-output", ".svrl" ])
 
         begin
           input.write(xml_string)
           input.close
           output.close
 
-          cmd = ["java", "-jar", SAXON_JAR,
+          cmd = [ "java", "-jar", SAXON_JAR,
                  "-s:#{input.path}",
                  "-xsl:#{XSLT_PATH}",
-                 "-o:#{output.path}"]
+                 "-o:#{output.path}" ]
 
           _, stderr, status = Open3.capture3(*cmd)
 

data/lib/einvoicing/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Einvoicing
-  VERSION = "0.5.0"
+  VERSION = "0.7.0"
 end

data/lib/einvoicing/xml_builder.rb

@@ -5,7 +5,7 @@ module Einvoicing
   # Produces indented XML with proper attribute and text escaping.
   class XMLBuilder
     def initialize
-      @parts = ['<?xml version="1.0" encoding="UTF-8"?>']
+      @parts = [ '<?xml version="1.0" encoding="UTF-8"?>' ]
       @depth = 0
     end
 

data/lib/einvoicing.rb

@@ -56,12 +56,13 @@ module Einvoicing
   # Generate XML from an invoice.
   # @param invoice [Einvoicing::Invoice]
   # @param format [Symbol] :cii (default, Factur-X) or :ubl (Peppol BIS 3.0)
+  # @param profile [Symbol] :en16931 (default) or :chorus_pro (French B2G portal)
   # @return [String] XML document
-  def self.xml(invoice, format: :cii)
+  def self.xml(invoice, format: :cii, profile: :en16931)
     case format
-    when :cii then Formats::CII.generate(invoice)
+    when :cii then Formats::CII.generate(invoice, profile: profile)
     when :ubl then Formats::UBL.generate(invoice)
-    else raise ArgumentError, "Unknown format: #{format.inspect}. Use :cii or :ubl"
+    else raise ArgumentError, Einvoicing::I18n.t("formats.unknown_format", fmt: format.inspect)
     end
   end
 
@@ -81,7 +82,7 @@ module Einvoicing
   def self.validate(invoice, market: :fr)
     case market
     when :fr then Validators::FR.validate(invoice)
-    else raise ArgumentError, "Unknown market: #{market.inspect}. Use :fr"
+    else raise ArgumentError, Einvoicing::I18n.t("formats.unknown_market", market: market.inspect)
     end
   end
 
@@ -98,6 +99,6 @@ module Einvoicing
     pdf_out = pdf ? embed(pdf, xml_str) : nil
     { valid: errors.empty?, errors: errors, xml: xml_str, pdf: pdf_out }
   rescue StandardError => e
-    { valid: false, errors: [{ field: :unknown, error: :exception, message: e.message }], xml: nil, pdf: nil }
+    { valid: false, errors: [ { field: :unknown, error: :exception, message: e.message } ], xml: nil, pdf: nil }
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: einvoicing
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Nathan Le Ray
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hexapdf
@@ -24,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -44,14 +57,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.65'
+        version: '1.70'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.65'
+        version: '1.70'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails-omakase
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
@@ -119,6 +160,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- LICENSE
 - README.md
 - config/locales/einvoicing.en.yml
 - config/locales/einvoicing.fr.yml
@@ -158,7 +200,6 @@ metadata:
   source_code_uri: https://github.com/sxnlabs/einvoicing
   changelog_uri: https://github.com/sxnlabs/einvoicing/blob/master/CHANGELOG.md
   documentation_uri: https://www.sxnlabs.com/en/gems/einvoicing/
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -173,8 +214,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
 summary: EU electronic invoicing for Ruby — EN 16931, Factur-X, UBL 2.1
 test_files: []