klarna 0.1.3

data/lib/klarna/api/methods/reservation.rb

@@ -0,0 +1,149 @@
+# encoding: utf-8
+
+module Klarna
+  module API
+    module Methods
+      module Reservation
+
+        # Reserve a purchase amount for a specific customer. The reservation is valid, by default, for 7 days.
+        # Pass cellphone no. instead of Pno for SMS payments.
+        #
+        def reserve_amount(pno_or_cellphone, amount, goods_list, reference, reference_code, order_id_1, order_id_2,
+                            client_ip, shipping_address, invoicing_address, email, phone, cell_phone,
+                            currency_code, country_code, language_code, pno_encoding, pclass, annual_salary = nil, flags = nil)
+          # params = [
+          #   pno_or_cellphone,
+          #   amount,
+          #   reference,
+          #   reference_code,
+          #   order_id_1,
+          #   order_id_2,
+          #   shipping_address,
+          #   invoicing_address,
+          #   email,
+          #   phone,
+          #   cell_phone,
+          #   client_ip,
+          #   flags,
+          #   currency_code,
+          #   country_code,
+          #   language_code,
+          #   self.store_id,
+          #   self.digest(pno_or_cellphone, amount),
+          #   pno_encoding,
+          #   (pclass || KRED_DEFAULT_PCLASS),
+          #   (annual_salary || KRED_DEFAULT_YSALARY),
+          #   goods_list
+          # ]
+          # self.call(:reserve_amount, *params)
+          raise NotImplementedError
+        end
+
+        # Activate purchases which have been previously reserved with the reserve_amount function.
+        #
+        def activate_reservation(reservation_id, pno, ocr, goods_list, reference, reference_code, order_id_1, order_id_2,
+                                 client_ip, shipping_address, invoicing_address, shipment_type, email, phone, cell_phone,
+                                 currency_code, country_code, language_code, pno_encoding, pclass, annual_salary = nil, flags = nil)
+          # params = [
+          #   reservation_id,
+          #   pno,
+          #   (ocr || KRED_DEFAULT_OCR),
+          #   goods_list,
+          #   reference,
+          #   reference_code,
+          #   order_id_1,
+          #   order_id_2,
+          #   shipping_address,
+          #   invoicing_address,
+          #   shipment_type,
+          #   email,
+          #   phone,
+          #   cell_phone,
+          #   client_ip,
+          #   flags,
+          #   currency_code,
+          #   country_code,
+          #   language_code,
+          #   self.store_id,
+          #   self.digest(pno, goods_list),
+          #   pno_encoding,
+          #   (pclass || KRED_DEFAULT_PCLASS),
+          #   (annual_salary || KRED_DEFAULT_YSALARY)
+          # ]
+          # self.call(:activate_reservation, *params)
+          raise NotImplementedError
+        end
+
+        # Cancel a reservation.
+        #
+        def cancel_reservation(reservation_id)
+          # params = [
+          #   reservation_id,
+          #   self.store_id,
+          #   self.digest(reservation_id)
+          # ]
+          # self.call(:cancel_reservation, *params)
+          raise NotImplementedError
+        end
+
+        # Split a reservation due to for example outstanding articles.
+        #
+        def split_reservation(reservation_id, split_amount, order_id_1, order_id_2, flags = nil)
+          # params = [
+          #   reservation_id,
+          #   split_amount,
+          #   order_id_1,
+          #   order_id_2,
+          #   flags.to_i,
+          #   self.store_id,
+          #   self.digest(reservation_id, split_amount)
+          # ]
+          # self.call(:split_reservation, *params)
+          raise NotImplementedError
+        end
+
+        # Change a reservation.
+        #
+        def change_reservation(reservation_id, new_amount)
+          # params = [
+          #   reservation_id,
+          #   new_amount,
+          #   self.store_id,
+          #   self.digest(reservation_id, new_amount)
+          # ]
+          # self.call(:change_reservation, *params)
+          raise NotImplementedError
+        end
+
+        # Reserves one or more OCR numbers for your store.
+        #
+        def reserve_ocr_numbers(number_of_ocrs)
+          # params = [
+          #   number_of_ocrs,
+          #   self.store_id,
+          #   self.digest(number_of_ocrs)
+          # ]
+          # self.call(:reserve_ocr_nums, *params)
+          raise NotImplementedError
+        end
+
+        # Create addresses for arguments such as the +activate_reservation+ function.
+        #
+        def make_reservation_address(first_name, last_name, street_address, zip, city, country_code, house_number = nil)
+          # {
+          #   :fname        => first_name,
+          #   :lname        => last_name,
+          #   :street       => street_address,
+          #   :zip          => zip,
+          #   :city         => city,
+          #   :country      => ::Klarna::API.id_for(:country, country_code),
+          #   :house_number => house_number
+          # }.with_indifferent_access
+          raise NotImplementedError
+        end
+        alias :mk_reservation_address :make_reservation_address
+
+      end
+    end
+  end
+end

data/lib/klarna/api/methods/standard.rb

@@ -0,0 +1,123 @@
+# encoding: utf-8
+
+module Klarna
+  module API
+    module Methods
+      module Standard
+
+        # Retrieve a customer’s address(es). Using this, the customer is not required to enter
+        # any information – only confirm the one presented to him/her.
+        # Can also be used for companies: If the customer enters a company number,
+        # it will return all the addresses where the company is registered at.
+        #
+        # == Note:
+        #
+        #   ONLY allowed to be used for Swedish persons with the following conditions:
+        #
+        #     * It can be only used if invoice or part payment is the default payment method
+        #     * It has to disappear if the customer chooses another payment method
+        #     * The button is not allowed to be called get address ("hämta adress"), but continue ("fortsätt")
+        #       or it can be picked up automatically when all the numbers have been typed.
+        #
+        #   In the other Nordic countries you will have to have input fields for name, last name, street name,
+        #   zip code and city so that the customer can enter this information by himself.
+        #
+        def get_addresses(pno, pno_encoding, address_type = :GIVEN)
+          pno = pno.to_s.gsub(/[\W]/, '')
+          pno_encoding = ::Klarna::API.id_for(:pno_format, pno_encoding)
+          address_type = ::Klarna::API.id_for(:address_format, address_type)
+          params = [
+            pno,
+            self.store_id,
+            self.digest(pno),
+            pno_encoding,
+            address_type,
+            self.client_ip
+          ]
+          self.call(:get_addresses, *params).tap do |result|
+            result = result.first
+            result[5] = ::Klarna::API.id_for(:country, result[5]) # TODO: Return symbol from ID
+          end
+        end
+
+        # Same as +get_addresses+ but returns only first address.
+        #
+        def get_address(*args)
+          self.get_addresses(*args).first
+        end
+
+        # Create addresses (i.e. the +address+ argument to the +add_transaction+ method).
+        #
+        def make_address(co_address, street_address, zip, city, country, phone, cell_phone, email,
+                          house_number = nil, house_extension = nil)
+          country = ::Klarna::API.id_for(:country, country)
+          phone = phone.to_s.gsub(/[\W\s\t]/, '')
+          cell_phone = cell_phone.to_s.gsub(/[\W\s\t]/, '')
+          {
+            :careof  => co_address,
+            :street  => street_address,
+            :postno  => zip,
+            :city    => city,
+            :country => country,
+            :telno   => phone,
+            :cellno  => cell_phone,
+            :email   => email
+          }.with_indifferent_access
+        end
+        alias :mk_address :make_address
+
+        # Create an inventory (i.e. the +goods_list+ argument) to the +add_transaction+ function.
+        #
+        # == Flags:
+        #
+        # Argument +flags+ can be used to set the precision of the article, to indicate a shipment
+        # or a fee or sending the price with VAT.
+        #
+        # By using either +PRINT_1000+, +PRINT_100+, or +PRINT_10+, the +flags+
+        # function can be used to set article quantity (+quantity+). Unit is either +1/10+, +1/100+
+        # or +1/1000+. This is useful for goods measured in meters or kilograms, rather than number of items.
+        #
+        # By using the +IS_SHIPMENT+ or +IS_HANDLING+ flags a shipping or handling fee can
+        # be applied. The fees are sent excluding VAT with the arguments +shipping_fee+ or +handling_fee+.
+        #
+        # By using the +INC_VAT+ flag, you can send the price including VAT.
+        #
+        # == Note:
+        #
+        #   If you are implementing sales with Euros, use the function mk_goods_flags instead
+        #   since using this method can result in round off problems. With +mk_goods_flags+ you
+        #   are able to send the price with VAT.
+        #
+        def make_goods(quantity, article_no, title, price, vat, discount = nil, flags = nil)
+          flags = ::Klarna::API.parse_flags(:GOODS, flags)
+          goods = {
+            :goods => {
+              :artno     => article_no,
+              :title     => title,
+              :price     => price.to_i,
+              :vat       => vat.to_f.round(2),
+              :discount  => discount.to_f.round(2),
+            },
+            :qty => quantity.to_i
+          }
+          goods[:goods].merge!(:flags => flags.to_i) # if flags.present?
+          goods.with_indifferent_access
+        end
+        alias :mk_goods :make_goods
+        alias :mk_goods_flags :make_goods
+
+        # Check if a user has an account.
+        #
+        def has_account?(pno, pno_encoding)
+          params = [
+            self.store_id,
+            self.digest(pno),
+            pno_encoding
+          ]
+          self.call(:has_account, *params)
+        end
+
+      end
+    end
+  end
+end

data/lib/klarna/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+module Klarna
+  VERSION = '0.1.3'
+end

data/test/fixtures/api/companies.yml

@@ -0,0 +1,97 @@
+# Here are Klarnas test COMPANIES.
+# All approved persons have unlimited credit and the system will never accept purchases from the not approved ones.
+#
+# Purchases done with the test persons will be displayed in Klarna Online as regular invoices, although they will
+# unvisible unless you have "Yes" selected next to "Display test invoices" when searching for invoices.
+#
+# We will not pay for the invoices created with the test persons nor companies and we will not collect any fees as well.
+
+companies:
+  se:
+    approved:
+      cno: "6020310139"
+      name: "Kalle Anka AB"
+      street_address: "Storgatan 1"
+      postal_code: "12345"
+      city: "Ankeborg"
+      street_address_2: "Lillgatan 99"
+      postal_code_2: "77777"
+      city_2: "Ankeborg"
+      country: "SE"
+      cell_phone: "076 526 00 00"
+      currency: "SEK"
+      language: "SV"
+    unapproved:
+      cno: "6720217931"
+      name: "Björnligan AB"
+      street_address: "Fulgatan 1"
+      postal_code: "12345"
+      city: "Ankeborg"
+      street_address_2: "Bakgatan 99"
+      postal_code_2: "77777"
+      city_2: "Ankeborg"
+      country: "SE"
+      cell_phone: "076 526 00 00"
+      currency: "SEK"
+      language: "SV"
+
+  no:
+    # N/A
+
+  dk:
+    approved:
+      pno: "27968880"
+      first_name: ""
+      last_name: "Onbase ApS"
+      street_address: "Centrumgaden 37"
+      postal_code: "2750"
+      city: "Ballerup"
+      country: "DK"
+      cell_phone: "20 123 456"
+      currency: "DKK"
+      language: "DA"
+    unapproved:
+      pno: "99999993"
+      first_name: ""
+      last_name: "Larsen & Olsen Contracters ApS"
+      street_address: "Glarmestervej 2"
+      postal_code: "8600"
+      city: "Silkeborg"
+      street_address: "Kristianiagade 9"
+      postal_code: "2100"
+      city: "København Ø"
+      country: "DK"
+      cell_phone: "20 123 456"
+      currency: "DKK"
+      language: "DA"
+
+  fi:
+    approved:
+      pno: "10891871"
+      first_name: ""
+      last_name: "Porin Mies-Laulu r.y."
+      street_address: "Vapaudenkatu 10"
+      postal_code: "28100"
+      city: "Pori"
+      country: "FI"
+      cell_phone: "040 123 45 67"
+      currency: "EUR"
+      language: "FI"
+
+    unapproved:
+      pno: "07527622"
+      first_name: ""
+      last_name: "Mankalan Perhekodit Oy"
+      street_address: "Porrassalmenkatu 19 B"
+      postal_code: "50100"
+      city: "Parikkala"
+      country: "FI"
+      cell_phone: "040 123 45 67"
+      currency: "EUR"
+      language: "FI"
+
+  de:
+    # N/A
+
+  nl:
+    # N/A

data/test/fixtures/api/pclasses.yml

@@ -0,0 +1,37 @@
+# Pclass id number, Description, Amount of months for part payment, Start fee, Invoice fee, Interest rate, Minimum purchase amount for pclass
+
+pclasses:
+  sek:
+    390:
+      pclass_id: 390
+      description: "Konto"
+      months: 24
+      start_fee: 0
+      invoice_fee: 2900
+      interest_rate: 1950
+      minimum_purchase_amount: 100
+    121:
+      pclass_id: 121
+      description: "6 m\303\245n"
+      months: 6
+      start_fee: 19500
+      invoice_fee: 2900
+      interest_rate: 0
+      minimum_purchase_amount: 100000
+    120:
+      pclass_id: 120
+      description: "3 m\303\245n"
+      months: 3
+      start_fee: 9500
+      invoice_fee: 2900
+      interest_rate: 0
+      minimum_purchase_amount: 100000
+
+  nok:
+    # Not available (for some reason)
+
+  dkk:
+    # Not available (for some reason)
+
+  eur:
+    # Not available (for some reason)

data/test/fixtures/api/persons.yml

@@ -0,0 +1,144 @@
+# Here are Klarnas test PERSONS.
+# All approved persons have unlimited credit and the system will never accept purchases from the not approved ones.
+#
+# Purchases done with the test persons will be displayed in Klarna Online as regular invoices, although they will
+# unvisible unless you have "Yes" selected next to "Display test invoices" when searching for invoices.
+#
+# We will not pay for the invoices created with the test persons nor companies and we will not collect any fees as well.
+
+persons:
+  se:
+    approved:
+      pno: "4304158399"
+      first_name: "Karl"
+      last_name: "Lidin"
+      street_address: "Junibackg. 42"
+      postal_code: "23634"
+      city: "Hollviken"
+      country: "SE"
+      cell_phone: "076 526 00 00"
+      currency: "SEK"
+      language: "SV"
+    unapproved:
+      pno: "5311096845"
+      first_name: "Maud"
+      last_name: "Johansson"
+      street_address: "Köpmansgatan 7"
+      postal_code: "12149"
+      city: "Johanneshov"
+      country: "SE"
+      cell_phone: "076 526 00 00"
+      currency: "SEK"
+      language: "SV"
+
+  no:
+    approved:
+      pno: "18106500157"
+      first_name: "Petter"
+      last_name: "Testmann"
+      street_address: "Hundremeterskogen 100"
+      postal_code: "0563"
+      city: "Oslo"
+      country: "NO"
+      cell_phone: "40 123 456"
+      currency: "NOK"
+      language: "NO"
+    unapproved:
+      pno: "18106500076"
+      first_name: "Petra"
+      last_name: "Testdame"
+      street_address: "Sofienberggate 56"
+      postal_code: "0563"
+      city: "Oslo"
+      country: "NO"
+      cell_phone: "40 123 456"
+      currency: "NOK"
+      language: "NO"
+
+  dk:
+    approved:
+      pno: "0505610059"
+      first_name: "Rasmus Jens-Peter"
+      last_name: "Lybert"
+      street_address: "Godthåbvej 8,-2"
+      postal_code: "3900"
+      city: "Godthåb"
+      country: "DK"
+      cell_phone: "20 123 456"
+      currency: "DKK"
+      language: "DA"
+    unapproved:
+      # N/A
+
+  # fi:
+  #   approved:
+  #     pno: "230246-8989"
+  #     first_name: "Suvi"
+  #     last_name: "Aurinkoinen"
+  #     street_address: "Planeettatie 2"
+  #     postal_code: "01450"
+  #     city: "Vantaa"
+  #     country: "FI"
+  #     cell_phone: "0401234567
+  #     currency: "EUR"
+  #     language: "FI"
+  #   unapproved:
+  #     pno: "010130-887T"
+  #     first_name: "Mikael"
+  #     last_name: "Miehinen"
+  #     street_address: "Tikkuritie 11"
+  #     postal_code: "01370"
+  #     city: "Vantaa"
+  #     country: "FI"
+  #     cell_phone: "0401234567"
+  #     currency: "EUR"
+  #     language: "FI"
+  #
+  de:
+    approved:
+      pno: "070719601"
+      first_name: "Uno"
+      last_name: "Eins"
+      street_address: "Hellersbergstrasse 14"
+      postal_code: "41460"
+      city: "Neuss"
+      country: "DE"
+      cell_phone: "015 2211 3356"
+      currency: "EUR"
+      language: "DE"
+    unapproved:
+      pno: "07071950"
+      first_name: "Uno"
+      last_name: "Vier"
+      street_address: "Hellersbergstrasse 14"
+      postal_code: "41460"
+      city: "Neuss"
+      cell_phone: "015 2211 3356"
+      country: "DE"
+      currency: "EUR"
+      language: "DE"
+
+  nl:
+    approved:
+      pno:
+      first_name: "Test"
+      last_name: "Persoon"
+      street_address: "Neherkade 1"
+      postal_code: "2521VA"
+      city: "Gravenhage"
+      country: "NL"
+      cell_phone: "0612345678"
+      currency: "EUR"
+      language: "NL"
+    unapproved:
+      # Only a few details available.
+      pno:
+      first_name:
+      last_name:
+      street_address:
+      postal_code:
+      city:
+      country: "NL"
+      cell_phone: "0612345678"
+      currency: "EUR"
+      language: "NL"