octobat 2.0.17 → 2.0.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: cba02a0cbd6ef4f0f6f8687a7addcd59dd96a294
-  data.tar.gz: b519371775c52b8b6f6a8b30b11fabc9729f0cc1
+SHA256:
+  metadata.gz: f103ca1de7b1fa391b9e7d17530d78ada6d6353bd63c5c8e7db09047ef9e3063
+  data.tar.gz: 9aa6e8e6c71f51f678e7087f4184154c419d70399254044059d30efdceee2d8e
 SHA512:
-  metadata.gz: 06fb388b483d8fe843c6db383abfdea030775ddc4603e02862692a1a81b8d7b478fd79d69a4c422b64bc00a8ad3ff41bd96b21b3304638a806b1de69349f9bc9
-  data.tar.gz: 732c2061e95830f5a0b94ca642102f1c4d95cdaa68a80c9009030e2506d0dc6500bbd867ef45a6c0b4cd316e0d48d1a90bd9c152740bdcbeb605644c7f313196
+  metadata.gz: 5eb46faf6dfcfcc621f2aa8207a42e9c214b8af361bbc657058213e447e9a4b0bab9bcc274ebb68b7a5dc29a1b478568db23eded829becdb7f01f762153b511d
+  data.tar.gz: 3fcd9c96dfd1d01d9ba83e6cdaa166ac9604eb67d48d364b3b9c3fe379528c4f02962f531f2d58d204ce8d97973171ddd554f2b61207d86c0031e51d539aa06e

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    octobat (2.0.17)
+    octobat (2.0.22)
       rest-client (>= 1.4, < 4.0)
 
 GEM
@@ -9,19 +9,21 @@ GEM
   specs:
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
+    http-accept (1.7.0)
     http-cookie (1.0.3)
       domain_name (~> 0.5)
-    mime-types (3.2.2)
+    mime-types (3.3.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2019.0331)
+    mime-types-data (3.2020.1104)
     netrc (0.11.0)
-    rest-client (2.0.2)
+    rest-client (2.1.0)
+      http-accept (>= 1.7.0, < 2.0)
       http-cookie (>= 1.0.2, < 2.0)
       mime-types (>= 1.16, < 4.0)
       netrc (~> 0.8)
     unf (0.1.4)
       unf_ext
-    unf_ext (0.0.7.6)
+    unf_ext (0.0.7.7)
 
 PLATFORMS
   ruby
@@ -30,4 +32,4 @@ DEPENDENCIES
   octobat!
 
 BUNDLED WITH
-   1.14.6
+   1.17.3

data/History.txt

@@ -1,3 +1,29 @@
+=== 2.0.22 2020-11-23
+* 1 minor enhancements:
+  * Add support for CustomerBalanceTransaction object
+
+=== 2.0.21 2020-11-12
+* 3 major enhancements:
+  * Add support for Supplier object
+  * Add support for SelfBillingInvoice object
+  * Add support for PurchaseItem object
+
+=== 2.0.20 2020-10-05
+* 1 major enhancements:
+  * Add support for Beanie::Session object
+
+=== 2.0.19 2020-05-28
+* 2 major enhancements:
+  * Add { opts } param for all nested methods, so you can include headers such as the Connected Octobat Account ID in subrequests
+  * Add support for CreditNote#cancel endpoint
+
+
+=== 2.0.18 2020-05-25
+* 3 major enhancements:
+  * Add support for multipart encoder (file upload)
+  * Add support for File API endpoints
+  * Add support for Reporting API endpoints
+
 === 2.0.17 2020-04-27
 * 1 minor enhancement:
   * Update Order API endpoints

data/VERSION

@@ -1 +1 @@
-2.0.17
+2.0.22

data/lib/octobat.rb

@@ -17,6 +17,7 @@ require 'octobat/api_operations/delete'
 require 'octobat/api_operations/list'
 
 # Resources
+require 'octobat/multipart_encoder'
 require 'octobat/util'
 require 'octobat/octobat_object'
 require 'octobat/api_resource'
@@ -24,11 +25,15 @@ require 'octobat/singleton_api_resource'
 require 'octobat/list_object'
 
 require 'octobat/customer'
+require 'octobat/supplier'
 require 'octobat/transaction'
+require 'octobat/customer_balance_transaction'
 require 'octobat/item'
+require 'octobat/purchase_item'
 require 'octobat/document'
 require 'octobat/invoice'
 require 'octobat/credit_note'
+require 'octobat/self_billing_invoice'
 require 'octobat/proforma_invoice'
 require 'octobat/payment_recipient'
 require 'octobat/payment_recipient_reference'
@@ -51,6 +56,13 @@ require 'octobat/exports_setting'
 require 'octobat/emails_setting'
 require 'octobat/tax_id'
 
+require 'octobat/file_upload'
+require 'octobat/file_link'
+require 'octobat/beanie/session'
+require 'octobat/reporting/report_type'
+require 'octobat/reporting/report_run'
+
+
 # Errors
 require 'octobat/errors/octobat_error'
 require 'octobat/errors/octobat_lib_error'
@@ -63,6 +75,7 @@ module Octobat
   #DEFAULT_CA_BUNDLE_PATH = File.dirname(__FILE__) + '/data/ca-certificates.crt'
   @api_base = 'https://apiv2.octobat.com'
   #@api_base = 'http://api.octobat.local:3052'
+  @uploads_base = "https://files.octobat.com"
 
   @max_network_retries = 0
   @max_network_retry_delay = 2
@@ -75,7 +88,7 @@ module Octobat
 
 
   class << self
-    attr_accessor :api_key, :api_base, :verify_ssl_certs, :api_version
+    attr_accessor :api_key, :api_base, :verify_ssl_certs, :api_version, :uploads_base
     attr_reader :max_network_retry_delay, :initial_network_retry_delay
   end
 

data/lib/octobat/beanie/session.rb

@@ -0,0 +1,13 @@
+module Octobat
+  module Beanie
+    class Session < APIResource
+      include Octobat::APIOperations::Create
+      extend Octobat::APIOperations::List
+      
+      def self.url
+        '/beanie/sessions'
+      end
+      
+    end
+  end
+end

data/lib/octobat/coupon.rb

@@ -4,20 +4,21 @@ module Octobat
     include Octobat::APIOperations::Create
     include Octobat::APIOperations::Update
 
-    def activate
-      response, api_key = Octobat.request(:patch, activate_url, @api_key)
+    def activate(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, activate_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def unactivate
-      response, api_key = Octobat.request(:patch, unactivate_url, @api_key)
+    def unactivate(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, unactivate_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def delete
-      response, api_key = Octobat.request(:delete, url, @api_key)
+    def delete(params = {}, opts = {})
+      response, api_key = Octobat.request(:delete, url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
+    
 
     private
 

data/lib/octobat/credit_note.rb

@@ -12,30 +12,41 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:post, url + '/pdf_export', api_key, params)
+      response, api_key = Octobat.request(:post, url + '/pdf_export', api_key, params, headers)
       return true
     end
     
 
-    def send_by_email(email_data = {})
-      response, api_key = Octobat.request(:post, send_url, @api_key, email_data)
+    def send_by_email(params = {}, opts = {})
+      response, api_key = Octobat.request(:post, send_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def confirm(confirmation_data = {})
-      response, api_key = Octobat.request(:patch, confirm_url, @api_key, confirmation_data)
+    def confirm(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, confirm_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
+    
+    
+    def cancel(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, cancel_url, @api_key, params, opts)
+      refresh_from(response, api_key)
+    end
+    
+    
 
-    def items(params = {})
-      Item.list(params.merge({credit_note: id }), @api_key)
+    def items(params = {}, opts = {})
+      Item.list(params.merge({ credit_note: id }), {api_key: @api_key}.merge(opts))
     end
 
-    def transactions(params = {})
-      Transaction.list(params.merge(credit_note: id), @api_key)
+    def transactions(params = {}, opts = {})
+      Transaction.list(params.merge(credit_note: id), {api_key: @api_key}.merge(opts))
     end
 
     private
+      def cancel_url
+        url + '/cancel'
+      end
 
       def send_url
         url + '/send'

data/lib/octobat/credit_note_numbering_sequence.rb

@@ -4,8 +4,8 @@ module Octobat
     include Octobat::APIOperations::Create
     include Octobat::APIOperations::Update
 
-    def set_to_default
-      response, api_key = Octobat.request(:patch, set_to_default_url, @api_key)
+    def set_to_default(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, set_to_default_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 

data/lib/octobat/customer.rb

@@ -5,16 +5,21 @@ module Octobat
     include Octobat::APIOperations::Update
     include Octobat::APIOperations::Delete
 
-    def invoices(params = {})
-      Invoice.all(params.merge({ :customer => id }), @api_key)
+    def invoices(params = {}, opts = {})
+      Invoice.list(params.merge({ :customer => id }), {api_key: @api_key}.merge(opts))
     end
 
-    def credit_notes(params = {})
-      CreditNote.all(params.merge({ :customer => id }), @api_key)
+    def credit_notes(params = {}, opts = {})
+      CreditNote.list(params.merge({ :customer => id }), {api_key: @api_key}.merge(opts))
     end
 
-    def payment_sources(params = {})
-      PaymentSource.all(params.merge({ :customer => id }), @api_key)
+    def payment_sources(params = {}, opts = {})
+      PaymentSource.list(params.merge({ :customer => id }), {api_key: @api_key}.merge(opts))
     end
+    
+    def customer_balance_transactions(params = {}, opts = {})
+      CustomerBalanceTransaction.list(params.merge({ :customer => id }), {api_key: @api_key}.merge(opts))
+    end
+    
   end
 end

data/lib/octobat/customer_balance_transaction.rb

@@ -0,0 +1,50 @@
+module Octobat
+  class CustomerBalanceTransaction < APIResource
+    extend Octobat::APIOperations::List
+    include Octobat::APIOperations::Create
+    
+    
+    def url
+      !parent_obj.nil? ? parentize_url : super
+    end
+    
+    
+    def save_url
+      if self[:id] == nil && self.class.respond_to?(:create)
+        self.relative_save_url
+      else
+        url
+      end
+    end
+    
+    
+    def parentize_url
+      if parent_obj.include?(:customer)
+        "#{Customer.url}/#{CGI.escape(parent_obj[:customer])}/customer_balance_transactions/#{CGI.escape(id)}"
+      else
+        url
+      end
+    end
+    
+    
+    
+    def relative_save_url
+      if self[:customer]
+        "#{Customer.url}/#{CGI.escape(self[:customer])}/customer_balance_transactions"
+      end
+    end
+    
+
+    def self.url
+      if @parent_resource.include?(:customer)
+        "#{Customer.url}/#{CGI.escape(@parent_resource[:customer])}/customer_balance_transactions"
+      end
+    end
+
+    def self.set_parent_resource(filters)
+      @parent_resource = filters.select{|k, v| [:customer].include?(k)}
+    end
+    
+    
+  end
+end

data/lib/octobat/document.rb

@@ -1,7 +1,6 @@
 module Octobat
   class Document < APIResource
     
-    
     def self.csv_export(params = {}, opts={})
       api_key, headers = Util.parse_opts(opts)
       api_key ||= @api_key
@@ -9,7 +8,7 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:post, url + '/csv_export', api_key, params)
+      response, api_key = Octobat.request(:post, url + '/csv_export', api_key, params, opts)
       return true
     end
     

data/lib/octobat/document_email_template.rb

@@ -10,7 +10,7 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:get, url + '/default', api_key, params)
+      response, api_key = Octobat.request(:get, url + '/default', api_key, params, opts)
       instance.refresh_from(response, api_key)
       instance
     end

data/lib/octobat/document_language.rb

@@ -10,7 +10,7 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:get, url + '/default', api_key, params)
+      response, api_key = Octobat.request(:get, url + '/default', api_key, params, opts)
       instance.refresh_from(response, api_key)
       instance
     end

data/lib/octobat/document_template.rb

@@ -4,23 +4,23 @@ module Octobat
     include Octobat::APIOperations::Create
     include Octobat::APIOperations::Update
 
-    def duplicate(params = {})
-      response, api_key = Octobat.request(:post, duplicate_url, @api_key, params)
+    def duplicate(params = {}, opts = {})
+      response, api_key = Octobat.request(:post, duplicate_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def activate
-      response, api_key = Octobat.request(:patch, activate_url, @api_key)
+    def activate(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, activate_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def delete
-      response, api_key = Octobat.request(:delete, url, @api_key)
+    def delete(params = {}, opts = {})
+      response, api_key = Octobat.request(:delete, url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
     
-    def preview(params = {})
-      response, api_key = Octobat.request(:get, preview_url, @api_key, params)
+    def preview(params = {}, opts = {})
+      response, api_key = Octobat.request(:get, preview_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 

data/lib/octobat/emails_setting.rb

@@ -10,7 +10,7 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:get, url + '/default', api_key, params)
+      response, api_key = Octobat.request(:get, url + '/default', api_key, params, opts)
       instance.refresh_from(response, api_key)
       instance
     end

data/lib/octobat/exports_setting.rb

@@ -10,7 +10,7 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:get, url + '/default', api_key, params)
+      response, api_key = Octobat.request(:get, url + '/default', api_key, params, opts)
       instance.refresh_from(response, api_key)
       instance
     end

data/lib/octobat/file_link.rb

@@ -0,0 +1,41 @@
+module Octobat
+  class FileLink < APIResource
+    include Octobat::APIOperations::Create
+    extend Octobat::APIOperations::List
+        
+    def self.create(params = {}, opts = {})
+      api_key, headers = Util.parse_opts(opts)
+      response, api_key = Octobat.request(:post, self.url, api_key, params, headers, Octobat.uploads_base)
+      Util.convert_to_octobat_object(response, api_key)
+    end
+    
+    def refresh
+      response, api_key = Octobat.request(:get, url, @api_key, @retrieve_options, @headers, Octobat.uploads_base)
+      refresh_from(response, api_key)
+    end
+    
+    def self.list(filters={}, opts={})
+      set_parent_resource(filters)
+      api_key, headers = Util.parse_opts(opts)
+      
+      api_key ||= @api_key
+
+      f = filters.select{|request_filter| !@parent_resource.has_key?(request_filter)}
+
+      response, api_key = Octobat.request(:get, url, api_key, f, headers, Octobat.uploads_base)
+      obj = ListObject.construct_from(response, api_key)
+
+      obj.filters = filters.dup
+      obj.cursors[:ending_before] = obj.filters.delete(:ending_before)
+      obj.cursors[:starting_after] = obj.filters.delete(:starting_after)
+
+      obj.filters.delete(:expand)
+      obj.parent_resource = @parent_resource
+
+      obj
+    end
+    
+    self.singleton_class.send(:alias_method, :all, :list)
+    
+  end
+end

data/lib/octobat/file_upload.rb

@@ -0,0 +1,59 @@
+module Octobat
+  class FileUpload < APIResource
+    include Octobat::APIOperations::Create
+    extend Octobat::APIOperations::List
+    
+    def self.url
+      "/files"
+    end
+    
+    
+    def self.create(params = {}, opts = {})
+      if params[:attachment] && !params[:attachment].is_a?(String)
+        unless params[:attachment].respond_to?(:read)
+          raise ArgumentError, "attachment must respond to `#read`"
+        end
+      end
+      
+      api_key, headers = Util.parse_opts(opts)
+      headers = headers.merge(content_type: MultipartEncoder::MULTIPART_FORM_DATA)
+      
+      response, api_key = Octobat.request(:post, self.url, api_key, params, headers, Octobat.uploads_base)
+      Util.convert_to_octobat_object(response, api_key)
+      
+    end
+        
+    def refresh
+      response, api_key = Octobat.request(:get, url, @api_key, @retrieve_options, @headers, Octobat.uploads_base)
+      refresh_from(response, api_key)
+    end
+    
+    
+    def self.list(filters={}, opts={})
+      set_parent_resource(filters)
+      api_key, headers = Util.parse_opts(opts)
+      
+      api_key ||= @api_key
+
+      f = filters.select{|request_filter| !@parent_resource.has_key?(request_filter)}
+
+      response, api_key = Octobat.request(:get, url, api_key, f, headers, Octobat.uploads_base)
+      obj = ListObject.construct_from(response, api_key)
+
+      obj.filters = filters.dup
+      obj.cursors[:ending_before] = obj.filters.delete(:ending_before)
+      obj.cursors[:starting_after] = obj.filters.delete(:starting_after)
+
+      obj.filters.delete(:expand)
+      obj.parent_resource = @parent_resource
+
+      obj
+    end
+    
+    self.singleton_class.send(:alias_method, :all, :list)
+
+    
+    
+    
+  end
+end

data/lib/octobat/invoice.rb

@@ -12,7 +12,7 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:post, url + '/pdf_export', api_key, params)
+      response, api_key = Octobat.request(:post, url + '/pdf_export', api_key, params, opts)
       return true
     end
     
@@ -23,42 +23,42 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:post, url + '/csv_export', api_key, params)
+      response, api_key = Octobat.request(:post, url + '/csv_export', api_key, params, opts)
       return true
     end
     
 
-    def send_by_email(email_data = {})
-      response, api_key = Octobat.request(:post, send_url, @api_key, email_data)
+    def send_by_email(params = {}, opts = {})
+      response, api_key = Octobat.request(:post, send_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def confirm(confirmation_data = {})
-      response, api_key = Octobat.request(:patch, confirm_url, @api_key, confirmation_data)
+    def confirm(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, confirm_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def cancel
-      response, api_key = Octobat.request(:patch, cancel_url, @api_key)
+    def cancel(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, cancel_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def cancel_and_replace
-      response, api_key = Octobat.request(:patch, cancel_and_replace_url, @api_key)
+    def cancel_and_replace(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, cancel_and_replace_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def delete
-      response, api_key = Octobat.request(:delete, url, @api_key)
+    def delete(params = {}, opts = {})
+      response, api_key = Octobat.request(:delete, url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def items(params = {})
-      Item.list(params.merge({ :invoice => id }), @api_key)
+    def items(params = {}, opts = {})
+      Item.list(params.merge({ :invoice => id }), {api_key: @api_key}.merge(opts))
     end
 
-    def transactions(params = {})
-      Transaction.list(params.merge(invoice: id), @api_key)
+    def transactions(params = {}, opts = {})
+      Transaction.list(params.merge(invoice: id), {api_key: @api_key}.merge(opts))
     end
 
 

data/lib/octobat/invoice_numbering_sequence.rb

@@ -4,8 +4,8 @@ module Octobat
     include Octobat::APIOperations::Create
     include Octobat::APIOperations::Update
 
-    def set_to_default
-      response, api_key = Octobat.request(:patch, set_to_default_url, @api_key)
+    def set_to_default(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, set_to_default_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 

data/lib/octobat/multipart_encoder.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+require "securerandom"
+require "tempfile"
+
+module Octobat
+  # Encodes parameters into a `multipart/form-data` payload as described by RFC
+  # 2388:
+  #
+  #     https://tools.ietf.org/html/rfc2388
+  #
+  # This is most useful for transferring file-like objects.
+  #
+  # Parameters should be added with `#encode`. When ready, use `#body` to get
+  # the encoded result and `#content_type` to get the value that should be
+  # placed in the `Content-Type` header of a subsequent request (which includes
+  # a boundary value).
+  class MultipartEncoder
+    MULTIPART_FORM_DATA = "multipart/form-data"
+
+    # A shortcut for encoding a single set of parameters and finalizing a
+    # result.
+    #
+    # Returns an encoded body and the value that should be set in the content
+    # type header of a subsequent request.
+    def self.encode(params)
+      encoder = MultipartEncoder.new
+      encoder.encode(params)
+      encoder.close
+      [encoder.body, encoder.content_type]
+    end
+
+    # Gets the object's randomly generated boundary string.
+    attr_reader :boundary
+
+    # Initializes a new multipart encoder.
+    def initialize
+      # Kind of weird, but required by Rubocop because the unary plus operator
+      # is considered faster than `Octobat.new`.
+      @body = +""
+
+      # Chose the same number of random bytes that Go uses in its standard
+      # library implementation. Easily enough entropy to ensure that it won't
+      # be present in a file we're sending.
+      @boundary = SecureRandom.hex(30)
+
+      @closed = false
+      @first_field = true
+    end
+
+    # Gets the encoded body. `#close` must be called first.
+    def body
+      raise "object must be closed before getting body" unless @closed
+
+      @body
+    end
+
+    # Finalizes the object by writing the final boundary.
+    def close
+      raise "object already closed" if @closed
+
+      @body << "\r\n"
+      @body << "--#{@boundary}--"
+
+      @closed = true
+
+      nil
+    end
+
+    # Gets the value including boundary that should be put into a multipart
+    # request's `Content-Type`.
+    def content_type
+      "#{MULTIPART_FORM_DATA}; boundary=#{@boundary}"
+    end
+
+    # Encodes a set of parameters to the body.
+    #
+    # Note that parameters are expected to be a hash, but a "flat" hash such
+    # that complex substructures like hashes and arrays have already been
+    # appropriately Octobat-encoded. Pass a complex structure through
+    # `Util.flatten_params` first before handing it off to this method.
+    def encode(params)
+      raise "no more parameters can be written to closed object" if @closed
+
+      params.each do |name, val|
+        if val.is_a?(::File) || val.is_a?(::Tempfile)
+          write_field(name, val.read, filename: ::File.basename(val.path))
+        elsif val.respond_to?(:read)
+          write_field(name, val.read, filename: "blob")
+        else
+          write_field(name, val, filename: nil)
+        end
+      end
+
+      nil
+    end
+
+    #
+    # private
+    #
+
+    # Escapes double quotes so that the given value can be used in a
+    # double-quoted string and replaces any linebreak characters with spaces.
+    private def escape(str)
+      str.gsub('"', "%22").tr("\n", " ").tr("\r", " ")
+    end
+
+    private def write_field(name, data, filename:)
+      if !@first_field
+        @body << "\r\n"
+      else
+        @first_field = false
+      end
+
+      @body << "--#{@boundary}\r\n"
+
+      if filename
+        @body << %(Content-Disposition: form-data) +
+                 %(; name="#{escape(name.to_s)}") +
+                 %(; filename="#{escape(filename)}"\r\n)
+        @body << %(Content-Type: application/octet-stream\r\n)
+      else
+        @body << %(Content-Disposition: form-data) +
+                 %(; name="#{escape(name.to_s)}"\r\n)
+      end
+
+      @body << "\r\n"
+      @body << data.to_s
+    end
+  end
+end

data/lib/octobat/order.rb

@@ -3,8 +3,8 @@ module Octobat
     extend Octobat::APIOperations::List
     include Octobat::APIOperations::Update
     
-    def expire
-      response, api_key = Octobat.request(:patch, expire_url, @api_key)
+    def expire(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, expire_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 

data/lib/octobat/payout.rb

@@ -2,8 +2,8 @@ module Octobat
   class Payout < APIResource
     extend Octobat::APIOperations::List
     
-    def balance_transactions(params = {})
-      BalanceTransaction.list(params.merge({ payout: id }), @api_key)
+    def balance_transactions(params = {}, opts = {})
+      BalanceTransaction.list(params.merge({ payout: id }), {api_key: @api_key}.merge(opts))
     end
     
     def self.csv_export(params = {}, opts={})

data/lib/octobat/purchase_item.rb

@@ -0,0 +1,52 @@
+module Octobat
+  class PurchaseItem < APIResource
+    extend Octobat::APIOperations::List
+    include Octobat::APIOperations::Create
+    include Octobat::APIOperations::Update
+    include Octobat::APIOperations::Delete
+    
+    
+    def url
+      !parent_obj.nil? ? parentize_url : super
+    end
+    
+    
+    def save_url
+      if self[:id] == nil && self.class.respond_to?(:create)
+        self.relative_save_url
+      else
+        url
+      end
+    end
+    
+    
+    def parentize_url
+      if parent_obj.include?(:self_billing_invoice)
+        "#{SelfBillingInvoice.url}/#{CGI.escape(parent_obj[:self_billing_invoice])}/purchase_items/#{CGI.escape(id)}"
+      else
+        url
+      end
+    end
+    
+    
+    
+    def relative_save_url
+      if self[:self_billing_invoice]
+        "#{SelfBillingInvoice.url}/#{CGI.escape(self[:self_billing_invoice])}/purchase_items"
+      end
+    end
+    
+
+    def self.url
+      if @parent_resource.include?(:self_billing_invoice)
+        "#{SelfBillingInvoice.url}/#{CGI.escape(@parent_resource[:self_billing_invoice])}/purchase_items"
+      end
+    end
+
+    def self.set_parent_resource(filters)
+      @parent_resource = filters.select{|k, v| [:self_billing_invoice].include?(k)}
+    end
+    
+    
+  end
+end

data/lib/octobat/reporting/report_run.rb

@@ -0,0 +1,12 @@
+module Octobat
+  module Reporting
+    class ReportRun < APIResource
+      include Octobat::APIOperations::Create
+      extend Octobat::APIOperations::List
+      
+      def self.url
+        '/reporting/report_runs'
+      end
+    end
+  end
+end

data/lib/octobat/reporting/report_type.rb

@@ -0,0 +1,12 @@
+module Octobat
+  module Reporting
+    class ReportType < APIResource
+      extend Octobat::APIOperations::List
+      
+      def self.url
+        '/reporting/report_types'
+      end
+      
+    end
+  end
+end

data/lib/octobat/self_billing_invoice.rb

@@ -0,0 +1,77 @@
+module Octobat
+  class SelfBillingInvoice < APIResource
+    extend Octobat::APIOperations::List
+    include Octobat::APIOperations::Create
+    include Octobat::APIOperations::Update
+    
+    
+    # def self.pdf_export(params = {}, opts={})
+    #   api_key, headers = Util.parse_opts(opts)
+    #   api_key ||= @api_key
+    #   opts[:api_key] = api_key
+    #
+    #   instance = self.new(nil, opts)
+    #
+    #   response, api_key = Octobat.request(:post, url + '/pdf_export', api_key, params, opts)
+    #   return true
+    # end
+    #
+    # def self.csv_export(params = {}, opts={})
+    #   api_key, headers = Util.parse_opts(opts)
+    #   api_key ||= @api_key
+    #   opts[:api_key] = api_key
+    #
+    #   instance = self.new(nil, opts)
+    #
+    #   response, api_key = Octobat.request(:post, url + '/csv_export', api_key, params, opts)
+    #   return true
+    # end
+    
+
+    def send_by_email(params = {}, opts = {})
+      response, api_key = Octobat.request(:post, send_url, @api_key, params, opts)
+      refresh_from(response, api_key)
+    end
+
+    def confirm(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, confirm_url, @api_key, params, opts)
+      refresh_from(response, api_key)
+    end
+
+    def cancel(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, cancel_url, @api_key, params, opts)
+      refresh_from(response, api_key)
+    end
+
+    def delete(params = {}, opts = {})
+      response, api_key = Octobat.request(:delete, url, @api_key, params, opts)
+      refresh_from(response, api_key)
+    end
+
+    def purchase_items(params = {}, opts = {})
+      PurchaseItem.list(params.merge({ :self_billing_invoice => id }), {api_key: @api_key}.merge(opts))
+    end
+
+    # def transactions(params = {}, opts = {})
+    #   Transaction.list(params.merge(invoice: id), {api_key: @api_key}.merge(opts))
+    # end
+
+
+    private
+
+      def send_url
+        url + '/send'
+      end
+
+      def confirm_url
+        url + '/confirm'
+      end
+
+      def cancel_url
+        url + '/cancel'
+      end
+
+  end
+
+
+end

data/lib/octobat/supplier.rb

@@ -0,0 +1,8 @@
+module Octobat
+  class Supplier < APIResource
+    extend Octobat::APIOperations::List
+    include Octobat::APIOperations::Create
+    include Octobat::APIOperations::Update
+    include Octobat::APIOperations::Delete
+  end
+end

data/lib/octobat/tax_evidence_request.rb

@@ -9,7 +9,7 @@ module Octobat
 
       instance = self.new(nil, opts)
 
-      response, api_key = Octobat.request(:post, url + '/for_supplier', api_key, params)
+      response, api_key = Octobat.request(:post, url + '/for_supplier', api_key, params, opts)
       instance.refresh_from(response, api_key)
       instance
     end

data/lib/octobat/tax_id.rb

@@ -4,8 +4,8 @@ module Octobat
     include Octobat::APIOperations::Create
     include Octobat::APIOperations::Update
 
-    def archive
-      response, api_key = Octobat.request(:patch, archive_url, @api_key)
+    def archive(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, archive_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 

data/lib/octobat/tax_region_setting.rb

@@ -4,13 +4,13 @@ module Octobat
     include Octobat::APIOperations::Update
     include Octobat::APIOperations::Create
 
-    def activate
-      response, api_key = Octobat.request(:patch, activate_url, @api_key)
+    def activate(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, activate_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 
-    def unactivate
-      response, api_key = Octobat.request(:patch, unactivate_url, @api_key)
+    def unactivate(params = {}, opts = {})
+      response, api_key = Octobat.request(:patch, unactivate_url, @api_key, params, opts)
       refresh_from(response, api_key)
     end
 

data/lib/octobat/transaction.rb

@@ -4,8 +4,8 @@ module Octobat
     include Octobat::APIOperations::Create
     include Octobat::APIOperations::Update
 
-    def items(params = {})
-      Item.list(params.merge({ :transaction => id }), @api_key)
+    def items(params = {}, opts = {})
+      Item.list(params.merge({ :transaction => id }), {api_key: @api_key}.merge(opts))
     end
     
     def self.csv_export(params = {}, opts={})

data/lib/octobat/util.rb

@@ -47,7 +47,11 @@ module Octobat
         'invoice' => Invoice,
         'credit_note' => CreditNote,
         'item' => Item,
+        'purchase_item' => PurchaseItem,
         'customer' => Customer,
+        'customer_balance_transaction' => CustomerBalanceTransaction,
+        'supplier' => Supplier,
+        'self_billing_invoice' => SelfBillingInvoice,
         'payout' => Payout,
         'balance_transaction' => BalanceTransaction,
         'document_template' => DocumentTemplate,
@@ -65,7 +69,12 @@ module Octobat
         'document_email_template' => DocumentEmailTemplate,
         'exports_setting' => ExportsSetting,
         'document' => Document,
-        'emails_setting' => EmailsSetting
+        'emails_setting' => EmailsSetting,
+        'file' => FileUpload,
+        'file_link' => FileLink,
+        'beanie.session' => Beanie::Session,
+        'reporting.report_type' => Reporting::ReportType,
+        'reporting.report_run' => Reporting::ReportRun
       }
     end
 

data/lib/octobat/version.rb

@@ -1,3 +1,3 @@
 module Octobat
-  VERSION = '2.0.17'
+  VERSION = '2.0.22'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: octobat
 version: !ruby/object:Gem::Version
-  version: 2.0.17
+  version: 2.0.22
 platform: ruby
 authors:
 - Gaultier Laperche
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-20 00:00:00.000000000 Z
+date: 2020-11-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -61,12 +61,14 @@ files:
 - lib/octobat/api_operations/update.rb
 - lib/octobat/api_resource.rb
 - lib/octobat/balance_transaction.rb
+- lib/octobat/beanie/session.rb
 - lib/octobat/certificate_blacklist.rb
 - lib/octobat/checkout.rb
 - lib/octobat/coupon.rb
 - lib/octobat/credit_note.rb
 - lib/octobat/credit_note_numbering_sequence.rb
 - lib/octobat/customer.rb
+- lib/octobat/customer_balance_transaction.rb
 - lib/octobat/document.rb
 - lib/octobat/document_email_template.rb
 - lib/octobat/document_language.rb
@@ -79,10 +81,13 @@ files:
 - lib/octobat/errors/octobat_error.rb
 - lib/octobat/errors/octobat_lib_error.rb
 - lib/octobat/exports_setting.rb
+- lib/octobat/file_link.rb
+- lib/octobat/file_upload.rb
 - lib/octobat/invoice.rb
 - lib/octobat/invoice_numbering_sequence.rb
 - lib/octobat/item.rb
 - lib/octobat/list_object.rb
+- lib/octobat/multipart_encoder.rb
 - lib/octobat/octobat_object.rb
 - lib/octobat/order.rb
 - lib/octobat/payment_recipient.rb
@@ -91,7 +96,12 @@ files:
 - lib/octobat/payout.rb
 - lib/octobat/product.rb
 - lib/octobat/proforma_invoice.rb
+- lib/octobat/purchase_item.rb
+- lib/octobat/reporting/report_run.rb
+- lib/octobat/reporting/report_type.rb
+- lib/octobat/self_billing_invoice.rb
 - lib/octobat/singleton_api_resource.rb
+- lib/octobat/supplier.rb
 - lib/octobat/tax_evidence.rb
 - lib/octobat/tax_evidence_request.rb
 - lib/octobat/tax_id.rb
@@ -120,7 +130,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.7.6.2
 signing_key: 
 specification_version: 4
 summary: Ruby bindings for the Octobat API