wheretocard 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9525b0d8a16b19b0ca6a24e94c14c0695fbad479
+  data.tar.gz: e023fb76f40ed4ed084f710b0f8845e4364904c1
+SHA512:
+  metadata.gz: 74b996595133f49ea3a67b3fcd64f7d0039676995d16ff6670d86554143250568a3ea586dcb561cd48feb45ceff6e585d1776ce8a0072623040ccf888cbd0b8e
+  data.tar.gz: b65fb0053e6d10167f7ac99832f79e10d0a9ea31d40015a32b15883de515943b7a7a7998ac8ec9a38534b8772fdbc051e8819cdf4cfac36eb44625d836154472

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/fixtures/

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.3
+before_install: gem install bundler -v 1.10.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in wheretocard.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Henk Meijer
+
+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,102 @@
+
+# Wheretocard
+
+The Wheretocard gem is a straight forward ruby binder for the Wheretocard API.
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'wheretocard'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install wheretocard
+
+## Usage
+
+To request two barcodes from two different ticket kinds (4 barcodes in total), you can do the following:
+
+
+```ruby
+# Setup the WtC client with credentials
+@wtc_client = Wheretocard::Client.new(
+                username: yourusername,
+                password: yourpassword,
+                client_code: yourclientcode,
+                case_code: yourcasecode
+              )
+
+# Check the credentials first, without making test orders
+@order.check_credentials("TICKET_KIND_1_CODE") #returns true or false
+
+# Initialize a new OrderRequest 
+@order_request = @wtc_client.order_request
+@order_request.first_name = "Foo"
+@order_request.last_name = "Bar"
+@order_request.email = "foobar@example.org"
+@order_request.delivery_type = "BARCODE" # ["TEXTCODE","BARCODE"]
+
+# Add line itmes to the request
+# Please note: the price is in cents (currency is EUR)
+@order_request.add_line_item(
+  product_code: TICKET_KIND_1_CODE,
+  quantity: 2,
+  price: 1250,
+  description: Action Description,
+  valid_from: Time.now,
+  valid_until: Time.now + 3.months
+)
+
+# It is also possible to not let WtC pick a barcode,
+# but to submit your own barcode by adding the 'barcode' param
+@order_request.add_line_item(
+  product_code: TICKET_KIND_3_CODE,
+  quantity: 2,
+  price: 1750,
+  description: Action Description,
+  barcode: "ABC12345"
+  valid_from: Time.now,
+  valid_until: Time.now + 3.months
+)
+
+
+# Submit the request and receive a response object
+@response = @order_request.submit
+
+# redirect the consumer to the PDF download page:
+if @response.success?
+	redirect_to @response.url
+    # => https://ticketing.wheretocard.nl/ticketService/print/printTicket?refId=xxx&ui=yyy
+else
+	# TODO: handle exception
+end
+
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/henkm/wheretocard.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+
+## Credits and disclaimer
+
+This gem is made with love by the smart people at [Eskes Media B.V.](http://www.eskesmedia.nl) and [dagjewegtickets.nl](https://www.dagjewegtickets.nl) 
+Wheretocard is not involved with this project and has no affiliation with Eskes Media B.V.

data/Rakefile

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

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "wheretocard"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/documentation/test_wtc_api.php

@@ -0,0 +1,243 @@
+<?php
+
+// test_wtc_api.php
+// 20160410/PPM Created
+
+// Warning: This scripts doesn't work without valid credentials in wtc_parameters
+
+
+test_wtc_api();
+
+
+// test_wtc_api()
+// Description: Send request, show result
+
+
+
+function xml_entities($string) {
+    return strtr(
+        $string, 
+        array(
+            "<" => "&lt;",
+            ">" => "&gt;",
+            '"' => "&quot;",
+            "'" => "&apos;",
+            "&" => "&amp;",
+        )
+    );
+}
+
+function convertdate_last2to($date_last){
+	$date_to = date('Y-m-d', strtotime($date_last.' + 1 day'));
+
+	return $date_to;
+}
+
+
+function test_wtc_api(){
+
+	// Initialize
+	$fname = __FUNCTION__;
+	$dbg = 1;
+
+	if($dbg>0){ echo "$fname()<br>\n"; }
+
+	// WtC parameters
+	$wtc_client_code = 'CLIENT_TICKETCOUNTER_API';
+	$wtc_case_code = 'TCAPI_CLIENT_NAME';
+	$wtc_client_username = 'username_api';
+	$wtc_client_password = 'rand0mpa55w0rd';
+	$wtc_request_url = 'https://ticketing.wheretocard.nl/ticketService/submitOrder';
+
+/*
+CLIENT_TICKETCOUNTER_API
+Case:
+TCAPI_CLIENT_NAME
+Apicodes:
+TICKET_KIND_1_API_CODE
+TICKET_KIND_2_API_CODE
+*/
+
+	// Construct name
+	$order_code = '1234';
+	$name = 'My Name';
+	$email = 'myemail@myemail.com';
+	$street = 'My Street';
+	$house_number = 123;
+	$postal_code = '1234AB';	
+	$city = 'My City';	
+
+	// To xml
+	$xml_order_code = xml_entities($order_code);
+	$xml_name = xml_entities($name);
+	$xml_email = xml_entities($email);
+	$xml_street = xml_entities($street);
+	$xml_house_number = xml_entities($house_number);
+	$xml_postal_code = xml_entities($postal_code);
+	$xml_city = xml_entities($city);
+
+	$properties_first_name = '';
+	$properties_infix = '';
+	$properties_last_name = $xml_name;
+	$properties_email = $xml_email;
+	$properties_street = $xml_street;
+	$properties_house_number = $xml_house_number;
+	$properties_postal_code = $xml_postal_code;
+	$properties_city = $xml_city;
+
+	if($dbg>0){ echo "$fname: prepare xml request ...<br>\n"; }
+
+	// Construct orderlines by constructing orderline items
+	// <orderline code="{{ reservation.producttypeperiodtime.producttypeperiod.producttype.code }}" ticket-ref="{{ reservation.number }}"><quantity>1</quantity><price>{{ reservation.price|makeCents }}</price><action>{{ reservation.producttypeperiodtime.producttypeperiod.producttype.name }}</action><validPeriod from="{{ reservation.reservationdate|date:"Y-m-d" }}T00:00:00" to="{{ reservation.reservationdate|addDays:1|date:"Y-m-d" }}T00:00:00"/></orderline>
+	
+	$orderitems = array();
+	// Product#1
+	$orderitems[] = array( 
+	'product_code'		=> 'TICKET_KIND_1_API_CODE',
+	'product_name'		=> 'My Ticket',
+	'quantity'			=> 1, 
+	'unitprice'			=> 1150,
+	'dated_from'		=> '2016-04-10',	
+	'dated_last'		=> '2016-06-30',	
+	);
+	// Product#2
+	$orderitems[] = array(
+	'product_code'		=> 'TICKET_KIND_2_API_CODE',
+	'product_name'		=> 'My Ticket 2',
+	'quantity'			=> 2, 
+	'unitprice'			=> 2250,
+	'dated_from'		=> '2016-04-10',	
+	'dated_last'		=> '2016-06-30',	
+	
+	);
+	
+	$orderlines = array();
+	foreach($orderitems as $orderitem){
+
+		$xml_orderline_ticketref = 23;
+
+		$xml_orderline_code = $orderitem['product_code'];
+
+		$xml_quantity = $orderitem['quantity'];
+		$orderline_quantity =<<<EOT
+<quantity>$xml_quantity</quantity>
+EOT;
+
+		$xml_price = $orderitem['unitprice'];
+		$orderline_price =<<<EOT
+<price>$xml_price</price>
+EOT;
+
+		$validPeriod_from = $orderitem['dated_from'].'T00:00:00';
+		$validPeriod_to = convertdate_last2to($orderitem['dated_from']).'T00:00:00';
+		$orderline_validPeriod =<<<EOT
+<validPeriod from="$validPeriod_from" to="$validPeriod_to"/>
+EOT;
+
+		$xml_product_name = xml_entities($orderitem['product_name']);
+		$orderline_action =<<<EOT
+<action>$xml_product_name</action>
+EOT;
+
+		// Construct orderline
+		$orderline = '<orderline code="'.$xml_orderline_code.'" ticket-ref="'.$xml_orderline_ticketref.'">'.$orderline_quantity.$orderline_price.$orderline_action.$orderline_validPeriod.'</orderline>';
+
+		// Add to list
+		$orderlines[] = $orderline;
+	}
+
+	// Join orderlines
+	$orderlines_list = join("\n", $orderlines);
+
+	$xml_request_data = <<<EOT
+<orderRequest version="1.0">
+	<client code="$wtc_client_code">
+		<username>$wtc_client_username</username>
+		<password>$wtc_client_password</password>
+	</client>
+	<order referenceId="$xml_order_code">
+		<properties>
+			<property name="FIRST_NAME" value="$properties_first_name"/>
+			<property name="INFIX" value="$properties_infix"/>
+			<property name="LAST_NAME" value="$properties_last_name"/>
+			<property name="EMAIL" value="$properties_email"/>
+			<property name="STREET" value="$properties_street"/>
+			<property name="HOUSE_NUMBER" value="$properties_house_number"/>
+			<property name="POSTAL_CODE" value="$properties_postal_code"/>
+			<property name="CITY" value="$properties_city"/>
+		</properties>
+		<cases>
+			<case code="$wtc_case_code">
+				<orderlines>
+$orderlines_list
+				</orderlines>
+			</case>
+		</cases>
+	</order>
+	<tickets>
+	<ticket ref="23" delivery-channel="WEB" delivery-format="BARCODE">
+	</ticket>
+	</tickets>
+</orderRequest>
+EOT;
+
+	if($dbg>0){ echo "$fname: wtc_request_url = ".$wtc_request_url."<br>\n"; }
+	if($dbg>0){ echo "$fname: xml_request_data = ".$xml_request_data; }
+
+
+	$ch = curl_init();
+	curl_setopt($ch, CURLOPT_HTTPHEADER, array('Expect:', 'Content-Type: text/xml')); 
+	curl_setopt($ch, CURLOPT_URL, $wtc_request_url);
+	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
+	curl_setopt($ch, CURLOPT_POST, 1);
+	curl_setopt($ch, CURLOPT_TIMEOUT, 30);
+	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
+	curl_setopt($ch, CURLOPT_POSTFIELDS, $xml_request_data);
+
+	$time_start = time();
+	$result = curl_exec($ch);
+	$time_end = time();
+
+	if($dbg>0){ echo "$fname: result = ".$result; }
+
+	$time_diff = $time_end - $time_start;
+	if($dbg>0){ echo "$fname: curl request executed in $time_diff second(s)<br>\n"; }
+
+	$curl_errors = 0;
+	$curl_errors_msg = '';
+	if(curl_errno($ch)){
+		// print curl_error($ch);
+		$curl_errors++;
+		$curl_errors_msg = curl_error($ch);
+		if($dbg>0){ echo "$fname: curl_error = ".$curl_errors_msg."<br>\n"; }
+		$result = '';
+	}else{
+		if($dbg>0){ echo "$fname: NO curl error(s)<br>\n"; }
+	}
+	curl_close($ch);
+
+	$got_ok = 0;
+	$got_url = 0;
+	$url = '';
+	if($curl_errors == 0){
+		// Try to locate OK (= <orderResponse status="OK"> ) in result
+		if(preg_match("/\<\s*orderResponse\s+status\s*\=\s*\"OK\"\\s*[\/]*\s*>/", $result)){
+			$got_ok = 1;
+
+			// Now try to get the URL	
+			if(preg_match("/\<\s*comment\s+type\s*\=\s*\"url\"\\s*[\/]*\s*>/", $result)){
+				if(preg_match("/\[CDATA\[http(.*?)\]\]/", $result, $matches)){
+					$got_url = 1;
+					$url = 'http'.$matches[1];
+				}
+			}
+		}
+	}
+	
+	if($dbg>0){ echo "$fname: curl_errors = $curl_errors, got_ok = $got_ok, got_url = $got_url, url = ".$url."<br>\n"; }
+
+}
+
+
+
+?>

data/lib/wheretocard.rb

@@ -0,0 +1,39 @@
+# Libraries
+require 'ostruct'
+require 'httparty'
+# require 'uri'
+# require 'rails'
+# require 'active_support/dependencies'
+# require 'active_support'
+require 'open-uri'
+require 'nokogiri'
+# require 'veto'
+
+
+#  Files
+require "wheretocard/version"
+require "wheretocard/config"
+require "wheretocard/engine" if defined?(Rails) && Rails::VERSION::MAJOR.to_i >= 3
+require "wheretocard/wheretocard_error"
+require "wheretocard/client"
+require "wheretocard/order"
+require "wheretocard/line_item"
+require "wheretocard/response"
+
+
+# 
+# Wheretocard Module
+# 
+module Wheretocard
+  API_VERSION = 1
+
+  # returns the version number
+  def self.version
+    VERSION
+  end 
+
+  def self.url
+    "https://ticketing.wheretocard.nl/ticketService/submitOrder"
+  end
+
+end

data/lib/wheretocard/client.rb

@@ -0,0 +1,66 @@
+module Wheretocard
+
+  class Client
+    # @note The is a required parameter.
+    attr_accessor :username
+    # @return [String] Your Wheretocard password
+    attr_accessor :password
+    # @return [String] Your Wheretocard client code
+    attr_accessor :client_code
+    # @return [String] Your Wheretocard case code
+    attr_accessor :case_code
+
+
+    #
+    # Initializer to transform a +Hash+ into an Client object
+    #
+    # @param [Hash] args
+    def initialize(args=nil)
+      required_args = [:username, :password, :client_code, :case_code]
+      for arg in required_args
+        if args.nil? || args[arg].nil?
+          raise WheretocardError.new(self), "Insufficient login credentials. Please provide @username, @password, @client_code and @case_code"
+        end
+      end
+
+      return if args.nil?
+      args.each do |k,v|
+        instance_variable_set("@#{k}", v) unless v.nil?
+      end
+    end
+
+    def check_credentials(product_code="")
+      o = order
+      o.add_line_item(
+        price: 0, 
+        description: 'Checking credentials [TEST]', 
+        ticket_ref: 1234,
+        valid_from: Time.now,
+        valid_until: Time.now + 24*31*3600,
+        product_code: product_code, 
+        quantity: 0
+      )
+      begin
+        o.submit
+      rescue WheretocardError => e
+        # return true if the error raised is only about the
+        # number of tickets (cannot be zero)
+        e.to_s.include?("OI_0210")
+      end
+      
+    end
+
+    # def order_requests
+    #   Wheretocard::Order
+    # end
+    # alias :order_request :order_requests
+
+    def order(args={})
+      Wheretocard::Order.new({client: self}.merge(args))
+    end
+    alias :orders :order
+    alias :new_order :order
+    alias :add_order :order
+
+  end
+end

data/lib/wheretocard/config.rb

@@ -0,0 +1,8 @@
+#
+# Configuration object for storing some parameters required for making transactions
+#
+module Wheretocard::Config
+  class << self
+    # config code here... (if needed)
+  end
+end

data/lib/wheretocard/line_item.rb

@@ -0,0 +1,47 @@
+module Wheretocard
+  #
+  # Object representing a line item with attributes provided by WTC
+  # required args:
+  # - product_code (string)
+  # - price (integer - cents) 
+  # - valid_from (DateTime / Date)
+  # - valid_until (DateTime / Date)
+  # - barcode (string) OR quantity (integer)
+  #
+  # @return [Array] Errors
+  class LineItem
+    attr_accessor :errors
+    attr_accessor :product_code
+    # If a barcode is given, it'll be used. There is no check for
+    # uniqueness. If no barcode is given, WtC will generate a unique one.
+    attr_accessor :barcode
+    attr_accessor :quantity
+    attr_accessor :ticket_ref
+    attr_accessor :price
+    attr_accessor :description
+    attr_accessor :valid_from
+    attr_accessor :valid_until
+
+    #
+    # Initializer to transform a +Hash+ into an Payment object
+    #
+    # @param [Hash] args
+    def initialize(args=nil)
+      @quantity = 1
+      return if args.nil?
+      args.each do |k,v|
+        instance_variable_set("@#{k}", v) unless v.nil?
+      end
+
+      validate
+    end
+
+    def validate
+      if barcode && quantity && quantity > 1
+        raise WheretocardError.new(self), "Quantity cannot be greater than 1 if a barcode is specified."
+      end
+    end
+
+
+  end
+end

data/lib/wheretocard/order.rb

@@ -0,0 +1,113 @@
+module Wheretocard
+
+  # Creates a validator
+  class OrderValidator
+    # include Veto.validator
+    # validates :value, presence: true, integer: true
+    # validates :profile, presence: true
+    # validates :currency, presence: true, format: /[A-Z]{3}/
+    # validates :email, presence: true
+  end
+
+
+
+  #
+  # Object representing a response object with attributes provided by WTC
+  #
+  # @return [Array] Errors
+  # @param :amount [Integer] The total price in cents
+  class Order
+    attr_accessor :errors
+    attr_accessor :reference_id
+    attr_accessor :first_name
+    attr_accessor :infix
+    attr_accessor :last_name
+    attr_accessor :street
+    attr_accessor :house_number
+    attr_accessor :city
+    attr_accessor :postal_code
+    attr_accessor :country
+    attr_accessor :email
+    attr_accessor :phone_number
+    attr_accessor :value
+    attr_accessor :client
+    attr_accessor :line_items
+    attr_accessor :delivery_format
+    attr_accessor :delivery_channel
+
+
+    #
+    # Initializer to transform a +Hash+ into an Payment object
+    #
+    # @param [Hash] args
+    def initialize(args=nil)
+      @line_items = []
+      @delivery_format = "BARCODE"
+      @delivery_channel = "WEB"
+      return if args.nil?
+      args.each do |k,v|
+        instance_variable_set("@#{k}", v) unless v.nil?
+      end
+    end
+
+    # @return [Boolean] true/false, depending if this instanciated object is valid
+    def valid?
+      validator = OrderValidator.new
+      validator.valid?(self)
+    end
+
+    # 
+    # This is the most importent method. It uses all the attributes
+    # and performs a `order` action on Wheretocard API. 
+    # @return [Wheretocard::Response] response object with `key`, `message` and `success?` methods
+    # 
+    def create
+      # if there are any line items, they should all be valid.
+      validate_line_items
+
+      # make the API call
+      # response        = Docdata.client.call(:create, xml: create_xml)
+      # response_object = Docdata::Response.parse(:create, response)
+      if response_object.success?
+        self.key = response_object.key
+      end
+
+      # set `self` as the value of the `payment` attribute in the response object
+      response_object.payment = self
+      response_object.url     = redirect_url
+
+      return response_object
+    end
+
+    # adds a line item of type LineItem to the line_items atribute (array)
+    def add_line_item(args=nil)
+      line_item = Wheretocard::LineItem.new(args)
+      line_items << line_item
+      return line_item
+    end
+
+    # @return [String] the xml to send in the SOAP API
+    def to_xml
+      xml_file        = "#{File.dirname(__FILE__)}/xml/order_request.xml.erb"
+      template        = File.read(xml_file)      
+      namespace       = OpenStruct.new(order: self, client: client)
+      xml             = ERB.new(template).result(namespace.instance_eval { binding })
+    end
+    alias :xml :to_xml
+
+    # submit the xml to the WtC API url 
+    # return object is a Wheretocard::Response
+    def submit
+      # validate_line_items
+      Wheretocard::Response.from_order_request(self)
+    end
+
+  end
+
+  private
+
+  # make sure all the line items are valid
+  def validate_line_items
+    
+  end
+end

data/lib/wheretocard/response.rb

@@ -0,0 +1,114 @@
+module Wheretocard
+
+
+  #
+  # Object representing a response object with attributes provided by WTC
+  #
+  # @return [Array] Errors
+  # @param :amount [Integer] The total price in cents
+  class Response
+    attr_accessor :errors
+    attr_accessor :body
+    attr_accessor :comment
+		attr_accessor :status
+		attr_accessor :url
+
+    #
+    # Initializer to transform a +Hash+ into an Payment object
+    #
+    # @param [Hash] args
+    def initialize(args=nil)
+      @line_items = []
+      return if args.nil?
+      args.each do |k,v|
+        instance_variable_set("@#{k}", v) unless v.nil?
+      end
+    end
+
+    # raise errors if the API returns errors
+    def validate
+    	if nokogiri_document.xpath('//error').any?
+    		code = nokogiri_document.xpath('//code').text
+    		desc = nokogiri_document.xpath('//description').text
+    		raise WheretocardError.new(self), "#{desc}\nError code: #{code} (#{error_codes[code]})"
+    	end
+    end
+
+    # return true if status is "OK"
+    def success
+    	status == "OK"
+    end
+    alias :success? :success
+
+    # return the parsed xml document
+		def nokogiri_document 
+			@nokogiri_document ||= Nokogiri::XML(body)
+		end
+
+		def error_codes
+			{
+				"OI_0001" => "Internal server error",
+				"OI_0099" => "Unknown error",
+
+				"OI_0101" => "Supplied client not found",
+				"OI_0102" => "Interface not enabled for client",
+
+				"OI_0201" => "Submitted client not found",
+				"OI_0202" => "Interface not enabled for client",
+				"OI_0203" => "Missing (or empty) order reference id attribute.",
+				"OI_0204" => "Request contains invalid orderline.ticket-ref <-> ticket.ref link reference(s)",
+				"OI_0205" => "Unknown delivery channel",
+				"OI_0206" => "Unknown delivery format",
+				"OI_0207" => "Device manufacturerer/type is not known",
+				"OI_0208" => "The delivery address is not specified",
+				"OI_0209" => "The submitted data for order reference id (max 32 chars), or one of the
+properties (max 100 chars) is too long.",
+				"OI_0210" => "Submitted number of persons is negative or 0",
+				"OI_0211" => "Submitted times valid is negative or 0",
+				"OI_0212" => "Supplied email address is missing or the format is not correct",
+				"OI_0213" => "The submitted orderline type does not belong to the client",
+				"OI_0214" => "Missing required orderlinetype",
+				"OI_0215" => "Orderline type is not owned by the submitted case",
+				"OI_0216" => "Could not generate ticket code for request, all ticket codes are in use (batch
+full).",
+			}
+		end
+
+    def self.parse_respose_code(order, code)
+    	if code == 200
+    		return
+    	elsif code == 500
+    		raise WheretocardError.new(order), "A server error occured (500)"
+    	else
+				raise WheretocardError.new(order), "The request failed (http status code #{code})"
+    	end
+    end
+
+    def self.from_order_request(order)
+			response = HTTParty.post(Wheretocard.url, body: order.to_xml)
+			# puts response.body, response.code, response.message, response.headers.inspect
+			
+
+			# raise error if code is not 200
+			parse_respose_code(order, response.code)
+
+			# parse the response
+			# <orderResponse status="NOT_OK">
+			# 	<error>
+			# 		<code>OI_0202</code>
+			# 		<description><![CDATA[Posted XML not valid, or not conform Schema definition. ]]></description>
+			# 	</error>
+			# </orderResponse>
+			
+			r = Response.new()
+			r.body = response.body
+			r.status = r.nokogiri_document.xpath('//orderResponse/@status').text
+			if r.nokogiri_document.search('comment[type="url"]').any?
+				r.url = r.nokogiri_document.search('comment[type="url"]').first.text
+			end
+			r.validate
+			return r
+    end
+
+  end
+end

data/lib/wheretocard/version.rb

@@ -0,0 +1,3 @@
+module Wheretocard
+  VERSION = "0.1.0"
+end

data/lib/wheretocard/wheretocard_error.rb

@@ -0,0 +1,7 @@
+class WheretocardError < StandardError
+  attr_reader :object
+  
+  def initialize(object)
+    @object = object
+  end
+end

data/lib/wheretocard/xml/order_request.xml.erb

@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="UTF-8"?> 
+<orderRequest version="1.0">
+	<client code="<%= client.client_code %>"> 
+		<username><%= client.username%></username> 
+		<password><%= client.password%></password>
+	</client>
+	<order referenceId="<%= order.reference_id %>">
+		<properties>
+			<property name="FIRST_NAME" value="<%= order.first_name %>"/>
+			<property name="INFIX" value="<%= order.infix %>"/>
+			<property name="LAST_NAME" value="<%= order.last_name %>"/>
+			<property name="EMAIL" value="<%= order.email %>"/>
+			<property name="STREET" value="<%= order.street %>"/>
+			<property name="HOUSE_NUMBER" value="<%= order.house_number %>"/>
+			<property name="POSTAL_CODE" value="<%= order.postal_code %>"/>
+			<property name="CITY" value="<%= order.city %>"/>
+		</properties> 
+		<cases>
+			<case code="<%= client.case_code %>">
+				<orderlines>
+					<% for line_item in order.line_items %>
+					<orderline code="<%= line_item.product_code %>" ticket-ref="<%= line_item.ticket_ref %>"> 
+						<quantity><%= line_item.quantity %></quantity>
+						<price><%= line_item.price %></price>
+						<action><%= line_item.description %></action>
+						<% if line_item.valid_from && line_item.valid_until %>
+						<validPeriod from="<%= line_item.valid_from.strftime("%Y-%m-%dT%H:%M:%S") %>" to="<%= line_item.valid_until.strftime("%Y-%m-%dT%H:%M:%S") %>"/>
+						<% end %>
+					</orderline>
+					<% end %>
+				</orderlines>
+			</case>
+		</cases>
+	</order> 
+	<tickets>
+			<% for line_item in order.line_items %>
+				<ticket ref="<%= line_item.ticket_ref %>" delivery-channel="<%= order.delivery_channel %>" delivery-format="<%= order.delivery_format %>">
+				<% if line_item.barcode %>
+				<contentCode><%= line_item.barcode %></contentCode>
+				<% end %>
+			</ticket>
+			<% end %>
+	</tickets>
+</orderRequest>

data/wheretocard.gemspec

@@ -0,0 +1,45 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'wheretocard/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "wheretocard"
+  spec.version       = Wheretocard::VERSION
+  spec.authors       = ["Henk Meijer"]
+  spec.email         = ["henk.meijer@eskesmedia.nl"]
+
+  spec.summary       = %q{Ruby binder to the Wherto CARD API}
+  spec.description   = %q{Ruby binder to the Wherto CARD API}
+  spec.homepage      = "http://www.eskesmedia.nl/"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+  # if spec.respond_to?(:metadata)
+  #   spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
+  # else
+  #   raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  # end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "fakeweb"
+  spec.add_development_dependency "coveralls"
+  spec.add_development_dependency "simplecov"
+
+
+  # spec.add_dependency 'veto'
+  # spec.add_dependency 'rubyntlm' #, '0.4.0'
+  spec.add_dependency 'httparty'
+  spec.add_dependency 'nokogiri'
+  # spec.add_dependency 'railties'
+
+end

metadata

@@ -0,0 +1,192 @@
+--- !ruby/object:Gem::Specification
+name: wheretocard
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Henk Meijer
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-04-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby binder to the Wherto CARD API
+email:
+- henk.meijer@eskesmedia.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- documentation/Ticketing order interface specification v1.60.pdf
+- documentation/test_wtc_api.php
+- lib/wheretocard.rb
+- lib/wheretocard/client.rb
+- lib/wheretocard/config.rb
+- lib/wheretocard/line_item.rb
+- lib/wheretocard/order.rb
+- lib/wheretocard/response.rb
+- lib/wheretocard/version.rb
+- lib/wheretocard/wheretocard_error.rb
+- lib/wheretocard/xml/order_request.xml.erb
+- wheretocard.gemspec
+homepage: http://www.eskesmedia.nl/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.3.0
+signing_key: 
+specification_version: 4
+summary: Ruby binder to the Wherto CARD API
+test_files: []
+has_rdoc: