zugpferd 0.3.4 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62856c1301920bbea44b64a360effeee49572cc5d0563a3585a57821f97a855d
-  data.tar.gz: e1a60440693e9a66f089a5469643d5b9089f1e9e97d2387a415a1fea82420e02
+  metadata.gz: 985b4ac96323c6efebddb2908c4346a25444370b4b930f052d79056586553695
+  data.tar.gz: 80bbf8c1df7fd5ce7cc7357b1bd197b6c75926eea07354ae8ba65976af60885a
 SHA512:
-  metadata.gz: f0f5da629eeeda2b93ec71a4398ea9cdec486742bf43a8871d663afe06498eea56ad4356e98638fbeb613aaca77e8301f48e62ffc1056c277be3f14651b570bf
-  data.tar.gz: 8b26ca18cd6dd8c1ecffc18d465e71796e152ec3ca29e25600627804b119dab8cf962e211937c1eb9ae8e6dcf11e75a5e423a129b6e843f622e84c3381841a79
+  metadata.gz: 28d68c38b89914a8a9d3edd29e073cc1d40790fdd47a8be96d698daaf55cffff9c9b5c146a9720884644a3cab473fc6c6d996c3601819be27961e93cd75335fe
+  data.tar.gz: '03648cd41bd7b8759d7159c1d9d9ba2d649d1d93721d6b11557b6fa060ebbb045cecaffc71b62047fe903b6f4c8b5ff6114a650de72136d37a8210ca5b2a0583'

data/lib/zugpferd/cii/mapping.rb

@@ -31,6 +31,13 @@ module Zugpferd
       SETTLEMENT = "#{TRANSACTION}/ram:ApplicableHeaderTradeSettlement"
       AGREEMENT = "#{TRANSACTION}/ram:ApplicableHeaderTradeAgreement"
 
+      # Invoicing period (BG-14)
+      BILLING_PERIOD = "ram:BillingSpecifiedPeriod"
+      BILLING_PERIOD_FIELDS = {
+        start_date: "ram:StartDateTime/udt:DateTimeString",
+        end_date:   "ram:EndDateTime/udt:DateTimeString",
+      }.freeze
+
       INVOICE_SETTLEMENT = {
         currency_code:  "#{SETTLEMENT}/ram:InvoiceCurrencyCode",
         buyer_reference: "#{AGREEMENT}/ram:BuyerReference",

data/lib/zugpferd/cii/reader.rb

@@ -36,6 +36,7 @@ module Zugpferd
       def build_invoice(root)
         settlement = root.at_xpath(SETTLEMENT, NS)
         delivery = root.at_xpath(DELIVERY, NS)
+        period = settlement&.at_xpath(BILLING_PERIOD, NS)
         type_code = text(root, INVOICE[:type_code])
         model_class = TYPE_CODE_MAP.fetch(type_code, Model::Invoice)
 
@@ -44,6 +45,8 @@ module Zugpferd
           issue_date: parse_cii_date(text(root, INVOICE[:issue_date])),
           due_date: parse_cii_date(settlement ? text(settlement, PAYMENT_TERMS_DUE_DATE) : nil),
           delivery_date: parse_cii_date(delivery ? text(delivery, DELIVERY_DATE) : nil),
+          invoicing_period_start_date: parse_cii_date(period ? text(period, BILLING_PERIOD_FIELDS[:start_date]) : nil),
+          invoicing_period_end_date: parse_cii_date(period ? text(period, BILLING_PERIOD_FIELDS[:end_date]) : nil),
           type_code: text(root, INVOICE[:type_code]),
           currency_code: text(root, INVOICE_SETTLEMENT[:currency_code]),
           buyer_reference: text(root, INVOICE_SETTLEMENT[:buyer_reference]),

data/lib/zugpferd/cii/writer.rb

@@ -173,6 +173,8 @@ module Zugpferd
             end
           end
 
+          build_billing_period(xml, doc) if doc.invoicing_period_start_date || doc.invoicing_period_end_date
+
           doc.allowance_charges.each { |ac| build_allowance_charge(xml, ac) }
 
           if doc.payment_instructions&.note || doc.due_date || doc.payment_instructions&.mandate_reference
@@ -191,6 +193,21 @@ module Zugpferd
         end
       end
 
+      def build_billing_period(xml, doc)
+        xml["ram"].BillingSpecifiedPeriod do
+          if doc.invoicing_period_start_date
+            xml["ram"].StartDateTime do
+              xml["udt"].DateTimeString(format_cii_date(doc.invoicing_period_start_date), format: "102")
+            end
+          end
+          if doc.invoicing_period_end_date
+            xml["ram"].EndDateTime do
+              xml["udt"].DateTimeString(format_cii_date(doc.invoicing_period_end_date), format: "102")
+            end
+          end
+        end
+      end
+
       def build_payment_means(xml, payment)
         xml["ram"].SpecifiedTradeSettlementPaymentMeans do
           xml["ram"].TypeCode payment.payment_means_code
@@ -235,8 +252,8 @@ module Zugpferd
             xml["ram"].TaxTotalAmount(format_decimal(tax_breakdown.tax_amount),
                                       currencyID: tax_breakdown.currency_code)
           end
-          xml["ram"].GrandTotalAmount format_decimal(totals.tax_inclusive_amount)
           xml["ram"].RoundingAmount format_decimal(totals.payable_rounding_amount) if totals.payable_rounding_amount
+          xml["ram"].GrandTotalAmount format_decimal(totals.tax_inclusive_amount)
           xml["ram"].TotalPrepaidAmount format_decimal(totals.prepaid_amount) if totals.prepaid_amount
           xml["ram"].DuePayableAmount format_decimal(totals.payable_amount)
         end

data/lib/zugpferd/model/billing_document.rb

@@ -19,6 +19,8 @@ module Zugpferd
       # @return [String] BT-3 Invoice type code
       # @return [String] BT-5 Document currency code (default: "EUR")
       # @return [Date, nil] BT-72 Actual delivery date
+      # @return [Date, nil] BT-73 Invoicing period start date
+      # @return [Date, nil] BT-74 Invoicing period end date
       # @return [String, nil] BT-10 Buyer reference
       # @return [String, nil] BT-24 Specification identifier
       # @return [String, nil] BT-23 Business process type
@@ -31,8 +33,9 @@ module Zugpferd
       # @return [PaymentInstructions, nil] BG-16 Payment information
       # @return [Array<AllowanceCharge>] BG-20/BG-21 Document-level allowances and charges
       attr_accessor :number, :issue_date, :due_date, :type_code,
-                    :currency_code, :delivery_date, :buyer_reference,
-                    :customization_id, :profile_id, :note, :seller, :buyer,
+                    :currency_code, :delivery_date,
+                    :invoicing_period_start_date, :invoicing_period_end_date,
+                    :buyer_reference, :customization_id, :profile_id, :note, :seller, :buyer,
                     :line_items, :tax_breakdown, :monetary_totals,
                     :payment_instructions, :allowance_charges
 

data/lib/zugpferd/ubl/mapping.rb

@@ -30,6 +30,13 @@ module Zugpferd
       DELIVERY = "cac:Delivery"
       DELIVERY_DATE = "cbc:ActualDeliveryDate"
 
+      # Invoicing period (BG-14)
+      INVOICE_PERIOD = "cac:InvoicePeriod"
+      INVOICE_PERIOD_FIELDS = {
+        start_date: "cbc:StartDate",
+        end_date:   "cbc:EndDate",
+      }.freeze
+
       # Seller (BG-4)
       SELLER = "cac:AccountingSupplierParty/cac:Party"
       # Buyer (BG-7)

data/lib/zugpferd/ubl/reader.rb

@@ -34,12 +34,15 @@ module Zugpferd
         model_class = @credit_note ? Model::CreditNote : Model::Invoice
 
         delivery_node = root.at_xpath(DELIVERY, @ns)
+        period_node = root.at_xpath(INVOICE_PERIOD, @ns)
 
         model_class.new(
           number: text(root, INVOICE[:number]),
           issue_date: parse_date(text(root, INVOICE[:issue_date])),
           due_date: parse_date(text(root, INVOICE[:due_date])),
           delivery_date: delivery_node ? parse_date(text(delivery_node, DELIVERY_DATE)) : nil,
+          invoicing_period_start_date: period_node ? parse_date(text(period_node, INVOICE_PERIOD_FIELDS[:start_date])) : nil,
+          invoicing_period_end_date: period_node ? parse_date(text(period_node, INVOICE_PERIOD_FIELDS[:end_date])) : nil,
           type_code: text(root, type_code_element),
           currency_code: text(root, INVOICE[:currency_code]),
           buyer_reference: text(root, INVOICE[:buyer_reference]),

data/lib/zugpferd/ubl/writer.rb

@@ -50,6 +50,7 @@ module Zugpferd
         xml["cbc"].Note doc.note if doc.note
         xml["cbc"].DocumentCurrencyCode doc.currency_code
         xml["cbc"].BuyerReference doc.buyer_reference if doc.buyer_reference
+        build_invoice_period(xml, doc) if doc.invoicing_period_start_date || doc.invoicing_period_end_date
 
         build_supplier(xml, doc.seller, doc.payment_instructions) if doc.seller
         build_customer(xml, doc.buyer) if doc.buyer
@@ -141,6 +142,13 @@ module Zugpferd
         end
       end
 
+      def build_invoice_period(xml, doc)
+        xml["cac"].InvoicePeriod do
+          xml["cbc"].StartDate doc.invoicing_period_start_date.to_s if doc.invoicing_period_start_date
+          xml["cbc"].EndDate doc.invoicing_period_end_date.to_s if doc.invoicing_period_end_date
+        end
+      end
+
       def build_delivery(xml, doc)
         xml["cac"].Delivery do
           xml["cbc"].ActualDeliveryDate doc.delivery_date.to_s

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: zugpferd
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.4.0
 platform: ruby
 authors:
 - Alexander Zeitler
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-19 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -70,7 +69,6 @@ description: Read, write and convert XRechnung and ZUGFeRD electronic invoices (
   according to EN 16931. Supports UBL 2.1 and UN/CEFACT CII syntaxes with dedicated
   classes for Invoice, Credit Note, Corrected Invoice, Self-billed Invoice, Partial
   Invoice and Prepayment Invoice.
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -119,7 +117,6 @@ metadata:
   changelog_uri: https://github.com/alexzeitler/zugpferd/blob/master/CHANGELOG.md
   documentation_uri: https://www.rubydoc.info/gems/zugpferd
   bug_tracker_uri: https://github.com/alexzeitler/zugpferd/issues
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -134,8 +131,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.20
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: XRechnung & ZUGFeRD e-invoicing library for Ruby (UBL + CII)
 test_files: []