zugpferd 0.3.5 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: abb862a514f5dca77411e88cf1f21a3ed148192d30c3e6e661dbd9720344cae4
-  data.tar.gz: 7effd9d5bed0d5a9e6d054acbad9602846f7c334a98ee32ec65037c62b4aee95
+  metadata.gz: 985b4ac96323c6efebddb2908c4346a25444370b4b930f052d79056586553695
+  data.tar.gz: 80bbf8c1df7fd5ce7cc7357b1bd197b6c75926eea07354ae8ba65976af60885a
 SHA512:
-  metadata.gz: 111a8f3af318dba1cd0d4f5f208ed5a35fce92d59eda7c5660098cc83d10d61d8229ad97a400fba46160bb4bb7df80fe23820c2a35d92f81e563b3b2e1bc36a3
-  data.tar.gz: 16c0f30986919d7365f321ef18c3f3cf820152d6d0abc3943a3889e7485733ffc77d61a392755d48859011e79bac8bd30e3b4e77e65ed0f2fca2c9f866b57065
+  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

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,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zugpferd
 version: !ruby/object:Gem::Version
-  version: 0.3.5
+  version: 0.4.0
 platform: ruby
 authors:
 - Alexander Zeitler