czech_post_b2b_client 1.0.0 → 1.2.2

data/lib/czech_post_b2b_client/printing_templates.rb

@@ -1,74 +1,91 @@
 # frozen_string_literal: true
+
+# rubocop:disable Style/AsciiComments
+
 # Available printing templates, which can be used in AdressSheetsGenerator `options[:template_id]`
 #
-# Do not miss `CzechPostB2bClient::PrintingTemplate.all_template_classes` method,
+# Do not miss `CzechPostB2bClient::PrintingTemplates.all_classes` method,
 # it has to be at end of module to work properly
 module CzechPostB2bClient
   module PrintingTemplates
     class Base
       class << self
-        attr_reader :id
-      end
-
-      class << self
-        attr_reader :description
+        attr_reader :id, :description, :page_dimensions
       end
     end
 
-    module AdressLabel
+    module AddressLabel
       class Simple < Base
         @id = 7
-        @description = 'adresní štítek (alonž) - samostatný'
+        @description = 'adresní štítek (alonž) [1x1/4 A4'
+        @page_dimensions = 'A4 portrait (210 × 297 mm)'
+      end
+
+      class SimpleA6FourOnPage < Base
+        @id = 103
+        @description = 'Adresní štítek A6 : 4x'
+        @page_dimensions = 'A4 portrait (210 × 297 mm)'
       end
 
       class SimpleWithCODVoucherA < Base
         @id = 8
-        @description = 'adresní štítek (alonž) + dobírková poukázka A'
+        @description = 'adresní štítek (alonž) + dobírková poukázka A [(1x1/4 A4 + 1x1/2 A4)'
+        @page_dimensions = 'A4 portrait (210 × 297 mm)'
       end
-      class Blank4OnPage < Base
+
+      class BiancoFourOnPage < Base
         @id = 20
-        @description = 'adresní štítek bianco - 4x (A4)'
+        @description = 'adresní štítek bianco : 4x'
+        @page_dimensions = 'A4 landscape (297 × 210 mm)'
       end
 
-      class Blank < Base
+      class Bianco < Base
         @id = 21
-        @description = 'adresní štítek bianco - samostatný'
+        @description = 'adresní štítek bianco'
+        @page_dimensions = 'A6 portrait (105 × 148 mm)'
       end
 
-      class BlankLandscape < Base
+      class BiancoLandscape < Base
         @id = 39
-        @description = 'adresní štítek bianco - samostatný (na šířku)'
+        @description = 'adresní štítek bianco - na šířku'
+        @page_dimensions = 'A6 landscape (148 × 105 mm)'
       end
 
       module ForeignPackage
         class Standard < Base
           @id = 58
-          @description = 'AŠ - samostatný Standardní balík do zahraničí'
+          @description = 'CP72 - standardní balík do zahraničí' # or 'AŠ - samostatný Standardní balík do zahraničí'
+          @page_dimensions = 'A5 landscape (210 × 148 mm)'
         end
 
-        class Standard4OnPage < Base
+        class StandardTwoOnPage < Base
           @id = 59
-          @description = 'AŠ - 4xA4 Standardní balík do zahraničí'
+          @description = 'CP72 - standardní balík do zahraničí : 2x' # or 'AŠ - 4xA4 Standardní balík do zahraničí'
+          @page_dimensions = 'A4 portrait (297 × 210 mm)'
         end
 
-        class Valuable < Base
+        class Insured < Base
           @id = 60
-          @description = 'AŠ - samostatný Cenný balík do zahraničí'
+          @description = 'CP72 - cenný balík do zahraničí' # or 'AŠ - samostatný Cenný balík do zahraničí'
+          @page_dimensions = 'A5 landscape (210 × 148 mm)'
         end
 
-        class Valuable4OnPage < Base
+        class InsuredFourOnPage < Base
           @id = 61
-          @description = '4xA4 Cenný balík do zahraničí'
+          @description = 'CP72 - cenný balík do zahraničí : 2x' # or '4xA4 Cenný balík do zahraničí'
+          @page_dimensions = 'A4 portrait (297 × 210 mm)'
         end
 
         class EMS < Base
           @id = 62
           @description = 'AŠ - samostatný EMS zahraničí'
+          @page_dimensions = 'unverified'
         end
 
-        class EMS2x4 < Base
+        class EMSTwoOnPage < Base
           @id = 63
-          @description = 'AŠ - 2xA4 EMS do zahraničí'
+          @description = 'AŠ - EMS do zahraničí : 2x'
+          @page_dimensions = 'unverified A4'
         end
       end
     end
@@ -77,90 +94,172 @@ module CzechPostB2bClient
       class EnvelopeC6 < Base
         @id = 22
         @description = 'obálka 1 - C6'
+        @page_dimensions = 'C6 portrait (114 × 162 mm)'
       end
 
       class EnvelopeC5 < Base
         @id = 23
         @description = 'obálka 2 - C5'
+        @page_dimensions = 'C5/prc7 portrait (162 × 229 mm)'
       end
 
       class EnvelopeB4 < Base
         @id = 24
         @description = 'obálka 3 - B4'
+        @page_dimensions = 'B4 portrait (250 × 353 mm)'
       end
 
       class EnvelopeDL < Base
         @id = 25
         @description = 'obálka 4 - DL bez okénka'
+        @page_dimensions = 'DL/prc5 portrait (109 × 219 mm)'
       end
     end
 
     class CODVoucherA < Base
       @id = 10
       @description = 'poštovní dobírková poukázka A - samostatná'
+      @page_dimensions = '102 × 210 mm'
     end
 
-    class CODVoucherA3OnPage < Base
+    class CODVoucherAThreeOnPage < Base
       @id = 11
-      @description = 'poštovní dobírková poukázka A - 3x (A4)'
+      @description = 'poštovní dobírková poukázka A - 3x'
+      @page_dimensions = '210 × 306 mm'
     end
 
     class CODVoucherC < Base
       @id = 12
       @description = 'Poštovní dobírková poukázka C'
+      @page_dimensions = 'unverified'
     end
 
     class CODVoucherForCSOB < Base
       @id = 13
       @description = 'Dobírková složenka ČSOB'
+      @page_dimensions = 'unverified'
     end
 
     class RRLabels3x8 < Base
       @id = 26
-      @description = 'štítky pro RR - 3x8 (A4)'
+      @description = 'štítky pro RR : 3x8'
+      @page_dimensions = 'A4 portrait (210 × 297 mm)'
     end
 
     class IntegratedDocument < Base
       @id = 38
       @description = 'Integrovaný doklad'
+      @page_dimensions = 'unverified'
     end
 
     class AddressData3x8 < Base
       @id = 40
-      @description = 'Adresní údaje 3x8 (A4)'
+      @description = 'Adresní údaje : 3x8'
+      @page_dimensions = 'A4 portrait (210 × 297 mm)'
     end
 
     class DeliveryTicket < Base
       @id = 41
       @description = 'Dodejka'
+      @page_dimensions = 'unverified'
     end
 
-    class CustomDeclarationCN22 < Base
-      @id = 56
-      @description = 'Celní prohlášení CN22'
-    end
+    module CustomsDeclaration
+      class CN22 < Base
+        @id = 56
+        @description = 'Celní prohlášení CN22 [samotný tisk je velikosti cca A6 vlevo nahořu od středu]'
+        @page_dimensions = 'A4 portrait (210 × 297 mm)'
+      end
+
+      class CN23 < Base
+        @id = 57
+        @description = 'Celní prohlášení CN23'
+        @page_dimensions = 'A5 landscape (210 × 148 mm)'
+      end
+
+      class CN22FourOnPage < Base
+        @id = 74
+        @description = 'Celní prohlášení CN22 : 4x (A4)'
+        @page_dimensions = 'unverified A4'
+      end
+
+      class CN22WithCK < Base
+        @id = 75
+        @description = 'Celní prohlášení CN22 s ČK (A4)'
+        @page_dimensions = 'unverified A4'
+      end
 
-    class CustomDeclarationCN23 < Base
-      @id = 57
-      @description = 'Celní prohlášení CN23'
+      class CN22WithCKFourOnPage < Base
+        @id = 76
+        @description = 'Celní prohlášení CN22 s ČK : 4x (A4)'
+        @page_dimensions = 'unverified A4'
+      end
     end
 
-    # Formulare ID 72 a 73 je mozno pouzit pouze pro zasilky s prefixem CE
-    # do zemi AT, DE, FR, GR, HR, CH, IS, LU, LV, NO, PL, SK
-    class HarmonizedLabel < Base
-      @id = 72
-      @description = 'Harmonizovaný štítek pro MZ produkty – samostatný'
+    class CN22FourOnPage < Base
+      @id = 74
+      @description = 'Celní prohlášení CN22 : 4x'
+      @page_dimensions = 'A4 portrait (210 × 297 mm)'
     end
 
-    class HarmonizedLabel4OnPage < Base
-      @id = 73
-      @description = 'Harmonizovaný štítek pro MZ produkty –  4x (A4)'
+    module HarmonizedLabel
+      # Formulare ID 72 a 73 je mozno pouzit pouze pro zasilky s prefixem CE
+      # do zemi AT, DE, FR, GR, HR, CH, IS, LU, LV, NO, PL, SK
+      class Simple < Base
+        @id = 72
+        @description = 'Obchodní balík do zahraničí' # or 'Harmonizovaný štítek pro MZ produkty-samostatný'
+        @page_dimensions = 'unverified'
+      end
+
+      class SimpleFourOnPage < Base
+        @id = 73
+        @description = 'Obchodní balík do zahraničí : 4x (A4)' # or 'Harmonizovaný štítek pro MZ produkty – 4x (A4)'
+        @page_dimensions = 'unverified A4'
+      end
+
+      class BiancoFourOnPage < Base
+        @id = 100
+        @description = 'Harmonizovaný štítek bianco : 4x'
+        @page_dimensions = 'A4 portrait (210 × 297 mm)'
+      end
+
+      class Bianco < Base
+        @id = 101
+        @description = 'Harmonizovaný štítek bianco'
+        @page_dimensions = 'A6 portrait (105 × 148 mm)'
+      end
+
+      class BiancoPortrait < Base
+        @id = 102
+        @description = 'Harmonizovaný štítek bianco - na výšku'
+        @page_dimensions = 'A6 landscape (148 × 105 mm)'
+      end
+
+      class ZebraBianco105x148 < Base
+        @id = 200
+        @description = 'Harmonizovaný štítek bianco - (Zebra - 105x148); nejde o PDF'
+        @page_dimensions = 'unverified 105 × 148 mm'
+      end
+
+      class ZebraBianco100x150 < Base
+        @id = 201
+        @description = 'Harmonizovaný štítek bianco - (Zebra - 100x150); nejde o PDF'
+        @page_dimensions = 'unverified 100 × 150 mm'
+      end
+
+      class ZebraBianco100x125 < Base
+        @id = 202
+        @description = 'Harmonizovaný štítek bianco - (Zebra - 100x125); nejde o PDF'
+        @page_dimensions = 'unverified 100 × 125 mm'
+      end
     end
 
     # has to be at the end, to load all subcasses before
-    def all_template_classes
-      ObjectSpace.each_object(CzechPostB2bClient::PrintingTemplates::Base.singleton_class)
+    def self.all_classes
+      base_class = CzechPostB2bClient::PrintingTemplates::Base
+      ObjectSpace.each_object(base_class.singleton_class).reject { |c| c == base_class }
     end
-    module_function :all_template_classes
   end
 end
+
+# rubocop:enable Style/AsciiComments

data/lib/czech_post_b2b_client/request_builders.rb

@@ -6,3 +6,4 @@ 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'
+require 'czech_post_b2b_client/request_builders/parcel_service_sync_builder'

data/lib/czech_post_b2b_client/request_builders/get_parcels_printing_builder.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# rubocop:disable Layout/LineLength
+
 module CzechPostB2bClient
   module RequestBuilders
     class GetParcelsPrintingBuilder < BaseBuilder
@@ -12,7 +14,7 @@ module CzechPostB2bClient
       end
 
       def self.allowed_printing_template_classes
-        @allowed_printing_template_classes ||= CzechPostB2bClient::PrintingTemplates.all_template_classes
+        @allowed_printing_template_classes ||= CzechPostB2bClient::PrintingTemplates.all_classes
       end
 
       private
@@ -44,11 +46,11 @@ module CzechPostB2bClient
         end
       end
 
-      def do_printing_header
+      def do_printing_header # rubocop:disable Metrics/AbcSize
         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:idForm', value: options[:template_id]) # Nepovine, default 20: 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
@@ -77,3 +79,5 @@ module CzechPostB2bClient
     end
   end
 end
+
+# rubocop:enable Layout/LineLength

data/lib/czech_post_b2b_client/request_builders/parcel_service_sync_builder.rb

@@ -0,0 +1,312 @@
+# frozen_string_literal: true
+
+# rubocop:disable Layout/LineLength, Style/AsciiComments
+
+module CzechPostB2bClient
+  module RequestBuilders
+    class ParcelServiceSyncBuilder < BaseBuilder # rubocop:disable Metrics/ClassLength
+      attr_reader :common_data, :parcel
+
+      def initialize(common_data:, parcel:, request_id: 1)
+        @common_data = common_data
+        @parcel = parcel
+        @request_id = request_id
+      end
+
+      private
+
+      def validate_data
+        validate_common_data_required_fields
+
+        if parcel.empty?
+          errors.add(:parcel, 'One parcel is needed!')
+        else
+          validate_parcel_required_fields
+        end
+
+        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_parcel_required_fields
+        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]
+        ]
+
+        parcel_id = parcel.dig(:params, :parcel_id)
+        rq_fields.each do |key_chain|
+          value = parcel.dig(*key_chain)
+
+          if value.nil? || value == ''
+            errors.add(:parcel, "Missing value for key { :#{key_chain.join(' => :')} } for parcel (parcel_id: '#{parcel_id}')!")
+          end
+        end
+      end
+
+      def send_parcels
+        new_element('ns2:parcelServiceSyncRequest').tap do |ps_sync_request|
+          add_element_to(ps_sync_request, do_parcel_header) # REQUIRED
+          add_element_to(ps_sync_request, do_parcel_data) # optional
+        end
+      end
+
+      def do_parcel_header # rubocop:disable Metrics/AbcSize
+        new_element('ns2:doPOLSyncParcelHeader').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, 'ns2:locationNumber', value: common_data[:sending_post_office_location_number]) # Nepovinne: cislo podaciho mista (z nastaveni v Podani Online)
+          add_element_to(parcel_header, 'ns2:senderCustCardNum', value: sender_data[:custom_card_number]) # Nepovinne: cislo zakaznicke karty odesilatele
+          add_element_to(parcel_header, print_params)
+        end
+      end
+
+      def do_parcel_data
+        new_element('ns2:doPOLSyncParcelData').tap do |do_parcel_data|
+          add_element_to(do_parcel_data, do_parcel_params)
+          add_element_to(do_parcel_data, do_parcel_address)
+          add_element_to(do_parcel_data, do_parcel_address_document)
+          add_element_to(do_parcel_data, do_parcel_customs_declaration)
+          add_customs_documents_to(do_parcel_data)
+        end
+      end
+
+      def print_params
+        return nil unless (pp = common_data[:print_params])
+
+        new_element('ns2:printParams').tap do |print_params|
+          add_element_to(print_params, 'ns2:idForm', value: pp[:template_id]) # Nepovine[0-20x]: ID formulare
+          add_element_to(print_params, 'ns2:shiftHorizontal', value: pp[:margin_in_mm][:left]) # Hodnota posunu doprava v mm
+          add_element_to(print_params, 'ns2:shiftVertical', value: pp[:margin_in_mm][:top]) # Hodnota posunu dolu v mm
+          add_element_to(print_params, 'ns2:position', value: pp[:position_order]) # Nepovinna: Hodnota pozice
+        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 # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+        params = parcel[:params]
+        cod = parcel[:cash_on_delivery] || {}
+        new_element('ns2:doPOLSyncParcelParams').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
+          add_parcel_services(parcel_params)
+        end
+      end
+
+      def add_parcel_services(parent_element)
+        (parcel[:services] || []).each do |p_service|
+          srv_element = new_element('ns2:doPOLParcelServices').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
+        add_parcel_adress_element('ns2:doPOLParcelAddress', parcel[:addressee])
+      end
+
+      def do_parcel_address_document
+        add_parcel_adress_element('ns2:doPOLParcelAddressDocument', parcel[:document_addressee])
+      end
+
+      def add_parcel_adress_element(element_name, addressee_data) # rubocop:disable Metrics/AbcSize
+        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
+        declaration_data = parcel[:custom_declaration]
+        return nil if declaration_data.nil?
+
+        new_element('ns2:doPOLParcelCustomsDeclaration').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
+          add_element_to(do_p_customs_declaration, 'ns2:importerRefNum', value: declaration_data[:importer_reference_number]) # Nepovinne: Cislo dovozce
+
+          (declaration_data[:content_descriptions] || []).each do |dsc|
+            do_p_customs_declaration << custom_goods_for(dsc)
+          end
+        end
+      end
+
+      def add_customs_documents_to(parent_element)
+        (parcel[:customs_documents] || []).each do |doc_data| # 0-3 documents
+          doc_element = new_element('ns2:doPOLParcelCustomsDocument').tap do |do_p_customs_document| # VVD dokument
+            add_element_to(do_p_customs_document, 'ns2:recordID', value: doc_data[:record_id]) #  ID Záznamu
+            add_element_to(do_p_customs_document, 'ns2:code', value: doc_data[:code]) # Typ
+            add_element_to(do_p_customs_document, 'ns2:name', value: doc_data[:name]) # Název
+            add_element_to(do_p_customs_document, 'ns2:id', value: doc_data[:id]) # Id
+          end
+
+          add_element_to(parent_element, doc_element)
+        end
+      end
+
+      def custom_goods_for(description_data)
+        new_element('ns2:doPOLParcelCustomsGoods').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
+
+      # Nepovinne. Adresa
+      def add_address_elements(parent_element, address_data, without: [])
+        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
+
+# rubocop:enable Layout/LineLength, Style/AsciiComments