sale 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5709e56615138240b522d2e4e92a8e68db8809aa
+  data.tar.gz: 3c4b2e2158939f9787e8d5685c158661c4f60635
+SHA512:
+  metadata.gz: d3dcdea744947207aa95a4681debe802c85295c5c93974475389e7cf2c8771584f2fce31de24bb2ccdaa61e0c72b2e2efff604c14c3a49c7833858faf3a96e49
+  data.tar.gz: a8e887b2fe4b1dc16a04244f247e57da772bcf302ca0d6c36cad8628bef4897548d785cd4913ac7cc9277473d67af569ece0c0291c2430881951dc05471eaccd

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/gems.rb

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# specified in gemspec
+gemspec

data/lib/base.rb

@@ -0,0 +1,41 @@
+require 'dagger'
+require 'json'
+
+module Bsale
+  class InvalidResponseError < StandardError; end
+
+  class APIBase
+    ENDPOINT = 'https://api.bsale.cl'.freeze
+    VERSION  = 'v1'.freeze
+
+    def initialize(token)
+      @token = token or raise 'Token not set!'
+    end
+
+    private
+
+    def request(method, path, body = nil)
+      headers = { access_token: @token }
+      url = path['://'] ? path : [ ENDPOINT, VERSION, path ].join('/')
+      Dagger.request(method, url, body, { json: true, follow: 3, headers: headers })
+    end
+
+    def handle_response(resp)
+      if resp.success?
+        data = parse_json(resp.body)
+        return data ? OpenStruct.new(data) : nil
+      else
+        raise InvalidResponseError.new("#{resp.code}: #{resp.body}")
+      end
+    end
+
+    def parse_json(str)
+      JSON.parse(str)
+    rescue JSON::ParserError => e
+      puts "Invalid JSON: #{e.message}"
+      nil
+    end
+
+  end
+
+end

data/lib/bsale.rb

@@ -0,0 +1,2 @@
+require_relative './buyers'
+require_relative './documents'

data/lib/buyers.rb

@@ -0,0 +1,94 @@
+require_relative './base'
+
+class Bsale::Buyers < Bsale::APIBase
+  class BuyerNotFoundError < Bsale::InvalidResponseError; end
+
+  EMAIL_REGEX = /\A([\w+\-].?)+@[a-z\d\-]+(\.[a-z]+)*\.[a-z]+\z/i
+
+  def get_buyer_with_email_and_code(email, code = nil)
+    if list = get_buyers_with_email(email) and list.any?
+      with_code = list.select { |b| code.nil? ? (b.code || '').size > 0 : (code.to_s == b.code.to_s) }
+
+      if with_code.count != 1
+        raise BuyerNotFoundError.new("#{with_code.count} clients under #{email} and code #{code}")
+      end
+
+      return with_code.first
+    end
+  end
+
+  def get_buyers_with_email(email)
+    return nil unless email && email.match(EMAIL_REGEX)
+    get_buyers_with(email: email)
+  end
+
+  def get_buyers_with_code(code)
+    get_buyers_with(code: code)
+  end
+
+  def add_buyer(firstName:, lastName:, address:, email:, phone:, code:, note:, activity:, municipality:, city:)
+    data = {
+      accumulatePoints: 1,
+      firstName: firstName,
+      lastName: lastName,
+      code: code,
+      address: address,
+      email: email,
+      phone: phone,
+      city: city,
+      municipality: municipality,
+      note: note, # gender
+      activity: activity # date of birth
+    }
+
+    return nil unless email.match(EMAIL_REGEX)
+    resp = request(:post, "/clients.json", data)
+    handle_response(resp)
+  end
+
+  def update_buyer(id, data)
+    if [:email, :code].include?(data.symbolize_keys.keys)
+      raise 'Invalid request, cannot update email nor code!'
+    end
+
+    # puts "Updating client #{id} with data: #{data.inspect}"
+    resp = request(:put, "/clients/#{id}.json", data.merge(id: id))
+    handle_response(resp)
+  end
+
+  def update_buyer_points(buyer, difference, order_code)
+    raise 'No point in modifying 0 points' if difference == 0
+
+    data = {
+      email: buyer.email,
+      points: difference.abs,
+      type: difference > 0 ? 0 : 1, # 0 to add, 1 to subtract
+      description: "Apply #{difference} points from order #{order_code}",
+      orderId: order_code
+    }
+
+    resp = request(:put, "/clients/points.json", data)
+    if resp.code == 200
+      return parse_json(resp.body)['points']
+    else
+      raise InvalidResponseError.new("#{resp.code}: #{resp.body}")
+    end
+  end
+
+  private
+
+  def get_buyers_with(attrs)
+    if data = get_buyers(attrs.merge(state: 0)) and data['items']
+      data['items'].map { |item| OpenStruct.new(item) }
+    else
+      []
+    end
+  end
+
+  def get_buyers(query)
+    search = query.map { |k,v| URI.encode(k.to_s) + '=' + URI.encode(v.to_s) }.join('&')
+    resp   = request(:get, '/clients.json?' + search)
+    resp.code == 200 ? parse_json(resp.body) : nil
+  end
+
+end

data/lib/documents.rb

@@ -0,0 +1,74 @@
+require_relative './base'
+
+class Bsale::Documents < Bsale::APIBase
+
+  def get_document_types
+    resp = request(:get, 'document_types.json')
+    handle_response(resp)
+  end
+
+  def get_payment_types
+    resp = request(:get, 'payment_types.json')
+    handle_response(resp)
+  end
+
+  def get_tax_types
+    resp = request(:get, 'taxes.json')
+    handle_response(resp)
+  end
+
+  def get_price_lists
+    resp = request(:get, 'price_lists.json')
+    handle_response(resp)
+  end
+
+  def get_pdf(url)
+    resp = request(:get, url)
+    if resp.success?
+      StringIO.new(resp.body, 'rb')
+    else
+      nil
+    end
+  end
+
+  def create_doc(codeSii:, emissionDate:, expirationDate:, declareSii:, priceListId:, \
+    officeId: nil, clientId: nil, client: nil, details: nil, payments: nil)
+
+    body = {
+      codeSii: codeSii, # we could also use "documentTypeId"
+      declareSii: declareSii,
+      emissionDate: emissionDate,
+      expirationDate: expirationDate
+    }
+
+    body[:officeId] = officeId if officeId
+    body[:priceListId] = priceListId if priceListId
+
+    # facturas require clientId, unlike boletas
+    if [33, 34].include?(codeSii.to_i)
+      if clientId
+        body[:clientId] = clientId
+      elsif client
+        body[:client] = client
+      else
+        raise 'clientId or client required'
+      end
+    end
+
+    body[:details]  = details  if details
+    body[:payments] = payments if payments
+
+    resp = request(:post, "documents.json", body.to_json)
+    handle_response(resp)
+  end
+
+  def mark_document_declared(id)
+    body = { id: id, informedSii: 1 }
+    request(:put, 'documents/set_sii_state.json', body)
+  end
+
+  def remove_document(id:, office_id:)
+    request(:delete, "documents/#{id}.json?officeid=#{office_id}")
+  end
+
+end

data/sale.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+# require File.expand_path("../lib/bsale/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "sale"
+  s.version     = '0.0.1'
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Tomás Pollak']
+  s.email       = ['tomas@bootic.net']
+  s.homepage    = "https://github.com/github/bsale-api-wrapper"
+  s.summary     = "A wrapper around the Bsale API."
+  s.description = "A wrapper around the Bsale API."
+
+  s.required_rubygems_version = ">= 1.3.6"
+  s.add_development_dependency "bundler", ">= 1.0.0"
+  s.add_development_dependency "rspec-core"
+  s.add_development_dependency "rspec-mocks"
+  s.add_development_dependency "rspec-expectations"
+
+  s.add_runtime_dependency "dagger", "~> 0.9.0"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+  # s.bindir       = 'bin'
+end

data/spec/buyers_spec.rb

@@ -0,0 +1,176 @@
+require 'bundler/setup'
+require_relative '../lib/bsale'
+
+RSpec.configure do |config|
+  config.color = true
+end
+
+describe 'Bsale' do
+
+  describe 'Buyers' do
+
+    let(:client) {
+      Bsale::Buyers.new('foo')
+    }
+
+    let(:fake_response) {
+      double('Response', code: 200, body: '{"count": 0}')
+    }
+
+    before do
+      allow(Dagger).to receive(:request).and_return(fake_response)
+    end
+
+    describe 'get_buyer_with_email_and_code' do
+
+      describe 'when email is invalid' do
+
+        it 'returns nil, without making a request' do
+          expect(client).not_to receive(:request)
+          client.get_buyer_with_email_and_code('aaa')
+        end
+
+      end
+
+      describe 'no results' do
+
+        before do
+          expect(fake_response).to receive(:body).and_return({ items: [] }.to_json)
+        end
+
+        it 'returns nil without code' do
+          client.get_buyer_with_email_and_code('aaa@foo.com')
+        end
+
+        it 'returns nil with code' do
+          client.get_buyer_with_email_and_code('aaa@foo.com', '123')
+        end
+
+      end
+
+      describe 'one result with code' do
+
+        before do
+          expect(fake_response).to receive(:body).and_return({ items: [{ code: 123, accumulatePoints: '1' }] }.to_json)
+        end
+
+        it 'returns result, without code' do
+          res = client.get_buyer_with_email_and_code('aaa@foo.com')
+          expect(res).to eql(OpenStruct.new({ code: 123, accumulatePoints: '1' }))
+        end
+
+        it 'returns result, with matching code' do
+          res = client.get_buyer_with_email_and_code('aaa@foo.com', '123')
+          expect(res).to eql(OpenStruct.new({ code: 123, accumulatePoints: '1' }))
+        end
+
+        it 'returns nil, with non-matching code' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com', '234')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+      end
+
+      describe 'one result with code, another one without' do
+
+        before do
+          list = [{ code: 123, accumulatePoints: '1' }, { code: '', accumulatePoints: '1' }]
+          expect(fake_response).to receive(:body).and_return({ items: list }.to_json)
+        end
+
+        it 'returns result, without code' do
+          res = client.get_buyer_with_email_and_code('aaa@foo.com')
+          expect(res).to eql(OpenStruct.new({ code: 123, accumulatePoints: '1' }))
+        end
+
+        it 'returns result, with matching code' do
+          res = client.get_buyer_with_email_and_code('aaa@foo.com', '123')
+          expect(res).to eql(OpenStruct.new({ code: 123, accumulatePoints: '1' }))
+        end
+
+        it 'returns nil, with non-matching code' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com', '234')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+      end
+
+      describe 'two results with same code' do
+
+        before do
+          expect(fake_response).to receive(:body).and_return({ items: [{ code: 123 }, { code: 123 }] }.to_json)
+        end
+
+        it 'returns nil, without code' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+        it 'returns nil, with matching code' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com', '123')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+        it 'returns nil, with non-matching code' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com', '234')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+      end
+
+      describe 'two results with different codes' do
+
+        before do
+          list = [{ code: 123, accumulatePoints: '1' }, { code: 345, accumulatePoints: '1' }]
+          expect(fake_response).to receive(:body).and_return({ items: list }.to_json)
+        end
+
+        it 'returns nil, without code' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+        it 'returns result, when code matches one' do
+          res = client.get_buyer_with_email_and_code('aaa@foo.com', '123')
+          expect(res).to eql(OpenStruct.new({ code: 123, accumulatePoints: '1' }))
+        end
+
+        it 'returns nil, when code doesnt match any' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com', '234')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+      end
+
+      describe 'two results without code' do
+
+        before do
+          expect(fake_response).to receive(:body).and_return({ items: [{ code: '' }, { code: '' }] }.to_json)
+        end
+
+        it 'returns nil, without code' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+        it 'returns nil, with code' do
+          expect do
+            client.get_buyer_with_email_and_code('aaa@foo.com', '123')
+          end.to raise_error(Bsale::Buyers::BuyerNotFoundError)
+        end
+
+      end
+
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: sale
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Tomás Pollak
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-11-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  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: rspec-mocks
+  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: rspec-expectations
+  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: dagger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+description: A wrapper around the Bsale API.
+email:
+- tomas@bootic.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Rakefile
+- gems.rb
+- lib/base.rb
+- lib/bsale.rb
+- lib/buyers.rb
+- lib/documents.rb
+- sale.gemspec
+- spec/buyers_spec.rb
+homepage: https://github.com/github/bsale-api-wrapper
+licenses: []
+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: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: A wrapper around the Bsale API.
+test_files: []