factur-x-builder 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 224858d0b676c38126632f450793b3ea65302d795ee6eba2f5fd34c532d7bc51
-  data.tar.gz: 67e574e617b043c7e2e433b95c17193c31dcd98df49d0d454338773a2b461acc
+  metadata.gz: da7a9bafbb80d9e9ac88ee325e49b76c1855e91774f3a1bf1c4dacdcf679cdc9
+  data.tar.gz: 729c3209aa5378bbde0b2400c797db122d887a34cb370d588c22e61df9a94d0b
 SHA512:
-  metadata.gz: 3a674455d7d5c036df7469dd489cd4d932912b1f0113a2aaecb48508a4f48abd4efd42174cdc525123f69e48b81193f8e052b8cbf2c72abe196f55f74d7c747d
-  data.tar.gz: d283359e423f7e88dcfd0a88cd56721812ed6be147dc9de9ce39f5cc784740115531011a43941c4174673c3b1baf137e47d91e9a88cdb266af24af783139c7e0
+  metadata.gz: bd23212eaeb87434500c7f45b41708b1bb9f72bea9f8c178a35953194d0503a41d939e0f36db9b24ae0ba1ace8bdb79035905e70516d0886f54c3af52da26b3a
+  data.tar.gz: 362f6dfba5482d591a1131e866e29ffbf1300873fe2aa73841f65ce3e36b829a8b417c3376cf4fbfc5a2fca6e0038159103b372d9e4a3e10d8907fb1dea55a4c

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+## [Unreleased]
+
+### Added
+
+- A credit note is now checked against BR-FR-CO-05: it must reference the invoice it corrects with
+  both the number (BT-25) and the issue date (BT-26). A reference missing its date failed the
+  French schematron exactly like an absent one, and neither was caught before generating.
+  `Codes::CREDIT_NOTE_TYPES` names the document types the rule applies to.
+
 ## [0.1.2] - 2026-08-15
 
 ### Added

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    factur-x-builder (0.1.3)
+    factur-x-builder (0.1.4)
       nokogiri (~> 1.15, < 1.16)
 
 GEM

data/README.md

@@ -133,6 +133,24 @@ anything is generated.
 A credit note carries **positive** amounts; the type code conveys the direction. Negative unit
 prices are rejected (`BR-27`, `BR-28`).
 
+Cancelling invoice A with credit note B changes four things and nothing else — B's own number
+(BT-1) and issue date (BT-2), the type code `381` (BT-3), and a reference to A carrying **both** its
+number and its issue date (BG-3). That reference is required by the French profile (`BR-FR-CO-05`)
+though not by EN 16931 alone, and a reference without a date fails just like a missing one. Parties,
+lines, prices, VAT breakdown and totals are copied over untouched.
+
+```ruby
+FacturX::Invoice.new(
+  number: "AV-2026-0012",
+  issued_on: Date.today,
+  type_code: FacturX::Codes::CREDIT_NOTE,
+  preceding_invoices: [
+    FacturX::ReferencedInvoice.new(number: "5-2026-0004", issued_on: Date.new(2026, 8, 4))
+  ],
+  # … everything else identical to the invoice being cancelled
+)
+```
+
 ### Routing address
 
 `routing_id` is the electronic address the platform delivers to (BT-34 for the seller, BT-49 for the

data/lib/factur_x/codes.rb

@@ -10,6 +10,11 @@ module FacturX
 
     DOCUMENT_TYPES = [COMMERCIAL_INVOICE, CREDIT_NOTE, SELF_BILLED_INVOICE].freeze
 
+    # The document types BR-FR-CO-05 treats as credit notes. Only 381 is
+    # emitted by this gem; the others are listed so the rule keeps matching
+    # if DOCUMENT_TYPES ever widens.
+    CREDIT_NOTE_TYPES = %w[261 381 396 502 503].freeze
+
     # Invoicing modes accepted by the French e-invoicing reform (BR-FR-08).
     BUSINESS_PROCESSES = %w[B1 S1 M1 B2 S2 M2 S3 B4 S4 M4 S5 S6 B7 S7 B8 S8 M8 B9 S9 M9].freeze
 

data/lib/factur_x/validation/rules.rb

@@ -91,6 +91,21 @@ module FacturX
               "notes (BT-22 with subject code #{code}, BR-FR-05) - " \
               "Note.french_legal_mentions provides the three of them")
         end
+
+        check_corrected_invoice
+      end
+
+      # BR-FR-CO-05: a credit note must say which invoice it corrects. EN 16931
+      # alone is happy without it, the French profile is not. The number and the
+      # issue date are both required - a reference carrying only the number
+      # fails the rule just as an absent one does.
+      def check_corrected_invoice
+        return unless Codes::CREDIT_NOTE_TYPES.include?(invoice.type_code)
+        return if invoice.preceding_invoices.any? { |ref| !blank?(ref.number) && !ref.issued_on.nil? }
+
+        add("a credit note must reference the invoice it corrects, with both its number and " \
+            "its issue date (BT-25 and BT-26, BR-FR-CO-05) - pass preceding_invoices: " \
+            "[ReferencedInvoice.new(number:, issued_on:)]")
       end
 
       def check_document

data/lib/factur_x/version.rb

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

metadata

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