rs.ge 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+coverage/*

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

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

data/README.md

@@ -0,0 +1,23 @@
+# RS.GE ვებ-სერვისები
+
+ეს ბიბლიოთეკა განკუთვნილია RS.GE-ს ვებ სერვისების გამოყენებაზე.
+ამ ბიბლიოთეკის მეშვეობით ადვილად მოახერხებთ ყველა ოპერაციის ჩატარებას,
+რასაც აღნიშნული ვებ სერვისი ითვალისწინებს.
+
+## გამოყენება
+
+გამოყენებისათვის უნდა ჩასვათ შემდეგი ხაზი თქვენს Gemfile-ში:
+
+	gem 'rs'
+
+შემდეგი გამოყენება ძალიან მარტივია:
+
+```ruby
+require 'rs'
+
+puts RS.what_is_my_ip # თქვენს IP მისამართს დაბეჭდავს კონსოლში
+```
+
+## სხვა ფუნქციები
+
+TODO: აქ დასაწერია თუ როგორ უნდა გამოიყენოთ სხვა ფუნქციები (დასალაგებბელია თემეტურად)

data/Rakefile

@@ -0,0 +1,12 @@
+require "bundler/gem_tasks"
+
+# RSpec
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:test) do |spec|
+  spec.rspec_opts = ["--color", "--format progress"]
+  spec.pattern = 'spec/**/*.rb'
+  spec.verbose = false
+end
+
+task :default => :test

data/lib/rs.rb

@@ -0,0 +1,55 @@
+# -*- encoding : utf-8 -*-
+require 'savon'
+require 'rs/version'
+require 'rs/sys'
+require 'rs/dict'
+require 'rs/waybill'
+
+module RS
+  # ელქტრონული ზედნადების ფორმის WSDL მისამართი
+  WAYBILL_SERVICE_URL = 'http://services.rs.ge/WayBillService/WayBillService.asmx?WSDL'
+
+  # ელექტრონული ა/ფ WSDL მისამართი
+  INVOICE_SERVICE_URL = 'https://www.revenue.mof.ge/ntosservice/ntosservice.asmx?WSDL'
+
+  # შეცდომის კლასი
+  class Error < RuntimeError
+  end
+
+  protected
+
+  # ელექტრონული ზედნადების SOAP კლიენტის მიღება
+  def self.waybill_service
+    Savon::Client.new do
+      wsdl.document = WAYBILL_SERVICE_URL
+    end
+  end
+
+  # ანგარიშ-ფაქტურის SOAP კლიენტის მიღება
+  def self.invoice_service
+    Savon::Client.new do
+      wsdl.document = INVOICE_SERVICE_URL
+    end
+  end
+
+  # ამოწმებს, რომ მოცემულ პარამეტრებში ყველას მნიშვნელობა განსხვავდებოდეს <code>nil</code>-სგან.
+  def self.validate_presence_of(params, *options)
+    options.each do |opt|
+      val = params[opt.to_s]
+      raise RS::Error.new("#{opt.to_s} required") if val.nil? or (val.instance_of? String and val.strip.empty?)
+    end if options
+  end
+
+  # უზრუნველყოფს <code>nil</code> მნიშვნელობების სწორად ჩაწერას.
+  def self.prepare_params(params)
+    attributes = {}
+    params.each do |k, v|
+      if v.nil?
+        params.delete k
+        attributes[k] = {'xsi:nil' => true}
+      end
+    end
+    params['attributes!'] = attributes unless attributes.empty?
+  end
+
+end

data/lib/rs/dict.rb

@@ -0,0 +1,247 @@
+# -*- encoding : utf-8 -*-
+
+module RS
+
+  # ეს არის აქციზის კოდის აღმწერი კლასი.
+  class ExciseCode
+    # name -- აქციზის დასახელება
+    # measure -- ზომის ერთეული
+    # code -- აქციზის კოდი
+    # value -- აქციზის განაკვეთი
+    attr_accessor :id, :name, :measure, :code, :value
+  end
+
+  # ეს არის ზედნადების ტიპის კლასი.
+  class WaybillType
+    INNER = 1
+    TRANSPORTATION = 2
+    WITHOUT_TRANSPORTATION = 3
+    DISTRIBUTION = 4
+    RETURN = 5
+    SUB_WAYBILL = 6
+    NAMES = {
+      INNER => 'შიდა გადაზიდვა', TRANSPORTATION => 'ტრანსპორტირებით', WITHOUT_TRANSPORTATION => 'ტრანსპორტირების გარეშე',
+      DISTRIBUTION => 'დისტრიბუცია', RETURN => 'უკან დაბრუნება', SUB_WAYBILL => 'ქვე-ზედნადები'
+    }
+    attr_accessor :id, :name
+    def self.create_from_id(id)
+      type = WaybillType.new
+      type.id = id
+      type.name = NAMES[id]
+      type
+    end
+  end
+
+  # ზედნადების ერთეულების განსაზღვრა.
+  class WaybillUnit
+    attr_accessor :id, :name
+
+    # ეს კოდი შეესაბამება ზომის ერთეულს 'სხვა'.
+    OTHERS = 99
+  end
+
+  # ტრანსპორტირების ტიპი
+  class TransportType
+    VEHICLE = 1
+    RAILWAY = 2
+    AIR     = 3
+    OTHERS  = 4
+    NAMES   = { VEHICLE => 'საავტომობილო', RAILWAY => 'სარკინიგზო', AIR => 'საავიაციო', OTHERS => 'სხვა' }
+    attr_accessor :id, :name
+    def self.create_from_id(id)
+      type = TransportType.new
+      type.id = id
+      type.name = NAMES[id]
+      type
+    end
+  end
+
+  # შტრიხკოდის აღმწერი კლასი
+  class BarCode
+    attr_accessor :code, :name, :unit_id, :unit_name, :excise_id
+  end
+
+  protected
+
+  def normalize_excise_name(name)
+    index = name =~ /\([0-9]+\)/
+    index ? name[0..index-1].strip : name
+  end
+
+  public
+
+  # აქციზის კოდების სიის მიღება.
+  #
+  # უნდა გადაეცეს შემდეგი პარამეტრები:
+  #
+  # su -- სერვისის მომხმარებლის სახელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  def self.get_excise_codes(params)
+    RS.validate_presence_of(params, 'su', 'sp')
+    client = RS.waybill_service
+    response = client.request 'get_akciz_codes' do
+      soap.body = params
+    end
+    codes_hash = response.to_hash[:get_akciz_codes_response][:get_akciz_codes_result][:akciz_codes][:akciz_code]
+    codes = []
+    codes_hash.each do |hash|
+      code = ExciseCode.new
+      code.id = hash[:id]
+      code.name = normalize_excise_name(hash[:title])
+      code.measure = hash[:measurement]
+      code.code = hash[:sakon_kodi]
+      code.value = hash[:akcis_ganakv].to_f
+      codes << code
+    end
+    codes
+  end
+
+  # ზედნადების ტიპების მიღება.
+  #
+  # უნდა გადაეცეს შემდეგი პარამეტრები:
+  #
+  # su -- სერვისის მომხმარებლის სახელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  def self.get_waybill_types(params)
+    RS.validate_presence_of(params, 'su', 'sp')
+    client = RS.waybill_service
+    response = client.request 'get_waybill_types' do
+      soap.body = params
+    end
+    types_hash = response.to_hash[:get_waybill_types_response][:get_waybill_types_result][:waybill_types][:waybill_type]
+    types = []
+    types_hash.each do |hash|
+      type = WaybillType.new
+      type.id = hash[:id]
+      type.name = hash[:name]
+      #puts "#{type.id}: #{type.name}"
+      types << type
+    end
+    types
+  end
+
+  # ზედნადების ზომის ერთეულების მიღება.
+  #
+  # უნდა გადაეცეს შემდეგი პარამეტრები:
+  #
+  # su -- სერვისის მომხმარებლის სახელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  def self.get_waybill_units(params)
+    RS.validate_presence_of(params, 'su', 'sp')
+    client = RS.waybill_service
+    response = client.request 'get_waybill_units' do
+      soap.body = params
+    end
+    units_hash = response.to_hash[:get_waybill_units_response][:get_waybill_units_result][:waybill_units][:waybill_unit]
+    units = []
+    units_hash.each do |hash|
+      unit = WaybillUnit.new
+      unit.id = hash[:id]
+      unit.name = hash[:name]
+      #puts "#{unit.id}: #{unit.name}"
+      units << unit
+    end
+    units
+  end
+
+  # ტრანსპორტის სახეობების მიღება.
+  #
+  # უნდა გადაეცეს შემდეგი პარამეტრები:
+  #
+  # su -- სერვისის მომხმარებლის სახელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  def self.get_transport_types(params)
+    RS.validate_presence_of(params, 'su', 'sp')
+    client = RS.waybill_service
+    response = client.request 'get_trans_types' do
+      soap.body = params
+    end
+    types_hash = response.to_hash[:get_trans_types_response][:get_trans_types_result][:transport_types][:transport_type]
+    types = []
+    types_hash.each do |hash|
+      type = TransportType.new
+      type.id = hash[:id]
+      type.name = hash[:name]
+      #puts "#{type.id}: #{type.name}"
+      types << type
+    end
+    types
+  end
+
+  # შტრიხკოდის შენახვის მეთოდი.
+  #
+  # უნდა გადაეცეს შემდეგი პარამეტრები:
+  #
+  # su -- სერვისის მომხმარებლის სახელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  # bar_code -- შტრიხკოდის მნიშვნელობა
+  # prod_name -- საქონლის დასახელება (შეესაბამება <code>goods_name</code> RS-ის სპეციფიკაციაში)
+  # unit_id -- ზომის ერთეულის კოდი
+  # unit_name -- ზომის ერთეულის დასახელება, როდესაც #{unit_id} ტოლია #{WaybillUnit::OTHERS},
+  #   სხვა მნიშვნელობისთვის ეს პარამეტრი არ უნდა გადმოეცეს
+  #   (შეესანამება <code>unit_txt</code> პარამეტრს RS-ის სპეციფიკაციაში)
+  # excise_id -- აქციზის კოდი. ან <code>nil</code>, თუ აქციზის კოდი არ უყენდება ამ საქონელს
+  #   (შეესაბამება <code>a_id</code> პარამეტრს RS-ის სპეციფიკაციაში)
+  def self.save_bar_code(params)
+    RS.validate_presence_of(params, 'su', 'sp', 'bar_code', 'prod_name', 'unit_id')
+    params2 = {'su' => params['su'], 'sp' => params['sp'], 'bar_code' => params['bar_code'],
+      'goods_name' => params['prod_name'], 'unit_id' => params['unit_id'],
+      'unit_txt' => params['unit_name'], 'a_id' => params['excise_id']}
+    prepare_params(params2)
+    params2['order!'] = ['su', 'sp', 'bar_code', 'goods_name', 'unit_id', 'unit_txt', 'a_id']
+    client = RS.waybill_service
+    response = client.request 'save_bar_code' do
+      soap.body = params2
+    end
+    resp = response.to_hash[:save_bar_code_response][:save_bar_code_result]
+    resp.to_i == 1 # success!
+  end
+
+  # შტრიხკოდის წაშლის მეთოდი.
+  #
+  # უნდა გადაეცეს შემდეგი პარამეტრები:
+  #
+  # su -- სერვისის მომხმარებლის სახელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  # bar_code -- შტრიხკოდის მნიშვნელობა
+  def self.delete_bar_code(params)
+    RS.validate_presence_of(params, 'su', 'sp', 'bar_code')
+    params['order!'] = ['su', 'sp', 'bar_code']
+    client = RS.waybill_service
+    response = client.request 'delete_bar_code' do
+      soap.body = params
+    end
+    resp = response.to_hash[:delete_bar_code_response][:delete_bar_code_result]
+    resp.to_i == 1 # success!
+  end
+
+  # შტრიხკოდების მიღების მეთოდი.
+  #
+  # უნდა გადაეცეს შემდეგი პარამეტრები:
+  #
+  # su -- სერვისის მომხმარებლის სახელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  # bar_code -- შტრიხკოდის მნიშვნელობა, რომლის მსგავსის ამოღებაც გვინდა
+  def self.get_bar_codes(params)
+    RS.validate_presence_of(params, 'su', 'sp', 'bar_code')
+    params['order!']= ['su', 'sp', 'bar_code']
+    client = RS.waybill_service
+    response = client.request 'get_bar_codes' do
+      soap.body = params
+    end
+    codes_hash = response.to_hash[:get_bar_codes_response][:bar_codes][:bar_codes][:bar_code]
+    codes_hash = [codes_hash] if codes_hash.instance_of? Hash
+    codes = []
+    codes_hash.each do |hash|
+      code = BarCode.new
+      code.code = hash[:code]
+      code.name = hash[:name]
+      code.unit_id = hash[:unit_id].to_i
+      code.unit_name = hash[:unit_txt]
+      code.excise_id = hash[:a_id].to_i == 0 ? nil : hash[:a_id].to_i
+      codes << code
+    end
+    codes
+  end
+
+end

data/lib/rs/sys.rb

@@ -0,0 +1,127 @@
+# -*- encoding : utf-8 -*-
+
+module RS
+
+  # სერვისის მომხმარებლის კლასი.
+  class User
+    attr_accessor :id, :user_name, :payer_id, :ip, :name
+  end
+
+  # აბრუნებს თქვენი კომპიუტერის გარე IP მისამართს.
+  def self.what_is_my_ip
+    client = RS.waybill_service
+    response = client.request 'what_is_my_ip'
+    response.to_hash[:what_is_my_ip_response][:what_is_my_ip_result]
+  end
+
+  # ქმნის ახალ მომხმარებელს.
+  #
+  # გადაეცემა შემდეგი პარამეტრები:
+  #
+  # user_name -- მომხმარებლის სახელი
+  # user_password -- მომხმარებლის პაროლი
+  # ip -- მანქანის IP მისამართი, რომლიდანაც უნდა მოხდეს ამ მომხმარებლის შემოსვლა
+  # name -- მაღაზიის სახელი
+  # su -- სერვისის მომხმარებლის სახელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  def self.create_service_user(params)
+    RS.validate_presence_of(params, 'user_name', 'user_password', 'ip', 'name', 'su', 'sp')
+    client = RS.waybill_service
+    response = client.request 'create_service_user' do
+      soap.body = params
+    end
+    response.to_hash[:create_service_user_response][:create_service_user_result]
+  end
+
+  # აბრუნებს სერვისის მომხმარებლელბის სიას. 
+  #
+  # გადაეცემა შემდეგი პარამეტრები:
+  #
+  # user_name -- მომხმარებლის სახელი
+  # user_password -- მომხმარებლი პაროლი
+  #
+  # ბრუნდება #{User}-ების მასივი.
+  def self.get_service_users(params)
+    RS.validate_presence_of(params, 'user_name', 'user_password')
+    client = RS.waybill_service
+    response = client.request 'get_service_users' do
+      soap.body = params
+    end
+    users_hash_array = response.to_hash[:get_service_users_response][:get_service_users_result][:service_users][:service_user]
+    #puts users_hash_array
+    users = []
+    users_hash_array.each do |user_hash|
+      user = User.new
+      user.id        = user_hash[:id]
+      user.user_name = user_hash[:user_name]
+      user.payer_id  = user_hash[:un_id]
+      user.ip        = user_hash[:ip]
+      user.name      = user_hash[:name]
+      users << user
+    end
+    users
+  end
+
+  # სერვისის მომხმარებლის პაროლის შემოწმება.
+  #
+  # გადაეცემა შემდეგი პარამეტრები:
+  #
+  # su -- სერვისის მომხმარებელი
+  # sp -- სერვისის მომხმარებლის პაროლი
+  #
+  # აბრუნებს #{User} ობიექტს, ცარიელი ip-თი ან <code>nil</code>-ს თუ არასწორი მომხმარებელია.
+  def self.check_service_user(params)
+    RS.validate_presence_of(params, 'su', 'sp')
+    client = RS.waybill_service
+    response = client.request 'chek_service_user' do
+      soap.body = params
+    end
+    if response[:chek_service_user_response][:chek_service_user_result]
+      payer_id = response[:chek_service_user_response][:un_id]
+      user_id  = response[:chek_service_user_response][:s_user_id]
+      user = User.new
+      user.id = user_id
+      user.user_name = params['su']
+      user.payer_id = payer_id
+      user
+    end
+  end
+
+  # სერვისის მომხმარებლის მონაცემების შეცვლა.
+  #
+  # გადაეცემა შემდეგი პარამეტრები:
+  #
+  # user_name -- მომხმარებლის სახელი
+  # user_password -- პაროლი
+  # ip -- მანქანის მისამართი,
+  # name -- მაღაზიის დასახელება
+  # su -- მომხამრებლის სახელი
+  # sp -- პაროლი
+  def self.update_service_user(params)
+    RS.validate_presence_of(params, 'user_name', 'user_password', 'ip', 'name', 'su', 'sp')
+    client = RS.waybill_service
+    response = client.request 'update_service_user' do
+      soap.body = params
+    end
+    #puts params
+    #puts response.to_hash
+    response.to_hash[:update_service_user_response][:update_service_user_result]
+  end
+
+  # აბრუნებს ორგანიზაციის/პიროვნების სახელს მისი საიდენტიფიკაციო ნომრიდან.
+  #
+  # გადაეცემა შემდეგი პარამეტრები:
+  #
+  # su -- მომხამრებლის სახელი
+  # sp -- პაროლი
+  # tin -- საიდენტიფიკაციო ნომერი
+  def self.get_name_from_tin(params)
+    RS.validate_presence_of(params, 'su', 'sp', 'tin')
+    client = RS.waybill_service
+    response = client.request 'get_name_from_tin' do
+      soap.body = params
+    end
+    response.to_hash[:get_name_from_tin_response][:get_name_from_tin_result]
+  end
+
+end