tradedoc 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d87493b2d1156cf4362761b4dc3398dad0c6348ce3170826baec0bfba4828e89
-  data.tar.gz: 24977f17f5d160e53db9bce2515ebf54f8230803dfd29421b70b0481999f9d93
+  metadata.gz: 9a70e0cf62712b8f2a9f32130333cfefde2290ee72e93dd5c9306efc5c6454c8
+  data.tar.gz: 3ec08efbd6910f6f8f2b3341fab2f7955d0b12b016d6583b600fad029734918d
 SHA512:
-  metadata.gz: c557ebc83e0c24369c8fa95290fe21814709f4d87b6b0f7877d98dd6cf5ea6d1805a4a5ba6e087a25b00c5a2ded4fbaabdc237eddfafc802792e5603f3eb3489
-  data.tar.gz: 85ef013be857e6ee3d4038c94aec51f06552d0e34daa75cd63a1e6755df6ed27accb484e5cc63478383382d85c3c6afd52547ef148034dcc95814b9a45616f43
+  metadata.gz: 3b73c93cb7944000755ff82cac2e71b8bffc8cff311ab75cb35dc7b63ff5c22af7b4d811125429c81b026611f18fb6bdca0ee05bff3a48a82bcefb12068a953e
+  data.tar.gz: 68cd3edbe9399e3b01bed3734d1b7e93ee9181159610ae7986d45be5d3c491cee421d422de4e524aa84e26884c9dccf68488976390edabbc9c2d52932a63e650

data/CHANGELOG.md

@@ -1,5 +1,15 @@
-## [Unreleased]
+[Unreleased]
+------------
 
-## [0.1.0] - 2026-07-29
+[0.2.0] - 2026-09-30
+--------------------
+
+### Added
+
+* `TradeParty` support for `vat_number` and `legal_registration_number`
+
+
+[0.1.0] - 2026-07-29
+--------------------
 
 - Initial release

data/lib/tradedoc/format/cii/coder/contact.rb

@@ -11,13 +11,13 @@ module Tradedoc
             w.add(as) do
               w.render(obj.name, as: "ram:PersonName")
 
-              if (tel = obj.phone)
+              w.render(obj.phone) do |tel|
                 w.add("ram:TelephoneUniversalCommunication") do
                   w.render(tel, as: "ram:CompleteNumber")
                 end
               end
 
-              if (email = obj.email)
+              w.render(obj.email) do |email|
                 w.add("ram:EmailURIUniversalCommunication") do
                   w.render(email, as: "ram:URIID")
                 end

data/lib/tradedoc/format/cii/coder/invoice.rb

@@ -26,7 +26,7 @@ module Tradedoc
 
           def self.dump(w, obj)
             w.add("rsm:CrossIndustryInvoice", NS) do
-              if (spec_id = obj.specification_id)
+              w.render(obj.specification_id) do |spec_id|
                 w.add("rsm:ExchangedDocumentContext") do
                   w.add("ram:GuidelineSpecifiedDocumentContextParameter") do
                     w.render(spec_id, as: "ram:ID")
@@ -38,7 +38,7 @@ module Tradedoc
                 w.render(obj.invoice_number, as: "ram:ID")
                 w.render(obj.invoice_type_code, as: "ram:TypeCode")
                 w.render(obj.issue_date, as: "ram:IssueDateTime")
-                if (note = obj.note)
+                w.render(obj.note) do |note|
                   w.add("ram:IncludedNote") do
                     w.add("ram:Content", note)
                   end

data/lib/tradedoc/format/cii/coder/invoice_line.rb

@@ -20,13 +20,13 @@ module Tradedoc
               end
 
               w.add("ram:SpecifiedLineTradeAgreement") do
-                if (gross = obj.price.gross)
+                w.render(obj.price.gross) do |gross|
                   w.add("ram:GrossPriceProductTradePrice") do
                     w.render(gross, as: "ram:ChargeAmount")
                   end
                 end
 
-                if (net = obj.price.net)
+                w.render(obj.price.net) do |net|
                   w.add("ram:NetPriceProductTradePrice") do
                     w.render(net, as: "ram:ChargeAmount")
                   end

data/lib/tradedoc/format/cii/coder/remittance_advice.rb

@@ -29,7 +29,7 @@ module Tradedoc
                 w.add("ram:ID", obj.id)
                 w.render(obj.issue_date, as: "ram:IssueDateTime")
 
-                if (note = obj.note)
+                w.render(obj.note) do |note|
                   w.add("ram:IncludedNote") do
                     w.add("ram:Content", note)
                   end

data/lib/tradedoc/format/cii/coder/trade_party.rb

@@ -3,6 +3,9 @@ module Tradedoc
     module CII
       module Coder
         class TradeParty
+          VAT_TYPE = "VA"
+          private_constant :VAT_TYPE
+
           def self.ruby_type
             Model::TradeParty
           end
@@ -10,16 +13,30 @@ module Tradedoc
           def self.dump(w, obj, as:)
             w.add(as) do
               w.render(obj.name, as: "Name")
+              w.render(obj.legal_registration_id) do |id|
+                w.add("ram:SpecifiedLegalOrganization") do
+                  w.add("ram:ID", id)
+                end
+              end
               w.render(obj.contact, as: "ram:DefinedTradeContact")
               w.render(obj.address, as: "PostalTradeAddress")
+              w.render(obj.vat_number) do |vat_number|
+                w.add("ram:SpecifiedTaxRegistration") do
+                  w.add("ram:ID", vat_number, schemeID: VAT_TYPE)
+                end
+              end
             end
           end
 
           def self.parse(r)
             ruby_type.new.tap do |tp|
               r.parse("ram:Name", :String) { tp.name = it }
+              r.parse("ram:SpecifiedLegalOrganization/ram:ID", :String) { tp.legal_registration_id = it }
               r.parse("ram:DefinedTradeContact", :Contact) { tp.contact = it }
               r.parse("ram:PostalTradeAddress", :Address) { tp.address = it }
+              r.parse("ram:SpecifiedTaxRegistration/ram:ID[@schemeID='#{VAT_TYPE}']", :String) do
+                tp.vat_number = it
+              end
             end
           end
         end

data/lib/tradedoc/format/ubl/coder/invoice.rb

@@ -35,17 +35,17 @@ module Tradedoc
               w.render(obj.note, as: "cbc:Note")
               w.render(obj.currency_code, as: "cbc:DocumentCurrencyCode", listAgencyID: Code::Agency::CEFACT)
               w.render(obj.invoice_period, as: "InvoicePeriod")
-              if (po_number = obj.purchase_order_number)
+              w.render(obj.purchase_order_number) do |po_number|
                 w.add("cac:OrderReference") do
                   w.render(po_number, as: "cbc:ID")
                 end
               end
-              if (supplier = obj.supplier)
+              w.render(obj.supplier) do |supplier|
                 w.add("cac:AccountingSupplierParty") do
                   w.render(supplier, as: "cac:Party")
                 end
               end
-              if (buyer = obj.buyer)
+              w.render(obj.buyer) do |buyer|
                 w.add("cac:AccountingCustomerParty") do
                   w.render(buyer, as: "cac:Party")
                 end

data/lib/tradedoc/format/ubl/coder/invoice_line.rb

@@ -12,7 +12,7 @@ module Tradedoc
               w.render(obj.id, as: "cbc:ID")
               w.render(obj.invoiced_quantity, as: "cbc:InvoicedQuantity")
               w.render(obj.total_excluding_tax, as: "LineExtensionAmount")
-              if (total_tax = obj.total_tax)
+              w.render(obj.total_tax) do |total_tax|
                 w.add("cac:TaxTotal") do
                   w.render(total_tax, as: "TotalTax")
                 end
@@ -20,7 +20,7 @@ module Tradedoc
 
               w.render(obj.product)
 
-              if (price = obj.price)
+              w.render(obj.price) do |price|
                 w.add("cac:Price") do
                   w.render(price.net, as: "PriceAmount")
                   w.render(price.base_quantity, as: "cbc:BaseQuantity")

data/lib/tradedoc/format/ubl/coder/product.rb

@@ -11,7 +11,7 @@ module Tradedoc
             w.add(as) do
               w.render(obj.description, as: "cbc:Description")
               w.render(obj.name, as: "cbc:Name")
-              if (id = obj.seller_assigned_id)
+              w.render(obj.seller_assigned_id) do |id|
                 w.add("cac:SellersItemIdentification") do
                   w.render(id, as: "cbc:ID")
                 end

data/lib/tradedoc/format/ubl/coder/tax_category.rb

@@ -13,7 +13,7 @@ module Tradedoc
               w.render(obj.rate_percent, as: "cbc:Percent")
               w.render(obj.exemption_reason_code, as: "cbc:TaxExemptionReasonCode")
               w.render(obj.exemption_reason, as: "cbc:TaxExemptionReason")
-              if (tax_scheme = obj.tax_scheme)
+              w.render(obj.tax_scheme) do |tax_scheme|
                 w.add("cac:TaxScheme") do
                   w.render(tax_scheme, as: "cbc:ID")
                 end

data/lib/tradedoc/format/ubl/coder/trade_party.rb

@@ -3,6 +3,9 @@ module Tradedoc
     module UBL
       module Coder
         class TradeParty
+          VAT_SCHEME = "VAT"
+          private_constant :VAT_SCHEME
+
           def self.ruby_type
             Model::TradeParty
           end
@@ -13,6 +16,19 @@ module Tradedoc
                 w.add("cbc:Name", obj.name)
               end
               w.render(obj.address, as: "PostalAddress")
+              w.render(obj.vat_number) do |vat_number|
+                w.add("cac:PartyTaxScheme") do
+                  w.add("cbc:CompanyID", vat_number)
+                  w.add("cac:TaxScheme") do
+                    w.add("cbc:ID", VAT_SCHEME, schemeAgencyID: Code::Agency::CEFACT)
+                  end
+                end
+              end
+              w.render(obj.legal_registration_id) do |id|
+                w.add("cac:PartyLegalEntity") do
+                  w.add("cbc:CompanyID", id)
+                end
+              end
               w.render(obj.contact, as: "cac:Contact")
             end
           end
@@ -26,6 +42,12 @@ module Tradedoc
               end
               r.parse("cac:PostalAddress", :Address) { obj.address = it }
               r.parse("cac:Contact", :Contact) { obj.contact = it }
+              r.parse("cac:PartyTaxScheme[cac:TaxScheme/cbc:ID='#{VAT_SCHEME}']/cbc:CompanyID", :String) do
+                obj.vat_number = it
+              end
+              r.with_node("cac:PartyLegalEntity") do
+                r.parse("cbc:CompanyID", :String) { obj.legal_registration_id = it }
+              end
             end
 
             obj

data/lib/tradedoc/model/trade_party.rb

@@ -1,9 +1,15 @@
 module Tradedoc
   module Model
+    # [BG-4]
     class TradeParty < Base
       has :name, String
       has :address, Address
       has :contact, Contact
+
+      # [BT-63]
+      has :vat_number, String
+
+      has :legal_registration_id, String
     end
   end
 end

data/lib/tradedoc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tradedoc
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/tradedoc/xml/writer.rb

@@ -32,12 +32,24 @@ module Tradedoc
       # Given an object, figure out how to dump/render it into the XML builder.
       #
       # If the given object/value is `nil`, nothing is rendered. No empty element.
+      #
+      # A block can be given for custom rendering without a coder class.
+      #
       # Otherwise, a coder is looked-up and used for the given type.
       # Assumes that the de-namespaced class name has a matching local coder.
       #   e.g. `Tradedoc::Model::Country` rendered by `Tradedoc::Format::UBL::Coder::Country`
       def render(obj, coder_ref = nil, **opts)
         return if obj.nil?
 
+        if coder_ref && block_given?
+          raise ArgumentError, "provide a coder or a block, but not both"
+        end
+
+        if block_given?
+          yield obj
+          return
+        end
+
         coder_class = self.format.coder_for(coder_ref || obj.class)
         coder_class.dump(self, obj, **opts)
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tradedoc
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - mroach