mintsoft 0.1.7 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2a17bbdcac6407c2e35b8c88255eca2aa11c885925050fa52b5c77ee56cdf17
-  data.tar.gz: b8bf5662fb94f4b854aca4790e0420fce462dd5915ef75f2ef6ecde8eb10ff7b
+  metadata.gz: 9b07eb48344fbc2e9350b4dfb180155f25849e2e07b6918089b577436b156ea3
+  data.tar.gz: a41f333869f6cee4e8e662aaf227fa10b4ae91221ccfb18df1140b42e7a09ff7
 SHA512:
-  metadata.gz: bb81292cb1375785a2f553848ca8312cf42e45d70c05b5bc2c79a8c63ad4c9e35145927decf712bef768392637baea29735d54aa98fad8e474bbfe4d7c897c9f
-  data.tar.gz: 691e669052b7de1ab710aff5d03061ab5040b9871b3593978cfc5eda0f91aec766c7fc0e1e8aea7e4c8a0cb44aa346801f35c5b41a4145eb8b321c6aaa3f7864
+  metadata.gz: 070433bc3da2e1357514c4aa98a0b7daea60e05403077beca76f9e7910cc1548d2ca6f71e7b8ee37db34a035def363ee793f9d27dab22a74e936bb93e2a1d842
+  data.tar.gz: 2e9a745d24b126e9bdf6a21b3bfddfe6fcc944683f323ed8c715b2a4c903cfd1be7b9dea7be2cfae954ca8d9b3a734d0efc4fbc66603f0208f0cd82772cc10ce

data/README.md

@@ -5,7 +5,7 @@ A Ruby wrapper for the Mintsoft API that provides simple token-based authenticat
 ## Features
 
 - **Token-only authentication**: Manual token management for full control
-- **5 Essential API endpoints**: Authentication, Order Search, Return Reasons, Create Returns, Add Return Items
+- **6 Essential API endpoints**: Authentication, Order Search, Return Reasons, Create Returns, Add Return Items, Retrieve Returns
 - **OpenStruct-based objects**: Flexible response handling with automatic attribute conversion
 - **Faraday HTTP client**: Robust HTTP handling with JSON support
 - **Comprehensive error handling**: Clear error messages for common scenarios
@@ -120,9 +120,16 @@ result = client.returns.add_item(return_obj.id, {
   notes: "Optional notes"
 })
 
+# Retrieve a specific return by ID
+return_obj = client.returns.retrieve(return_id)
+
 # Access return properties
 puts return_obj.id          # Direct access to return ID
-# Note: Items data structure depends on API response format
+puts return_obj.order_id    # Direct access to order ID
+puts return_obj.status      # Direct access to return status
+puts return_obj.customer_name # Direct access to customer name
+puts return_obj.total_value # Direct access to total value
+# Note: Available properties depend on API response structure
 ```
 
 ### Error Handling

data/lib/mintsoft/resources/orders.rb

@@ -15,17 +15,39 @@ module Mintsoft
         end
       end
 
+      def retrieve(id)
+        validate_id!(id)
+        response = get_request("/api/Order/#{id}")
+
+        if response.status == 404
+          nil # Return nil for not found orders
+        else
+          response_data = handle_response(response)
+          parse_order(response_data)
+        end
+      end
+
       private
 
       def validate_order_number!(order_number)
         raise ValidationError, "Order number required" if order_number.nil? || order_number.empty?
       end
 
+      def validate_id!(id)
+        raise ValidationError, "ID must be present" if id.nil? || (id.respond_to?(:empty?) && id.empty?)
+      end
+
       def parse_orders(data)
         return [] unless data.is_a?(Array)
 
         data.map { |order_data| Objects::Order.new(order_data) }
       end
+
+      def parse_order(data)
+        return nil unless data.is_a?(Hash)
+
+        Objects::Order.new(data)
+      end
     end
   end
 end

data/lib/mintsoft/resources/returns.rb

@@ -31,6 +31,15 @@ module Mintsoft
         Objects::Return.new(response_data)
       end
 
+      def retrieve(return_id)
+        validate_return_id!(return_id)
+
+        response = get_request("/api/Return/#{return_id}")
+        response_data = handle_response(response)
+
+        Objects::Return.new(response_data)
+      end
+
       private
 
       def validate_order_id!(order_id)

data/lib/mintsoft/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mintsoft
-  VERSION = "0.1.7"
+  VERSION = "0.1.9"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mintsoft
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.9
 platform: ruby
 authors:
 - Andy Chong