sepa_king_extended 0.10.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 68e290efdadafcefde07e7dfd18d52d0f028984a
+  data.tar.gz: 8ee6a6c2e0c2fe238eb29a76c90380fcf5b9e533
+SHA512:
+  metadata.gz: df42581c1870f90fa12c018d5eb5ab86561fe7a00be3ce14aaf7ffd8be268e2543407d9c4c9ba1e9f41d95d3be9b1d31a75534360c185d577d814fed54e963cd
+  data.tar.gz: bd9b798d22a70f1869dd7ed70cc6bd25fb062b1874f40ea6adae1ece7427ea5ce60462c3e95b824439ce482eb21c068c1c8097154808151e23daafbac149aacf

data/.gitignore

@@ -0,0 +1,9 @@
+nbproject/*
+.rvmrc
+coverage/*
+rdoc/*
+pkg/*
+.DS_Store
+Gemfile.lock
+# tmp disable
+docs/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.travis.yml

@@ -0,0 +1,30 @@
+rvm:
+  - 2.0.0
+  - 2.1.10
+  - 2.2.8
+  - 2.3.5
+  - 2.4.2
+gemfile:
+  - gemfiles/Gemfile-activemodel-3.0.x
+  - gemfiles/Gemfile-activemodel-3.1.x
+  - gemfiles/Gemfile-activemodel-3.2.x
+  - gemfiles/Gemfile-activemodel-4.0.x
+  - gemfiles/Gemfile-activemodel-4.1.x
+  - gemfiles/Gemfile-activemodel-4.2.x
+  - gemfiles/Gemfile-activemodel-5.0.x
+  - gemfiles/Gemfile-activemodel-5.1.x
+matrix:
+  exclude:
+    - rvm: 2.0.0
+      gemfile: gemfiles/Gemfile-activemodel-5.1.x
+    - rvm: 2.1.10
+      gemfile: gemfiles/Gemfile-activemodel-5.1.x
+    - rvm: 2.0.0
+      gemfile: gemfiles/Gemfile-activemodel-5.0.x
+    - rvm: 2.1.10
+      gemfile: gemfiles/Gemfile-activemodel-5.0.x
+    - rvm: 2.4.2
+      gemfile: gemfiles/Gemfile-activemodel-4.1.x
+    - rvm: 2.4.2
+      gemfile: gemfiles/Gemfile-activemodel-4.2.x
+sudo: false

data/CONTRIBUTING.md

@@ -0,0 +1,38 @@
+We love pull requests. Here's a quick guide:
+
+1. Fork the repo.
+
+2. Run the tests. We only take pull requests with passing tests, and it's great
+to know that you have a clean slate: `bundle && rake`
+
+3. Add a test for your change. Only refactoring and documentation changes
+require no new tests. If you are adding functionality or fixing a bug, we need
+a test!
+
+4. Make the test pass.
+
+5. Push to your fork and submit a pull request.
+
+
+At this point you're waiting on us. We like to at least comment on, if not
+accept, pull requests within three business days (and, typically, one business
+day). We may suggest some changes or improvements or alternatives.
+
+Some things that will increase the chance that your pull request is accepted,
+taken straight from the Ruby on Rails guide:
+
+* Use Rails idioms and helpers
+* Include tests that fail without your code, and pass with it
+* Update the documentation, the surrounding one, examples elsewhere, guides,
+  whatever is affected by your contribution
+
+Syntax:
+
+* Two spaces, no tabs.
+* No trailing whitespace. Blank lines should not have any space.
+* Prefer &&/|| over and/or.
+* MyClass.my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
+* a = b and not a=b.
+* Follow the conventions you see used in the source already.
+
+And in case we didn't emphasize it enough: we love tests!

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013-2017 Georg Leciejewski (Sales King GmbH) & Georg Ledermann
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,267 @@
+# Ruby gem for creating SEPA XML files
+
+[![Build Status](https://travis-ci.org/salesking/sepa_king.svg)](http://travis-ci.org/salesking/sepa_king)
+[![Code Climate](https://codeclimate.com/github/salesking/sepa_king/badges/gpa.svg)](https://codeclimate.com/github/salesking/sepa_king)
+[![Coverage Status](https://coveralls.io/repos/salesking/sepa_king/badge.svg?branch=master)](https://coveralls.io/r/salesking/sepa_king?branch=master)
+[![Gem Version](https://badge.fury.io/rb/sepa_king.svg)](http://badge.fury.io/rb/sepa_king)
+[![Dependency Status](https://gemnasium.com/salesking/sepa_king.svg)](https://gemnasium.com/salesking/sepa_king)
+
+We love building payment applications! So after developing the [DTAUS library for Ruby](https://github.com/salesking/king_dtaus) we move on with SEPA.
+
+
+## Features
+
+This gem implements the following two messages out of the ISO 20022 standard:
+
+* Credit Transfer Initiation (`pain.001.003.03`, `pain.001.002.03` and `pain.001.001.03`)
+* Direct Debit Initiation (`pain.008.003.02`, `pain.008.002.02` and `pain.008.001.02`)
+
+It handles the _Specification of Data Formats_ v2.7 (2013-11-04).
+
+BTW: **pain** is a shortcut for **Pa**yment **In**itiation.
+
+
+## Requirements
+
+* Ruby 2.0.0 or newer
+* ActiveModel 3.0 or newer
+
+
+## Installation
+
+    gem install sepa_king
+
+
+## Usage
+
+How to create the XML for **Direct Debit Initiation** (in German: "Lastschriften")
+
+```ruby
+# First: Create the main object
+sdd = SEPA::DirectDebit.new(
+  # Name of the initiating party and creditor, in German: "Auftraggeber"
+  # String, max. 70 char
+  name:       'Gläubiger GmbH',
+
+  # OPTIONAL: Business Identifier Code (SWIFT-Code) of the creditor
+  # String, 8 or 11 char
+  bic:        'BANKDEFFXXX',
+
+  # International Bank Account Number of the creditor
+  # String, max. 34 chars
+  iban:       'DE87200500001234567890',
+
+  # Creditor Identifier, in German: Gläubiger-Identifikationsnummer
+  # String, max. 35 chars
+  creditor_identifier: 'DE98ZZZ09999999999'
+)
+
+# Second: Add transactions
+sdd.add_transaction(
+  # Name of the debtor, in German: "Zahlungspflichtiger"
+  # String, max. 70 char
+  name:                      'Zahlemann & Söhne GbR',
+
+  # OPTIONAL: Business Identifier Code (SWIFT-Code) of the debtor's account
+  # String, 8 or 11 char
+  bic:                       'SPUEDE2UXXX',
+
+  # International Bank Account Number of the debtor's account
+  # String, max. 34 chars
+  iban:                      'DE21500500009876543210',
+
+  # Amount
+  # Number with two decimal digit
+  amount:                    39.99,
+
+  # OPTIONAL: Currency, EUR by default (ISO 4217 standard)
+  # String, 3 char
+  currency:                  'EUR',
+
+  # OPTIONAL: Instruction Identification, will not be submitted to the debtor
+  # String, max. 35 char
+  instruction:               '12345',
+
+  # OPTIONAL: End-To-End-Identification, will be submitted to the debtor
+  # String, max. 35 char
+  reference:                 'XYZ/2013-08-ABO/6789',
+
+  # OPTIONAL: Unstructured remittance information, in German "Verwendungszweck"
+  # String, max. 140 char
+  remittance_information:    'Vielen Dank für Ihren Einkauf!',
+
+  # Mandate identifikation, in German "Mandatsreferenz"
+  # String, max. 35 char
+  mandate_id:                'K-02-2011-12345',
+
+  # Mandate Date of signature, in German "Datum, zu dem das Mandat unterschrieben wurde"
+  # Date
+  mandate_date_of_signature: Date.new(2011,1,25),
+
+  # Local instrument, in German "Lastschriftart"
+  # One of these strings:
+  #   'CORE' ("Basis-Lastschrift")
+  #   'COR1' ("Basis-Lastschrift mit verkürzter Vorlagefrist")
+  #   'B2B' ("Firmen-Lastschrift")
+  local_instrument: 'CORE',
+
+  # Sequence type
+  # One of these strings:
+  #   'FRST' ("Erst-Lastschrift")
+  #   'RCUR' ("Folge-Lastschrift")
+  #   'OOFF' ("Einmalige Lastschrift")
+  #   'FNAL' ("Letztmalige Lastschrift")
+  sequence_type: 'OOFF',
+
+  # OPTIONAL: Requested collection date, in German "Fälligkeitsdatum der Lastschrift"
+  # Date
+  requested_date: Date.new(2013,9,5),
+
+  # OPTIONAL: Enables or disables batch booking, in German "Sammelbuchung / Einzelbuchung"
+  # True or False
+  batch_booking: true
+
+  # OPTIONAL: Use a different creditor account
+  # CreditorAccount
+  creditor_account: SEPA::CreditorAccount.new(
+    name:                'Creditor Inc.',
+    bic:                 'RABONL2U',
+    iban:                'NL08RABO0135742099',
+    creditor_identifier: 'NL53ZZZ091734220000'
+  )
+)
+sdd.add_transaction ...
+
+# Last: create XML string
+xml_string = sdd.to_xml # Use latest schema pain.008.003.02
+xml_string = sdd.to_xml('pain.008.002.02') # Use former schema pain.008.002.02
+```
+
+
+How to create the XML for **Credit Transfer Initiation** (in German: "Überweisungen")
+
+```ruby
+# First: Create the main object
+sct = SEPA::CreditTransfer.new(
+  # Name of the initiating party and debtor, in German: "Auftraggeber"
+  # String, max. 70 char
+  name: 'Schuldner GmbH',
+
+  # OPTIONAL: Business Identifier Code (SWIFT-Code) of the debtor
+  # String, 8 or 11 char
+  bic:  'BANKDEFFXXX',
+
+  # International Bank Account Number of the debtor
+  # String, max. 34 chars
+  iban: 'DE87200500001234567890'
+)
+
+# Second: Add transactions
+sct.add_transaction(
+  # Name of the creditor, in German: "Zahlungsempfänger"
+  # String, max. 70 char
+  name:                   'Telekomiker AG',
+
+  # OPTIONAL: Business Identifier Code (SWIFT-Code) of the creditor's account
+  # String, 8 or 11 char
+  bic:                    'PBNKDEFF370',
+
+  # International Bank Account Number of the creditor's account
+  # String, max. 34 chars
+  iban:                   'DE37112589611964645802',
+
+  # Amount
+  # Number with two decimal digit
+  amount:                 102.50,
+
+  # OPTIONAL: Currency, EUR by default (ISO 4217 standard)
+  # String, 3 char
+  currency:               'EUR',
+
+  # OPTIONAL: Instruction Identification, will not be submitted to the creditor
+  # String, max. 35 char
+  instruction:               '12345',
+
+  # OPTIONAL: End-To-End-Identification, will be submitted to the creditor
+  # String, max. 35 char
+  reference:              'XYZ-1234/123',
+
+  # OPTIONAL: Unstructured remittance information, in German "Verwendungszweck"
+  # String, max. 140 char
+  remittance_information: 'Rechnung vom 22.08.2013',
+
+  # OPTIONAL: Requested execution date, in German "Ausführungstermin"
+  # Date
+  requested_date: Date.new(2013,9,5),
+
+  # OPTIONAL: Enables or disables batch booking, in German "Sammelbuchung / Einzelbuchung"
+  # True or False
+  batch_booking: true,
+
+  # OPTIONAL: Urgent Payment
+  # One of these strings:
+  #   'SEPA' ("SEPA-Zahlung")
+  #   'URGP' ("Taggleiche Eilüberweisung")
+  service_level: 'URGP'
+)
+sct.add_transaction ...
+
+# Last: create XML string
+xml_string = sct.to_xml # Use latest schema pain.001.003.03
+xml_string = sct.to_xml('pain.001.002.03') # Use former schema pain.001.002.03
+```
+
+## Validations
+
+You can rely on our internal validations, raising errors when needed, during
+message creation.
+To validate your models holding SEPA related information (e.g. BIC, IBAN,
+mandate_id) you can use our validator classes or rely on some constants.
+
+Examples:
+
+```ruby
+class BankAccount < ActiveRecord::Base
+  # IBAN validation, by default it validates the attribute named "iban"
+  validates_with SEPA::IBANValidator, field_name: :iban_the_terrible
+
+  # BIC validation, by default it validates the attribute named "bic"
+  validates_with SEPA::BICValidator, field_name: :bank_bic
+end
+
+class Payment < ActiveRecord::Base
+  validates_inclusion_of :sepa_sequence_type, in: SEPA::DirectDebitTransaction::SEQUENCE_TYPES
+
+  # Mandate ID validation, by default it validates the attribute named "mandate_id"
+  validates_with SEPA::MandateIdentifierValidator, field_name: :mandate_id
+end
+```
+
+**Beware:** The SEPA::IBANValidator is strict - e.g. it does not allow any spaces in the IBAN.
+
+Also see:
+* [lib/sepa_king/validator.rb](https://github.com/salesking/sepa_king/blob/master/lib/sepa_king/validator.rb)
+* [lib/sepa_king/transaction/direct_debit_transaction.rb](https://github.com/salesking/sepa_king/blob/master/lib/sepa_king/transaction/direct_debit_transaction.rb)
+
+
+## Changelog
+
+https://github.com/salesking/sepa_king/releases
+
+
+## Contributors
+
+https://github.com/salesking/sepa_king/graphs/contributors
+
+
+## Resources
+
+* http://www.ebics.de/index.php?id=77
+* SalesKing: http://salesking.eu
+
+
+## License
+
+Released under the MIT license
+
+Copyright (c) 2013-2017 Georg Leciejewski (SalesKing), Georg Ledermann (https://github.com/ledermann)

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/gemfiles/Gemfile-activemodel-3.0.x

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec path: '..'
+
+gem 'activemodel', '~>3.0.20'

data/gemfiles/Gemfile-activemodel-3.1.x

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec path: '..'
+
+gem 'activemodel', '~>3.1.12'

data/gemfiles/Gemfile-activemodel-3.2.x

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec path: '..'
+
+gem 'activemodel', '~>3.2.22.2'

data/gemfiles/Gemfile-activemodel-4.0.x

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec path: '..'
+
+gem 'activemodel', '~>4.0.13'

data/gemfiles/Gemfile-activemodel-4.1.x

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec path: '..'
+
+gem 'activemodel', '~>4.1.15'

data/gemfiles/Gemfile-activemodel-4.2.x

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec path: '..'
+
+gem 'activemodel', '~>4.2.6'

data/gemfiles/Gemfile-activemodel-5.0.x

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec path: '..'
+
+gem 'activemodel', '~> 5.0.0'

data/gemfiles/Gemfile-activemodel-5.1.x

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec path: '..'
+
+gem 'activemodel', '~> 5.1.0'