czech_post_b2b_client 1.0.0

data/lib/czech_post_b2b_client/request_builders.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'czech_post_b2b_client/request_builders/base_builder'
+require 'czech_post_b2b_client/request_builders/get_stats_builder'
+require 'czech_post_b2b_client/request_builders/get_parcels_printing_builder'
+require 'czech_post_b2b_client/request_builders/get_parcel_state_builder'
+require 'czech_post_b2b_client/request_builders/get_result_parcels_builder'
+require 'czech_post_b2b_client/request_builders/send_parcels_builder'

data/lib/czech_post_b2b_client/request_builders/base_builder.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require 'ox'
+
+module CzechPostB2bClient
+  module RequestBuilders
+    class BaseBuilder < SteppedService::Base
+      attr_reader :request_id
+
+      TIME_FORMAT = '%FT%T.%L%:z' # '2014-03-12T13:33:34.573+01:00'
+
+      def initialize(request_id: 1)
+        @request_id = request_id
+      end
+
+      def steps
+        %i[validate_data
+           build_xml_struct
+           render_xml]
+      end
+
+      private
+
+      attr_reader :xml_struct
+
+      def validate_data
+        # nothing to validate
+      end
+
+      def build_xml_struct
+        @xml_struct = struct_base
+        add_element_to(@xml_struct, new_instruct(attributes: { version: '1.0', encoding: 'UTF-8', standalone: 'yes' }))
+
+        bb = new_element('b2bRequest', attributes: configuration.namespaces).tap do |b2b_req|
+          add_element_to(b2b_req, b2b_req_header)
+          add_element_to(b2b_req, service_data_struct)
+        end
+
+        add_element_to(@xml_struct, bb)
+
+        @xml_struct
+      end
+
+      def render_xml
+        @result = Ox.dump(xml_struct)
+      end
+
+      def configuration
+        CzechPostB2bClient.configuration
+      end
+
+      def namespaces
+        configuration.namespaces.to_a.collect { |ns, url| "#{ns}=\"#{url}\"" }.join(' ')
+      end
+
+      def struct_base
+        Ox::Document.new(encoding: 'utf-8')
+      end
+
+      def b2b_req_header
+        new_element('header').tap do |header|
+          add_element_to(header, 'idExtTransaction', value: request_id)
+          add_element_to(header, 'timeStamp', value: Time.now.strftime(TIME_FORMAT))
+          add_element_to(header, 'idContract', value: configuration.contract_id)
+        end
+      end
+
+      def add_element_to(parent_element, element, attributes: {}, value: nil)
+        if element.is_a?(String)
+          parent_element << new_element(element, attributes: attributes, value: value) unless value.nil?
+        else
+          parent_element << element unless element.nil?
+        end
+      end
+
+      def new_element(name, attributes: {}, value: '')
+        Ox::Element.new(name).tap do |elm|
+          attributes.each_pair { |key, val| elm[key] = val }
+          elm << value.to_s
+        end
+      end
+
+      def new_instruct(attributes: {})
+        Ox::Instruct.new(:xml).tap do |elm|
+          attributes.each_pair { |key, val| elm[key] = val }
+        end
+      end
+    end
+  end
+end

data/lib/czech_post_b2b_client/request_builders/get_parcel_state_builder.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module CzechPostB2bClient
+  module RequestBuilders
+    class GetParcelStateBuilder < BaseBuilder
+      attr_reader :parcel_codes
+
+      def initialize(parcel_codes:, request_id: 1)
+        @parcel_codes = parcel_codes
+        @request_id = request_id
+      end
+
+      private
+
+      def validate_data
+        if parcel_codes.empty?
+          errors.add(:parcel_codes, 'Minimum of 1 parcel code is required!')
+          fail!
+        end
+
+        return if parcel_codes.size <= 10
+
+        errors.add(:parcel_codes, 'Maximum of 10 parcel codes are allowed!')
+        fail!
+      end
+
+      def service_data_struct
+        new_element('serviceData').tap do |srv_data|
+          add_element_to(srv_data, get_parcel_state)
+        end
+      end
+
+      def get_parcel_state # rubocop:disable Naming/AccessorMethodName
+        new_element('ns2:getParcelState').tap do |parcel_state|
+          parcel_codes.each do |parcel_code|
+            add_element_to(parcel_state, 'ns2:idParcel', value: parcel_code.to_s)
+          end
+
+          add_element_to(parcel_state, 'ns2:language', value: configuration.language.to_s)
+        end
+      end
+    end
+  end
+end

data/lib/czech_post_b2b_client/request_builders/get_parcels_printing_builder.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module CzechPostB2bClient
+  module RequestBuilders
+    class GetParcelsPrintingBuilder < BaseBuilder
+      attr_reader :parcel_codes, :options
+
+      def initialize(parcel_codes:, options:, request_id: 1)
+        @parcel_codes = parcel_codes
+        @options = options
+        @request_id = request_id
+      end
+
+      def self.allowed_printing_template_classes
+        @allowed_printing_template_classes ||= CzechPostB2bClient::PrintingTemplates.all_template_classes
+      end
+
+      private
+
+      def validate_data
+        if parcel_codes.empty?
+          errors.add(:parcel_codes, 'Minimum of 1 parcel code is required!')
+          fail!
+        end
+
+        if parcel_codes.size > 500
+          errors.add(:parcel_codes, 'Maximum of 500 parcel codes are allowed!')
+          fail!
+        end
+
+        validate_template_ids
+      end
+
+      def service_data_struct
+        new_element('serviceData').tap do |srv_data|
+          add_element_to(srv_data, get_parcels_printing)
+        end
+      end
+
+      def get_parcels_printing # rubocop:disable Naming/AccessorMethodName
+        new_element('ns2:getParcelsPrinting').tap do |get_parcels_printing|
+          add_element_to(get_parcels_printing, do_printing_header)
+          add_element_to(get_parcels_printing, do_printing_data)
+        end
+      end
+
+      def do_printing_header
+        new_element('ns2:doPrintingHeader').tap do |printing_header|
+          add_element_to(printing_header, 'ns2:customerID', value: options[:customer_id]) # Technologicke cislo podavatele
+          add_element_to(printing_header, 'ns2:contractNumber', value: options[:contract_number]) # Nepovine: ID CCK slozky podavatele
+          add_element_to(printing_header, 'ns2:idForm', value: options[:template_id]) # Nepovine[0-20x]: ID formulare
+          add_element_to(printing_header, 'ns2:shiftHorizontal', value: options[:margin_in_mm][:left]) # Hodnota posunu doprava v mm
+          add_element_to(printing_header, 'ns2:shiftVertical', value: options[:margin_in_mm][:top]) # Hodnota posunu dolu v mm
+          add_element_to(printing_header, 'ns2:position', value: options[:position_order]) # Nepovinna: Hodnota pozice
+        end
+      end
+
+      def do_printing_data
+        new_element('ns2:doPrintingData').tap do |printing_data|
+          parcel_codes.each do |parcel_code|
+            add_element_to(printing_data, 'ns2:parcelCode', value: parcel_code.to_s)
+          end
+        end
+      end
+
+      def validate_template_ids
+        # TODO: there can be up to 20 `idForm` nodes, but I do not know how it works yet
+        template_id = options[:template_id]
+        return if template_id.to_s == ''
+
+        allowed_ids = self.class.allowed_printing_template_classes.collect(&:id)
+        return if allowed_ids.include?(template_id)
+
+        errors.add(:template_id, "Value '#{template_id}' is not allowed!")
+        fail!
+      end
+    end
+  end
+end

data/lib/czech_post_b2b_client/request_builders/get_result_parcels_builder.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module CzechPostB2bClient
+  module RequestBuilders
+    class GetResultParcelsBuilder < BaseBuilder
+      attr_reader :transaction_id
+
+      def initialize(transaction_id:, request_id: 1)
+        @transaction_id = transaction_id
+        @request_id = request_id
+      end
+
+      private
+
+      def validate_data
+        return unless transaction_id.nil? || transaction_id == ''
+
+        errors.add(:transaction_id, 'Must be present!')
+        fail!
+      end
+
+      def service_data_struct
+        # No <serviceDate> element in this case
+        new_element('idTransaction', value: transaction_id)
+      end
+    end
+  end
+end

data/lib/czech_post_b2b_client/request_builders/get_stats_builder.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module CzechPostB2bClient
+  module RequestBuilders
+    class GetStatsBuilder < BaseBuilder
+      attr_reader :from_date, :to_date
+
+      def initialize(from_date:, to_date:, request_id: 1)
+        @from_date = from_date.to_time
+        @to_date = to_date.to_time
+        @request_id = request_id
+      end
+
+      private
+
+      def service_data_struct
+        new_element('serviceData').tap do |srv_data|
+          add_element_to(srv_data, get_stats)
+        end
+      end
+
+      def get_stats # rubocop:disable Naming/AccessorMethodName
+        new_element('ns2:getStats').tap do |get_stats|
+          add_element_to(get_stats, 'ns2:dateBegin', value: from_date.strftime(TIME_FORMAT))
+          add_element_to(get_stats, 'ns2:dateEnd', value: to_date.strftime(TIME_FORMAT))
+        end
+      end
+    end
+  end
+end

data/lib/czech_post_b2b_client/request_builders/send_parcels_builder.rb

@@ -0,0 +1,294 @@
+# frozen_string_literal: true
+
+module CzechPostB2bClient
+  module RequestBuilders
+    class SendParcelsBuilder < BaseBuilder
+      attr_reader :common_data, :parcels
+
+      def initialize(common_data:, parcels:, request_id: 1)
+        @common_data = common_data
+        @parcels = parcels
+        @request_id = request_id
+      end
+
+      private
+
+      def validate_data
+        errors.add(:parcels, 'Maximum of 1000 parcels are allowed!') if parcels.size > 1000
+
+        validate_common_data_required_fields
+        validate_parcels_required_fields
+
+        fail! unless errors.empty?
+      end
+
+      def service_data_struct
+        new_element('serviceData').tap do |srv_data|
+          add_element_to(srv_data, send_parcels)
+        end
+      end
+
+      def validate_common_data_required_fields
+        [[:parcels_sending_date],
+         [:customer_id],
+         [:sending_post_office_code]].each do |key_chain|
+           value = common_data.dig(*key_chain)
+           if value.nil? || value == ''
+             errors.add(:common_data, "Missing value for key { :#{key_chain.join(' => :') } }!")
+           end
+         end
+      end
+
+      def validate_parcels_required_fields
+        return if parcels.empty?
+
+        rq_fields = [
+          %i[params parcel_id],
+          %i[params parcel_code_prefix],
+          %i[addressee address last_name],
+          %i[addressee address street],
+          %i[addressee address house_number],
+          %i[addressee address city],
+          %i[addressee address post_code]
+        ]
+        parcels.each_with_index do |parcel_data, index|
+          parcel_id = parcel_data.dig(:params, :parcel_id)
+          rq_fields.each do |key_chain|
+            value = parcel_data.dig(*key_chain)
+
+            if value.nil? || value == ''
+              errors.add(:parcels, "Missing value for key { :#{key_chain.join(' => :')} } for #{index + 1}. parcel (parcel_id: '#{parcel_id}')!")
+            end
+          end
+        end
+      end
+
+      def send_parcels
+        new_element('ns2:sendParcels').tap do |send_parcels|
+          add_element_to(send_parcels, do_parcel_header) # REQUIRED
+          parcels.each do |parcel|
+            add_element_to(send_parcels, do_parcel_data(parcel)) # optional
+          end
+        end
+      end
+
+      def do_parcel_header
+        new_element('ns2:doParcelHeader').tap do |parcel_header|
+          add_element_to(parcel_header, 'ns2:transmissionDate', value: common_data[:parcels_sending_date].strftime('%d.%m.%Y')) # Predpokladane datum podani (format DD.MM.YYYY !)
+          add_element_to(parcel_header, 'ns2:customerID', value: common_data[:customer_id]) # Technologicke cislo podavatele
+          add_element_to(parcel_header, 'ns2:postCode', value: common_data[:sending_post_office_code]) # PSC podaci posty
+          add_element_to(parcel_header, 'ns2:contractNumber', value: common_data[:contract_number]) # Nepovinne: Cislo zakazky
+          add_element_to(parcel_header, 'ns2:frankingNumber', value: common_data[:franking_machine_number]) # Nepovinne: Cislo vyplatniho stroje
+          add_element_to(parcel_header, 'ns2:transmissionEnd', value: common_data[:close_requests_batch]) # Nepovinna, default true: Indikace zda uzavrit podani, nebo budou jeste nasledovat dalsi requesty pro stejne podani
+          add_element_to(parcel_header, sender_address)
+          add_element_to(parcel_header, cache_on_delivery_address)
+          add_element_to(parcel_header, cache_on_delivery_bank)
+          add_element_to(parcel_header, sender_contacts)
+          add_element_to(parcel_header, 'ns2:senderCustCardNum', value: sender_data[:custom_card_number]) # Nepovinne: cislo zakaznicke karty odesilatele
+          add_element_to(parcel_header, 'ns2:locationNumber', value: common_data[:sending_post_office_location_number]) # Nepovinne: cislo podaciho mista (z nastaveni v Podani Online)
+        end
+      end
+
+      def do_parcel_data(parcel)
+        new_element('ns2:doParcelData').tap do |do_parcel_data|
+          add_element_to(do_parcel_data, do_parcel_params(parcel))
+          add_parcel_services(do_parcel_data, parcel)
+          add_element_to(do_parcel_data, do_parcel_address(parcel))
+          add_element_to(do_parcel_data, do_parcel_address_document(parcel))
+          add_element_to(do_parcel_data, do_parcel_customs_declaration(parcel))
+        end
+      end
+
+      def sender_address
+        return nil unless sender_data[:address]
+
+        new_element('ns2:senderAddress').tap do |s_address|
+          add_address_elements(s_address, sender_data[:address], without: ['ns2:firstName', 'ns2:surname'])
+        end
+      end
+
+      def cache_on_delivery_address
+        adr_data = common_data.dig(:cash_on_delivery, :address)
+        return nil unless adr_data
+
+        new_element('ns2:codAddress').tap do |cod_address|
+          add_address_elements(cod_address, adr_data, without: ['ns2:firstName', 'ns2:surname'])
+        end
+      end
+
+      def cache_on_delivery_bank
+        data = common_data.dig(:cash_on_delivery, :bank_account)
+        return nil unless data
+
+        new_element('ns2:codBank').tap do |cod_bank|
+          add_bank_elements(cod_bank, data)
+        end
+      end
+
+      def sender_contacts
+        return nil unless sender_data
+
+        new_element('ns2:senderContacts').tap do |element|
+          add_contact_elements(element, sender_data) # Nepovinne. Telefon, Mobil a Email
+        end
+      end
+
+      def do_parcel_params(parcel_data)
+        params = parcel_data[:params]
+        cod = parcel_data[:cash_on_delivery] || {}
+        new_element('ns2:doParcelParams').tap do |parcel_params|
+          add_element_to(parcel_params, 'ns2:recordID', value: params[:parcel_id]) # Unikatni ID zaznamu
+          add_element_to(parcel_params, 'ns2:parcelCode', value: params[:parcel_code]) # Nepovinne: ID zasilky
+          add_element_to(parcel_params, 'ns2:prefixParcelCode', value: params[:parcel_code_prefix]) # Typ zasilky (prefix)
+          add_element_to(parcel_params, 'ns2:weight', value: params[:weight_in_kg]) # Nepovinne: Hmotnost
+          add_element_to(parcel_params, 'ns2:insuredValue', value: params[:insured_value]) # Nepovinne: Udana cena
+          add_element_to(parcel_params, 'ns2:amount', value: cod[:amount]) # Nepovinne: Dobirka
+          add_element_to(parcel_params, 'ns2:currency', value: cod[:currency_iso_code]) # Nepovinne, default CZK: ISO kod meny dobirky
+          add_element_to(parcel_params, 'ns2:vsVoucher', value: params[:voucher_variable_symbol]) # Nepovinne: Variabilni symbol - poukazka
+          add_element_to(parcel_params, 'ns2:vsParcel', value: params[:parcel_variable_symbol]) # Nepovinne: Variabilni symbol - zasilka
+          add_element_to(parcel_params, 'ns2:sequenceParcel', value: params[:parcel_order]) # Nepovinne: Poradi v ramci vicekusove zasilky
+          add_element_to(parcel_params, 'ns2:quantityParcel', value: params[:parcels_count]) # Nepovinne: Celkovy pocet zasilek vicekusove zasilky
+          add_element_to(parcel_params, 'ns2:note', value: params[:note]) # Nepovinne: Poznamka
+          add_element_to(parcel_params, 'ns2:notePrint', value: params[:note_for_print]) # Nepovinne: Poznamka pro tisk
+          add_element_to(parcel_params, 'ns2:length', value: params[:length]) # Nepovinne: Delka
+          add_element_to(parcel_params, 'ns2:width', value: params[:width]) # Nepovinne: Sirka
+          add_element_to(parcel_params, 'ns2:height', value: params[:height]) # Nepovinne: Vyska
+          add_element_to(parcel_params, 'ns2:mrn', value: params[:mrn_code]) # Nepovinne: Kod MRN
+          add_element_to(parcel_params, 'ns2:referenceNumber', value: params[:reference_number]) # Nepovinne: Cislo jednaci
+          add_element_to(parcel_params, 'ns2:pallets', value: params[:pallets_count]) # Nepovinne: Pocet palet
+          add_element_to(parcel_params, 'ns2:specSym', value: params[:specific_symbol]) # Nepovinne: Specificky symbol
+          add_element_to(parcel_params, 'ns2:note2', value: params[:note2]) # Nepovinne: Poznamka 2
+          add_element_to(parcel_params, 'ns2:numSign', value: params[:documents_to_sign_count]) # Nepovinne: Počet dokumentů
+          add_element_to(parcel_params, 'ns2:score', value: params[:score]) # Nepovinne: Napocet ceny sluzby
+          add_element_to(parcel_params, 'ns2:orderNumberZPRO', value: params[:zpro_order_number]) # Nepovinne: Cislo objednavky ZPRO
+          add_element_to(parcel_params, 'ns2:returnNumDays', value: params[:days_to_deposit]) # Nepovinne: Pocet dni pro vraceni zasilky
+        end
+      end
+
+      def add_parcel_services(parent_element, parcel_data)
+        (parcel_data[:services] || []).each do |p_service|
+          srv_element = new_element('ns2:doParcelServices').tap do |dps|
+            add_element_to(dps, 'ns2:service', value: p_service)
+          end
+
+          add_element_to(parent_element, srv_element)
+        end
+      end
+
+      def do_parcel_address(parcel_data)
+        add_parcel_adress_element('ns2:doParcelAddress', parcel_data[:addressee])
+      end
+
+      def do_parcel_address_document(parcel_data)
+        add_parcel_adress_element('ns2:doParcelAddressDocument', parcel_data[:document_addressee])
+      end
+
+      def add_parcel_adress_element(element_name, addressee_data)
+        return nil if addressee_data.nil?
+
+        address_data = addressee_data[:address]
+        new_element(element_name).tap do |do_parcel_address|
+          add_element_to(do_parcel_address, 'ns2:recordID', value: addressee_data[:addressee_id]) # Nepovinne: Interni oznaceni adresata
+
+          add_address_elements(do_parcel_address, address_data) # Nepovinne: Adresa
+
+          add_element_to(do_parcel_address, 'ns2:subject', value: addressee_data[:addressee_type]) # Nepovinne: Typ adresata
+          add_element_to(do_parcel_address, 'ns2:ic', value: addressee_data[:ic]) # Nepovinne: ICO
+          add_element_to(do_parcel_address, 'ns2:dic', value: addressee_data[:dic]) # Nepovinne: DIC
+          add_element_to(do_parcel_address, 'ns2:specification', value: addressee_data[:addressee_specification]) # Nepovinne: Specifikace napr. datum narozeni
+
+          add_bank_elements(do_parcel_address, addressee_data[:bank_account]) # Nepovinne. Kod banky, cislo a predcisli uctu
+          add_contact_elements(do_parcel_address, addressee_data) # Nepovinne. Telefon, Mobil a Email
+
+          add_element_to(do_parcel_address, 'ns2:custCardNum', value: addressee_data[:custom_card_number]) # Nepovinne: cislo zakaznicke karty
+
+          (addressee_data[:advice_informations] || []).each_with_index do |adv_info, index|
+            add_element_to(do_parcel_address, 'ns2:adviceInformation' + (index + 1).to_s, value: adv_info) # Nepovinne: Informace 1- 6 k dodejce
+          end
+
+          add_element_to(do_parcel_address, 'ns2:adviceNote', value: addressee_data[:advice_note]) # Nepovinne: Poznamka k dodejce
+        end
+      end
+
+      def do_parcel_customs_declaration(parcel_data)
+        declaration_data = parcel_data[:custom_declaration]
+        return nil if declaration_data.nil?
+
+        new_element('ns2:doParcelCustomsDeclaration').tap do |do_p_customs_declaration|
+          add_element_to(do_p_customs_declaration, 'ns2:category', value: declaration_data[:category]) # Kategorie zasilky
+          add_element_to(do_p_customs_declaration, 'ns2:note', value: declaration_data[:note]) # Nepovinne: Poznamka
+          add_element_to(do_p_customs_declaration, 'ns2:customValCur', value: declaration_data[:value_currency_iso_code]) # ISO kod meny celni hodnoty
+
+          (declaration_data[:content_descriptions] || []).each do |dsc|
+            do_p_customs_declaration << custom_goods_for(dsc)
+          end
+        end
+      end
+
+      def custom_goods_for(description_data)
+        new_element('ns2:doParcelCustomsGoods').tap do |do_p_customs_goods|
+          add_element_to(do_p_customs_goods, 'ns2:sequence', value: description_data[:order]) # Nepovinne: Poradi
+          add_element_to(do_p_customs_goods, 'ns2:customCont', value: description_data[:description]) # Nepovinne: Popis zbozi
+          add_element_to(do_p_customs_goods, 'ns2:quantity', value: description_data[:quantity]) # Nepovinne: Mnozstvi
+          add_element_to(do_p_customs_goods, 'ns2:weight', value: description_data[:weight_in_kg]) # Nepovinne: Hmotnost
+          add_element_to(do_p_customs_goods, 'ns2:customVal', value: description_data[:value]) # Nepovinne: Celni hodnota
+          add_element_to(do_p_customs_goods, 'ns2:hsCode', value: description_data[:hs_code]) # Nepovinne: HS kod
+          add_element_to(do_p_customs_goods, 'ns2:iso', value: description_data[:origin_country_iso_code]) # Nepovinne: Zeme puvodu zbozi
+        end
+      end
+
+      def add_address_elements(parent_element, address_data, without: []) # Nepovinne. Adresa
+        return if address_data.nil?
+
+        address_tags_and_values(address_data).each_pair do |xml_tag, value|
+          unless without.include?(xml_tag)
+            add_element_to(parent_element, xml_tag, value: value) unless value.nil?
+          end
+        end
+      end
+
+      def address_tags_and_values(address_data)
+        {
+          'ns2:firstName' => address_data[:first_name], # Nepovinne: Jmeno
+          'ns2:surname' => address_data[:last_name], # Nepovinne: Prijmeni
+          'ns2:companyName' => address_data[:company_name], # Nepovinne: Nazev spolecnosti
+          'ns2:aditionAddress' => address_data[:addition_to_name], # Nepovinne: Doplnujici iformace k nazvu podavatele
+          'ns2:street' => address_data[:street], # Nepovinne: Ulice
+          'ns2:houseNumber' => address_data[:house_number], # Nepovinne: Cislo popisne
+          'ns2:sequenceNumber' => address_data[:sequence_number], # Nepovinne: Cislo orientacni
+          'ns2:partCity' => address_data[:city_part], # Nepovinne: Cast obce
+          'ns2:city' => address_data[:city], # Nepovinne: Obec
+          'ns2:zipCode' => address_data[:post_code], # Nepovinne: PSC
+          'ns2:isoCountry' => address_data[:country_iso_code], # Nepovinne, default 'CZ': ISO kod zeme
+          'ns2:subIsoCountry' => address_data[:subcountry_iso_code], # Nepovinne: ISO kod uzemi
+        }
+      end
+
+      def add_bank_elements(parent_element, bank_account)
+        return if bank_account.to_s == ''
+
+        if (m = bank_account.match(%r{(?:(\d+)-)?(\d+)\/(\d+)}))
+          prefix = m[1]
+          account = m[2]
+          bank = m[3]
+        else
+          prefix, account, bank = nil
+        end
+
+        add_element_to(parent_element, 'ns2:prefixAccount', value: prefix) # Nepovinne: Predcisli k uctu
+        add_element_to(parent_element, 'ns2:account', value: account) # Nepovinne: cislo uctu
+        add_element_to(parent_element, 'ns2:bank', value: bank) # Nepovinne: kod banky
+      end
+
+      def add_contact_elements(parent_element, data_hash)
+        add_element_to(parent_element, 'ns2:mobileNumber', value: data_hash[:mobile_phone]) # Nepovinne: Mobil
+        add_element_to(parent_element, 'ns2:phoneNumber', value: data_hash[:phone]) # Nepovinne: Telefon
+        add_element_to(parent_element, 'ns2:emailAddress', value: data_hash[:email]) # Nepovinne: Email
+      end
+
+      def sender_data
+        common_data[:sender]
+      end
+    end
+  end
+end