add ledger support

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.1.6] - 2025-09-17
+### Added
+- **Ledger API** support:
+  - `delete_by_id`
+  - `delete_by_keys`
+  - `get_ad_hoc_schema`
+  - `get_by_id`
+  - `get_by_keys`
+  - `get_list`
+  - `put_entity`
+  - `put_file`
+  - `invoke_action`
+
 ## [0.1.5] - 2025-08-13
 ### Added
 - **Currency API** support:

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    myob_acumatica (0.1.5)
+    myob_acumatica (0.1.6)
 
 GEM
   remote: https://rubygems.org/

examples/app.rb

@@ -41,6 +41,7 @@ class App < Sinatra::Base
         access_token: response['access_token'],
         endpoint_name: ENV['MYOB_ACUMATICA_ENDPOINT_NAME'],
         endpoint_version: ENV['MYOB_ACUMATICA_ENDPOINT_VERSION'],
+        query_params: { '$top' => 100, '$skip' => 0 },
         logger: Logger.new($stdout)
       )
 
@@ -96,40 +97,49 @@ class App < Sinatra::Base
     # end
 
     get '/customers' do
-      page_size = 1
-      skip = 0
-
-      customer_enum = Enumerator.new do |yielder|
-        customers = MyobAcumatica::Api::Customer.get_list(
-          instance_name: ENV['MYOB_ACUMATICA_INSTANCE_NAME'],
-          access_token: params['access_token'],
-          query_params: {
-            '$top' => page_size,
-            '$skip' => skip
-          }
-        )
-
-        while customers.size == page_size
-          yielder << customers
-          skip += page_size
-
-          customers = MyobAcumatica::Api::Customer.get_list(
-            instance_name: ENV['MYOB_ACUMATICA_INSTANCE_NAME'],
-            access_token: params['access_token'],
-            query_params: {
-              '$top' => page_size,
-              '$skip' => skip
-            }
-          )
-        end
-
-        yielder << customers if customers.any?
-      end
-
-      customers = customer_enum.flat_map(&:itself)
+      # page_size = 1
+      # skip = 0
+
+      # customer_enum = Enumerator.new do |yielder|
+      #   customers = MyobAcumatica::Api::Customer.get_list(
+      #     instance_name: ENV['MYOB_ACUMATICA_INSTANCE_NAME'],
+      #     access_token: params['access_token'],
+      #     query_params: {
+      #       '$top' => page_size,
+      #       '$skip' => skip
+      #     }
+      #   )
+
+      #   while customers.size == page_size
+      #     yielder << customers
+      #     skip += page_size
+
+      #     customers = MyobAcumatica::Api::Customer.get_list(
+      #       instance_name: ENV['MYOB_ACUMATICA_INSTANCE_NAME'],
+      #       access_token: params['access_token'],
+      #       query_params: {
+      #         '$top' => page_size,
+      #         '$skip' => skip
+      #       }
+      #     )
+      #   end
+
+      #   yielder << customers if customers.any?
 
       content_type :json
 
+      customers = MyobAcumatica::Api::Customer.get_list(
+        instance_name: ENV['MYOB_ACUMATICA_INSTANCE_NAME'],
+        access_token: params['access_token'],
+        endpoint_name: ENV['MYOB_ACUMATICA_ENDPOINT_NAME'],
+        endpoint_version: ENV['MYOB_ACUMATICA_ENDPOINT_VERSION'],
+        query_params: {
+          '$top' => 100,
+          '$skip' => 0
+        },
+        logger: Logger.new($stdout)
+      )
+
       { customers: customers }.to_json
     end
 

examples/ledger.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'logger'
+require 'dotenv/load'
+
+require 'myob_acumatica'
+
+access_token = ENV['MYOB_ACUMATICA_ACCESS_TOKEN']
+logger = Logger.new($stdout)
+
+MyobAcumatica::Api::Ledger.get_ad_hoc_schema(
+  access_token: access_token,
+  logger: logger
+)
+
+ledger1 = MyobAcumatica::Api::Ledger.put_entity(
+  access_token: access_token,
+  entity: {
+    'LedgerID' => { 'value' => 'LEDGER-ACTUAL' },
+    'Description' => { 'value' => 'Actuals Ledger' },
+    'Active' => { 'value' => true }
+  },
+  logger: logger
+)
+
+ledger1 = MyobAcumatica::Api::Ledger.put_entity(
+  access_token: access_token,
+  entity: {
+    'LedgerID' => { 'value' => ledger1['LedgerID']['value'] },
+    'Description' => { 'value' => 'Actuals Ledger (Updated)' }
+  },
+  logger: logger
+)
+
+ledger1 = MyobAcumatica::Api::Ledger.get_by_keys(
+  access_token: access_token,
+  keys: [ledger1['LedgerID']['value']],
+  logger: logger
+)
+
+MyobAcumatica::Api::Ledger.put_file(
+  access_token: access_token,
+  keys: [ledger1['LedgerID']['value']],
+  file_path: 'examples/dummy.pdf',
+  logger: logger
+)
+
+MyobAcumatica::Api::Ledger.get_by_id(
+  access_token: access_token,
+  id: ledger1['id'],
+  logger: logger
+)
+
+MyobAcumatica::Api::Ledger.get_list(
+  access_token: access_token,
+  logger: logger
+)
+
+MyobAcumatica::Api::Ledger.delete_by_id(
+  access_token: access_token,
+  id: ledger1['id'],
+  logger: logger
+)
+
+ledger2 = MyobAcumatica::Api::Ledger.put_entity(
+  access_token: access_token,
+  entity: {
+    'LedgerID' => { 'value' => 'LEDGER-BUDGET' },
+    'Description' => { 'value' => 'Budget Ledger' },
+    'Active' => { 'value' => false }
+  },
+  logger: logger
+)
+
+MyobAcumatica::Api::Ledger.delete_by_keys(
+  access_token: access_token,
+  keys: [ledger2['LedgerID']['value']],
+  logger: logger
+)
+
+# MyobAcumatica::Api::Ledger.invoke_action(
+#   access_token: access_token,
+#   action_name: 'RebuildBalances',
+#   entity: { 'LedgerID' => { 'value' => 'LEDGER-ACTUAL' } },
+#   parameters: { 'FromPeriod' => { 'value' => '2024-01' } },
+#   logger: logger
+# )

lib/myob_acumatica.rb

@@ -30,3 +30,4 @@ class Error < StandardError; end
 require_relative 'myob_acumatica/api/payment'
 require_relative 'myob_acumatica/api/tax'
 require_relative 'myob_acumatica/api/currency'
+require_relative 'myob_acumatica/api/ledger'