epics 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 36e7870a631e71236b0c9379770056d5c9c8d08f
-  data.tar.gz: 59d5dfe38c22a0d71fc1b9a700bb145fa4f1059c
+  metadata.gz: af6bf6d6425c258c08814fc2c1c3b9a3b3073123
+  data.tar.gz: 1ee5bef16a6bf11f34f8aa60a79f3b11d8875122
 SHA512:
-  metadata.gz: eb1d40e580bf49be94aba0618a2146113cecc2781f60a4a37a79650a5afd479e09ab459568cca018faf7b2adfab741af7f6184c82934d2fb01ac673423cef458
-  data.tar.gz: 6d58b9dc15721089a511f908896b5c5b60a9628171fe0edb70f702b53a5a7346d788974c54e2ef50a46434c7906cf5190908ccf0e8d8095256df0221e87026f0
+  metadata.gz: 1afc8a8f34f6cde89869f5a5c4a24b09ae3bcb111da63ef81f97823fc187fa67120f86b0343c54a8841f4c43654e7be27b44804ca87ed479f3c27f6666d5ca6b
+  data.tar.gz: f57a864a565b4bd70731cde527052f5d17c6e304542f26a7937321e7045136ca53424287c082e132d870df0158c73cee4696873fd8fb815bfc90ac30549d9f32

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+### 1.1.0
+
+  * [BUGFIX] Sending `Receipts` after downloading data, to circumvent download locks
+  * [BUGFIX] adding missing require statements
+  * adding HAC, HKD, C52 and C53 support
+  * less verbose object inspection for `Epics::Client`
+  * readme polishing
+
+### 1.0.0
+
+  * first release

data/README.md

@@ -1,9 +1,11 @@
-[![Build Status](https://magnum.travis-ci.com/railslove/epics.svg?token=EhFJyZWe1sxdBDmF2bzC&branch=master)](https://magnum.travis-ci.com/railslove/epics)
+[![Build Status](https://travis-ci.org/railslove/epics.svg?branch=master)](https://travis-ci.org/railslove/epics)
+[![Gem Version](https://badge.fury.io/rb/epics.svg)](http://badge.fury.io/rb/epics)
 
 # Epics
 
 EPICS is a ruby implementation of the [EBICS](http://www.ebics.org/) (Electronic Banking Internet Communication Standard)
 
+The client support the complete initialization process comprising INI, HIA and HPB including the INI letter generation. It offers support for the most common download and upload order types (STA HAA HTD HPD PKT HAC HKD C52 C53 CD1 CDD CCT)
 
 
 ## Installation
@@ -14,10 +16,6 @@ Add this line to your application's Gemfile:
 gem 'epics'
 ```
 
-And then execute:
-
-    $ bundle
-
 Or install it yourself as:
 
     $ gem install epics
@@ -94,6 +92,13 @@ e.HAA
 
 To get a list of all supported order types.
 
+
+## Need help? Having questions? 
+
+We have many years of experience in developing innovative applications for the finance sector and integration application with financial institutions. - you might want to have a look at our [portfolio](http://www.railslove.com/portfolio)   
+__If you need help we are happy to provide consulting or development services. Contact us: [team@railslove.com](mailto:team@railslove.com)__
+
+
 ## Usage
 
 ### Create a client
@@ -108,17 +113,6 @@ keys = File.read('/tmp/my.key')
 e = Epics::Client.new(keys, 'passphrase', 'url', 'host', 'user', 'partner')
 ```
 
-### Lazy Mode
-
-Once you have a client, go ahead and start playing! There are 3 convinence methods
-that are hiding some strange names from you:
-
-* debit( _xml_ ) (submits a PAIN.008.003.02 document via CDD)
-* credit( _xml_ ) (submits a pain.001.003.03 document)
-* statements( _from_, _to_ ) (fetches an account statement via STA)
-
-If you need more sophisticated EBICS order types, please read the next section
-about the supported functionalities.
 
 ## Features
 
@@ -137,6 +131,7 @@ Currently this EPICS implementation supports the following order types:
 * HTD (user properties and settings)
 * HPD (the available bank parameters)
 * PKT (customer usage report in text format)
+* HAC (customer usage report in xml format)
 * ... more coming soon
 
 Example:
@@ -177,14 +172,50 @@ puts e.CD1("i-am-a-PAIN-xml-file")
 # res is a the transaction id of the order
 ```
 
+### Lazy Mode
+
+Once you have a client, go ahead and start playing! There are 3 convinence methods
+that are hiding some strange names from you:
+
+* debit( _xml_ ) (submits a PAIN.008.003.02 document via CDD)
+* credit( _xml_ ) (submits a pain.001.003.03 document)
+* statements( _from_, _to_ ) (fetches an account statement via STA)
+
+If you need more sophisticated EBICS order types, please read the next section
+about the supported functionalities.
+
+
+## Issues and Feature Requests
+
+[Railslove](http://railslove.com) is commited to provide the best developer tools for integrating with financial institutions. Epics is one of our many tools and services. 
+If you are missing some features or something is not working as expected please create an issue. 
+
+
+
 ## Supported Banks
 
+This gem provides a full implementation of the Electronic Banking Internet Communication Standard and works with any bank that supports this standard. Please ask your bank if they support EBICS and what order types are available. 
+
+Besides EBCIS being a standard, some server implementations are slighty different. 
+Is Epics working with your institution? 
+Please help us to grow this list of supported banks:
+
 * Sofortbank
 * Deutsche Bank
+* Sparkasse KölnBonn
+
+
+## Links
+
+* [ebics.de](http://www.ebics.de/)
+* [EBICS specification](http://www.ebics.de/index.php?id=30)
+* [Common Integrative Implementation Guide to Supplement the EBICS Specification (pdf)](http://www.ebics.de/fileadmin/unsecured/specification/implementation_guide_DE/EBICS_Common_IG_basiert_auf_EBICS_2.5.pdf)
+* [Die Deutsche Kreditwirtschaft](http://www.die-deutsche-kreditwirtschaft.de/) 
+
 
 ## Contributing
 
-0. Contact team@raislove.com for information about howto CLA
+0. Contact team@railslove.com for information about the CLA
 1. Fork it ( https://github.com/[my-github-username]/epics/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
@@ -192,6 +223,5 @@ puts e.CD1("i-am-a-PAIN-xml-file")
 5. Create a new Pull Request
 
 
-
-
-made with love by [railslove](http://www.railslove.com)
+------------
+2014 - built with love by [Railslove](http://railslove.com) and released under the [GNU LESSER GENERAL PUBLIC LICENSE](https://github.com/railslove/epics/blob/master/LICENSE.txt). We have built quite a number of FinTech products. If you need support we are happy to help. Please contact us at team@railslove.com.

data/epics.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |spec|
     including the INI letter generation.
 
     Furthermore it offers support for the most common download types:
-      STA HAA HTD HPD PKT
+      STA HAA HTD HPD PKT HAC HKD C52 C53
 
     And the following upload orders:
       CD1 CDD CCT
@@ -36,7 +36,7 @@ Gem::Specification.new do |spec|
   spec.post_install_message += "Railslove as the maintainer is commited to provide extensive developer tools to make integrating financial institutions fun and easy.\n"
   spec.post_install_message += "Please create an issue on github (railslove/epics) if anything does not work as expected. And contact team@railslove.com if you are looking for support with your integration.\n"
   spec.post_install_message += "\e[32m" + ("*" * 60) + "\n\e[0m"
-  
+
   spec.add_dependency "nokogiri"
   spec.add_dependency "gyoku"
   spec.add_dependency "faraday"

data/lib/epics.rb

@@ -5,7 +5,8 @@ require 'json'
 require 'nokogiri'
 require 'gyoku'
 require 'faraday'
-
+require 'securerandom'
+require 'time'
 require "epics/version"
 require "epics/key"
 require "epics/mgf"
@@ -16,10 +17,14 @@ require "epics/middleware/parse_ebics"
 require "epics/generic_request"
 require "epics/generic_upload_request"
 require "epics/hpb"
+require "epics/hkd"
 require "epics/htd"
 require "epics/haa"
 require "epics/sta"
+require "epics/c52"
+require "epics/c53"
 require "epics/ptk"
+require "epics/hac"
 require "epics/hpd"
 require "epics/cd1"
 require "epics/cct"

data/lib/epics/c52.rb

@@ -0,0 +1,52 @@
+class Epics::C52 < Epics::GenericRequest
+  attr_accessor :from, :to
+
+  def initialize(client, from, to)
+    super(client)
+    self.from = from
+    self.to = to
+  end
+
+  def header
+    {
+      :@authenticate => true,
+      static: {
+        "HostID" => host_id,
+        "Nonce" => nonce,
+        "Timestamp" => timestamp,
+        "PartnerID" => partner_id,
+        "UserID" => user_id,
+        "Product" => {
+          :@Language => "de",
+          :content! => "EPICS - a ruby ebics kernel"
+        },
+        "OrderDetails" => {
+          "OrderType" => "C52",
+          "OrderAttribute" => "DZHNN",
+          "StandardOrderParams" => {
+            "DateRange" => {
+              "Start" => from,
+              "End" => to
+            }
+          }
+        },
+        "BankPubKeyDigests" => {
+          "Authentication" => {
+            :@Version => "X002",
+            :@Algorithm => "http://www.w3.org/2001/04/xmlenc#sha256",
+            :content! => client.bank_x.public_digest
+          },
+          "Encryption" => {
+            :@Version => "E002",
+            :@Algorithm => "http://www.w3.org/2001/04/xmlenc#sha256",
+            :content! => client.bank_e.public_digest
+          }
+        },
+        "SecurityMedium" => "0000"
+     },
+      "mutable" => {
+        "TransactionPhase" => "Initialisation"
+      }
+    }
+  end
+end

data/lib/epics/c53.rb

@@ -0,0 +1,52 @@
+class Epics::C53 < Epics::GenericRequest
+  attr_accessor :from, :to
+
+  def initialize(client, from, to)
+    super(client)
+    self.from = from
+    self.to = to
+  end
+
+  def header
+    {
+      :@authenticate => true,
+      static: {
+        "HostID" => host_id,
+        "Nonce" => nonce,
+        "Timestamp" => timestamp,
+        "PartnerID" => partner_id,
+        "UserID" => user_id,
+        "Product" => {
+          :@Language => "de",
+          :content! => "EPICS - a ruby ebics kernel"
+        },
+        "OrderDetails" => {
+          "OrderType" => "C53",
+          "OrderAttribute" => "DZHNN",
+          "StandardOrderParams" => {
+            "DateRange" => {
+              "Start" => from,
+              "End" => to
+            }
+          }
+        },
+        "BankPubKeyDigests" => {
+          "Authentication" => {
+            :@Version => "X002",
+            :@Algorithm => "http://www.w3.org/2001/04/xmlenc#sha256",
+            :content! => client.bank_x.public_digest
+          },
+          "Encryption" => {
+            :@Version => "E002",
+            :@Algorithm => "http://www.w3.org/2001/04/xmlenc#sha256",
+            :content! => client.bank_e.public_digest
+          }
+        },
+        "SecurityMedium" => "0000"
+     },
+      "mutable" => {
+        "TransactionPhase" => "Initialisation"
+      }
+    }
+  end
+end

data/lib/epics/client.rb

@@ -16,6 +16,13 @@ class Epics::Client
     self.partner_id = partner_id
   end
 
+  def inspect
+    "#<#{self.class}:#{self.object_id}
+     @keys=#{self.keys.keys},
+     @user_id=#{self.user_id},
+     @partner_id=#{self.partner_id}"
+  end
+
   def e
     keys["E002"]
   end
@@ -124,6 +131,14 @@ class Epics::Client
     download(Epics::STA, from, to)
   end
 
+  def C52(from, to)
+    download(Epics::C52, from, to)
+  end
+
+  def C53(from, to)
+    download(Epics::C53, from, to)
+  end
+
   def HAA
     Nokogiri::XML(download(Epics::HAA)).at_xpath("//xmlns:OrderTypes").content.split(/\s/)
   end
@@ -140,10 +155,18 @@ class Epics::Client
     download(Epics::HPD)
   end
 
+  def HKD
+    download(Epics::HKD)
+  end
+
   def PTK(from, to)
     download(Epics::PTK, from, to)
   end
 
+  def HAC(from, to)
+    download(Epics::HAC, from, to)
+  end
+
   def save_keys(path)
     File.write(path, dump_keys)
   end
@@ -152,9 +175,7 @@ class Epics::Client
 
   def upload(order_type, document)
     order = order_type.new(self, document)
-
     res = post(url, order.to_xml).body
-
     order.transaction_id = res.transaction_id
 
     res = post(url, order.to_transfer_xml).body
@@ -165,6 +186,11 @@ class Epics::Client
   def download(order_type, *args)
     document = order_type.new(self, *args)
     res = post(url, document.to_xml).body
+    document.transaction_id = res.transaction_id
+
+    if res.segmented? && res.last_segment?
+      post(url, document.to_receipt_xml).body
+    end
 
     res.order_data
   end

data/lib/epics/generic_request.rb

@@ -1,6 +1,7 @@
 class Epics::GenericRequest
   extend Forwardable
   attr_accessor :client
+  attr_accessor :transaction_id
 
   def initialize(client)
     self.client = client
@@ -81,6 +82,34 @@ class Epics::GenericRequest
     }), nil, "utf-8").to_xml(save_with: Nokogiri::XML::Node::SaveOptions::AS_XML)
   end
 
+  def to_receipt_xml
+    Nokogiri::XML.parse(Gyoku.xml({
+      root => {
+        :"@xmlns:ds" => "http://www.w3.org/2000/09/xmldsig#",
+        :@xmlns => "urn:org:ebics:H004",
+        :@Version => "H004",
+        :@Revision => "1",
+        "header" => {
+          :@authenticate => true,
+          "static" => {
+            "HostID" => host_id,
+            "TransactionID" => transaction_id
+          },
+          "mutable" => {
+            "TransactionPhase" => "Receipt"
+          }
+        },
+        "AuthSignature" => auth_signature,
+        "body" => {
+          "TransferReceipt" => {
+            :@authenticate => true,
+            "ReceiptCode" => 0
+          }
+        }
+      }
+    }), nil, "utf-8").to_xml(save_with: Nokogiri::XML::Node::SaveOptions::AS_XML)
+  end
+
   def to_xml
     Nokogiri::XML.parse(Gyoku.xml(    {
       root => {

data/lib/epics/generic_upload_request.rb

@@ -2,7 +2,6 @@ class Epics::GenericUploadRequest < Epics::GenericRequest
 
   attr_accessor :key
   attr_accessor :document
-  attr_accessor :transaction_id
 
   def initialize(client, document)
     super(client)

data/lib/epics/hac.rb

@@ -0,0 +1,52 @@
+class Epics::HAC < Epics::GenericRequest
+  attr_accessor :from, :to
+
+  def initialize(client, from, to)
+    super(client)
+    self.from = from
+    self.to = to
+  end
+
+  def header
+    {
+      :@authenticate => true,
+      static: {
+        "HostID" => host_id,
+        "Nonce" => nonce,
+        "Timestamp" => timestamp,
+        "PartnerID" => partner_id,
+        "UserID" => user_id,
+        "Product" => {
+          :@Language => "de",
+          :content! => "EPICS - a ruby ebics kernel"
+        },
+        "OrderDetails" => {
+          "OrderType" => "HAC",
+          "OrderAttribute" => "DZHNN",
+          "StandardOrderParams" => {
+            "DateRange" => {
+              "Start" => from,
+              "End" => to
+            }
+          }
+        },
+        "BankPubKeyDigests" => {
+          "Authentication" => {
+            :@Version => "X002",
+            :@Algorithm => "http://www.w3.org/2001/04/xmlenc#sha256",
+            :content! => client.bank_x.public_digest
+          },
+          "Encryption" => {
+            :@Version => "E002",
+            :@Algorithm => "http://www.w3.org/2001/04/xmlenc#sha256",
+            :content! => client.bank_e.public_digest
+          }
+        },
+        "SecurityMedium" => "0000"
+     },
+      "mutable" => {
+        "TransactionPhase" => "Initialisation"
+      }
+    }
+  end
+end

data/lib/epics/hkd.rb

@@ -0,0 +1,40 @@
+class Epics::HKD < Epics::GenericRequest
+
+  def header
+    {
+      :@authenticate => true,
+      static: {
+        "HostID" => host_id,
+        "Nonce" => nonce,
+        "Timestamp" => timestamp,
+        "PartnerID" => partner_id,
+        "UserID" => user_id,
+        "Product" => {
+          :@Language => "de",
+          :content! => "EPICS - a ruby ebics kernel"
+        },
+        "OrderDetails" => {
+          "OrderType" => "HKD",
+          "OrderAttribute" => "DZHNN",
+          "StandardOrderParams/" => ""
+        },
+        "BankPubKeyDigests" => {
+          "Authentication" => {
+            :@Version => "X002",
+            :@Algorithm => "http://www.w3.org/2001/04/xmlenc#sha256",
+            :content! => client.bank_x.public_digest
+          },
+          "Encryption" => {
+            :@Version => "E002",
+            :@Algorithm => "http://www.w3.org/2001/04/xmlenc#sha256",
+            :content! => client.bank_e.public_digest
+          }
+        },
+        "SecurityMedium" => "0000"
+     },
+      "mutable" => {
+        "TransactionPhase" => "Initialisation"
+      }
+    }
+  end
+end

data/lib/epics/response.rb

@@ -8,7 +8,7 @@ class Epics::Response
   end
 
   def technical_error?
-    technical_code != "000000"
+    !["011000", "000000"].include?(technical_code)
   end
 
   def technical_code
@@ -16,7 +16,7 @@ class Epics::Response
   end
 
   def business_error?
-    business_code != "000000" && business_code != ""
+    !["", "000000"].include?(business_code)
   end
 
   def business_code
@@ -27,6 +27,14 @@ class Epics::Response
     !technical_error? & !business_error?
   end
 
+  def last_segment?
+    !!doc.at_xpath("//xmlns:header/xmlns:mutable/*[@lastSegment='true']")
+  end
+
+  def segmented?
+    !!doc.at_xpath("//xmlns:header/xmlns:mutable/xmlns:SegmentNumber")
+  end
+
   def return_code
     doc.xpath("//xmlns:ReturnCode").last.content
   rescue NoMethodError
@@ -38,7 +46,7 @@ class Epics::Response
   end
 
   def transaction_id
-    doc.xpath("//xmlns:TransactionID").first.content
+    doc.xpath("//xmlns:header/xmlns:static/xmlns:TransactionID").text
   end
 
   def digest_valid?

data/lib/epics/version.rb

@@ -1,3 +1,3 @@
 module Epics
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/spec/client_spec.rb

@@ -22,6 +22,14 @@ RSpec.describe Epics::Client do
 
   end
 
+  describe '#inspect' do
+    it 'will not print the complete object' do
+      expect(subject.inspect).to include("@keys=#{subject.keys.keys}")
+      expect(subject.inspect).to include("@user_id=#{subject.user_id}")
+      expect(subject.inspect).to include("@partner_id=#{subject.partner_id}")
+    end
+  end
+
   describe '#e' do
     it 'the encryption key' do
       expect(subject.e.public_digest).to eq("rwIxSUJAVEFDQ0sdYe+CybdspMllDG6ArNtdCzUbT1E=")

data/spec/fixtures/xml/sta_response.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ebicsResponse xmlns="urn:org:ebics:H004" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:org:ebics:H004 http://www.ebics.org/H004/ebics_response_H004.xsd" Version="H004" Revision="1">
+  <header authenticate="true">
+    <static>
+      <TransactionID>ECD6F062AAEDFA77250526A68CBEC549</TransactionID>
+      <NumSegments>1</NumSegments>
+    </static>
+    <mutable>
+      <TransactionPhase>Initialisation</TransactionPhase>
+      <SegmentNumber lastSegment="true">1</SegmentNumber>
+      <ReturnCode>000000</ReturnCode>
+      <ReportText>[EBICS_OK] OK</ReportText>
+    </mutable>
+  </header>
+  <AuthSignature>
+    <ds:SignedInfo>
+      <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
+      <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/>
+      <ds:Reference URI="#xpointer(//*[@authenticate='true'])">
+        <ds:Transforms>
+          <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
+        </ds:Transforms>
+        <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
+        <ds:DigestValue>OnY4VczV+1XfplpMS/SCKFWn+FDMge40X8TJ9pA6HEI=</ds:DigestValue>
+      </ds:Reference>
+    </ds:SignedInfo>
+    <ds:SignatureValue>Qiz8clr/Ym+wLpB8CzTuxKP5rgIR2P4SaX8O4gGZx0Di8Lzd4hsBO3koqIuX11NRZo0RYA5E/IKQCoYLepkcM4QHvLT37YidbrXsTZe6cml/yF8OdyRAcd/9U7AoA9GKENFk4lnBFfZYmM4ADK6wVOCE/ABaOk0NeCDDbxrKA75tfTxwxTvQBfUOHZ87LrZxuQf//L9pzmtI07/7GbsQX8ZceQq40SpBFZn/oRvT/Q38Qu2ZO59MZexJn+BTzlhpfv9fQGF/sgXkdhUkPTEW3nL4j7ehasq3CtySGO2RnEppohEvJ4m07RDtEY3OWyAAZoPFVpvnECM6pOLbIuR40w==</ds:SignatureValue>
+  </AuthSignature>
+  <body>
+    <DataTransfer>
+      <DataEncryptionInfo authenticate="true">
+        <EncryptionPubKeyDigest Algorithm="http://www.w3.org/2001/04/xmlenc#sha256" Version="E002">IUW05JB5cuCzRYYa4kIAZ2ehYVrLI3lKvxZvo1uP+ug=</EncryptionPubKeyDigest>
+        <TransactionKey>CPdd6ODXrCxHWpYrwS/5a3NIZ1R2SDscHHJSONc2I7g8ara7qv5Ra7H03W+336DPQLZQxH+EBRWdE2FQ1vrVTcypK6fkFarmO1dEtQt6Ka89AozC7aQMyp4yGl+zlF+XvFkJXZbRXgoEOPsgcG0xM6nKLXnr1ThYRFOoAasigLDGwqxliyhoR94F9dL7YB8Le/uZeRj78mNp4smkE5ZKKyPhwVx+0IW78YuVCSC2c2qbsMmm4evAvycdpLfuuoG4KVlNMIlvkKeBfMZFELcmeKKm85D2zPYkZ7cqG2IfAAp5qdS6K8P7RY4gtjUhOtP5mi8bZt/ZcjioUmIR9dAMnA==</TransactionKey>
+      </DataEncryptionInfo>
+      <OrderData>lJ/v1HvOYAZKTPkxULH4mOcUy01+EaAsxLzCPhtieAo9m5AtU5URdyBVfmclHbtWe3ELb02lR37bChynq0Esqpljxx7CiB+kl/bVs7XkNQQmtGPlh08O7ApJ7AHdKPFFvE+SM2OWpSwUrqJGtmyaU6s+RM66o/3Q0wvKi4y3+Q2jm8nkiWZpPfNt52g4ReE9Ge86o+L+EBOBgZm634L5Z/i6pq908mXBAklPdk1ERdEgWONaOeYYmB70FToplR1gINJEF2CnfAtD/wV+DuQFPDth+EWHqhe3a4xO0d9eJ55ou2QCYOPUC2g/qz1sp7GR74W7P5IWJdmnUEuPFsKJ6OvM+1V8S06jZGDa/QhUGDK8F3G/TMP09W1MsrlQTRr3YQ5H43+pMY7I6Jysze+X9OKZZTTpv4GmYm1USjmraGyMuPF3j9hrlmpttK+1gg2WzytCJO44YsZp9ckls8JNK4bT5uwTuomKZoRgmiIOTcMh4VP7V28TWj2XdF+T6rBFILTvQyXMOzvbe1kLwg2O31JDBdJ8X1fHCYJxKsIrYCSDPz4sha8h7QmHrCSFmjoXb+LUElnbLXZVRkY5/Dc73EM6Es3wAgjwSJK2asRqdqU0PhbS5qpIlgYKsNcb+Wes</OrderData>
+    </DataTransfer>
+    <ReturnCode authenticate="true">000000</ReturnCode>
+    <TimestampBankParameter authenticate="true">2013-12-09T15:14:30.000Z</TimestampBankParameter>
+  </body>
+</ebicsResponse>

data/spec/fixtures/xml/sta_response_continued.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ebicsResponse xmlns="urn:org:ebics:H004" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:org:ebics:H004 http://www.ebics.org/H004/ebics_response_H004.xsd" Version="H004" Revision="1">
+  <header authenticate="true">
+    <static>
+      <TransactionID>ECD6F062AAEDFA77250526A68CBEC549</TransactionID>
+      <NumSegments>2</NumSegments>
+    </static>
+    <mutable>
+      <TransactionPhase>Initialisation</TransactionPhase>
+      <SegmentNumber lastSegment="false">1</SegmentNumber>
+      <ReturnCode>000000</ReturnCode>
+      <ReportText>[EBICS_OK] OK</ReportText>
+    </mutable>
+  </header>
+  <AuthSignature>
+    <ds:SignedInfo>
+      <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
+      <ds:SignatureMethod Algorithm="http://www.w3.org/2001/04/xmldsig-more#rsa-sha256"/>
+      <ds:Reference URI="#xpointer(//*[@authenticate='true'])">
+        <ds:Transforms>
+          <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
+        </ds:Transforms>
+        <ds:DigestMethod Algorithm="http://www.w3.org/2001/04/xmlenc#sha256"/>
+        <ds:DigestValue>OnY4VczV+1XfplpMS/SCKFWn+FDMge40X8TJ9pA6HEI=</ds:DigestValue>
+      </ds:Reference>
+    </ds:SignedInfo>
+    <ds:SignatureValue>Qiz8clr/Ym+wLpB8CzTuxKP5rgIR2P4SaX8O4gGZx0Di8Lzd4hsBO3koqIuX11NRZo0RYA5E/IKQCoYLepkcM4QHvLT37YidbrXsTZe6cml/yF8OdyRAcd/9U7AoA9GKENFk4lnBFfZYmM4ADK6wVOCE/ABaOk0NeCDDbxrKA75tfTxwxTvQBfUOHZ87LrZxuQf//L9pzmtI07/7GbsQX8ZceQq40SpBFZn/oRvT/Q38Qu2ZO59MZexJn+BTzlhpfv9fQGF/sgXkdhUkPTEW3nL4j7ehasq3CtySGO2RnEppohEvJ4m07RDtEY3OWyAAZoPFVpvnECM6pOLbIuR40w==</ds:SignatureValue>
+  </AuthSignature>
+  <body>
+    <DataTransfer>
+      <DataEncryptionInfo authenticate="true">
+        <EncryptionPubKeyDigest Algorithm="http://www.w3.org/2001/04/xmlenc#sha256" Version="E002">IUW05JB5cuCzRYYa4kIAZ2ehYVrLI3lKvxZvo1uP+ug=</EncryptionPubKeyDigest>
+        <TransactionKey>CPdd6ODXrCxHWpYrwS/5a3NIZ1R2SDscHHJSONc2I7g8ara7qv5Ra7H03W+336DPQLZQxH+EBRWdE2FQ1vrVTcypK6fkFarmO1dEtQt6Ka89AozC7aQMyp4yGl+zlF+XvFkJXZbRXgoEOPsgcG0xM6nKLXnr1ThYRFOoAasigLDGwqxliyhoR94F9dL7YB8Le/uZeRj78mNp4smkE5ZKKyPhwVx+0IW78YuVCSC2c2qbsMmm4evAvycdpLfuuoG4KVlNMIlvkKeBfMZFELcmeKKm85D2zPYkZ7cqG2IfAAp5qdS6K8P7RY4gtjUhOtP5mi8bZt/ZcjioUmIR9dAMnA==</TransactionKey>
+      </DataEncryptionInfo>
+      <OrderData>lJ/v1HvOYAZKTPkxULH4mOcUy01+EaAsxLzCPhtieAo9m5AtU5URdyBVfmclHbtWe3ELb02lR37bChynq0Esqpljxx7CiB+kl/bVs7XkNQQmtGPlh08O7ApJ7AHdKPFFvE+SM2OWpSwUrqJGtmyaU6s+RM66o/3Q0wvKi4y3+Q2jm8nkiWZpPfNt52g4ReE9Ge86o+L+EBOBgZm634L5Z/i6pq908mXBAklPdk1ERdEgWONaOeYYmB70FToplR1gINJEF2CnfAtD/wV+DuQFPDth+EWHqhe3a4xO0d9eJ55ou2QCYOPUC2g/qz1sp7GR74W7P5IWJdmnUEuPFsKJ6OvM+1V8S06jZGDa/QhUGDK8F3G/TMP09W1MsrlQTRr3YQ5H43+pMY7I6Jysze+X9OKZZTTpv4GmYm1USjmraGyMuPF3j9hrlmpttK+1gg2WzytCJO44YsZp9ckls8JNK4bT5uwTuomKZoRgmiIOTcMh4VP7V28TWj2XdF+T6rBFILTvQyXMOzvbe1kLwg2O31JDBdJ8X1fHCYJxKsIrYCSDPz4sha8h7QmHrCSFmjoXb+LUElnbLXZVRkY5/Dc73EM6Es3wAgjwSJK2asRqdqU0PhbS5qpIlgYKsNcb+Wes</OrderData>
+    </DataTransfer>
+    <ReturnCode authenticate="true">000000</ReturnCode>
+    <TimestampBankParameter authenticate="true">2013-12-09T15:14:30.000Z</TimestampBankParameter>
+  </body>
+</ebicsResponse>

data/spec/orders/c52_spec.rb

@@ -0,0 +1,11 @@
+RSpec.describe Epics::C52 do
+
+  let(:client) { Epics::Client.new( File.open(File.join( File.dirname(__FILE__), '..', 'fixtures', 'SIZBN001.key')), 'secret' , 'https://194.180.18.30/ebicsweb/ebicsweb', 'SIZBN001', 'EBIX', 'EBICS') }
+
+  subject { described_class.new(client, "2014-09-01", "2014-09-30") }
+
+  describe '#to_xml' do
+    specify { expect(subject.to_xml).to be_a_valid_ebics_doc }
+  end
+
+end

data/spec/orders/c53_spec.rb

@@ -0,0 +1,11 @@
+RSpec.describe Epics::C53 do
+
+  let(:client) { Epics::Client.new( File.open(File.join( File.dirname(__FILE__), '..', 'fixtures', 'SIZBN001.key')), 'secret' , 'https://194.180.18.30/ebicsweb/ebicsweb', 'SIZBN001', 'EBIX', 'EBICS') }
+
+  subject { described_class.new(client, "2014-09-01", "2014-09-30") }
+
+  describe '#to_xml' do
+    specify { expect(subject.to_xml).to be_a_valid_ebics_doc }
+  end
+
+end

data/spec/orders/hac_spec.rb

@@ -0,0 +1,11 @@
+RSpec.describe Epics::HAC do
+
+  let(:client) { Epics::Client.new( File.open(File.join( File.dirname(__FILE__), '..', 'fixtures', 'SIZBN001.key')), 'secret' , 'https://194.180.18.30/ebicsweb/ebicsweb', 'SIZBN001', 'EBIX', 'EBICS') }
+
+  subject { described_class.new(client, "2014-09-01", "2014-09-30") }
+
+  describe '#to_xml' do
+    specify { expect(subject.to_xml).to be_a_valid_ebics_doc }
+  end
+
+end

data/spec/orders/hkd_spec.rb

@@ -0,0 +1,11 @@
+RSpec.describe Epics::HKD do
+
+  let(:client) { Epics::Client.new( File.open(File.join( File.dirname(__FILE__), '..', 'fixtures', 'SIZBN001.key')), 'secret' , 'https://194.180.18.30/ebicsweb/ebicsweb', 'SIZBN001', 'EBIX', 'EBICS') }
+
+  subject { described_class.new(client) }
+
+  describe '#to_xml' do
+    specify { expect(subject.to_xml).to be_a_valid_ebics_doc }
+  end
+
+end

data/spec/orders/sta_spec.rb

@@ -8,4 +8,10 @@ RSpec.describe Epics::STA do
     specify { expect(subject.to_xml).to be_a_valid_ebics_doc }
   end
 
+  describe '#to_receipt_xml' do
+    before { subject.transaction_id = SecureRandom.hex(16) }
+
+    specify { expect(subject.to_receipt_xml).to be_a_valid_ebics_doc }
+  end
+
 end

data/spec/response_spec.rb

@@ -1,21 +1,25 @@
 RSpec.describe Epics::Response do
   let(:client) { Epics::Client.new( File.open(File.join( File.dirname(__FILE__), 'fixtures', 'SIZBN001.key')), 'secret' , 'https://194.180.18.30/ebicsweb/ebicsweb', 'SIZBN001', 'EBIX', 'EBICS') }
-  subject { described_class.new( client, File.read('spec/fixtures/xml/upload_init_response.xml') ) }
+  subject { described_class.new( client, ebics_response ) }
 
   describe '#digest_valid?' do
+    let(:ebics_response) { File.read('spec/fixtures/xml/upload_init_response.xml') }
+
     it 'checks if //ds:DigestValue matches the calculated digest' do
       expect(subject.digest_valid?).to be(true)
     end
   end
 
   describe '#signature_valid?' do
+    let(:ebics_response) { File.read('spec/fixtures/xml/upload_init_response.xml') }
+
     it 'checks if the signature value can be verified with the bank key' do
       expect(subject.signature_valid?).to be(true)
     end
   end
 
   describe '#public_digest_valid?' do
-    subject { described_class.new( client, File.read('spec/fixtures/xml/hpb_response.xml') ) }
+    let(:ebics_response) { File.read('spec/fixtures/xml/hpb_response.xml') }
 
     it "checks if //xmlns:EncryptionPubKeyDigest matches the user encryption key" do
       expect(subject.public_digest_valid?).to be(true)
@@ -23,12 +27,54 @@ RSpec.describe Epics::Response do
   end
 
   describe 'order_data' do
+    let(:ebics_response) { File.read('spec/fixtures/xml/hpb_response.xml') }
     let(:order_data) { File.read('spec/fixtures/xml/hpb_response_order.xml') }
-    subject { described_class.new( client, File.read('spec/fixtures/xml/hpb_response.xml') ) }
 
     it "retrieves the decrypted order data" do
       expect(subject.order_data).to eq(order_data)
     end
   end
 
+  describe '#transaction_id' do
+    let(:ebics_response) { File.read('spec/fixtures/xml/sta_response.xml') }
+    it 'pulls the transaction_id from the response' do
+      expect(subject.transaction_id).to eq('ECD6F062AAEDFA77250526A68CBEC549')
+    end
+  end
+
+  describe '#last_segment?' do
+    describe 'when its the last segement' do
+      let(:ebics_response) { File.read('spec/fixtures/xml/sta_response.xml') }
+
+      it 'will be true' do
+        expect(subject.last_segment?).to be(true)
+      end
+    end
+
+    describe 'when there are more segments' do
+      let(:ebics_response) { File.read('spec/fixtures/xml/sta_response_continued.xml') }
+      it 'will be false' do
+        expect(subject.last_segment?).to be(false)
+      end
+    end
+  end
+
+  describe '#segmented?' do
+    describe 'when the response is segemnted' do
+      let(:ebics_response) { File.read('spec/fixtures/xml/sta_response.xml') }
+
+      it 'will be true' do
+        expect(subject.segmented?).to be(true)
+      end
+    end
+
+    describe 'when the response is not segemnted' do
+      let(:ebics_response) { File.read('spec/fixtures/xml/hpb_response.xml') }
+
+      it 'will be false' do
+        expect(subject.segmented?).to be(false)
+      end
+    end
+  end
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: epics
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Lars Brillert
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-21 00:00:00.000000000 Z
+date: 2014-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -143,7 +143,7 @@ description: |2
       including the INI letter generation.
 
       Furthermore it offers support for the most common download types:
-        STA HAA HTD HPD PKT
+        STA HAA HTD HPD PKT HAC HKD C52 C53
 
       And the following upload orders:
         CD1 CDD CCT
@@ -156,6 +156,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- CHANGELOG.md
 - CONTRIBUTING.md
 - Gemfile
 - LICENSE.txt
@@ -163,6 +164,8 @@ files:
 - Rakefile
 - epics.gemspec
 - lib/epics.rb
+- lib/epics/c52.rb
+- lib/epics/c53.rb
 - lib/epics/cct.rb
 - lib/epics/cd1.rb
 - lib/epics/cdd.rb
@@ -171,7 +174,9 @@ files:
 - lib/epics/generic_request.rb
 - lib/epics/generic_upload_request.rb
 - lib/epics/haa.rb
+- lib/epics/hac.rb
 - lib/epics/hia.rb
+- lib/epics/hkd.rb
 - lib/epics/hpb.rb
 - lib/epics/hpd.rb
 - lib/epics/htd.rb
@@ -206,16 +211,22 @@ files:
 - spec/fixtures/xml/htd_order_data.xml
 - spec/fixtures/xml/ini.xml
 - spec/fixtures/xml/signature_pub_key_order_data.xml
+- spec/fixtures/xml/sta_response.xml
+- spec/fixtures/xml/sta_response_continued.xml
 - spec/fixtures/xml/upload_init_response.xml
 - spec/hpb_spec.rb
 - spec/key_spec.rb
 - spec/mgf_spec.rb
 - spec/middleware/parse_ebics_spec.rb
+- spec/orders/c52_spec.rb
+- spec/orders/c53_spec.rb
 - spec/orders/cct_spec.rb
 - spec/orders/cd1_spec.rb
 - spec/orders/cdd_spec.rb
 - spec/orders/haa_spec.rb
+- spec/orders/hac_spec.rb
 - spec/orders/hia_spec.rb
+- spec/orders/hkd_spec.rb
 - spec/orders/hpb_spec.rb
 - spec/orders/hpd_spec.rb
 - spec/orders/htd_spec.rb
@@ -287,16 +298,22 @@ test_files:
 - spec/fixtures/xml/htd_order_data.xml
 - spec/fixtures/xml/ini.xml
 - spec/fixtures/xml/signature_pub_key_order_data.xml
+- spec/fixtures/xml/sta_response.xml
+- spec/fixtures/xml/sta_response_continued.xml
 - spec/fixtures/xml/upload_init_response.xml
 - spec/hpb_spec.rb
 - spec/key_spec.rb
 - spec/mgf_spec.rb
 - spec/middleware/parse_ebics_spec.rb
+- spec/orders/c52_spec.rb
+- spec/orders/c53_spec.rb
 - spec/orders/cct_spec.rb
 - spec/orders/cd1_spec.rb
 - spec/orders/cdd_spec.rb
 - spec/orders/haa_spec.rb
+- spec/orders/hac_spec.rb
 - spec/orders/hia_spec.rb
+- spec/orders/hkd_spec.rb
 - spec/orders/hpb_spec.rb
 - spec/orders/hpd_spec.rb
 - spec/orders/htd_spec.rb