zugpferd 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1bafe4631b8105289e0f6c6efba696b91e0502cfbf99173918dc0d57de096263
+  data.tar.gz: 3afe5b0d992a4622f3eadfabfbc1b4495ff5deca092f15eb659b5a8b4b529f23
+SHA512:
+  metadata.gz: 8c50bedc1c561b09d28fb69c808dcc4b0e80b655e9a2c69a138229f05752ff4898ac64fd6bf144a4eb3d0cfdcfa84742576a64565097a7ae9f4e666c686fb06e
+  data.tar.gz: ad2b0b0bc923f4debd510f40a9e1b296212af4fcbff0df9af0df5c295b2608e01430c80993000257de81d8d247c30939143567d9a8efa80805f02028dd36c99e

data/lib/zugpferd/cii/mapping.rb

@@ -0,0 +1,153 @@
+module Zugpferd
+  module CII
+    module Mapping
+      NS = {
+        "rsm" => "urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100",
+        "ram" => "urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100",
+        "udt" => "urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100",
+        "qdt" => "urn:un:unece:uncefact:data:standard:QualifiedDataType:100",
+      }.freeze
+
+      # Document context
+      CONTEXT = "rsm:ExchangedDocumentContext"
+      DOCUMENT = "rsm:ExchangedDocument"
+      TRANSACTION = "rsm:SupplyChainTradeTransaction"
+
+      # Invoice header (BG-0)
+      INVOICE = {
+        number:           "#{DOCUMENT}/ram:ID",
+        issue_date:       "#{DOCUMENT}/ram:IssueDateTime/udt:DateTimeString",
+        type_code:        "#{DOCUMENT}/ram:TypeCode",
+        note:             "#{DOCUMENT}/ram:IncludedNote/ram:Content",
+        customization_id: "#{CONTEXT}/ram:GuidelineSpecifiedDocumentContextParameter/ram:ID",
+        profile_id:       "#{CONTEXT}/ram:BusinessProcessSpecifiedDocumentContextParameter/ram:ID",
+      }.freeze
+
+      # Settlement (contains currency, payment, tax, totals)
+      SETTLEMENT = "#{TRANSACTION}/ram:ApplicableHeaderTradeSettlement"
+      AGREEMENT = "#{TRANSACTION}/ram:ApplicableHeaderTradeAgreement"
+
+      INVOICE_SETTLEMENT = {
+        currency_code:  "#{SETTLEMENT}/ram:InvoiceCurrencyCode",
+        buyer_reference: "#{AGREEMENT}/ram:BuyerReference",
+      }.freeze
+
+      # Seller (BG-4)
+      SELLER = "#{AGREEMENT}/ram:SellerTradeParty"
+      # Buyer (BG-7)
+      BUYER = "#{AGREEMENT}/ram:BuyerTradeParty"
+
+      # TradeParty fields
+      PARTY = {
+        name:                  "ram:Name",
+        trading_name:          "ram:SpecifiedLegalOrganization/ram:TradingBusinessName",
+        identifier:            "ram:ID",
+        legal_registration_id: "ram:SpecifiedLegalOrganization/ram:ID",
+        legal_form:            "ram:Description",
+        vat_identifier:        "ram:SpecifiedTaxRegistration/ram:ID[@schemeID='VA']",
+        electronic_address:    "ram:URIUniversalCommunication/ram:URIID",
+      }.freeze
+
+      # PostalAddress (BG-5 / BG-8)
+      POSTAL_ADDRESS = "ram:PostalTradeAddress"
+      ADDRESS = {
+        street_name:  "ram:LineOne",
+        city_name:    "ram:CityName",
+        postal_zone:  "ram:PostcodeCode",
+        country_code: "ram:CountryID",
+      }.freeze
+
+      # Contact (BG-6 / BG-9)
+      CONTACT = "ram:DefinedTradeContact"
+      CONTACT_FIELDS = {
+        name:      "ram:PersonName",
+        telephone: "ram:TelephoneUniversalCommunication/ram:CompleteNumber",
+        email:     "ram:EmailURIUniversalCommunication/ram:URIID",
+      }.freeze
+
+      # PaymentMeans (BG-16)
+      PAYMENT_MEANS = "ram:SpecifiedTradeSettlementPaymentMeans"
+      PAYMENT = {
+        payment_means_code: "ram:TypeCode",
+        account_id:         "ram:PayeePartyCreditorFinancialAccount/ram:IBANID",
+        card_account_id:    "ram:ApplicableTradeSettlementFinancialCard/ram:ID",
+        card_holder_name:   "ram:ApplicableTradeSettlementFinancialCard/ram:CardholderName",
+        debited_account_id: "ram:PayerPartyDebtorFinancialAccount/ram:IBANID",
+      }.freeze
+      CREDITOR_REFERENCE_ID = "ram:CreditorReferenceID"
+      PAYMENT_REFERENCE = "ram:PaymentReference"
+      PAYMENT_TERMS_NOTE = "ram:SpecifiedTradePaymentTerms/ram:Description"
+      PAYMENT_TERMS_DUE_DATE = "ram:SpecifiedTradePaymentTerms/ram:DueDateDateTime/udt:DateTimeString"
+      PAYMENT_TERMS_MANDATE = "ram:SpecifiedTradePaymentTerms/ram:DirectDebitMandateID"
+
+      # TaxTotal (BG-23)
+      TAX_SUBTOTAL = "ram:ApplicableTradeTax"
+      TAX = {
+        taxable_amount:        "ram:BasisAmount",
+        tax_amount:            "ram:CalculatedAmount",
+        category_code:         "ram:CategoryCode",
+        percent:               "ram:RateApplicablePercent",
+        exemption_reason:      "ram:ExemptionReason",
+        exemption_reason_code: "ram:ExemptionReasonCode",
+      }.freeze
+
+      # LegalMonetaryTotal (BG-22)
+      MONETARY_TOTAL = "ram:SpecifiedTradeSettlementHeaderMonetarySummation"
+      TOTALS = {
+        line_extension_amount:  "ram:LineTotalAmount",
+        tax_exclusive_amount:   "ram:TaxBasisTotalAmount",
+        tax_inclusive_amount:    "ram:GrandTotalAmount",
+        prepaid_amount:          "ram:TotalPrepaidAmount",
+        payable_rounding_amount: "ram:RoundingAmount",
+        payable_amount:          "ram:DuePayableAmount",
+        tax_total_amount:        "ram:TaxTotalAmount",
+        allowance_total_amount:  "ram:AllowanceTotalAmount",
+        charge_total_amount:     "ram:ChargeTotalAmount",
+      }.freeze
+
+      # AllowanceCharge (BG-20 / BG-21)
+      ALLOWANCE_CHARGE = "ram:SpecifiedTradeAllowanceCharge"
+      ALLOWANCE_CHARGE_FIELDS = {
+        charge_indicator: "ram:ChargeIndicator/udt:Indicator",
+        reason:           "ram:Reason",
+        reason_code:      "ram:ReasonCode",
+        amount:           "ram:ActualAmount",
+        base_amount:      "ram:BasisAmount",
+        multiplier_factor: "ram:CalculationPercent",
+        tax_category_code: "ram:CategoryTradeTax/ram:CategoryCode",
+        tax_percent:       "ram:CategoryTradeTax/ram:RateApplicablePercent",
+      }.freeze
+
+      # InvoiceLine (BG-25)
+      INVOICE_LINE = "#{TRANSACTION}/ram:IncludedSupplyChainTradeLineItem"
+      LINE = {
+        id:                    "ram:AssociatedDocumentLineDocument/ram:LineID",
+        note:                  "ram:AssociatedDocumentLineDocument/ram:IncludedNote/ram:Content",
+        invoiced_quantity:     "ram:SpecifiedLineTradeDelivery/ram:BilledQuantity",
+        unit_code:             "ram:SpecifiedLineTradeDelivery/ram:BilledQuantity/@unitCode",
+        line_extension_amount: "ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeSettlementLineMonetarySummation/ram:LineTotalAmount",
+      }.freeze
+
+      # Item (BG-31)
+      ITEM = "ram:SpecifiedTradeProduct"
+      ITEM_FIELDS = {
+        name:               "ram:Name",
+        description:        "ram:Description",
+        sellers_identifier: "ram:SellerAssignedID",
+      }.freeze
+
+      # Item tax (from line settlement, not from product)
+      ITEM_TAX = "ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax"
+      ITEM_TAX_FIELDS = {
+        tax_category: "ram:CategoryCode",
+        tax_percent:  "ram:RateApplicablePercent",
+      }.freeze
+
+      # Price (BG-29)
+      PRICE = "ram:SpecifiedLineTradeAgreement/ram:NetPriceProductTradePrice"
+      PRICE_FIELDS = {
+        amount: "ram:ChargeAmount",
+      }.freeze
+    end
+  end
+end

data/lib/zugpferd/cii/reader.rb

@@ -0,0 +1,219 @@
+require "nokogiri"
+require "date"
+require "bigdecimal"
+require_relative "mapping"
+
+module Zugpferd
+  module CII
+    # Reads UN/CEFACT CII CrossIndustryInvoice XML into {Model::Invoice}.
+    #
+    # @example
+    #   invoice = Zugpferd::CII::Reader.new.read(File.read("invoice.xml"))
+    class Reader
+      include Mapping
+
+      # Parses a CII CrossIndustryInvoice XML string.
+      #
+      # @param xml_string [String] valid CII D16B XML
+      # @return [Model::Invoice]
+      # @raise [Nokogiri::XML::SyntaxError] if the XML is malformed
+      def read(xml_string)
+        doc = Nokogiri::XML(xml_string) { |config| config.strict }
+        root = doc.root
+        build_invoice(root)
+      end
+
+      private
+
+      def build_invoice(root)
+        settlement = root.at_xpath(SETTLEMENT, NS)
+        Model::Invoice.new(
+          number: text(root, INVOICE[:number]),
+          issue_date: parse_cii_date(text(root, INVOICE[:issue_date])),
+          due_date: parse_cii_date(settlement ? text(settlement, PAYMENT_TERMS_DUE_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]),
+          customization_id: text(root, INVOICE[:customization_id]),
+          profile_id: text(root, INVOICE[:profile_id]),
+          note: text(root, INVOICE[:note]),
+          seller: build_party(root.at_xpath(SELLER, NS)),
+          buyer: build_party(root.at_xpath(BUYER, NS)),
+          line_items: root.xpath(INVOICE_LINE, NS).map { |n| build_line_item(n) },
+          allowance_charges: settlement ? build_allowance_charges(settlement) : [],
+          tax_breakdown: build_tax_breakdown(settlement),
+          monetary_totals: build_monetary_totals(settlement&.at_xpath(MONETARY_TOTAL, NS)),
+          payment_instructions: build_payment_instructions(settlement),
+        )
+      end
+
+      def build_party(node)
+        return nil unless node
+
+        party = Model::TradeParty.new(
+          name: text(node, PARTY[:name]),
+          trading_name: text(node, PARTY[:trading_name]),
+          identifier: text(node, PARTY[:identifier]),
+          legal_registration_id: text(node, PARTY[:legal_registration_id]),
+          legal_form: text(node, PARTY[:legal_form]),
+          vat_identifier: text(node, PARTY[:vat_identifier]),
+          electronic_address: text(node, PARTY[:electronic_address]),
+        )
+
+        endpoint = node.at_xpath(PARTY[:electronic_address], NS)
+        party.electronic_address_scheme = endpoint["schemeID"] if endpoint
+
+        addr_node = node.at_xpath(POSTAL_ADDRESS, NS)
+        party.postal_address = build_postal_address(addr_node) if addr_node
+
+        contact_node = node.at_xpath(CONTACT, NS)
+        party.contact = build_contact(contact_node) if contact_node
+
+        party
+      end
+
+      def build_postal_address(node)
+        Model::PostalAddress.new(
+          country_code: text(node, ADDRESS[:country_code]),
+          street_name: text(node, ADDRESS[:street_name]),
+          city_name: text(node, ADDRESS[:city_name]),
+          postal_zone: text(node, ADDRESS[:postal_zone]),
+        )
+      end
+
+      def build_contact(node)
+        Model::Contact.new(
+          name: text(node, CONTACT_FIELDS[:name]),
+          telephone: text(node, CONTACT_FIELDS[:telephone]),
+          email: text(node, CONTACT_FIELDS[:email]),
+        )
+      end
+
+      def build_payment_instructions(settlement_node)
+        return nil unless settlement_node
+
+        means_node = settlement_node.at_xpath(PAYMENT_MEANS, NS)
+        return nil unless means_node
+
+        Model::PaymentInstructions.new(
+          payment_means_code: text(means_node, PAYMENT[:payment_means_code]),
+          payment_id: text(settlement_node, PAYMENT_REFERENCE),
+          account_id: text(means_node, PAYMENT[:account_id]),
+          card_account_id: text(means_node, PAYMENT[:card_account_id]),
+          card_holder_name: text(means_node, PAYMENT[:card_holder_name]),
+          debited_account_id: text(means_node, PAYMENT[:debited_account_id]),
+          creditor_reference_id: text(settlement_node, CREDITOR_REFERENCE_ID),
+          mandate_reference: text(settlement_node, PAYMENT_TERMS_MANDATE),
+          note: text(settlement_node, PAYMENT_TERMS_NOTE),
+        )
+      end
+
+      def build_tax_breakdown(settlement_node)
+        return nil unless settlement_node
+
+        totals_node = settlement_node.at_xpath(MONETARY_TOTAL, NS)
+        tax_total_node = totals_node&.at_xpath(TOTALS[:tax_total_amount], NS)
+        currency = tax_total_node&.[]("currencyID")
+
+        breakdown = Model::TaxBreakdown.new(
+          tax_amount: tax_total_node&.text,
+          currency_code: currency,
+        )
+
+        breakdown.subtotals = settlement_node.xpath(TAX_SUBTOTAL, NS).map do |sub|
+          Model::TaxSubtotal.new(
+            taxable_amount: text(sub, TAX[:taxable_amount]),
+            tax_amount: text(sub, TAX[:tax_amount]),
+            category_code: text(sub, TAX[:category_code]),
+            percent: parse_decimal(text(sub, TAX[:percent])),
+            currency_code: currency,
+            exemption_reason: text(sub, TAX[:exemption_reason]),
+            exemption_reason_code: text(sub, TAX[:exemption_reason_code]),
+          )
+        end
+
+        breakdown
+      end
+
+      def build_monetary_totals(node)
+        return nil unless node
+
+        Model::MonetaryTotals.new(
+          line_extension_amount: text(node, TOTALS[:line_extension_amount]),
+          tax_exclusive_amount: text(node, TOTALS[:tax_exclusive_amount]),
+          tax_inclusive_amount: text(node, TOTALS[:tax_inclusive_amount]),
+          prepaid_amount: parse_decimal(text(node, TOTALS[:prepaid_amount])),
+          payable_rounding_amount: parse_decimal(text(node, TOTALS[:payable_rounding_amount])),
+          allowance_total_amount: parse_decimal(text(node, TOTALS[:allowance_total_amount])),
+          charge_total_amount: parse_decimal(text(node, TOTALS[:charge_total_amount])),
+          payable_amount: text(node, TOTALS[:payable_amount]),
+        )
+      end
+
+      def build_line_item(node)
+        item_node = node.at_xpath(ITEM, NS)
+        price_node = node.at_xpath(PRICE, NS)
+        tax_node = node.at_xpath(ITEM_TAX, NS)
+
+        Model::LineItem.new(
+          id: text(node, LINE[:id]),
+          invoiced_quantity: text(node, LINE[:invoiced_quantity]),
+          unit_code: node.at_xpath(LINE[:unit_code], NS)&.text,
+          line_extension_amount: text(node, LINE[:line_extension_amount]),
+          note: text(node, LINE[:note]),
+          item: build_item(item_node, tax_node),
+          price: build_price(price_node),
+        )
+      end
+
+      def build_item(node, tax_node)
+        return nil unless node
+
+        Model::Item.new(
+          name: text(node, ITEM_FIELDS[:name]),
+          description: text(node, ITEM_FIELDS[:description]),
+          sellers_identifier: text(node, ITEM_FIELDS[:sellers_identifier]),
+          tax_category: tax_node ? text(tax_node, ITEM_TAX_FIELDS[:tax_category]) : nil,
+          tax_percent: tax_node ? parse_decimal(text(tax_node, ITEM_TAX_FIELDS[:tax_percent])) : nil,
+        )
+      end
+
+      def build_price(node)
+        return nil unless node
+
+        Model::Price.new(
+          amount: text(node, PRICE_FIELDS[:amount]),
+        )
+      end
+
+      def build_allowance_charges(settlement_node)
+        settlement_node.xpath(ALLOWANCE_CHARGE, NS).map do |node|
+          Model::AllowanceCharge.new(
+            charge_indicator: text(node, ALLOWANCE_CHARGE_FIELDS[:charge_indicator]) == "true",
+            reason: text(node, ALLOWANCE_CHARGE_FIELDS[:reason]),
+            reason_code: text(node, ALLOWANCE_CHARGE_FIELDS[:reason_code]),
+            amount: text(node, ALLOWANCE_CHARGE_FIELDS[:amount]),
+            base_amount: parse_decimal(text(node, ALLOWANCE_CHARGE_FIELDS[:base_amount])),
+            multiplier_factor: parse_decimal(text(node, ALLOWANCE_CHARGE_FIELDS[:multiplier_factor])),
+            tax_category_code: text(node, ALLOWANCE_CHARGE_FIELDS[:tax_category_code]),
+            tax_percent: parse_decimal(text(node, ALLOWANCE_CHARGE_FIELDS[:tax_percent])),
+          )
+        end
+      end
+
+      def text(node, xpath)
+        node.at_xpath(xpath, NS)&.text
+      end
+
+      def parse_cii_date(str)
+        return nil unless str
+        # CII format 102 = YYYYMMDD
+        Date.strptime(str, "%Y%m%d")
+      end
+
+      def parse_decimal(str)
+        BigDecimal(str) if str
+      end
+    end
+  end
+end

data/lib/zugpferd/cii/writer.rb

@@ -0,0 +1,314 @@
+require "nokogiri"
+require_relative "mapping"
+
+module Zugpferd
+  module CII
+    # Writes {Model::Invoice} to UN/CEFACT CII CrossIndustryInvoice XML.
+    #
+    # @example
+    #   xml = Zugpferd::CII::Writer.new.write(invoice)
+    class Writer
+      include Mapping
+
+      # Serializes an invoice to CII D16B XML.
+      #
+      # @param invoice [Model::Invoice] the invoice to serialize
+      # @return [String] UTF-8 encoded XML string
+      def write(invoice)
+        builder = Nokogiri::XML::Builder.new(encoding: "UTF-8") do |xml|
+          xml["rsm"].CrossIndustryInvoice(
+            "xmlns:rsm" => NS["rsm"],
+            "xmlns:ram" => NS["ram"],
+            "xmlns:qdt" => NS["qdt"],
+            "xmlns:udt" => NS["udt"]
+          ) do
+            build_document_context(xml, invoice)
+            build_exchanged_document(xml, invoice)
+            build_transaction(xml, invoice)
+          end
+        end
+        builder.to_xml
+      end
+
+      private
+
+      def build_document_context(xml, inv)
+        xml["rsm"].ExchangedDocumentContext do
+          if inv.profile_id
+            xml["ram"].BusinessProcessSpecifiedDocumentContextParameter do
+              xml["ram"].ID inv.profile_id
+            end
+          end
+          if inv.customization_id
+            xml["ram"].GuidelineSpecifiedDocumentContextParameter do
+              xml["ram"].ID inv.customization_id
+            end
+          end
+        end
+      end
+
+      def build_exchanged_document(xml, inv)
+        xml["rsm"].ExchangedDocument do
+          xml["ram"].ID inv.number
+          xml["ram"].TypeCode inv.type_code
+          xml["ram"].IssueDateTime do
+            xml["udt"].DateTimeString(format_cii_date(inv.issue_date), format: "102")
+          end
+          if inv.note
+            xml["ram"].IncludedNote do
+              xml["ram"].Content inv.note
+            end
+          end
+        end
+      end
+
+      def build_transaction(xml, inv)
+        xml["rsm"].SupplyChainTradeTransaction do
+          inv.line_items.each { |li| build_line_item(xml, li) }
+          build_agreement(xml, inv)
+          xml["ram"].ApplicableHeaderTradeDelivery
+          build_settlement(xml, inv)
+        end
+      end
+
+      def build_agreement(xml, inv)
+        xml["ram"].ApplicableHeaderTradeAgreement do
+          xml["ram"].BuyerReference inv.buyer_reference if inv.buyer_reference
+          build_party(xml, "SellerTradeParty", inv.seller) if inv.seller
+          build_party(xml, "BuyerTradeParty", inv.buyer) if inv.buyer
+        end
+      end
+
+      def build_party(xml, element_name, party)
+        xml["ram"].send(element_name) do
+          if party.identifier
+            xml["ram"].ID party.identifier
+          end
+
+          xml["ram"].Name party.name
+
+          xml["ram"].Description party.legal_form if party.legal_form
+
+          if party.legal_registration_id || party.trading_name
+            xml["ram"].SpecifiedLegalOrganization do
+              xml["ram"].ID party.legal_registration_id if party.legal_registration_id
+              xml["ram"].TradingBusinessName party.trading_name if party.trading_name
+            end
+          end
+
+          build_contact(xml, party.contact) if party.contact
+
+          build_postal_address(xml, party.postal_address) if party.postal_address
+
+          if party.electronic_address
+            xml["ram"].URIUniversalCommunication do
+              attrs = {}
+              attrs[:schemeID] = party.electronic_address_scheme if party.electronic_address_scheme
+              xml["ram"].URIID(party.electronic_address, attrs)
+            end
+          end
+
+          if party.vat_identifier
+            xml["ram"].SpecifiedTaxRegistration do
+              xml["ram"].ID(party.vat_identifier, schemeID: "VA")
+            end
+          end
+        end
+      end
+
+      def build_postal_address(xml, addr)
+        xml["ram"].PostalTradeAddress do
+          xml["ram"].PostcodeCode addr.postal_zone if addr.postal_zone
+          xml["ram"].LineOne addr.street_name if addr.street_name
+          xml["ram"].CityName addr.city_name if addr.city_name
+          xml["ram"].CountryID addr.country_code
+        end
+      end
+
+      def build_contact(xml, contact)
+        xml["ram"].DefinedTradeContact do
+          xml["ram"].PersonName contact.name if contact.name
+          if contact.telephone
+            xml["ram"].TelephoneUniversalCommunication do
+              xml["ram"].CompleteNumber contact.telephone
+            end
+          end
+          if contact.email
+            xml["ram"].EmailURIUniversalCommunication do
+              xml["ram"].URIID contact.email
+            end
+          end
+        end
+      end
+
+      def build_settlement(xml, inv)
+        xml["ram"].ApplicableHeaderTradeSettlement do
+          if inv.payment_instructions&.creditor_reference_id
+            xml["ram"].CreditorReferenceID inv.payment_instructions.creditor_reference_id
+          end
+
+          if inv.payment_instructions&.payment_id
+            xml["ram"].PaymentReference inv.payment_instructions.payment_id
+          end
+
+          xml["ram"].InvoiceCurrencyCode inv.currency_code
+
+          build_payment_means(xml, inv.payment_instructions) if inv.payment_instructions
+
+          if inv.tax_breakdown
+            inv.tax_breakdown.subtotals.each do |sub|
+              build_tax_subtotal(xml, sub)
+            end
+          end
+
+          inv.allowance_charges.each { |ac| build_allowance_charge(xml, ac) }
+
+          if inv.payment_instructions&.note || inv.due_date || inv.payment_instructions&.mandate_reference
+            xml["ram"].SpecifiedTradePaymentTerms do
+              xml["ram"].Description inv.payment_instructions.note if inv.payment_instructions&.note
+              if inv.due_date
+                xml["ram"].DueDateDateTime do
+                  xml["udt"].DateTimeString(format_cii_date(inv.due_date), format: "102")
+                end
+              end
+              xml["ram"].DirectDebitMandateID inv.payment_instructions.mandate_reference if inv.payment_instructions&.mandate_reference
+            end
+          end
+
+          build_monetary_total(xml, inv.monetary_totals, inv.tax_breakdown) if inv.monetary_totals
+        end
+      end
+
+      def build_payment_means(xml, payment)
+        xml["ram"].SpecifiedTradeSettlementPaymentMeans do
+          xml["ram"].TypeCode payment.payment_means_code
+          if payment.card_account_id
+            xml["ram"].ApplicableTradeSettlementFinancialCard do
+              xml["ram"].ID payment.card_account_id
+              xml["ram"].CardholderName payment.card_holder_name if payment.card_holder_name
+            end
+          end
+          if payment.debited_account_id
+            xml["ram"].PayerPartyDebtorFinancialAccount do
+              xml["ram"].IBANID payment.debited_account_id
+            end
+          end
+          if payment.account_id
+            xml["ram"].PayeePartyCreditorFinancialAccount do
+              xml["ram"].IBANID payment.account_id
+            end
+          end
+        end
+      end
+
+      def build_tax_subtotal(xml, sub)
+        xml["ram"].ApplicableTradeTax do
+          xml["ram"].CalculatedAmount format_decimal(sub.tax_amount)
+          xml["ram"].TypeCode "VAT"
+          xml["ram"].ExemptionReason sub.exemption_reason if sub.exemption_reason
+          xml["ram"].BasisAmount format_decimal(sub.taxable_amount)
+          xml["ram"].CategoryCode sub.category_code
+          xml["ram"].ExemptionReasonCode sub.exemption_reason_code if sub.exemption_reason_code
+          xml["ram"].RateApplicablePercent format_decimal(sub.percent) if sub.percent
+        end
+      end
+
+      def build_monetary_total(xml, totals, tax_breakdown)
+        xml["ram"].SpecifiedTradeSettlementHeaderMonetarySummation do
+          xml["ram"].LineTotalAmount format_decimal(totals.line_extension_amount)
+          xml["ram"].ChargeTotalAmount format_decimal(totals.charge_total_amount) if totals.charge_total_amount
+          xml["ram"].AllowanceTotalAmount format_decimal(totals.allowance_total_amount) if totals.allowance_total_amount
+          xml["ram"].TaxBasisTotalAmount format_decimal(totals.tax_exclusive_amount)
+          if tax_breakdown
+            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"].TotalPrepaidAmount format_decimal(totals.prepaid_amount) if totals.prepaid_amount
+          xml["ram"].DuePayableAmount format_decimal(totals.payable_amount)
+        end
+      end
+
+      def build_allowance_charge(xml, ac)
+        xml["ram"].SpecifiedTradeAllowanceCharge do
+          xml["ram"].ChargeIndicator do
+            xml["udt"].Indicator ac.charge_indicator.to_s
+          end
+          xml["ram"].CalculationPercent format_decimal(ac.multiplier_factor) if ac.multiplier_factor
+          xml["ram"].BasisAmount format_decimal(ac.base_amount) if ac.base_amount
+          xml["ram"].ActualAmount format_decimal(ac.amount)
+          xml["ram"].ReasonCode ac.reason_code if ac.reason_code
+          xml["ram"].Reason ac.reason if ac.reason
+          if ac.tax_category_code
+            xml["ram"].CategoryTradeTax do
+              xml["ram"].TypeCode "VAT"
+              xml["ram"].CategoryCode ac.tax_category_code
+              xml["ram"].RateApplicablePercent format_decimal(ac.tax_percent) if ac.tax_percent
+            end
+          end
+        end
+      end
+
+      def build_line_item(xml, line)
+        xml["ram"].IncludedSupplyChainTradeLineItem do
+          xml["ram"].AssociatedDocumentLineDocument do
+            xml["ram"].LineID line.id
+            if line.note
+              xml["ram"].IncludedNote do
+                xml["ram"].Content line.note
+              end
+            end
+          end
+
+          build_item(xml, line.item) if line.item
+
+          xml["ram"].SpecifiedLineTradeAgreement do
+            if line.price
+              xml["ram"].NetPriceProductTradePrice do
+                xml["ram"].ChargeAmount format_decimal(line.price.amount)
+              end
+            end
+          end
+
+          xml["ram"].SpecifiedLineTradeDelivery do
+            xml["ram"].BilledQuantity(format_decimal(line.invoiced_quantity),
+                                      unitCode: line.unit_code)
+          end
+
+          xml["ram"].SpecifiedLineTradeSettlement do
+            if line.item&.tax_category
+              xml["ram"].ApplicableTradeTax do
+                xml["ram"].TypeCode "VAT"
+                xml["ram"].CategoryCode line.item.tax_category
+                xml["ram"].RateApplicablePercent format_decimal(line.item.tax_percent) if line.item.tax_percent
+              end
+            end
+
+            xml["ram"].SpecifiedTradeSettlementLineMonetarySummation do
+              xml["ram"].LineTotalAmount format_decimal(line.line_extension_amount)
+            end
+          end
+        end
+      end
+
+      def build_item(xml, item)
+        xml["ram"].SpecifiedTradeProduct do
+          xml["ram"].SellerAssignedID item.sellers_identifier if item.sellers_identifier
+          xml["ram"].Name item.name
+          xml["ram"].Description item.description if item.description
+        end
+      end
+
+      def format_cii_date(date)
+        date.strftime("%Y%m%d")
+      end
+
+      def format_decimal(value)
+        return value.to_s unless value.is_a?(BigDecimal)
+        str = value.to_s("F")
+        str.sub(/\.?0+$/, "")
+      end
+    end
+  end
+end