czech_post_b2b_client 1.0.2 → 1.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4ccd8a99118f5ef7d0ecea94ff0f54fabcf9b463
-  data.tar.gz: 48b1cf59bc7507cdf999300da9c808cb84039aba
+  metadata.gz: 2a85b06fa34faeb7213e1441a6545383e8643f33
+  data.tar.gz: 91bc102f0d2f2686b9d0e64fdb42db9ba7f295e6
 SHA512:
-  metadata.gz: c5be2e12fc57bf7409f75401c50327ca07bae5120de0976ec6b190fd437031351f494106339876e1505ea55d975eabb1be3fec0a2c79260e2d6ffabe8e4b90bc
-  data.tar.gz: 296c77c8b88f0ddb86d20d63d2ef5beee702b64d2231d32fc20437e803bcd28ea0f3f89b7815320010131dc458a8b8f8ae6742d5583731199ff2dbe3b9efd038
+  metadata.gz: 25c9c40f2da073568cdb86f391caf378b6a2005c17433486d8e88354e24bad2e0b388e3c2e4331e0b15f241fee1845b6ad9d541db2f2c624e86d869a9e649196
+  data.tar.gz: 6ef1357723687047dc2483f262214a2a01b91f368119af7b1c2608713c7a12d9649bb22da65f28d8b3d005106b07e3a192fa581a668cb0529c0fdbf51d3a478c

data/.rubocop.yml

@@ -14,7 +14,7 @@ AllCops:
     - "bin/*"
 Documentation:
   Enabled: false
-Metrics/LineLength:
+Layout/LineLength:
   Max: 120
 Metrics/AbcSize:
   Max: 20
@@ -50,3 +50,5 @@ Style/HashTransformKeys:
    Enabled: true
 Style/HashTransformValues:
    Enabled: true
+Naming/VariableNumber:
+  Enabled: false

data/CHANGELOG.md

@@ -2,14 +2,39 @@
 
 All changes to the gem are documented here.
 
+## [1.2.3] - 2020-08-21
+
+ - Corrected order in XML `sequence` elements
+ - Added `schemaLocation` to root element and placed publicly accessible XSDs into Github repo
+
+## [1.2.2] - 2020-08-19
+
+ - Printing templates now include @page_dimensions
+ - Forced secure SSL ciphers for requests
+ - `examples/try_api_call.rb` refactored to be more versatile (download XSDs [:do not work], pritn_selected_combinations)
+
+## [1.2.0] - 2020-06-07
+
+ - **Breaking** Introducing new Printing templates, improved some template names and scopes
+ - Added options `custom_card_number` and `print_options` to `Configuration`
+
+## [1.1.0] - 2020-05-28
+
+ - Introducing new API documentation from Czech Post
+ - Added service `ParcelSyncSender` service which uses newly discovered `parcelsServiceSync` API endpoint
+ - Renamed `ParcelSender` to `ParcelAsyncSender` . And created deprecating clone `ParcelSender`, so no Breaking change! If You usit it calls `ParcelAsyncSender` and displays deprecation message.
+
+## [1.0.3] - 2020-05-20
+
+ - Added Czech Post service  DiscountForOnlinePosting.
+ - **Breaking**: Renamed Post service "Size" classes `CzechPostB2bClient::PostServices::Size???` to `CzechPostB2bClient::PostServices::ParcelSize???` (eg. : `CzechPostB2bClient::PostServices::ParcelSizeXL`)
+  I know, that I have **breaking** in every new version, I hope You are not fast enough.
 
 ## [1.0.2] - 2020-05-08
 
  - Added Czech Post services as classes, not just list in docs.
  - **Breaking**: Renamed methods `CzechPostB2bClient::PrintingTemplate.all_template_classes` and `CzechPostB2bClient::ResponseCodes.all_code_classes` to  `CzechPostB2bClient::PrintingTemplate.all_classes`  , and `CzechPostB2bClient::ResponseCodes.all_classes`
 
-
-
 ## [1.0.0] - 2020-03-19
 
 Production ready release

data/README.md

@@ -2,12 +2,16 @@
 Accessing B2B API of Czech Post for bulk processing of parcels ("B2B - WS PodáníOnline").
 
 There are these supported operations of API:
+- *parcelServiceSync* - stores data of one parcel and return package_code and optional PDF adress sheet [HTTP POST - sync response]
+                        Seems to me, that there are is no place extensive Cash On Delivery data, just `amount` and `currency`
 - *sendParcels* - stores data of parcels for async processing [HTTP POST - async response]
 - *getResultParcels* - return results of such processing [HTTP GET - sync response]
 - *getStats* - returns statistics of parcels sent in time period [HTTP GET - sync response]
 - *getParcelState* - returns all known states for listed parcels [HTTP GET - sync response]
 - *getParcelsPrinting* - returns PDF with address labels/stickers for listed parcels [HTTP GET - sync response]
 
+## Development of this gem is donated by [Squared s.r.o.](https://www.vyvolej.to)
+
 ## Installation
 ### 1) Registration at Czech Post (CP)
 The longterm and hardest part.
@@ -35,216 +39,236 @@ gem 'czech_post_b2b_client'
 
 And then execute:
 
-    $ bundle
+```
+$ bundle
+```
 
 Or install it yourself as:
 
     $ gem install czech_post_b2b_client
 
 ### 4) Setting up gem
-   Set up your `contract_id`, `customer_id` (both from CP signed contract), `certificate_path`, `private_key_path` and `private_key_password` in configuration:
-   ```
-    CzechPostB2bClient.configure do |config|
-      config.contract_id = 'contract_id'
-      config.customer_id = 'customer_id'
-      config.certificate_path = 'full_path/to/your/postsignum_certificate.pem'
-      config.private_key_path = 'full_path/to/your/postsignum_private.key'
-      config.private_key_password = 'your_password or nil'
-
-      # this actually do not work, I have to use `sending_post_office_location_number`. But it is REQUIRED!
-      config.sending_post_office_code = 12_345 # PSC of post office where parcels will be physically delivered and submitted
-
-      # and You can override defaults
-      # config.sending_post_office_location_number => 1
-      # config.namespaces #XML namespaces
-      # config.language => :cs # other languages are not supported now
-      # config.logger => ::Rails.logger or ::Logger.new(STDOUT),
-      # config.b2b_api_base_uri => 'https://b2b.postaonline.cz/services/POLService/v1'
-    end
-   ```
-
-   - `contract_id` is _"ID CČK"_ (can be found in contract; eg.: _"2511327004"_)
-   - `customer_id` is _"Technologické číslo"_ (can be found in contract; eg.: _"U123"_ or _"L03022"_; also is visible at [PodaníOnline](https://www.postaonline.cz/podanionline/PrednastaveniUdajuZasilky.action)
-
-   Because PostSignum Certificate Authority is not trusted by default, correct certificate chain is in `certs/` folder. If You have problem with them, create a issue here. Maybe they are outdated now.
+Set up your `contract_id`, `customer_id` (both from CP signed contract), `certificate_path`, `private_key_path` and `private_key_password` in configuration:
+```
+CzechPostB2bClient.configure do |config|
+  config.contract_id = 'contract_id'
+  config.customer_id = 'customer_id'
+  config.certificate_path = 'full_path/to/your/postsignum_certificate.pem'
+  config.private_key_path = 'full_path/to/your/postsignum_private.key'
+  config.private_key_password = 'your_password or nil'
+
+  # these two just save Your time, can be overwritten for each call
+  config.custom_card_number = 'ABCD123456'
+  config.print_options = { template_id: 21, # 'adresní štítek bianco - samostatný'
+                           margin_in_mm: { top: 0, left: 0 } }
+
+  # this actually do not work, I have to use `sending_post_office_location_number`. But it is REQUIRED!
+  config.sending_post_office_code = 12_345 # PSC of post office where parcels will be physically delivered and submitted
+
+  # and You can override defaults
+  # config.sending_post_office_location_number => 1
+  # config.namespaces #XML namespaces
+  # config.language => :cs # other languages are not supported now
+  # config.logger => ::Rails.logger or ::Logger.new(STDOUT),
+  # config.b2b_api_base_uri => 'https://b2b.postaonline.cz/services/POLService/v1'
+end
+```
+
+- `contract_id` is _"ID CČK"_ (can be found in contract; eg.: _"2511327004"_)
+- `customer_id` is _"Technologické číslo"_ (can be found in contract; eg.: _"U123"_ or _"L03022"_; also is visible at [PodaníOnline](https://www.postaonline.cz/podanionline/PrednastaveniUdajuZasilky.action)
+
+Because PostSignum Certificate Authority is not trusted by default, correct certificate chain is in `certs/` folder. If You have problem with them, create a issue here. Maybe they are outdated now.
 
 ## Usage
-  **You have to know which parcel type (according to CP) you sending!** Eg. 'BA' or 'RR'. See [`documents/parcel_types.md`](./documents/parcel_types.md).
-
-  **And what services You will use for each parcel**, see [`documents/services_list.md`](./documents/services_list.md) and [`documents/parcels_type_and_services_restrictions.md`](./documents/parcels_type_and_services_restrictions.md).
-
-  Hashes used is service calls bellow:
-  ```
-    short_sender_data = { address: {
-                            company_name: 'Oriflame',
-                            addition_to_name: 'perfume', # optional
-                            street: 'V olšinách',
-                            house_number: '16',
-                            city_part: 'Strašnice',
-                            city: 'Praha',
-                            post_code: 10_000,
-                          },
-                          mobile_phone: '+420777888999',
-                          email: 'rehor.jan@cpost.cz' }
-    sending_data = { contract_id: configuration.contract_id,
-                     parcels_sending_date: Date.today,
-                     sending_post_office_location_number: 1,
-                     sender: short_sender_data,
-                     cash_on_delivery: {
-                       address: short_sender_data[:address]
-                       bank_account: '123456-1234567890/1234'
-                     } }
-
-    short_addressee_data = { address: {
-                              first_name: 'Petr',
-                              last_name: 'Foton',
-                              street: 'Fischerova',
-                              house_number: '686',
-                              sequence_number: '32',
-                              city_part: 'Nové Sady',
-                              city: 'Olomouc',
-                              post_code: 77_900
-                            },
-      email: 'foton@github.com',
-      mobile_phone: '+420777888999' }
-
-    parcels = [
-      {
-        addressee: short_addressee_data,
-        params: { parcel_id: 'package_1of2',
-                  parcel_code_prefix: 'BA',
-                  weight_in_kg: 1.0,
-                  parcel_order: 1,
-                  parcels_count: 2 },
-        services: [70, 7, 'S']
-      },
-      {
-        addressee: short_addressee_data,
-        params: { parcel_id: 'package_2of2',
-                  parcel_code_prefix: 'BA',
-                  weight_in_kg: 1.6,
-                  parcel_order: 2,
-                  parcels_count: 2 },
-        services: [70,'S']
-      },
-      {
-        addressee: short_addressee_data,
-        params: { parcel_id: 'package_3',
-                  parcel_code_prefix: 'BA',
-                  weight_in_kg: 1.9 },
-        services: [7,'M']
-      }
-    ]
+**You have to know which parcel type (according to CP) you sending!** Eg. 'BA' or 'RR'. See [`documents/parcel_types.md`](./documents/parcel_types.md).
+
+**And what services You will use for each parcel**, see [`documents/services_list.md`](./documents/services_list.md) and [`documents/parcels_type_and_services_restrictions.md`](./documents/parcels_type_and_services_restrictions.md).
+
+Hashes used is service calls bellow:
+
+```
+short_sender_data = { address: {
+                        company_name: 'Oriflame',
+                        addition_to_name: 'perfume', # optional
+                        street: 'V olšinách',
+                        house_number: '16',
+                        city_part: 'Strašnice',
+                        city: 'Praha',
+                        post_code: 10_000,
+                      },
+                      mobile_phone: '+420777888999',
+                      email: 'rehor.jan@cpost.cz' }
+sending_data = { contract_id: configuration.contract_id,
+                  parcels_sending_date: Date.today,
+                  sending_post_office_location_number: 1,
+                  sender: short_sender_data,
+                  cash_on_delivery: {
+                    address: short_sender_data[:address]
+                    bank_account: '123456-1234567890/1234'
+                  } }
+
+short_addressee_data = { address: {
+                          first_name: 'Petr',
+                          last_name: 'Foton',
+                          street: 'Fischerova',
+                          house_number: '686',
+                          sequence_number: '32',
+                          city_part: 'Nové Sady',
+                          city: 'Olomouc',
+                          post_code: 77_900
+                        },
+  email: 'foton@github.com',
+  mobile_phone: '+420777888999' }
+
+parcels = [
+  {
+    addressee: short_addressee_data,
+    params: { parcel_id: 'package_1of2',
+              parcel_code_prefix: 'BA',
+              weight_in_kg: 1.0,
+              parcel_order: 1,
+              parcels_count: 2 },
+    services: [70, 7, 'S']
+  },
+  {
+    addressee: short_addressee_data,
+    params: { parcel_id: 'package_2of2',
+              parcel_code_prefix: 'BA',
+              weight_in_kg: 1.6,
+              parcel_order: 2,
+              parcels_count: 2 },
+    services: [70,'S']
+  },
+  {
+    addressee: short_addressee_data,
+    params: { parcel_id: 'package_3',
+              parcel_code_prefix: 'BA',
+              weight_in_kg: 1.9 },
+    services: [7,'M']
+  }
+]
 ```
 
 
-  1) Pack your parcel(s)
-
-  2) Call `ParcelsSender`, this will store in `result` `transmission_id` and expected time to ask for results.
-      ```
-        psender = CzechPostB2bClient::Services::ParcelsSender.call(sending_data: sending_data, parcels: parcels)
-
-        if psender.success?
-          result = psender.result
-          processing_end_time_utc = (result.processing_end_expected_at - (60 *60)).utc # API returns time in CET but marked as UTC
-          transaction_id = result.transaction_id
-        else
-          puts psender.errors.full_messages
-        end
-      ```
-     For now, `parcels` is array of complicated hashes; each parcel must have `parcel_id` key (your ID of parcel).
-
-  3) When such expected time pass, ask for results by calling `ParcelsSendProcessUpdater`.
-
-     You can get error `Processing is not yet finished` or hash based on `parcel_id` keys.
-     Eg. :
-     ```
-        pudater = CzechPostB2bClient::Services::ParcelsSendProcessUpdater.call(transmission_id: transmission_id)
-
-        if pupdater.success?
-          update_my_parcels_with(pupdater.result) # => { 'parcel_1of2' => { parcel_code: 'BA12354678', states: [{ code: 1, text: 'OK' }]},
-                                                  #      'parcel_2of2' => { parcel_code: 'BA12354679', states: [{ code: 1, text: 'OK' }]},
-                                                  #      'parcel_3' => { parcel_code: 'BA12354680', states: [{ code: 1, text: 'OK' }]}
-        else
-          puts psender.errors.full_messages # => "response_state: ResponseCode[19 BATCH_INVALID] V dávce se vyskytují chybné záznamy"
-                                            #    "parcels: Parcel[parcel_2of2] => ResponseCode[104 INVALID_WEIGHT] Hmotnost mimo povolený rozsah"
-                                            #    "parcels: Parcel[parcel_2of2] => ResponseCode[261 MISSING_SIZE_CATEGORY] Neuvedena rozměrová kategorie zásilky"
-                                            #    "parcels: Parcel[parcel_3] => ResponseCode[310 INVALID_PREFIX] Neplatný typ zásilky"
-        end
-     ```
-     `parcel_code` is CzechPost ID of parcel and is used in following calls.
-
-  4) Print address sheets of parcels(s) by calling `AddressSheetsGenerator`.
-     See [template_classes](./lib/czech_post_b2b_client/printing_templates.rb) for available templates.
-     Eg. :
-     ```
-     parcel_codes = %w[RA123456789 RR123456789F RR123456789G] # beware of parcel_id!
-     options = {
-          customer_id: configuration.customer_id, # required
-          contract_number: configuration.contract_id, # not required
-          template_id: 24, # 'obalka 3 - B4'  #
-          margin_in_mm: { top: 5, left: 3 } # required
-        }
-
-      adrprinter = CzechPostB2bClient::Services::AddressSheetsGenerator.call(parcel_codes: parcel_codes, options: options )
-
-      if adrprinter.success?
-        File.write("adrsheet.pdf", adrprinter.result.pdf_content)
-      else
-        puts(adrprinter.errors.full_messages)
-      end
-     ```
-
-  5) Repeat steps 1-4 until You decide to deliver packages to post office.
-
-  6) Close your parcels submission with call `ParcelsSubmissionCloser.call(sending_data: sender_data)`.
-
-  7) _They will await You at post office with warm welcome (hopefully). Parcels which are not delivered within 60 days are removed from CzechPost systems for free :-)_
-
-  8) You can check current status of delivering with `DeliveringInspector`, which will return hash based on `parcel_code` keys.
-     Eg. :
-     ```
-      delivery_boy = CzechPostB2bClient::Services::DeliveringInspector.call(parcel_codes: parcel_codes)
-
-      if delivery_boy.success?
-        update_my_parcels_delivery_status_with(delivery_boy.result)
-        # result is like:
-        # { 'RA12345687' => { current_state: { id: '91',
-                                               date: Date.parse('2015-09-04'),
-                                               text: 'Dodání zásilky.',
-                                               post_code: '25756',
-                                               post_name: 'Neveklov'},
-                              deposited_until: Date.new(2015, 9, 2),
-                              deposited_for_days: 15,
-                              all_states: [
-                                { id: '21', date: Date.parse('2015-09-02'), text: 'Podání zásilky.', post_code: '26701', post_name: 'Králův Dvůr u Berouna' },
-                                { id: '-F', date: Date.parse('2015-09-03'), text: 'Vstup zásilky na SPU.', post_code: '22200', post_name: 'SPU Praha 022' },
-                                { id: '-I', date: Date.parse('2015-09-03'), text: 'Výstup zásilky z SPU.', post_code: '22200', post_name: 'SPU Praha 022' },
-                                { id: '-B', date: Date.parse('2015-09-03'), text: 'Přeprava zásilky k dodací poště.', post_code: nil, post_name: nil },
-                                { id: '51', date: Date.parse('2015-09-04'), text: 'Příprava zásilky k doručení.', post_code: '25607', post_name: 'Depo Benešov 70' },
-                                { id: '53', date: Date.parse('2015-09-04'), text: 'Doručování zásilky.', post_code: '25756', post_name: 'Neveklov' },
-                                { id: '91', date: Date.parse('2015-09-04'), text: 'Dodání zásilky.', post_code: '25756', post_name: 'Neveklov' }
-                              ]},
-            'BA56487125' => {...}
-          }
-      else
-        puts(delivery_boy.errors.full_messages)
-      end
-      ```
-
-  9) And You can always ask for statistics!
-      ```
-      tps = CzechPostB2bClient::Services::TimePeriodStatisticator.call(from_date: Date.today - 5, to_date: Date.today)
-      if tps.success?
-        result = tps.result
-        result.requests.total # => 26,
-        result.requests.with_errors # => 16
-        result.requests.successful # => 10
-        result.imported_parcels # => 3
-      else
-        puts(tps.errors.full_messages)
-      end
-      ```
+1 ) Pack your parcel(s)
+
+2 ) If you have many parcels and treats them as bulk, use ASYNC registration process (steps 3a - 7a)[15 000 calls per day allowed]. If You want to register parcel and get  parcel_code and address sheet immediatelly (3 sec), use SYNC process (step 3b)[1 000 calls per day allowed]
+
+3a) Call `ParcelsAsyncSender`, this will setup `transmission_id` and expected time to ask for results.
+```
+psender = CzechPostB2bClient::Services::ParcelsAsyncSender.call(sending_data: sending_data, parcels: parcels)
+
+if psender.success?
+  result = psender.result
+  processing_end_time_utc = (result.processing_end_expected_at - (60 *60)).utc # API returns time in CET but marked as UTC
+  transaction_id = result.transaction_id
+else
+  puts psender.errors.full_messages
+end
+```
+For now, `parcels` is array of complicated hashes; each parcel must have `parcel_id` key (your ID of parcel).
+
+4a) When such expected time pass, ask for results by calling `ParcelsSendProcessUpdater`. You can get error `Processing is not yet finished` or hash based on `parcel_id` keys.
+```
+pudater = CzechPostB2bClient::Services::ParcelsSendProcessUpdater.call(transmission_id: transmission_id)
+
+if pupdater.success?
+  update_my_parcels_with(pupdater.result) # => { 'parcel_1of2' => { parcel_code: 'BA12354678', states: [{ code: 1, text: 'OK' }]},
+                                          #      'parcel_2of2' => { parcel_code: 'BA12354679', states: [{ code: 1, text: 'OK' }]},
+                                          #      'parcel_3' => { parcel_code: 'BA12354680', states: [{ code: 1, text: 'OK' }]}
+else
+  puts psender.errors.full_messages # => "response_state: ResponseCode[19 BATCH_INVALID] V dávce se vyskytují chybné záznamy"
+                                    #    "parcels: Parcel[parcel_2of2] => ResponseCode[104 INVALID_WEIGHT] Hmotnost mimo povolený rozsah"
+                                    #    "parcels: Parcel[parcel_2of2] => ResponseCode[261 MISSING_SIZE_CATEGORY] Neuvedena rozměrová kategorie zásilky"
+                                    #    "parcels: Parcel[parcel_3] => ResponseCode[310 INVALID_PREFIX] Neplatný typ zásilky"
+end
+```
+`parcel_code` is CzechPost Tracking number of parcel and is used in following calls.
+
+5a) Print address sheets of parcel(s) by calling `AddressSheetsGenerator`.
+See [template_classes](./lib/czech_post_b2b_client/printing_templates.rb) for available templates.
+```
+parcel_codes = %w[RA123456789 RR123456789F RR123456789G] # beware of parcel_id!
+options = {
+    customer_id: configuration.customer_id, # required
+    contract_number: configuration.contract_id, # not required
+    template_id: 24, # 'obalka 3 - B4'  #
+    margin_in_mm: { top: 5, left: 3 } # required
+  }
+
+adrprinter = CzechPostB2bClient::Services::AddressSheetsGenerator.call(parcel_codes: parcel_codes, options: options )
+
+if adrprinter.success?
+  File.write("adrsheet.pdf", adrprinter.result.pdf_content)
+else
+  puts(adrprinter.errors.full_messages)
+end
+```
+
+6a) Repeat steps 1-4 until You decide to deliver packages to post office.
+
+7a) Close your parcels submission with call `ParcelsSubmissionCloser.call(sending_data: sender_data)`.
+
+3b) For immediate (one) parcel registering call `ParcelsSyncSender`. You can optionally request address sheet pdf in response (see step 5a for info)
+```
+s_data = sending_data.merge(print_params: { template_id: 40, margin_in_mm: { top: 1, left: 1 }})
+psender = CzechPostB2bClient::Services::ParcelsSyncSender.call(sending_data: s_data, parcels: [parcels.first])
+
+if psender.success?
+  result = psender.result
+  update_my_parcels_with(result) # => { 'parcel_1of2' => { parcel_code: 'BA12354678', states: [{ code: 1, text: 'OK' }]},
+  File.write("adrsheet.pdf", result.pdf_content)
+else
+  puts psender.errors.full_messages
+end
+```
+`parcel_code` is CzechPost Tracking number of parcel and is used in following calls.
+
+8_) _They will await You at post office with warm welcome (hopefully). Parcels which are not delivered within 60 days are removed from CzechPost systems for free :-)_
+
+9_) You can check current status of delivering with `DeliveringInspector`, which will return hash based on `parcel_code` keys.
+```
+delivery_boy = CzechPostB2bClient::Services::DeliveringInspector.call(parcel_codes: parcel_codes)
+
+if delivery_boy.success?
+  update_my_parcels_delivery_status_with(delivery_boy.result)
+  # result is like:
+  # { 'RA12345687' => { current_state: { id: '91',
+                                          date: Date.parse('2015-09-04'),
+                                          text: 'Dodání zásilky.',
+                                          post_code: '25756',
+                                          post_name: 'Neveklov'},
+                        deposited_until: Date.new(2015, 9, 2),
+                        deposited_for_days: 15,
+                        all_states: [
+                          { id: '21', date: Date.parse('2015-09-02'), text: 'Podání zásilky.', post_code: '26701', post_name: 'Králův Dvůr u Berouna' },
+                          { id: '-F', date: Date.parse('2015-09-03'), text: 'Vstup zásilky na SPU.', post_code: '22200', post_name: 'SPU Praha 022' },
+                          { id: '-I', date: Date.parse('2015-09-03'), text: 'Výstup zásilky z SPU.', post_code: '22200', post_name: 'SPU Praha 022' },
+                          { id: '-B', date: Date.parse('2015-09-03'), text: 'Přeprava zásilky k dodací poště.', post_code: nil, post_name: nil },
+                          { id: '51', date: Date.parse('2015-09-04'), text: 'Příprava zásilky k doručení.', post_code: '25607', post_name: 'Depo Benešov 70' },
+                          { id: '53', date: Date.parse('2015-09-04'), text: 'Doručování zásilky.', post_code: '25756', post_name: 'Neveklov' },
+                          { id: '91', date: Date.parse('2015-09-04'), text: 'Dodání zásilky.', post_code: '25756', post_name: 'Neveklov' }
+                        ]},
+      'BA56487125' => {...}
+    }
+else
+  puts(delivery_boy.errors.full_messages)
+end
+```
+
+10_) And You can always ask for statistics!
+```
+tps = CzechPostB2bClient::Services::TimePeriodStatisticator.call(from_date: Date.today - 5, to_date: Date.today)
+if tps.success?
+  result = tps.result
+  result.requests.total # => 26,
+  result.requests.with_errors # => 16
+  result.requests.successful # => 10
+  result.imported_parcels # => 3
+else
+  puts(tps.errors.full_messages)
+end
+```
 
 ### Example usage
 
@@ -254,6 +278,8 @@ Or install it yourself as:
 
 ## Troubleshooting
 
+  You can validate request XML against XSD in [`documents/latest_xsds`](./documents/latest_xsds) (There are no public  files from Czech Post :-( )
+
   1) Read all stuff in [`./documents`](./documents/) and [Yard docs](./doc/index.html), maybe it helps.
   2) If You get "handshake protocol failed" You do not have correct setup for certificates. If You get any xml response (see logger in debug mode) certificates are ok.
      You can always try `TimePeriodStatisticator` for that check, it do not need any "before" actions.
@@ -261,6 +287,8 @@ Or install it yourself as:
   4) Error `11: INVALID_LOCATION` was occuring when only `sending_post_office_code` was used. Try to use `sending_post_office_location_number`.
   5) And last tip `261 MISSING_SIZE_CATEGORY` -> add correct "size service" to services (eg: 'S', 'M')
   6) Compare resulting request XML with examples in `test/request_builders`
+  7) If You get strings like `"Obdr\xC5\xBEeny \xC3\xBAdaje k z\xC3\xA1silce."` instead of `"Obdrženy údaje k zásilce."`, You need to `str.force_encoding('UTF-8')`. It happens to me, after I started to use gem in app. Something like backward influence.
+
 
 ## Development