einvoicing 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7581f06decdc863a7f8c7509a3ff696f73ca8d223579aa4695a3eee160f3e196
-  data.tar.gz: 1355d8b9034f874d7f3bd7c38315428c90477c6f987ef9642e0deca071f17587
+  metadata.gz: a27d36b05ee79942e8828c53055b9b3088bec50a526d1277dff05aa7b447e405
+  data.tar.gz: bf8f072d6f8a3e15b5f74c06117f3e8def1fd1eb81173dcb2edcaf1bced32f02
 SHA512:
-  metadata.gz: '0146294e7c5ea5515211eabf88d54dde12525052409b69a29aa4206df02762622a96b92bfd2c9e5afef820a50b4c34d939ba2e52baa4c217adf843b324bb90b6'
-  data.tar.gz: 19dac11dd07c6dafb9856fe0878201de2ddc259678bbddef425107413a2d4649058568d6fdae988002df71223b4165b1aee38d3692bf4f7ec390a874b61a8b45
+  metadata.gz: 235d066a6f7d45ed40d10cbd871a560008a33e3bd5c2791e66bafd5f5649a62da0c84f31b7df854e06bf78e8c9514f948f23c88a5043f27bc8ed7f36b46ca11e
+  data.tar.gz: 357abed47d361906c413171f66ba6d66963b275e4149d141d94886822dca14958ca75d0e164ed3d523b293482454ad3baee49347702aec29b8e00bb97d78099f

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.1] - 2026-07-16
+
+### Fixed
+- CII credit notes now emit the preceding invoice number (BT-25) and optional issue date (BT-26) as a machine-readable EN 16931 BG-3 reference while retaining the legacy human-readable note when no explicit invoice note is provided
+
 ## [0.7.0] - 2026-07-14
 
 ### Added
@@ -91,5 +96,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Zero runtime dependencies beyond hexapdf (stdlib-only XML generation via internal builder)
 - RSpec test suite
 
-[Unreleased]: https://github.com/sxnlabs/einvoicing/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/sxnlabs/einvoicing/compare/v0.7.1...HEAD
+[0.7.1]: https://github.com/sxnlabs/einvoicing/compare/v0.7.0...v0.7.1
 [0.1.0]: https://github.com/sxnlabs/einvoicing/releases/tag/v0.1.0

data/lib/einvoicing/formats/cii.rb

@@ -51,22 +51,26 @@ module Einvoicing
           b.tag("ram:IssueDateTime") do
             b.text("udt:DateTimeString", format_date(invoice.issue_date), "format" => "102")
           end
-          if invoice.document_type == :credit_note && invoice.original_invoice_number
+          if (note = document_note(invoice))
             b.tag("ram:IncludedNote") do
-              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
-          if invoice.note
-            b.tag("ram:IncludedNote") do
-              b.text("ram:Content", invoice.note)
-            end
-          end
         end
       end
       private_class_method :exchanged_document
 
+      def self.document_note(invoice)
+        return invoice.note unless invoice.note.to_s.strip.empty?
+        return unless invoice.document_type == :credit_note
+        return if invoice.original_invoice_number.to_s.strip.empty?
+
+        note = "Credit note for invoice #{invoice.original_invoice_number}"
+        note += " dated #{format_display_date(invoice.original_invoice_date)}" if invoice.original_invoice_date
+        note
+      end
+      private_class_method :document_note
+
       def self.supply_chain_trade_transaction(b, invoice, profile)
         b.tag("rsm:SupplyChainTradeTransaction") do
           invoice.lines.each_with_index do |line, idx|
@@ -195,10 +199,25 @@ module Einvoicing
             b.text("ram:TotalPrepaidAmount", format_amount(invoice.prepaid_amount)) if invoice.prepaid_amount.positive?
             b.text("ram:DuePayableAmount",   format_amount(invoice.due_amount))
           end
+
+          preceding_invoice_reference(b, invoice) if invoice.document_type == :credit_note &&
+                                                      invoice.original_invoice_number
         end
       end
       private_class_method :header_trade_settlement
 
+      def self.preceding_invoice_reference(b, invoice)
+        b.tag("ram:InvoiceReferencedDocument") do
+          b.text("ram:IssuerAssignedID", invoice.original_invoice_number)
+          if invoice.original_invoice_date
+            b.tag("ram:FormattedIssueDateTime") do
+              b.text("qdt:DateTimeString", format_date(invoice.original_invoice_date), "format" => "102")
+            end
+          end
+        end
+      end
+      private_class_method :preceding_invoice_reference
+
       # Format a Date or string as YYYYMMDD (CII date format 102).
       def self.format_date(date)
         d = date.is_a?(Date) ? date : Date.parse(date.to_s)
@@ -206,6 +225,12 @@ module Einvoicing
       end
       private_class_method :format_date
 
+      def self.format_display_date(date)
+        d = date.is_a?(Date) ? date : Date.parse(date.to_s)
+        d.strftime("%d/%m/%Y")
+      end
+      private_class_method :format_display_date
+
       def self.format_amount(value)
         format("%.2f", value)
       end

data/lib/einvoicing/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: einvoicing
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Nathan Le Ray