sepa_king_codeur 0.12.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 57f71b7126e13285e3c08f47dd860f2144924a9f87e9ec4eb3eb121b2a36aa57
+  data.tar.gz: 861c233545df462a3bd4ca9d2f3756bc79cefaec0b0c69a967ab0e51f005665b
+SHA512:
+  metadata.gz: 32c1f3589e7cf1ff64eafeed22763099ae549aa0ab5053257872868861a50e4f3c35e8066379a3144afb54307c0b0f186b98eb0b490f0c8b08c43622d4db2219
+  data.tar.gz: 17b71ed8d94489b00bd90ae0be98eac5fbf8d9f35566e532c3b9ea45328de194ed743a179ec394aebe7daa42a9c6a677b2499445cd0c7fd12c3a9c6ac87e33fd

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,37 @@
+rvm:
+  - 2.2.10
+  - 2.3.8
+  - 2.4.6
+  - 2.5.5
+  - 2.6.3
+gemfile:
+  - 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
+  - gemfiles/Gemfile-activemodel-5.2.x
+  - gemfiles/Gemfile-activemodel-6.0.x
+matrix:
+  exclude:
+    - rvm: 2.2.10
+      gemfile: gemfiles/Gemfile-activemodel-6.0.x
+    - rvm: 2.3.8
+      gemfile: gemfiles/Gemfile-activemodel-6.0.x
+    - rvm: 2.4.6
+      gemfile: gemfiles/Gemfile-activemodel-4.1.x
+    - rvm: 2.4.6
+      gemfile: gemfiles/Gemfile-activemodel-4.2.x
+    - rvm: 2.4.6
+      gemfile: gemfiles/Gemfile-activemodel-6.0.x
+    - rvm: 2.5.5
+      gemfile: gemfiles/Gemfile-activemodel-4.1.x
+    - rvm: 2.5.5
+      gemfile: gemfiles/Gemfile-activemodel-4.2.x
+    - rvm: 2.6.3
+      gemfile: gemfiles/Gemfile-activemodel-4.1.x
+    - rvm: 2.6.3
+      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-2019 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,297 @@
+# 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.2 or newer
+* ActiveModel 3.1 or newer (including 6.0)
+
+
+## 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'
+  )
+
+  # OPTIONAL: Specify the country & address of the debtor (REQUIRED for SEPA debits outside of EU. The individually required fields depend on the target country)
+  debtor_address: SEPA::DebtorAddress.new(
+    country_code:        'CH',
+    # Not required if individual fields are used
+    address_line1:       'Mustergasse 123a',
+    address_line2:       '1234 Musterstadt'
+    # Not required if address_line1 and address_line2 are used
+    street_name:         'Mustergasse',
+    building_number:     '123a',
+    post_code:           '1234',
+    town_name:           'Musterstadt'
+  )
+)
+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'
+
+  # OPTIONAL: Unstructured information to indicate the purpose of the payment
+  # String, max. 4 char
+  category_purpose:         'SALA',
+
+  # OPTIONAL: Specify the country & address of the creditor (REQUIRED for SEPA debits outside of EU. The individually required fields depend on the target country)
+  creditor_address: SEPA::CreditorAddress.new(
+    country_code:        'CH',
+    # Not required if individual fields are used
+    address_line1:       'Mustergasse 123a',
+    address_line2:       '1234 Musterstadt'
+    # Not required if address_line1 and address_line2 are used
+    street_name:         'Mustergasse',
+    building_number:     '123a',
+    post_code:           '1234',
+    town_name:           'Musterstadt'
+  )
+)
+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-2019 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.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'