money_s3 1.0.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: '037494edbaba12bfdb3309ec99d90889b6943fe4'
-  data.tar.gz: 1aeed2bc17fd0defd09c9130d94035d56f9bd2ce
+SHA256:
+  metadata.gz: 1c7d18e475496bb9a5557afdb5db6beab7d2c79d33ba6f1a51327e1d1aa9076a
+  data.tar.gz: 81723dbcd3c9a8f194162c5adde17947149267ba65f389ca5d7646be0c04c990
 SHA512:
-  metadata.gz: 68ca3accd0c4426ecaa81d4340152ed9241d11da26870cc46e2ca670d1d3572cc6d10578891f97e43c34fc9d0ac2a7d3988cec95a8bc727d2d62dfa7a1c786f6
-  data.tar.gz: 76d0beaffa4fca648b198ed811692cac997eac34d2cdb3b505fc749573a28bf21a8d8bac22e2ca836ddf251c0d025b1df67446bab49295e435cc67a387800d4b
+  metadata.gz: 1be862e0cfcbe4f2b4b82ebd717199acb876d2704ccd4960dc2b30ac370712544a695de7e7751f141832bab2b68c865c80c61847f029aafe847269acdaa89236
+  data.tar.gz: 55ef7442f721afaa7adc13cb822b2239f8fcef07f0b651f4845d3e04e382cd159029ff31c0dc2533a8aa9bba25b2ccacf8a7c5d1496fe69a684ccdd3f1d63af6

data/README.md

@@ -1,7 +1,89 @@
 # MoneyS3
 
-Unstable until 1.0.0
+This gem allows to parse and build any Money S3 entity defined in theirs XML schemas. All the names and structure are preserved as in the original definitions which can be found [here](https://github.com/Masa331/money_xsd). This gem also includes few utilities for fast and easy XML generation.
+
+## Usage
+
+### Parsing a XML
+
+I didn't have time to write docs yet. However parsing works exactly the same as in [Pohoda gem](https://github.com/Masa331/pohoda)
+
+### Building a XML
+
+To build a Money S3 XML you need a hash with same structure you get from calling `#to_h` on parsed xml:
+
+```ruby
+hash = { seznam_fakt_vyd: [{ doklad: '123' }] }
+MoneyS3.build(hash)
+```
+
+it returns a string like this:
+```xml
+<?xml version=\"1.0\"?>
+<MoneyData>
+  <SeznamFaktVyd>
+    <FaktVyd>
+      <Doklad>123</Doklad>
+    </FaktVyd>
+  </SeznamFaktVyd>
+</MoneyData>
+```
+
+Building works also exactly the same as in [Pohoda gem](https://github.com/Masa331/pohoda)
+
+### Utilities
+
+#### `MoneyS3::Utils::BankStatements` class
+
+Generates XML with bank movements for importing into Money S3.
+
+Instantiate `MoneyS3::Utils::BankStatements` with hash containing statements config:
+```
+config = {
+  my_bank_account_id: 'BAN', # Czech: zkratka bankovniho uctu
+  credit_transactions_rule: 'BP001', # Czech: predkontace pro prijmy
+  debit_transactions_rule: 'BV001', # Czech: predkontace pro vydaje
+  credit_transactions_vat_rule: '19Ř00U', # Czech: cleneni dph pro prijmy
+  debit_transactions_vat_rule: '19Ř00P', # Czech: cleneni dph pro vydaje
+  credit_transactions_series: 'BPrr', # Czech: ciselna rada prijmovych bankovnich dokladu
+  debit_transactions_series: 'BVrr' # Czech: ciselna rada vydajovych bankovnich dokladu
+}
+generator = MoneyS3::Utils::BankStatements.new(config)
+```
+
+Then call `#to_xml` on the generator and pass it an array containing hashes with movement data:
+```
+transactions = [
+  { :date => #<Date: 2019-12-05 ((2458823j,0s,0n),+0s,2299161j)>,
+    :transaction_id => "121205SI201442",
+    :my_bank_account_id => "ACC1", # if given it overwrites the one from configuration
+    :amount => 8500.0,
+    :statement_id => "012/00001",
+    :variable_symbol => "0000112019",
+    :specific_symbol => "",
+    :constant_symbol => "0000000138",
+    :counterparty_account => "1023706843",
+    :counterparty_bank_code => "0100",
+    :type => :debit, # or :credit for credit transactions
+    :description => "Some description..",
+    :note => "Some note.." },
+    ...,
+    ...
+]
+statements_string = generator.to_xml(transactions)
+File.open("statements.xml", 'wb') { |f| f.write statements_string }
+```
+
+## Changelog
+
+### 23.02.2020 - v2.1.0
+
+Add utility class for bank statements generation.
+
+### 20.10.2019
+
+Updated gem with new schemas from Money S3 19.603
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/money_s3.rb

@@ -5,6 +5,8 @@ require 'money_s3/requires'
 require 'money_s3/parsers/money_data'
 require 'money_s3/builders/money_data'
 
+require 'money_s3/utils/bank_statements'
+
 module MoneyS3
   def self.parse(raw)
     parsed = Ox.load(raw, skip: :skip_none)

data/lib/money_s3/builders/adresa_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Ulice', data[:ulice], data[:ulice_attributes]) if data.key? :ulice
         root << build_element('Misto', data[:misto], data[:misto_attributes]) if data.key? :misto

data/lib/money_s3/builders/alternativa_prislusenstvi_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Popis', data[:popis], data[:popis_attributes]) if data.key? :popis
         root << build_element('PocMJ', data[:poc_mj], data[:poc_mj_attributes]) if data.key? :poc_mj

data/lib/money_s3/builders/ban_dokl_type.rb

@@ -5,14 +5,14 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Vydej', data[:vydej], data[:vydej_attributes]) if data.key? :vydej
         root << build_element('Doklad', data[:doklad], data[:doklad_attributes]) if data.key? :doklad
         root << build_element('EvCisDokl', data[:ev_cis_dokl], data[:ev_cis_dokl_attributes]) if data.key? :ev_cis_dokl
         root << build_element('ZpusobUctovani', data[:zpusob_uctovani], data[:zpusob_uctovani_attributes]) if data.key? :zpusob_uctovani
+        root << build_element('Storno', data[:storno], data[:storno_attributes]) if data.key? :storno
+        root << build_element('Del', data[:del], data[:del_attributes]) if data.key? :del
         root << build_element('Popis', data[:popis], data[:popis_attributes]) if data.key? :popis
         root << build_element('DatUcPr', data[:dat_uc_pr], data[:dat_uc_pr_attributes]) if data.key? :dat_uc_pr
         root << build_element('DatVyst', data[:dat_vyst], data[:dat_vyst_attributes]) if data.key? :dat_vyst
@@ -37,6 +37,7 @@ module MoneyS3
         root << build_element('Zakazka', data[:zakazka], data[:zakazka_attributes]) if data.key? :zakazka
         root << build_element('Cinnost', data[:cinnost], data[:cinnost_attributes]) if data.key? :cinnost
         root << build_element('StatMOSS', data[:stat_moss], data[:stat_moss_attributes]) if data.key? :stat_moss
+        root << build_element('ZpVypDPH', data[:zp_vyp_dph], data[:zp_vyp_dph_attributes]) if data.key? :zp_vyp_dph
         root << build_element('SSazba', data[:s_sazba], data[:s_sazba_attributes]) if data.key? :s_sazba
         root << build_element('ZSazba', data[:z_sazba], data[:z_sazba_attributes]) if data.key? :z_sazba
         if data.key? :souhrn_dph

data/lib/money_s3/builders/bank_dokl.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         super.nodes.each do |n|
           root << n

data/lib/money_s3/builders/bank_spojeni_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Ucet', data[:ucet], data[:ucet_attributes]) if data.key? :ucet
         root << build_element('KodBanky', data[:kod_banky], data[:kod_banky_attributes]) if data.key? :kod_banky

data/lib/money_s3/builders/bank_ucet_pokladna_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Zkrat', data[:zkrat], data[:zkrat_attributes]) if data.key? :zkrat
         root << build_element('Popis', data[:popis], data[:popis_attributes]) if data.key? :popis

data/lib/money_s3/builders/castky.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Celkem', data[:celkem], data[:celkem_attributes]) if data.key? :celkem
         root << build_element('Zaklad_0', data[:zaklad_0], data[:zaklad_0_attributes]) if data.key? :zaklad_0
@@ -18,6 +16,8 @@ module MoneyS3
         root << build_element('DPH_2', data[:dph_2], data[:dph_2_attributes]) if data.key? :dph_2
         root << build_element('DPH_3', data[:dph_3], data[:dph_3_attributes]) if data.key? :dph_3
         root << build_element('CestSluzba', data[:cest_sluzba], data[:cest_sluzba_attributes]) if data.key? :cest_sluzba
+        root << build_element('PouzZbozi', data[:pouz_zbozi], data[:pouz_zbozi_attributes]) if data.key? :pouz_zbozi
+        root << build_element('PouzZb_0', data[:pouz_zb_0], data[:pouz_zb_0_attributes]) if data.key? :pouz_zb_0
         root << build_element('PouzZb_1', data[:pouz_zb_1], data[:pouz_zb_1_attributes]) if data.key? :pouz_zb_1
         root << build_element('PouzZb_2', data[:pouz_zb_2], data[:pouz_zb_2_attributes]) if data.key? :pouz_zb_2
         root << build_element('PouzZb_3', data[:pouz_zb_3], data[:pouz_zb_3_attributes]) if data.key? :pouz_zb_3

data/lib/money_s3/builders/cena_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Limit', data[:limit], data[:limit_attributes]) if data.key? :limit
         root << build_element('Cena', data[:cena], data[:cena_attributes]) if data.key? :cena

data/lib/money_s3/builders/cenova_hladina.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         super.nodes.each do |n|
           root << n

data/lib/money_s3/builders/cenova_hladina_type.rb

@@ -2,13 +2,10 @@ module MoneyS3
   module Builders
     class CenovaHladinaType
       include ParserCore::BaseBuilder
-      include Groups::DefiniceCeny
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Zkrat', data[:zkrat], data[:zkrat_attributes]) if data.key? :zkrat
         root << build_element('Nazev', data[:nazev], data[:nazev_attributes]) if data.key? :nazev
@@ -18,9 +15,8 @@ module MoneyS3
         end
         root << build_element('Skup', data[:skup], data[:skup_attributes]) if data.key? :skup
         root << build_element('Ceny', data[:ceny], data[:ceny_attributes]) if data.key? :ceny
-
-        mega.each do |r|
-          r.nodes.each { |n| root << n }
+        if data.key? :definice_ceny
+          root << DefiniceCeny.new('definiceCeny', data[:definice_ceny]).builder
         end
 
         root

data/lib/money_s3/builders/cinnost.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         super.nodes.each do |n|
           root << n

data/lib/money_s3/builders/cinnost_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Zkrat', data[:zkrat], data[:zkrat_attributes]) if data.key? :zkrat
         root << build_element('Nazev', data[:nazev], data[:nazev_attributes]) if data.key? :nazev

data/lib/money_s3/builders/clen_dph.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         super.nodes.each do |n|
           root << n

data/lib/money_s3/builders/clen_dph_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Zkrat', data[:zkrat], data[:zkrat_attributes]) if data.key? :zkrat
         root << build_element('DatumOd', data[:datum_od], data[:datum_od_attributes]) if data.key? :datum_od
@@ -18,6 +16,13 @@ module MoneyS3
         root << build_element('BezOdpoctu', data[:bez_odpoctu], data[:bez_odpoctu_attributes]) if data.key? :bez_odpoctu
         root << build_element('NoKoef', data[:no_koef], data[:no_koef_attributes]) if data.key? :no_koef
         root << build_element('Majetek', data[:majetek], data[:majetek_attributes]) if data.key? :majetek
+        root << build_element('KV1', data[:kv1], data[:kv1_attributes]) if data.key? :kv1
+        root << build_element('KV2', data[:kv2], data[:kv2_attributes]) if data.key? :kv2
+        root << build_element('KVLimit', data[:kv_limit], data[:kv_limit_attributes]) if data.key? :kv_limit
+        root << build_element('KVRezim', data[:kv_rezim], data[:kv_rezim_attributes]) if data.key? :kv_rezim
+        root << build_element('KVPomer', data[:kv_pomer], data[:kv_pomer_attributes]) if data.key? :kv_pomer
+        root << build_element('KVInsolv', data[:kv_insolv], data[:kv_insolv_attributes]) if data.key? :kv_insolv
+        root << build_element('MOSS', data[:moss], data[:moss_attributes]) if data.key? :moss
         root << build_element('Pozn', data[:pozn], data[:pozn_attributes]) if data.key? :pozn
 
         root

data/lib/money_s3/builders/control.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         if data.key? :cislo_davky
           root << MessageRootType.new('CisloDavky', data[:cislo_davky]).builder

data/lib/money_s3/builders/dalsi_sazba.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Popis', data[:popis], data[:popis_attributes]) if data.key? :popis
         root << build_element('HladinaDPH', data[:hladina_dph], data[:hladina_dph_attributes]) if data.key? :hladina_dph

data/lib/money_s3/builders/def_sub_pol_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('MJNaSadu', data[:mj_na_sadu], data[:mj_na_sadu_attributes]) if data.key? :mj_na_sadu
         if data.key? :polozka

data/lib/money_s3/builders/definice_ceny.rb

@@ -2,16 +2,32 @@ module MoneyS3
   module Builders
     class DefiniceCeny
       include ParserCore::BaseBuilder
-      include Groups::DefiniceCeny
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
-        mega.each do |r|
-          r.nodes.each { |n| root << n }
+        root << build_element('SDPH', data[:sdph], data[:sdph_attributes]) if data.key? :sdph
+        root << build_element('Zaok', data[:zaok], data[:zaok_attributes]) if data.key? :zaok
+        root << build_element('ZpusobZao', data[:zpusob_zao], data[:zpusob_zao_attributes]) if data.key? :zpusob_zao
+        root << build_element('VychA', data[:vych_a], data[:vych_a_attributes]) if data.key? :vych_a
+        root << build_element('ZpusobZmA', data[:zpusob_zm_a], data[:zpusob_zm_a_attributes]) if data.key? :zpusob_zm_a
+        root << build_element('VychB', data[:vych_b], data[:vych_b_attributes]) if data.key? :vych_b
+        root << build_element('ZpusobZmB', data[:zpusob_zm_b], data[:zpusob_zm_b_attributes]) if data.key? :zpusob_zm_b
+        if data.key? :sleva1
+          root << SlevaType.new('Sleva1', data[:sleva1]).builder
+        end
+        if data.key? :sleva2
+          root << SlevaType.new('Sleva2', data[:sleva2]).builder
+        end
+        if data.key? :sleva3
+          root << SlevaType.new('Sleva3', data[:sleva3]).builder
+        end
+        if data.key? :sleva4
+          root << SlevaType.new('Sleva4', data[:sleva4]).builder
+        end
+        if data.key? :sleva5
+          root << SlevaType.new('Sleva5', data[:sleva5]).builder
         end
 
         root

data/lib/money_s3/builders/dl_prij.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         super.nodes.each do |n|
           root << n

data/lib/money_s3/builders/dl_vyd.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         super.nodes.each do |n|
           root << n

data/lib/money_s3/builders/dodavka_type.rb

@@ -5,9 +5,7 @@ module MoneyS3
 
       def builder
         root = Ox::Element.new(name)
-        if data.key? :attributes
-          data[:attributes].each { |k, v| root[k] = v }
-        end
+        root = add_attributes_and_namespaces(root)
 
         root << build_element('Oznaceni', data[:oznaceni], data[:oznaceni_attributes]) if data.key? :oznaceni
         root << build_element('DatExp', data[:dat_exp], data[:dat_exp_attributes]) if data.key? :dat_exp