.gitignore documentation/ViaPostCustomer API v1.1.pdf lib/viapost/letter.rb spec/viapost/interface_spec.rb @@ -4,6 +4,7 @@ $:.unshift(File.dirname(__FILE__)) unless gem 'soap4r' require 'soap/wsdlDriver' require 'viapost/interface' +require 'viapost/letter' module Viapost VERSION = '0.0.1' lib/viapost.rb @@ -1,3 +1,5 @@ +require 'base64' + module Viapost class Interface @@ -8,18 +10,46 @@ module Viapost class UnknownEnvironment < Exception; end class InvalidUserOrPass < Exception; end + attr_reader :driver, :login_token + def initialize(user, pass, environment = :live) @driver = SOAP::WSDLDriverFactory.new(wsdl(environment)).create_rpc_driver @user = user @pass = pass end - def get_balance + def balance response = @driver.GetBalance(:sLoginToken => login_token) response.dBalance.to_f end - private + def letters(query = '') + response = @driver.GetLetters(:sLoginToken => login_token, :sSearchDocumentName => query) + soap_letters = response.returnLetters.anyType + + # for some reason their API returns just the letter instead of an array if it only returns one letter + if soap_letters.is_a?(Array) + soap_letters.map { |l| Letter.build_from_soap_object(l) } + else + [Letter.build_from_soap_object(soap_letters)] + end + end + + def upload_letter(file, title, colour = false, double_sided = false) + file = File.open(file, 'r') if file.is_a?(String) # allow path instead of file + + response = @driver.UploadDocument(:sLoginToken => login_token, :sDocumentName => title, :DocumentData => file.read, :Colour => colour, :DoubleSided => double_sided) + end + + def send_letter(letter, name, address_1, address_2, address_3, address_4, address_5, postcode) + response = @driver.SendLetter(:sLoginToken => login_token, :myCustomerAPILetter => letter, :addressName => name, :address1 => address_1, :address2 => address_2, :address3 => address_3, :address4 => address_4, :address5 => address_5, :postcode => postcode) + end + + def letter(letter_id) + @driver.GetLetterByID(:sLoginToken => login_token, :LetterID => letter_id) + end + + # private def login_token @login_response ||= @driver.SignIn(:sUserName => @user, :sPassword => @pass) lib/viapost/interface.rb cf0b52ca2b044dded1d368d0c21b9e93cac79a37 Tom Taylor tom@tomtaylor.co.uk http://github.com/tomtaylor/viapost/commit/0af02f3bcdf63fcf37b3a19263842f9ee8b3f68d 0af02f3bcdf63fcf37b3a19263842f9ee8b3f68d 2009-01-17T06:59:34-08:00 2009-01-17T06:59:34-08:00 Some stuff that doesn't work properly yet. Fixing soon. 02e7359554ce347d21d07ddc64d847ccbee984f3 Tom Taylor tom@tomtaylor.co.uk