bukku_rails 0.1.4 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df23a6a528a26b6ee952178ab0f4ecc1695b788e205044c5a373fd807df81c1d
-  data.tar.gz: 858aa3808ea2089f9c5854ad02a823ec5ba13b678c3c033daacb6494896fac92
+  metadata.gz: c67f4ffcd9e8bb2bba1d68c241003ba09ade70e0e7b5006a01373d047b4cf5e9
+  data.tar.gz: aa4ae29f71918a76fcdab8ac286752dd5b8f4ad9ae79fb4089b2da95c5f5e4bf
 SHA512:
-  metadata.gz: e61943b4520221cf4286a2cb8cc426e074cdfc5eeeb270f1548d84d2dc7ec285ed0caccffad3847aa7fa65d4c15d4e60a0dee25209c007d81f9751b70cd72d20
-  data.tar.gz: a1b401386099562ee80bbd86717aa39b9132a55842c69627758e1c454c3ec4ee279fe1a642773feabdeebcfd2e26e226ae0e62c33e32885e757b736183070895
+  metadata.gz: cacbd80c9079264a39ac0426777de2d9110e974599768585685066f6cc04e2acec4fb371562b49759d6ff91385d91f3f05132b96c2b3580139aa69782dc1a868
+  data.tar.gz: 034b19b90d92d54f5f6361b8ba977b39a4c00d5a727fcb970e2cab6191fda237f87d9d29513bea1f51a5d976d053c676a21721643429a820b7e646af0064c922

data/README.md

@@ -8,9 +8,19 @@ Take a look at [Bukku's API](https://developers.bukku.my) to know what data you
 
 ## Installation
 
-Add the gen into your Gemfile like so:
+### Rails
 
-`gem "bukku_rails`
+Add the gem into your Gemfile like so:
+
+`gem "bukku_rails"`
+
+### Ruby
+
+1. Install the gem `gem install bukku_rails`
+
+2. Test the gem standalone `irb -r bukku_rails`
+
+3. If your satisfied with the gem usage you can include the gem in your `Gemfile` of your app.
 
 ## Usage
 
@@ -18,9 +28,17 @@ You will need 2 things - your **subdomain** and **API Token**.
 
 You can get these after you login into your Bukku account, Control Panel -> Integrations -> Turn ON API Access.
 
-Note: Bukku offers 2 type of access - Staging and Production. You can [email Bukku](mailto:dev@bukku.my) for a Staging account which will be a great way to test your Rails app to see if it is extracting the correct data from Bukku's staging server (exactly the same app but at their staging server). Once you are satisfied you can then use access the Production server where your actual data lives.
+Note: Bukku offers 2 type of access:
+
+1. *Staging* - For testing your app. You can [email Bukku](mailto:dev@bukku.my) for a Staging account which will be a great way to test your Rails app to see if it is extracting the correct data from Bukku's staging server (exactly the same app).
+
+2. *Production* - Your actual Bukku data, where all your data lives.
+
+**Bukku Rails** provides usage for both access, under 2 different classes:
+
+1. *Staging* use the `BukkuTest` class, like so `client = BukkuTest.new(domain: "sub-domain", token: "token-from-bukku-fyi")`
 
-**Bukku Rails** provides usage for both access. For Staging use the `BukkuTest` class and actual Production simply use `Bukku` class. Then you can use any of the methods listed in the table below:
+2. *Production* use `Bukku` class, like so `client = Bukku.new(domain: "sub-domain", token: "token-from-bukku-my")`
 
 ### Available Methods
 
@@ -30,74 +48,74 @@ Just like in Rails the methods follow the singular and plural expression. Method
 
 | HTTP Method | Ruby Method | Endpoint |
 |------------|-------------|----------|
-| GET | `get_sales_quotes(**kwargs)` | `/sales/quotes` |
+| GET | `get_sales_quotes(query-parameters)` | `/sales/quotes` |
 | GET | `get_sales_quote(id)` | `/sales/quotes/:id` |
-| GET | `get_sales_orders(**kwargs)` | `/sales/orders` |
+| GET | `get_sales_orders(query-parameters)` | `/sales/orders` |
 | GET | `get_sales_order(id)` | `/sales/orders/:id` |
-| GET | `get_delivery_orders(**kwargs)` | `/sales/delivery_orders` |
+| GET | `get_delivery_orders(query-parameters)` | `/sales/delivery_orders` |
 | GET | `get_delivery_order(id)` | `/sales/delivery_orders/:id` |
-| GET | `get_invoices(**kwargs)` | `/sales/invoices` |
+| GET | `get_invoices(query-parameters)` | `/sales/invoices` |
 | GET | `get_invoice(id)` | `/sales/invoices/:id` |
-| GET | `get_sales_credit_notes(**kwargs)` | `/sales/credit_notes` |
+| GET | `get_sales_credit_notes(query-parameters)` | `/sales/credit_notes` |
 | GET | `get_sales_credit_note(id)` | `/sales/credit_notes/:id` |
-| GET | `get_sales_payments(**kwargs)` | `/sales/payments` |
+| GET | `get_sales_payments(query-parameters)` | `/sales/payments` |
 | GET | `get_sales_payment(id)` | `/sales/payments/:id` |
-| GET | `get_sales_refunds(**kwargs)` | `/sales/refunds` |
+| GET | `get_sales_refunds(query-parameters)` | `/sales/refunds` |
 | GET | `get_sales_refund(id)` | `/sales/refunds/:id` |
 
 #### Purchases
 
 | HTTP Method | Ruby Method | Endpoint |
 |------------|-------------|----------|
-| GET | `get_purchase_orders(**kwargs)` | `/purchases/orders` |
+| GET | `get_purchase_orders(query-parameters)` | `/purchases/orders` |
 | GET | `get_purchase_order(id)` | `/purchases/orders/:id` |
-| GET | `get_received_notes(**kwargs)` | `/purchases/goods_received_notes` |
+| GET | `get_received_notes(query-parameters)` | `/purchases/goods_received_notes` |
 | GET | `get_received_note(id)` | `/purchases/goods_received_notes/:id` |
-| GET | `get_bills(**kwargs)` | `/purchases/bills` |
+| GET | `get_bills(query-parameters)` | `/purchases/bills` |
 | GET | `get_bill(id)` | `/purchases/bills/:id` |
-| GET | `get_purchases_credit_notes(**kwargs)` | `/purchases/credit_notes` |
+| GET | `get_purchases_credit_notes(query-parameters)` | `/purchases/credit_notes` |
 | GET | `get_purchases_credit_note(id)` | `/purchases/credit_notes/:id` |
-| GET | `get_purchases_payments(**kwargs)` | `/purchases/payments` |
+| GET | `get_purchases_payments(query-parameters)` | `/purchases/payments` |
 | GET | `get_purchases_payments(id)` | `/purchases/payments/:id` |
-| GET | `get_purchases_refunds(**kwargs)` | `/purchases/refunds` |
+| GET | `get_purchases_refunds(query-parameters)` | `/purchases/refunds` |
 | GET | `get_purchases_refund(id)` | `/purchases/refunds/:id` |
 
 #### Banking
 
 | HTTP Method | Ruby Method | Endpoint |
 |------------|-------------|----------|
-| GET | `get_banking_incomes(**kwargs)` | `/banking/incomes` |
+| GET | `get_banking_incomes(query-parameters)` | `/banking/incomes` |
 | GET | `get_banking_income(id)` | `/banking/incomes/:id` |
-| GET | `get_banking_expenses(**kwargs)` | `/banking/expenses` |
+| GET | `get_banking_expenses(query-parameters)` | `/banking/expenses` |
 | GET | `get_banking_expense(id)` | `/banking/expenses/:id` |
-| GET | `get_transfers(**kwargs)` | `/banking/transfers` |
+| GET | `get_transfers(query-parameters)` | `/banking/transfers` |
 | GET | `get_transfer(id)` | `/banking/transfers/:id` |
 
 #### Contacts
 
 | HTTP Method | Ruby Method | Endpoint |
 |------------|-------------|----------|
-| GET | `get_contacts(**kwargs)` | `/contacts` |
+| GET | `get_contacts(query-parameters)` | `/contacts` |
 | GET | `get_contact(id)` | `/contacts/:id` |
-| GET | `get_contact_groups(**kwargs)` | `/contacts/groups` |
+| GET | `get_contact_groups(query-parameters)` | `/contacts/groups` |
 | GET | `get_contact_group(id)` | `/contacts/groups/:id` |
 
 #### Products
 
 | HTTP Method | Ruby Method | Endpoint |
 |------------|-------------|----------|
-| GET | `get_products(**kwargs)` | `/products` |
+| GET | `get_products(query-parameters)` | `/products` |
 | GET | `get_product(id)` | `/products/:id` |
-| GET | `get_product_groups(**kwargs)` | `/products/groups` |
+| GET | `get_product_groups(query-parameters)` | `/products/groups` |
 | GET | `get_product_group(id)` | `/products/groups/:id` |
 
 #### Accounting
 
 | HTTP Method | Ruby Method | Endpoint |
 |------------|-------------|----------|
-| GET | `get_journal_entries(**kwargs)` | `/journal_entries` |
+| GET | `get_journal_entries(query-parameters)` | `/journal_entries` |
 | GET | `get_journal_entry(id)` | `/journal_entries/:id` |
-| GET | `get_accounts(**kwargs)` | `/accounts` |
+| GET | `get_accounts(query-parameters)` | `/accounts` |
 | GET | `get_account(id)` | `/accounts/:id` |
 
 ### Examples

data/lib/bukku.rb

@@ -1,9 +1,9 @@
 class Bukku < Client
   # Usage of this integration as follows:
-  # access = Bukku.new(token: "bukku_token_key", domain: "domain")
-  # respond = access.<method>(parameters)
-  # Example: respond = access.get_sales_invoices(date_from: "2025-11-25", date_to: "2025-11-30")
+  # access = BukkuTest.new(token: "bukku_token_key", domain: "domain")
+  # respond = access.<method>
 
+  # Testing URL
   BASE_URI = 'https://api.bukku.my'
 
   ## SALES
@@ -16,6 +16,10 @@ class Bukku < Client
     get "/sales/quotes/#{id}"
   end
 
+  def create_quote(body:)
+    post '/sales/quotes', body: body
+  end
+
   # Sales Order
   def get_sales_orders(**kwargs)
     get '/sales/orders', query: kwargs
@@ -25,6 +29,10 @@ class Bukku < Client
     get "/sales/orders/#{id}"
   end
 
+  def create_sales_order(body:)
+    post '/sales/orders', body: body
+  end
+
   # Delivery Order
   def get_delivery_orders(**kwargs)
     get '/sales/delivery_orders', query: kwargs
@@ -34,6 +42,10 @@ class Bukku < Client
     get "/sales/delivery_orders/#{id}"
   end
 
+  def create_delivery_order(body:)
+    post '/sales/delivery_orders', body: body
+  end
+
   # Invoice
   def get_invoices(**kwargs)
     get '/sales/invoices', query: kwargs
@@ -43,6 +55,10 @@ class Bukku < Client
     get "/sales/invoices/#{id}"
   end
 
+  def create_invoice(body:)
+    post '/sales/invoices', body: body
+  end
+
   # Credit Note
   def get_sales_credit_notes(**kwargs)
     get '/sales/credit_notes', query: kwargs
@@ -52,6 +68,10 @@ class Bukku < Client
     get "/sales/credit_notes/#{id}"
   end
 
+  def create_credit_note(body:)
+    post '/sales/credit_notes', body: body
+  end
+
   # Payment
   def get_sales_payments(**kwargs)
     get '/sales/payments', query: kwargs
@@ -61,7 +81,11 @@ class Bukku < Client
     get "/sales/payments/#{id}"
   end
 
-  # Redund
+  def create_payment(body:)
+    post '/sales/payments', body: body
+  end
+
+  # Refund
   def get_sales_refunds(**kwargs)
     get '/sales/refunds', query: kwargs
   end
@@ -70,6 +94,10 @@ class Bukku < Client
     get "/sales/refunds/#{id}"
   end
 
+  def create_refund(body:)
+    post '/sales/refunds', body: body
+  end
+
   ## PURCHASE
   # Purchase Order
   def get_purchase_orders(**kwargs)
@@ -80,6 +108,10 @@ class Bukku < Client
     get "/purchases/orders/#{id}"
   end
 
+  def create_purchase_order(body:)
+    post '/purchases/orders', body: body
+  end
+
   ## Goods Received Note
   def get_received_notes(**kwargs)
     get '/purchases/goods_received_notes', query: kwargs
@@ -89,6 +121,10 @@ class Bukku < Client
     get "/purchases/goods_received_notes/#{id}"
   end
 
+  def create_received_note(body:)
+    post '/purchases/goods_received_notes', body: body
+  end
+
   # Bill
   def get_bills(**kwargs)
     get '/purchases/bills', query: kwargs
@@ -98,6 +134,10 @@ class Bukku < Client
     get "/purchases/bills/#{id}"
   end
 
+  def create_bill(body:)
+    post '/purchases/bills', body: body
+  end
+
   # Credit Note
   def get_purchases_credit_notes(**kwargs)
     get '/purchases/credit_notes', query: kwargs
@@ -107,6 +147,10 @@ class Bukku < Client
     get "/purchases/credit_notes/#{id}"
   end
 
+  def create_purchase_credit_note(body:)
+    post '/purchases/credit_note', body: body
+  end
+
   # Payment
   def get_purchases_payments(**kwargs)
     get '/purchases/payments', query: kwargs
@@ -116,6 +160,10 @@ class Bukku < Client
     get "/purchases/payments/#{id}"
   end
 
+  def create_purchases_payment(body:)
+    post '/purchases/payments', body: body
+  end
+
   # Refund
   def get_purchases_refunds(**kwargs)
     get '/purchases/refunds', query: kwargs
@@ -125,6 +173,10 @@ class Bukku < Client
     get "/purchases/refunds/#{id}"
   end
 
+  def create_purchases_refund(body:)
+    post '/purchases/refunds', body: body
+  end
+
   ## BANK
   # Money In
   def get_banking_incomes(**kwargs)
@@ -135,6 +187,10 @@ class Bukku < Client
     get "/banking/incomes/#{id}"
   end
 
+  def create_banking_income(body:)
+    post '/banking/incomes', body: body
+  end
+
   # Money Out
   def get_banking_expenses(**kwargs)
     get '/banking/expenses', query: kwargs
@@ -144,6 +200,10 @@ class Bukku < Client
     get "/banking/expenses/#{id}"
   end
 
+  def create_expense(body:)
+    post '/banking/expenses', body: body
+  end
+
   # Transfers
   def get_transfers(**kwargs)
     get '/banking/transfers', query: kwargs
@@ -153,6 +213,10 @@ class Bukku < Client
     get "/banking/transfers/#{id}"
   end
 
+  def create_transfer(body:)
+    post '/banking/transfer', body: body
+  end
+
   ## CONTACT
   # Contacts
   def get_contacts(**kwargs)
@@ -163,6 +227,10 @@ class Bukku < Client
     get "/contacts/#{id}"
   end
 
+  def create_contact(body:)
+    post '/contacts', body: body
+  end
+
   # Groups
   def get_contact_groups(**kwargs)
     get '/contacts/groups', query: kwargs
@@ -172,6 +240,10 @@ class Bukku < Client
     get "/contacts/groups/#{id}"
   end
 
+  def create_group(body:)
+    post '/contacts/groups', body: body
+  end
+
   ## PRODUCT
   # Product
   def get_products(**kwargs)
@@ -182,6 +254,19 @@ class Bukku < Client
     get "/products/#{id}"
   end
 
+  def create_product(body:)
+    post '/products', body: body
+  end
+
+  # Bundles
+  def get_bundle(id)
+    get "/products/bundles/#{id}"
+  end
+
+  def create_bundle(body:)
+    post '/products/bundles', body: body
+  end
+
   # Groups
   def get_product_groups(**kwargs)
     get '/products/groups', query: kwargs
@@ -191,6 +276,10 @@ class Bukku < Client
     get "/products/groups/#{id}"
   end
 
+  def create_product_group(body:)
+    post '/products/groups', body: body
+  end
+
   ## ACCOUNTING
   # Journal Entries
   def get_journal_entries(**kwargs)
@@ -201,6 +290,10 @@ class Bukku < Client
     get "/journal_entries/#{id}"
   end
 
+  def create_journal_entry(body:)
+    post '/journal_entries', body: body
+  end
+
   # Account
   def get_accounts(**kwargs)
     get '/accounts', query: kwargs
@@ -209,4 +302,13 @@ class Bukku < Client
   def get_account(id)
     get "/accounts/#{id}"
   end
+
+  def create_account(body:)
+    post '/accounts', body: body
+  end
+
+  # Files
+  def upload_file(file_data:, filename:, mime_type:)
+    upload '/files', file_data: file_data, filename: filename, mime_type: mime_type
+  end
 end

data/lib/bukku_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BukkuRails
-  VERSION = '0.1.4'
+  VERSION = '0.2.1'
 end

data/lib/bukku_test.rb

@@ -16,6 +16,10 @@ class BukkuTest < Client
     get "/sales/quotes/#{id}"
   end
 
+  def create_quote(body:)
+    post '/sales/quotes', body: body
+  end
+
   # Sales Order
   def get_sales_orders(**kwargs)
     get '/sales/orders', query: kwargs
@@ -25,6 +29,10 @@ class BukkuTest < Client
     get "/sales/orders/#{id}"
   end
 
+  def create_sales_order(body:)
+    post '/sales/orders', body: body
+  end
+
   # Delivery Order
   def get_delivery_orders(**kwargs)
     get '/sales/delivery_orders', query: kwargs
@@ -34,6 +42,10 @@ class BukkuTest < Client
     get "/sales/delivery_orders/#{id}"
   end
 
+  def create_delivery_order(body:)
+    post '/sales/delivery_orders', body: body
+  end
+
   # Invoice
   def get_invoices(**kwargs)
     get '/sales/invoices', query: kwargs
@@ -43,6 +55,10 @@ class BukkuTest < Client
     get "/sales/invoices/#{id}"
   end
 
+  def create_invoice(body:)
+    post '/sales/invoices', body: body
+  end
+
   # Credit Note
   def get_sales_credit_notes(**kwargs)
     get '/sales/credit_notes', query: kwargs
@@ -52,6 +68,10 @@ class BukkuTest < Client
     get "/sales/credit_notes/#{id}"
   end
 
+  def create_credit_note(body:)
+    post '/sales/credit_notes', body: body
+  end
+
   # Payment
   def get_sales_payments(**kwargs)
     get '/sales/payments', query: kwargs
@@ -61,7 +81,11 @@ class BukkuTest < Client
     get "/sales/payments/#{id}"
   end
 
-  # Redund
+  def create_payment(body:)
+    post '/sales/payments', body: body
+  end
+
+  # Refund
   def get_sales_refunds(**kwargs)
     get '/sales/refunds', query: kwargs
   end
@@ -70,6 +94,10 @@ class BukkuTest < Client
     get "/sales/refunds/#{id}"
   end
 
+  def create_refund(body:)
+    post '/sales/refunds', body: body
+  end
+
   ## PURCHASE
   # Purchase Order
   def get_purchase_orders(**kwargs)
@@ -80,6 +108,10 @@ class BukkuTest < Client
     get "/purchases/orders/#{id}"
   end
 
+  def create_purchase_order(body:)
+    post '/purchases/orders', body: body
+  end
+
   ## Goods Received Note
   def get_received_notes(**kwargs)
     get '/purchases/goods_received_notes', query: kwargs
@@ -89,6 +121,10 @@ class BukkuTest < Client
     get "/purchases/goods_received_notes/#{id}"
   end
 
+  def create_received_note(body:)
+    post '/purchases/goods_received_notes', body: body
+  end
+
   # Bill
   def get_bills(**kwargs)
     get '/purchases/bills', query: kwargs
@@ -98,6 +134,10 @@ class BukkuTest < Client
     get "/purchases/bills/#{id}"
   end
 
+  def create_bill(body:)
+    post '/purchases/bills', body: body
+  end
+
   # Credit Note
   def get_purchases_credit_notes(**kwargs)
     get '/purchases/credit_notes', query: kwargs
@@ -107,6 +147,10 @@ class BukkuTest < Client
     get "/purchases/credit_notes/#{id}"
   end
 
+  def create_purchase_credit_note(body:)
+    post '/purchases/credit_note', body: body
+  end
+
   # Payment
   def get_purchases_payments(**kwargs)
     get '/purchases/payments', query: kwargs
@@ -116,6 +160,10 @@ class BukkuTest < Client
     get "/purchases/payments/#{id}"
   end
 
+  def create_purchases_payment(body:)
+    post '/purchases/payments', body: body
+  end
+
   # Refund
   def get_purchases_refunds(**kwargs)
     get '/purchases/refunds', query: kwargs
@@ -125,6 +173,10 @@ class BukkuTest < Client
     get "/purchases/refunds/#{id}"
   end
 
+  def create_purchases_refund(body:)
+    post '/purchases/refunds', body: body
+  end
+
   ## BANK
   # Money In
   def get_banking_incomes(**kwargs)
@@ -135,6 +187,10 @@ class BukkuTest < Client
     get "/banking/incomes/#{id}"
   end
 
+  def create_banking_income(body:)
+    post '/banking/incomes', body: body
+  end
+
   # Money Out
   def get_banking_expenses(**kwargs)
     get '/banking/expenses', query: kwargs
@@ -144,6 +200,10 @@ class BukkuTest < Client
     get "/banking/expenses/#{id}"
   end
 
+  def create_expense(body:)
+    post '/banking/expenses', body: body
+  end
+
   # Transfers
   def get_transfers(**kwargs)
     get '/banking/transfers', query: kwargs
@@ -153,6 +213,10 @@ class BukkuTest < Client
     get "/banking/transfers/#{id}"
   end
 
+  def create_transfer(body:)
+    post '/banking/transfer', body: body
+  end
+
   ## CONTACT
   # Contacts
   def get_contacts(**kwargs)
@@ -163,6 +227,10 @@ class BukkuTest < Client
     get "/contacts/#{id}"
   end
 
+  def create_contact(body:)
+    post '/contacts', body: body
+  end
+
   # Groups
   def get_contact_groups(**kwargs)
     get '/contacts/groups', query: kwargs
@@ -172,6 +240,10 @@ class BukkuTest < Client
     get "/contacts/groups/#{id}"
   end
 
+  def create_group(body:)
+    post '/contacts/groups', body: body
+  end
+
   ## PRODUCT
   # Product
   def get_products(**kwargs)
@@ -182,6 +254,19 @@ class BukkuTest < Client
     get "/products/#{id}"
   end
 
+  def create_product(body:)
+    post '/products', body: body
+  end
+
+  # Bundles
+  def get_bundle(id)
+    get "/products/bundles/#{id}"
+  end
+
+  def create_bundle(body:)
+    post '/products/bundles', body: body
+  end
+
   # Groups
   def get_product_groups(**kwargs)
     get '/products/groups', query: kwargs
@@ -191,6 +276,10 @@ class BukkuTest < Client
     get "/products/groups/#{id}"
   end
 
+  def create_product_group(body:)
+    post '/products/groups', body: body
+  end
+
   ## ACCOUNTING
   # Journal Entries
   def get_journal_entries(**kwargs)
@@ -201,6 +290,10 @@ class BukkuTest < Client
     get "/journal_entries/#{id}"
   end
 
+  def create_journal_entry(body:)
+    post '/journal_entries', body: body
+  end
+
   # Account
   def get_accounts(**kwargs)
     get '/accounts', query: kwargs
@@ -209,4 +302,13 @@ class BukkuTest < Client
   def get_account(id)
     get "/accounts/#{id}"
   end
+
+  def create_account(body:)
+    post '/accounts', body: body
+  end
+
+  # Files
+  def upload_file(file_data:, filename:, mime_type:)
+    upload '/files', file_data: file_data, filename: filename, mime_type: mime_type
+  end
 end

data/lib/client.rb

@@ -1,6 +1,6 @@
 class Client
   # The BASE_URI below is there to facilitate test only
-  BASE_URI = "https://rekon.org"
+  BASE_URI = 'https://rekon.org'
 
   attr_reader :token, :domain
 
@@ -16,6 +16,15 @@ class Client
   end
 
   def default_headers
+    {
+      'Authorization' => "Bearer #{@token}",
+      'Company-Subdomain' => "#{@domain}",
+      'Accept' => 'application/json',
+      'Content-Type' => 'application/json'
+    }
+  end
+
+  def upload_headers
     {
       'Authorization' => "Bearer #{@token}",
       'Company-Subdomain' => "#{@domain}",
@@ -31,30 +40,55 @@ class Client
     make_request Net::HTTP::Post, path, query: query, body: body
   end
 
-  def make_request(klass, path, query: {}, body: {})
-    uri = URI("#{base_uri}#{path}")
-    uri.query = URI.encode_www_form(query) if query
+  def upload(path, file_data:, filename:, mime_type:)
+    upload_request Net::HTTP::Post, path, file_data: file_data, filename: filename, mime_type: mime_type
+  end
 
+  def build_http(uri)
     http = Net::HTTP.new(uri.host, uri.port)
     http.use_ssl = uri.instance_of?(URI::HTTPS)
+
+    # Add the 2 lines below because development keeps on failing SSL CRL checks
+    # Check this article for explanation: 
+    # https://dev.to/madhuhari188/how-we-solved-unable-to-get-certificate-crl-in-rails-a-debugging-story-2pna
+    http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+    http.verify_callback = ->(_preverify_ok, _store_ctx) { true }
+
+    http
+  end
+
+  def make_request(klass, path, query: {}, body: {})
     # Uncomment below for debuging purpose to see the payload that was sent.
-    # http.set_debug_output($stdout)
+    # build_http(uri).set_debug_output($stdout)
+
+    uri = URI("#{base_uri}#{path}")
+    uri.query = URI.encode_www_form(query) if query
 
     request = klass.new(uri.request_uri, default_headers)
-    if body && !body.empty?
-      request.body = body.to_json
-    end
+    request.body = body.to_json if body && !body.empty?
 
+    execute_request(build_http(uri), request)
+  end
+
+  def upload_request(klass, path, file_data:, filename:, mime_type:)
+    uri = URI("#{base_uri}#{path}")
+    request = klass.new(uri.request_uri, upload_headers)
+    request.set_form(
+      [['file', StringIO.new(file_data), { filename: filename, content_type: mime_type }]], 'multipart/form-data'
+    )
+
+    execute_request(build_http(uri), request)
+  end
+
+  def execute_request(http, request)
     response = http.request(request)
 
     case response.code.to_i
     when 200, 201, 202, 203, 204
-      # JSON.parse(response.body) if response.body.present?
       JSON.parse(response.body) if response.body && !response.body.empty?
     else
       raise Error, "#{response.code}: #{response.body}"
     end
   end
-
   class Error < StandardError; end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bukku_rails
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.1
 platform: ruby
 authors:
 - Muzaffar Ariff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-12-11 00:00:00.000000000 Z
+date: 2026-02-26 00:00:00.000000000 Z
 dependencies: []
 description: Use Rails conventions to call Bukku API requests.
 email:
@@ -50,5 +50,6 @@ requirements: []
 rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
-summary: Bukku Cloud accounting API implementation in Rails
+summary: Bukku Cloud accounting API implementation in Ruby and usage mostly for Rails
+  apps
 test_files: []