Project

nordea-filetransfer

0.01
No commit activity in last 3 years
No release in over 3 years
nordea-filetransfermak-it/nordea-filetransferDocumentationSource CodeBug Tracker
Ruby client for Nordea FileTransfer Web Services
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
4,397
Stars
8
Forks
6
Watchers
25
 Releases
Current version
0.2.1
Total releases
1
First release
2013-04-03
Latest release
2013-04-03
 Issues
Open Issues
0
Closed Issues
1
Total Issues
1
Issue Closure Rate
100%
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
1
Pull Request Acceptance Rate
100%
 Development
Primary Language
Ruby
Average date of last 50 commits
2013-02-07
Reverse Dependencies
0

 Dependencies

Development

awesome_print
>= 0
debugger
>= 0
fakeweb
>= 0
rake
>= 0.9.2.2
redcarpet
>= 0
rspec
~> 2.11
simplecov
>= 0
vcr
>= 0
yard
>= 0

Runtime

activesupport
>= 3.0
savon
~> 1.0.0
signer
~> 1.1.1
virtus
~> 0.5.1
 Project Readme

Ruby client for Nordea FileTransfer

         Payload                ApplicationRequest           SOAP Envelope
   +-------------------+     +---------------------+     +--------------------+
 C |                   |     |                     |     |                    |
 O |   Content         |     |   Customer ID       |     |    SOAP Header     |
 R |                   |     |   Timestamp         |     | +----------------+ |
 P |                   |     |   Environment       |     | | Signature      | |
 O |                   |     |   Target ID         |     | | ...            | |
 R |                   |     |   Encryption        |     | +----------------+ |
 A |                   |     |   Compression       |     |                    |
 T |                   |     |   Software ID       |     |                    |
 E |                   |     |   File Type         |     |                    |
   |                   |     | +-----------------+ |     |                    |
 L |                   +-------> Content Base64  | |     |     SOAP Body      |
 E |                   |     | +-----------------+ |     | +----------------+ |
 G |                   |     |                     |     | | Request Header | |
 A |                   |     |                     +-------> AppReq Base64  | |
 C |                   |     |                     |     | +----------------+ |
 Y |                   |     |                     |     |                    |
   +-------------------+     +---------------------+     +--------------------+

   1.          | 2.      | 3.                   | 4.        | 5.
   Generate    | Import  | Builds XML structure | Transport | Creates WS Message
   Legacy data | Payload | and signs it         | App.Req.  | and signs it

Installation

$ gem install nordea-filetransfer

Usage

require "nordea/file_transfer"

Nordea::FileTransfer.configure do |config|
  config.language = "EN"
  config.environment = "PRODUCTION"
  config.user_agent = "Ruby"
  config.software_id = "Ruby"
  config.cert_file = "path/to/cert.pem"
  config.private_key_file = "path/to/key.pem"
  config.sender_id = 11111111
end

client = Nordea::FileTransfer::Client.new

response = client.get_user_info do |header, request|
  header.receiver_id  = 123456789
  request.customer_id = 162355330
end

response.response_header
# => Nordea::FileTransfer::ResponseHeader

response.application_response
# => Nordea::FileTransfer::ApplicationResponse

Get User Info

The service will provide the client with information of authorized user file types and service ID’s.

response = client.get_user_info do |header, request|
  header.receiver_id  = 123456789
  request.customer_id = 162355330,
end

response.application_response.user_file_types
# => [Nordea::FileTransfer::UserFileType, ...]

Download File List

The service will provide the client with a list of files that are available for download from Nordea.

response = client.download_file_list do |header, request|
  header.receiver_id  = 123456789
  request.customer_id = 162355330
  request.status      = "ALL"
  request.target_id   = "11111111A1"
  request.file_type   = "NDCORPAYL"
end

response.application_response.file_descriptors
# => [Nordea::FileTransfer::FileDescriptor, ...]

Download File

The service will provide the client with requested files. Downloadable files can be checked by DownloadFileList –service. The query may be:

  • download single file
  • download multiple files
  • download all files of type
  • download all files
response = client.download_file do |header, request|
  header.receiver_id      = 123456789
  request.customer_id     = 162355330
  request.file_references = ["2012082621423418"]
  request.target_id       = "11111111A1"
  request.file_type       = "VKEUR"
end

response.application_response.content
# => VK0100020120821154650Listakurssit alle 40.000 eur maksuille 21.08.12 15:35
#    VK01001199901010730000001EUREUR00000100000000000010000000000001000000000000100000000000010000000+K000000000K
#    VK01001201208211535490001USDEUR00000124280000000012578000000001227800000000127180000000012138000+K000000000K
#    VK01001201208211535470001JPYEUR00009881000000001008100000000096810000000010252000000000951000000+K000000000K
#    ...

Upload File

The Service will provide the transport of the customers file to Nordea. The response from Nordea will be a transport acknowledgement with details regarding the status of the transport.

Backend system will process the files in batch mode. This means that the only verification of a file transfer, successful or not, will be a transfer acknowledgement. The client will not usually receive any other notification and the result must be retrieved with a new call later.

response = client.upload_file do |header, request|
  header.receiver_id      = 123456789
  request.customer_id     = 162355330
  request.target_id       = "11111111A1"
  request.service_id      = "0012345678"
  request.file_type       = "CNFTC000S"
  request.user_filename   = "TEST.TXT"
  request.content         = "..."
end

References