bukku_rails 0.1.6 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 155357b4ca282d160dcb92f22b77c6ceed853d4df539470838b02846809af42a
-  data.tar.gz: e59657c28be7b60904edb9dda405435d7b8216a61610f0c3f5603b0fcd02137f
+  metadata.gz: ae7834af9fb6e0e658c7983ec8470965dd05895d5e9fb812287abf2138b7cf0b
+  data.tar.gz: 372206b437586da2dc52d54ecf05c9c3e20df6129115551bb5d537c6fa2ba121
 SHA512:
-  metadata.gz: 27e5a345e5dd38ba2e2a5d05d5d52d6f3fd83ac9815be509df718ee08ecba3cd14227f8fc09d818985171f6b23c8d98b02f3201a930b392dfdc59399ca12c1a0
-  data.tar.gz: 41a28319db712943fb2181c7793d7eb674414b071cf7632a04cfae617603605b09467608864f19b3f1820db8e42041187c6b21dd714d25658f2060a4a31c42f7
+  metadata.gz: 34272757719187e556d86f660a2079ea01b2727740fefa86dad212189f0e58557238d141e6ecb8e27dbe4d15665ae83b5210cca645788a7a9263c7bf109a4716
+  data.tar.gz: 2439395811ac766fe33cac66a6c7632c50fadea7f50322f477510c415847ec8653e075aa9dbb75a5d9afaae1bd57d8254da30e9e577bc41c43aa69d62c0cfca3

data/README.md

@@ -4,7 +4,7 @@ Use Rails methods to interact with your data in [Bukku](https://bukku.my/) accou
 
 Take a look at [Bukku's API](https://developers.bukku.my) to know what data you can extract from Bukku.
 
-> As of December 2, 2025, the gem only handles **GET** request. If you require other request, fork the gem and write it and then send us a Pull Request.
+> As of February 2026, the gem handles **GET**, **POST**, and **file upload** requests.
 
 ## Installation
 
@@ -50,18 +50,25 @@ Just like in Rails the methods follow the singular and plural expression. Method
 |------------|-------------|----------|
 | GET | `get_sales_quotes(query-parameters)` | `/sales/quotes` |
 | GET | `get_sales_quote(id)` | `/sales/quotes/:id` |
+| POST | `create_quote(body:)` | `/sales/quotes` |
 | GET | `get_sales_orders(query-parameters)` | `/sales/orders` |
 | GET | `get_sales_order(id)` | `/sales/orders/:id` |
+| POST | `create_sales_order(body:)` | `/sales/orders` |
 | GET | `get_delivery_orders(query-parameters)` | `/sales/delivery_orders` |
 | GET | `get_delivery_order(id)` | `/sales/delivery_orders/:id` |
+| POST | `create_delivery_order(body:)` | `/sales/delivery_orders` |
 | GET | `get_invoices(query-parameters)` | `/sales/invoices` |
 | GET | `get_invoice(id)` | `/sales/invoices/:id` |
+| POST | `create_invoice(body:)` | `/sales/invoices` |
 | GET | `get_sales_credit_notes(query-parameters)` | `/sales/credit_notes` |
 | GET | `get_sales_credit_note(id)` | `/sales/credit_notes/:id` |
+| POST | `create_credit_note(body:)` | `/sales/credit_notes` |
 | GET | `get_sales_payments(query-parameters)` | `/sales/payments` |
 | GET | `get_sales_payment(id)` | `/sales/payments/:id` |
+| POST | `create_payment(body:)` | `/sales/payments` |
 | GET | `get_sales_refunds(query-parameters)` | `/sales/refunds` |
 | GET | `get_sales_refund(id)` | `/sales/refunds/:id` |
+| POST | `create_refund(body:)` | `/sales/refunds` |
 
 #### Purchases
 
@@ -69,16 +76,22 @@ Just like in Rails the methods follow the singular and plural expression. Method
 |------------|-------------|----------|
 | GET | `get_purchase_orders(query-parameters)` | `/purchases/orders` |
 | GET | `get_purchase_order(id)` | `/purchases/orders/:id` |
+| POST | `create_purchase_order(body:)` | `/purchases/orders` |
 | GET | `get_received_notes(query-parameters)` | `/purchases/goods_received_notes` |
 | GET | `get_received_note(id)` | `/purchases/goods_received_notes/:id` |
+| POST | `create_received_note(body:)` | `/purchases/goods_received_notes` |
 | GET | `get_bills(query-parameters)` | `/purchases/bills` |
 | GET | `get_bill(id)` | `/purchases/bills/:id` |
+| POST | `create_bill(body:)` | `/purchases/bills` |
 | GET | `get_purchases_credit_notes(query-parameters)` | `/purchases/credit_notes` |
 | GET | `get_purchases_credit_note(id)` | `/purchases/credit_notes/:id` |
+| POST | `create_purchase_credit_note(body:)` | `/purchases/credit_note` |
 | GET | `get_purchases_payments(query-parameters)` | `/purchases/payments` |
-| GET | `get_purchases_payments(id)` | `/purchases/payments/:id` |
+| GET | `get_purchases_payment(id)` | `/purchases/payments/:id` |
+| POST | `create_purchases_payment(body:)` | `/purchases/payments` |
 | GET | `get_purchases_refunds(query-parameters)` | `/purchases/refunds` |
 | GET | `get_purchases_refund(id)` | `/purchases/refunds/:id` |
+| POST | `create_purchases_refund(body:)` | `/purchases/refunds` |
 
 #### Banking
 
@@ -86,10 +99,13 @@ Just like in Rails the methods follow the singular and plural expression. Method
 |------------|-------------|----------|
 | GET | `get_banking_incomes(query-parameters)` | `/banking/incomes` |
 | GET | `get_banking_income(id)` | `/banking/incomes/:id` |
+| POST | `create_banking_income(body:)` | `/banking/incomes` |
 | GET | `get_banking_expenses(query-parameters)` | `/banking/expenses` |
 | GET | `get_banking_expense(id)` | `/banking/expenses/:id` |
+| POST | `create_expense(body:)` | `/banking/expenses` |
 | GET | `get_transfers(query-parameters)` | `/banking/transfers` |
 | GET | `get_transfer(id)` | `/banking/transfers/:id` |
+| POST | `create_transfer(body:)` | `/banking/transfer` |
 
 #### Contacts
 
@@ -97,8 +113,10 @@ Just like in Rails the methods follow the singular and plural expression. Method
 |------------|-------------|----------|
 | GET | `get_contacts(query-parameters)` | `/contacts` |
 | GET | `get_contact(id)` | `/contacts/:id` |
+| POST | `create_contact(body:)` | `/contacts` |
 | GET | `get_contact_groups(query-parameters)` | `/contacts/groups` |
 | GET | `get_contact_group(id)` | `/contacts/groups/:id` |
+| POST | `create_group(body:)` | `/contacts/groups` |
 
 #### Products
 
@@ -106,8 +124,12 @@ Just like in Rails the methods follow the singular and plural expression. Method
 |------------|-------------|----------|
 | GET | `get_products(query-parameters)` | `/products` |
 | GET | `get_product(id)` | `/products/:id` |
+| POST | `create_product(body:)` | `/products` |
+| GET | `get_bundle(id)` | `/products/bundles/:id` |
+| POST | `create_bundle(body:)` | `/products/bundles` |
 | GET | `get_product_groups(query-parameters)` | `/products/groups` |
 | GET | `get_product_group(id)` | `/products/groups/:id` |
+| POST | `create_product_group(body:)` | `/products/groups` |
 
 #### Accounting
 
@@ -115,8 +137,16 @@ Just like in Rails the methods follow the singular and plural expression. Method
 |------------|-------------|----------|
 | GET | `get_journal_entries(query-parameters)` | `/journal_entries` |
 | GET | `get_journal_entry(id)` | `/journal_entries/:id` |
+| POST | `create_journal_entry(body:)` | `/journal_entries` |
 | GET | `get_accounts(query-parameters)` | `/accounts` |
 | GET | `get_account(id)` | `/accounts/:id` |
+| POST | `create_account(body:)` | `/accounts` |
+
+#### Files
+
+| HTTP Method | Ruby Method | Endpoint |
+|------------|-------------|----------|
+| POST | `upload_file(file_data:, filename:, mime_type:)` | `/files` |
 
 ### Examples
 
@@ -159,10 +189,34 @@ invoices = client.get_invoices(date_from: "2025-11-01", date_to: "2025-11-30")
 invoice = client.get_invoice(123)
 ```
 
+**Creating a new contact (or supplier)**:
+
+```ruby
+body = {
+  entity_type: "MALAYSIAN_COMPANY",
+  legal_name: invoice.supplier_name,
+  types: ["supplier"]
+}
+
+contact = client.create_contact(body: body)
+```
+
+**File upload:**
+
+```ruby
+
+file_data = File.read("invoice.pdf")
+filename  = "invoice.pdf"
+mime_type = "application/pdf"
+
+client.upload_file(file_data: file_data, filename: filename, mime_type: mime_type)
+
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at <https://github.com/stopar/bukku_rails>.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT)

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.6'
+  VERSION = '0.2.2'
 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,36 +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
+    # 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.6
+  version: 0.2.2
 platform: ruby
 authors:
 - Muzaffar Ariff
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-19 00:00:00.000000000 Z
+date: 2026-02-27 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: []