facturx 0.1.0 → 1.0.0

data/lib/facturx/reader/term_reader/unmapped.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Facturx
+  class Reader
+    class TermReader
+      IGNORED_ATTRIBUTES = %w[currencyID schemeID].freeze
+
+      def add_unmapped(root)
+        add_unmapped_elements(root)
+        add_unmapped_attributes(root)
+      end
+
+      private
+
+      def add_unmapped_elements(root)
+        root.xpath('.//*[not(*)]').each do |node|
+          next if node.text.empty? || matched?(node)
+
+          add(:unmapped_element, nil, node.path, 'Element is not mapped to the EN16931 model', value: node.text)
+        end
+      end
+
+      def add_unmapped_attributes(root)
+        root.xpath('.//@*').each do |attribute|
+          next if IGNORED_ATTRIBUTES.include?(attribute.name) || matched?(attribute)
+
+          add(:unmapped_element, nil, attribute.path, 'Attribute is not mapped to the EN16931 model',
+              value: attribute.value)
+        end
+      end
+
+      def matched?(node)
+        @matched_nodes.key?(node)
+      end
+    end
+  end
+end

data/lib/facturx/reader/term_reader.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+require_relative '../coerce'
+require_relative '../diagnostic'
+
+module Facturx
+  class Reader
+    class TermReader
+      attr_reader :diagnostics
+
+      def initialize(document:, profile:, registry:, coercer:, diagnostics:)
+        @document = document
+        @profile = profile
+        @registry = registry
+        @coercer = coercer
+        @diagnostics = diagnostics
+        @matched_nodes = {}.compare_by_identity
+      end
+
+      def value(id, context: @document, base_xpath: nil, nodes: nil)
+        term = active_term(id)
+        return unless term
+
+        selected = nodes || context.xpath(relative_xpath(term.xpath, base_xpath), NAMESPACES)
+        selected.each { |node| mark(node) }
+        cardinality = term.cardinalities.fetch(@profile.id)
+        diagnose_cardinality(term, selected, cardinality)
+        materialize(term, selected, cardinality)
+      end
+
+      def group_nodes(id, context: @document, base_xpath: nil, collapse_if: nil, &)
+        group = active_group(id)
+        return [].freeze unless group
+
+        nodes = select_group_nodes(group, context, base_xpath, &)
+        cardinality = group.cardinalities.fetch(@profile.id)
+        diagnose_cardinality(group, cardinality_nodes(nodes, collapse_if), cardinality)
+        nodes.each { |node| mark(node) }
+        nodes.freeze
+      end
+
+      def raw_value(xpath, context:, mark_node: true)
+        node = context.at_xpath(xpath, NAMESPACES)
+        mark(node) if node && mark_node
+        node&.text
+      end
+
+      def mark_value(id, context: @document, base_xpath: nil)
+        term = active_term(id)
+        return unless term
+
+        context.xpath(relative_xpath(term.xpath, base_xpath), NAMESPACES).each { |node| mark(node) }
+      end
+
+      def mark(node)
+        return unless node
+
+        @matched_nodes[node] = true
+      end
+
+      def add(code, term_id, path, message, details = {})
+        @diagnostics << Diagnostic.new(
+          code:,
+          term_id:,
+          path:,
+          message:,
+          details:
+        )
+      end
+
+      private
+
+      def select_group_nodes(group, context, base_xpath, &filter)
+        nodes = context.xpath(relative_xpath(group.xpath, base_xpath), NAMESPACES).to_a
+        filter ? nodes.select(&filter) : nodes
+      end
+
+      def cardinality_nodes(nodes, collapse_if)
+        collapse_if&.call(nodes) ? [nodes.first] : nodes
+      end
+
+      def active_term(id)
+        term = @registry.fetch(id)
+        term if term.cardinalities.key?(@profile.id)
+      end
+
+      def active_group(id)
+        group = @registry.group(id)
+
+        group if group.cardinalities.key?(@profile.id)
+      rescue KeyError
+        raise KeyError, "Unknown Factur-X group: #{id}"
+      end
+
+      def diagnose_cardinality(definition, nodes, cardinality)
+        missing(definition) if nodes.empty? && required?(cardinality)
+        multiple(definition, nodes.size) if nodes.size > 1 && !repeated?(cardinality)
+      end
+
+      def materialize(term, nodes, cardinality)
+        values = nodes.map { |node| coerce(node, term) }
+        return values.freeze if repeated?(cardinality)
+
+        values.first
+      end
+
+      def missing(definition)
+        add(:missing_required_term, definition.id, definition.xpath, 'Required value is missing')
+      end
+
+      def multiple(definition, count)
+        add(:multiple_values, definition.id, definition.xpath, 'Multiple values found for a scalar field', count:)
+      end
+
+      def relative_xpath(xpath, base_xpath)
+        return xpath unless base_xpath
+
+        suffix = xpath.delete_prefix(base_xpath)
+        raise ArgumentError, "#{xpath} is outside #{base_xpath}" if suffix == xpath
+
+        suffix.empty? ? '.' : ".#{suffix}"
+      end
+
+      def required?(cardinality) = cardinality.start_with?('1')
+
+      def repeated?(cardinality) = cardinality.end_with?('n')
+    end
+  end
+end
+
+require_relative 'term_reader/unmapped'
+require_relative 'term_reader/coercion'

data/lib/facturx/reader.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative 'diagnostic'
+require_relative 'document'
+require_relative 'coerce'
+require_relative 'error'
+require_relative 'profiles'
+require_relative 'reading'
+require_relative 'source_reader'
+require_relative 'terms'
+require_relative 'xml/parser'
+require_relative 'xml/namespaces'
+require_relative 'xml/profile_detector'
+
+module Facturx
+  class Reader
+    CII_NAMESPACE = Xml::Namespaces::CII
+    NAMESPACES = Xml::Namespaces::MAP
+    UNKNOWN_PROFILE_POLICIES = %i[fallback raise].freeze
+
+    COLLABORATORS = %i[profile_resolver registry coercer profiles].freeze
+
+    def initialize(parser: Xml::Parser.new, extractor: Pdf::Extractor.new, **collaborators)
+      unknown = collaborators.keys - COLLABORATORS
+      raise ArgumentError, "Unknown collaborators: #{unknown.join(', ')}" unless unknown.empty?
+
+      @parser = parser
+      @source_reader = SourceReader.new(extractor:)
+      @profile_resolver = collaborators.fetch(:profile_resolver) { Xml::ProfileDetector.new }
+      @registry = collaborators.fetch(:registry, Terms)
+      @coercer = collaborators.fetch(:coercer, Coerce)
+      @profiles = collaborators.fetch(:profiles, Profiles)
+    end
+
+    def call(source, on_unknown_profile: :fallback)
+      validate_unknown_profile_policy!(on_unknown_profile)
+      input = @source_reader.call(source)
+      parsed = parse(input.xml)
+      diagnostics = []
+      profile = resolve_profile(parsed, on_unknown_profile, diagnostics)
+      document = map(parsed, profile, diagnostics)
+
+      Reading.new(document:, profile:, diagnostics:, source: input.xml, source_type: input.source_type)
+    end
+
+    private
+
+    def validate_unknown_profile_policy!(policy)
+      return if UNKNOWN_PROFILE_POLICIES.include?(policy)
+
+      raise ArgumentError, "on_unknown_profile must be one of #{UNKNOWN_PROFILE_POLICIES.inspect}"
+    end
+
+    def cross_industry_invoice(document)
+      root = document.root
+      return root if root&.name == 'CrossIndustryInvoice' && root.namespace&.href == CII_NAMESPACE
+
+      raise InvalidXmlError.new('XML is not a CrossIndustryInvoice', reason: :unsupported_document)
+    end
+
+    def parse(xml)
+      document = @parser.call(xml:)
+      cross_industry_invoice(document)
+      document
+    end
+
+    def map(parsed, profile, diagnostics)
+      mapper = SemanticMapper.new(
+        document: parsed, profile:, registry: @registry, coercer: @coercer, diagnostics:
+      )
+      document = mapper.call
+      mapper.add_unmapped(parsed.root)
+      document
+    end
+
+    def resolve_profile(document, policy, diagnostics)
+      @profile_resolver.call(document:)
+    rescue UnknownProfileError => e
+      raise if policy == :raise
+
+      diagnostics << profile_diagnostic(e)
+      @profiles.fetch(:extended)
+    end
+
+    def profile_diagnostic(error)
+      guideline_urn = error.details[:guideline_urn]
+      Diagnostic.new(
+        code: guideline_urn.nil? || guideline_urn.empty? ? :missing_profile : :unknown_profile,
+        term_id: 'BT-24', path: Xml::ProfileDetector::GUIDELINE_XPATH,
+        message: error.message, details: error.details
+      )
+    end
+  end
+end
+
+require_relative 'reader/term_reader'
+require_relative 'reader/semantic_mapper'

data/lib/facturx/reading.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative 'model/immutable'
+
+module Facturx
+  READING_SOURCE_TYPES = %i[xml pdf].freeze
+  private_constant :READING_SOURCE_TYPES
+
+  Reading = Data.define(:document, :profile, :diagnostics, :source, :source_type) do
+    include Model::ValidatedWith
+
+    def initialize(document:, profile:, source:, diagnostics: [], source_type: :xml)
+      raise TypeError, 'source must be a byte String' unless source.is_a?(String)
+      raise TypeError, 'diagnostics must be an Array' unless diagnostics.is_a?(Array)
+      unless READING_SOURCE_TYPES.include?(source_type)
+        raise ArgumentError, "Unknown source type: #{source_type.inspect}"
+      end
+
+      xml = source.dup.force_encoding(Encoding::BINARY).freeze
+      super(document:, profile:, diagnostics: Model.copy_and_freeze(diagnostics), source: xml, source_type:)
+    end
+  end
+end

data/lib/facturx/source_reader.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative 'error'
+require_relative 'pdf/extractor'
+
+module Facturx
+  class SourceReader
+    Result = Data.define(:xml, :source_type)
+
+    def initialize(extractor: Pdf::Extractor.new)
+      @extractor = extractor
+    end
+
+    def call(source)
+      unless source.is_a?(String)
+        raise InvalidXmlError.new('Source must be provided as a byte String', input_class: source.class.name)
+      end
+
+      return Result.new(xml: source, source_type: :xml) unless pdf?(source)
+
+      Result.new(xml: @extractor.call(source).xml, source_type: :pdf)
+    end
+
+    private
+
+    def pdf?(bytes)
+      bytes.byteslice(0, 1024).b.include?('%PDF-'.b)
+    end
+  end
+end

data/lib/facturx/term.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Facturx
+  Term = Data.define(:id, :model, :attribute, :group_id, :xpath, :type, :scale, :cardinalities)
+end

data/lib/facturx/terms/declaration.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative '../term'
+require_relative '../group'
+
+module Facturx
+  module TermDeclarations
+    module Declaration
+      module_function
+
+      def term(*attributes, **cardinalities)
+        Term.new(*attributes, cardinalities.freeze).freeze
+      end
+
+      def group(*attributes, **cardinalities)
+        Group.new(*attributes, cardinalities.freeze).freeze
+      end
+    end
+  end
+end

data/lib/facturx/terms/declarations/adjustments.rb

@@ -0,0 +1,230 @@
+# frozen_string_literal: true
+
+Facturx::TermDeclarations::ADJUSTMENTS = [
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-138', :allowance_charge, :percentage, 'BG-27',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:CalculationPercent',
+    :decimal, nil,
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-137', :allowance_charge, :base_amount, 'BG-27',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:BasisAmount',
+    :decimal, 2,
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-136', :allowance_charge, :amount, 'BG-27',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ActualAmount',
+    :decimal, 2,
+    basic: '1..1',
+    en16931: '1..1',
+    extended: '1..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-140', :allowance_charge, :reason_code, 'BG-27',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ReasonCode',
+    :string, nil,
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-139', :allowance_charge, :reason, 'BG-27',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:Reason',
+    :string, nil,
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-143', :allowance_charge, :percentage, 'BG-28',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:CalculationPercent',
+    :decimal, nil,
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-142', :allowance_charge, :base_amount, 'BG-28',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:BasisAmount',
+    :decimal, 2,
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-141', :allowance_charge, :amount, 'BG-28',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ActualAmount',
+    :decimal, 2,
+    basic: '1..1',
+    en16931: '1..1',
+    extended: '1..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-145', :allowance_charge, :reason_code, 'BG-28',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:ReasonCode',
+    :string, nil,
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-144', :allowance_charge, :reason, 'BG-28',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:SpecifiedTradeAllowanceCharge/ram:Reason',
+    :string, nil,
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-94', :allowance_charge, :percentage, 'BG-20',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:CalculationPercent',
+    :decimal, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-93', :allowance_charge, :base_amount, 'BG-20',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:BasisAmount',
+    :decimal, 2,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-92', :allowance_charge, :amount, 'BG-20',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:ActualAmount',
+    :decimal, 2,
+    basic_wl: '1..1',
+    basic: '1..1',
+    en16931: '1..1',
+    extended: '1..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-98', :allowance_charge, :reason_code, 'BG-20',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:ReasonCode',
+    :string, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-97', :allowance_charge, :reason, 'BG-20',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:Reason',
+    :string, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-95', :allowance_charge, :tax, 'BG-20',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:CategoryTradeTax/ram:CategoryCode',
+    :string, nil,
+    basic_wl: '1..1',
+    basic: '1..1',
+    en16931: '1..1',
+    extended: '1..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-96', :allowance_charge, :tax, 'BG-20',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:CategoryTradeTax/ram:RateApplicablePercent',
+    :decimal, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-101', :allowance_charge, :percentage, 'BG-21',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:CalculationPercent',
+    :decimal, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-100', :allowance_charge, :base_amount, 'BG-21',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:BasisAmount',
+    :decimal, 2,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-99', :allowance_charge, :amount, 'BG-21',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:ActualAmount',
+    :decimal, 2,
+    basic_wl: '1..1',
+    basic: '1..1',
+    en16931: '1..1',
+    extended: '1..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-105', :allowance_charge, :reason_code, 'BG-21',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:ReasonCode',
+    :string, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-104', :allowance_charge, :reason, 'BG-21',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:Reason',
+    :string, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-102', :allowance_charge, :tax, 'BG-21',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:CategoryTradeTax/ram:CategoryCode',
+    :string, nil,
+    basic_wl: '1..1',
+    basic: '1..1',
+    en16931: '1..1',
+    extended: '1..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-103', :allowance_charge, :tax, 'BG-21',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:SpecifiedTradeAllowanceCharge/ram:CategoryTradeTax/ram:RateApplicablePercent',
+    :decimal, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  )
+].freeze

data/lib/facturx/terms/declarations/delivery.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+Facturx::TermDeclarations::DELIVERY = [
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-134', :period, :start_date, 'BG-26',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:BillingSpecifiedPeriod/ram:StartDateTime' \
+    '/udt:DateTimeString',
+    :date_102, nil,
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-135', :period, :end_date, 'BG-26',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:IncludedSupplyChainTradeLineItem' \
+    '/ram:SpecifiedLineTradeSettlement/ram:BillingSpecifiedPeriod/ram:EndDateTime/udt:DateTimeString',
+    :date_102, nil,
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-71', :delivery, :location_identifier, 'BG-13',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeDelivery' \
+    '/ram:ShipToTradeParty/ram:ID',
+    :string, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-71-1', :delivery, :location_identifier, 'BG-13',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeDelivery' \
+    '/ram:ShipToTradeParty/ram:GlobalID/@schemeID',
+    :string, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-70', :delivery, :party, 'BG-13',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeDelivery' \
+    '/ram:ShipToTradeParty/ram:Name',
+    :string, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-72', :delivery, :date, 'BG-13-00',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeDelivery' \
+    '/ram:ActualDeliverySupplyChainEvent/ram:OccurrenceDateTime/udt:DateTimeString',
+    :date_102, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-73', :period, :start_date, 'BG-14',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:BillingSpecifiedPeriod/ram:StartDateTime/udt:DateTimeString',
+    :date_102, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  ),
+  Facturx::TermDeclarations::Declaration.term(
+    'BT-74', :period, :end_date, 'BG-14',
+    '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement' \
+    '/ram:BillingSpecifiedPeriod/ram:EndDateTime/udt:DateTimeString',
+    :date_102, nil,
+    basic_wl: '0..1',
+    basic: '0..1',
+    en16931: '0..1',
+    extended: '0..1'
+  )
+].freeze