erp_integration 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10feefb3de410db28d960dcab694fd3ac8cbc08e9d2ea06627e8cd5f514b2a57
-  data.tar.gz: a7d6540c305bf8519789aa11073dc38141cdb60226a1296a99c5ea2e2d412838
+  metadata.gz: f838562b7bce4ffaab0944a370300bfa1c9d2f43d71777342a34be928857622b
+  data.tar.gz: f693bb521585a843abe5afd0fa1637a6235198a0a466cfe116130bd8f4906c81
 SHA512:
-  metadata.gz: e64d55ee5b4ab827fb78ebd864ea278bfaaa50506de7e73737cfd88cc9e9f83485b34c7c96d840f3b3a5e26b3a8df730d69f8822d1c513f31b7f4d11bf8dd2e4
-  data.tar.gz: dacaceb6e96523354e470e70056f574933cd8dd4e9bf30757a5ab9742545d7b460c73b3b32ff9e41a6284a99c25cb62d4eed9f312b7e4c443242f0d18d3dc894
+  metadata.gz: a008498534cd8274a24dcb37fe11c090126f128756d388173c908a29458aedc7fe8f8b70a53652c5499aafad5f27896ca61c7648c8bf3dacb8d032e0d21a66a3
+  data.tar.gz: 99ac0de4fa2bfb6a1a6bbbc709bb8b84eac47157561e45a16e5df4827f8e8b12ecfd7222ba262a626546b20fee27919655a01b6b25a820cd31bda389d083c519

data/lib/erp_integration/configuration.rb

@@ -82,6 +82,11 @@ module ErpIntegration
     # @return [Symbol] The configured adapter for the order lines.
     attr_writer :sales_order_line_adapter
 
+    # Allows configuring an adapter for the `SalesReturnReason` resource. When none is
+    # configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the order lines.
+    attr_writer :sales_return_reason_adapter
+
     # Allows configuring an adapter for the `SupplierShipment` resource. When
     # none is configured, it will default to Fulfil.
     # @return [Symbol] The configured adapter for the supplier shipment.
@@ -92,6 +97,11 @@ module ErpIntegration
     # @return [Symbol] The configured adapter for the stock move.
     attr_writer :stock_move_adapter
 
+    # Allows configuring an adapter for the `TrackingNumber` resource. When
+    # none is configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the tracking number.
+    attr_writer :tracking_number_adapter
+
     # Logger that will be used for HTTP operations on Client
     # @return [Logger] The configured logger
     attr_accessor :logger
@@ -150,6 +160,10 @@ module ErpIntegration
       @sales_order_adapter || :fulfil
     end
 
+    def sales_return_reason_adapter
+      @sales_return_reason_adapter || :fulfil
+    end
+
     def supplier_shipment_adapter
       @supplier_shipment_adapter || :fulfil
     end
@@ -157,6 +171,10 @@ module ErpIntegration
     def stock_move_adapter
       @stock_move_adapter || :fulfil
     end
+
+    def tracking_number_adapter
+      @tracking_number_adapter || :fulfil
+    end
   end
 
   # Returns ERP Integration's configuration.

data/lib/erp_integration/fulfil/persistence.rb

@@ -27,6 +27,17 @@ module ErpIntegration
         [attributes, [extract_error_message(e)]]
       end
 
+      # Destroys the resource.
+      #
+      # @param resource_id [Integer] The ID of the resource.
+      # @return [Boolean] Returns true if the resource was deleted
+      def destroy(resource_id)
+        client.delete("model/#{model_name}/#{resource_id}")
+        { id: resource_id }
+      rescue ErpIntegration::HttpError::BadRequest => e
+        [{ id: resource_id }, [extract_error_message(e)]]
+      end
+
       private
 
       # Fulfil returns a 400 status code (e.g. Bad Request) with the error message

data/lib/erp_integration/fulfil/resources/sales_order.rb

@@ -28,6 +28,55 @@ module ErpIntegration
         rescue Faraday::ParsingError
           true
         end
+
+        # Allows duplicating the entire sales order in Fulfil.
+        # @param id [Integer|String] The ID of the to be duplicated order.
+        # @return [Array|boolean] Whether the sales order was duplicated successfully or not.
+        def duplicate(id)
+          duplicated_order_id = client.put("model/sale.sale/#{id}/copy").first
+          ErpIntegration::SalesOrder.new(id: duplicated_order_id)
+
+        # Fulfil will return an 400 (a.k.a. "Bad Request") status code when a sales order couldn't
+        # be duplicated.
+        rescue ErpIntegration::HttpError::BadRequest
+          false
+        end
+
+        # Confirm the order on Fulfil.
+        # @param id [Integer|String] The ID of the to be confirmed order.
+        # @return [boolean] Whether the sales order was confirmed successfully or not.
+        def confirm(id)
+          client.put("model/sale.sale/#{id}/confirm")
+          true
+
+        # Fulfil will return an 400 (a.k.a. "Bad Request") status code when a sales order couldn't
+        # be confirmed.
+        rescue ErpIntegration::HttpError::BadRequest
+          false
+        # Workaround: Fulfil api does not return a json when status code is 200 (a.k.a. "Ok")
+        # and faraday is having an error when trying to parse it. Let's skip the parse error
+        # and move on.
+        rescue Faraday::ParsingError
+          true
+        end
+
+        # Process the order on Fulfil.
+        # @param id [Integer|String] The ID of the to be processed order.
+        # @return [boolean] Whether the sales order was processed successfully or not.
+        def process(id)
+          client.put("model/sale.sale/#{id}/process")
+          true
+
+        # Fulfil will return an 400 (a.k.a. "Bad Request") status code when a sales order couldn't
+        # be processed.
+        rescue ErpIntegration::HttpError::BadRequest
+          false
+        # Workaround: Fulfil api does not return a json when status code is 200 (a.k.a. "Ok")
+        # and faraday is having an error when trying to parse it. Let's skip the parse error
+        # and move on.
+        rescue Faraday::ParsingError
+          true
+        end
       end
     end
   end

data/lib/erp_integration/fulfil/resources/sales_return_reason.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative '../api_resource'
+
+module ErpIntegration
+  module Fulfil
+    module Resources
+      class SalesReturnReason < ApiResource
+        self.model_name = 'sale.return.reason'
+      end
+    end
+  end
+end

data/lib/erp_integration/fulfil/resources/tracking_number.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative '../api_resource'
+
+module ErpIntegration
+  module Fulfil
+    module Resources
+      class TrackingNumber < ApiResource
+        self.model_name = 'shipment.tracking'
+      end
+    end
+  end
+end

data/lib/erp_integration/resources/persistence.rb

@@ -35,6 +35,15 @@ module ErpIntegration
         assign_attributes(attrs)
         validate_with(error_messages)
       end
+
+      # Destroy an resource in the ERP.
+      # @return [Boolean] Whether the destroy action was succcesful or not.
+      def destroy(id)
+        attrs, error_messages = self.class.adapter.destroy(id)
+
+        assign_attributes(attrs)
+        validate_with(error_messages)
+      end
     end
   end
 end

data/lib/erp_integration/sales_order.rb

@@ -19,5 +19,17 @@ module ErpIntegration
     def cancel
       self.class.adapter.cancel(id)
     end
+
+    def duplicate
+      self.class.adapter.duplicate(id)
+    end
+
+    def confirm
+      self.class.adapter.confirm(id)
+    end
+
+    def process
+      self.class.adapter.process(id)
+    end
   end
 end

data/lib/erp_integration/sales_return_reason.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # The `ErpIntegration::SalesReturnReason` exposes an uniformed API for interaction with
+  # third-party ERP vendors.
+  class SalesReturnReason < Resource
+    attr_accessor :attachments, :create_date, :create_uid, :description,
+                  :id, :messages, :metadata, :name, :private_notes,
+                  :public_notes, :rec_blurb, :rec_name, :write_date,
+                  :write_uid
+  end
+end

data/lib/erp_integration/tracking_number.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # The `ErpIntegration::TrackingNumber` exposes an uniformed API for interaction with
+  # third-party ERP vendors.
+  class TrackingNumber < Resource
+    attr_accessor :attachments, :attempts, :carrier, :carrier_identifier,
+                  :carrier_service, :create_date, :create_uid, :delivered_at,
+                  :delivered_date, :delivery_date, :delivery_time, :easypost_order_id,
+                  :estimated_delivery_date, :id, :is_master, :messages, :metadata,
+                  :next_update_at, :origin, :private_notes, :public_notes, :rec_blurb,
+                  :rec_name, :reference, :scac, :state, :tracking_number,
+                  :tracking_url, :transportation_mode, :write_date, :write_uid
+  end
+end

data/lib/erp_integration/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ErpIntegration
-  VERSION = '0.11.0'
+  VERSION = '0.12.0'
 end

data/lib/erp_integration.rb

@@ -33,8 +33,10 @@ module ErpIntegration
   autoload :Resource, 'erp_integration/resource'
   autoload :SalesOrder, 'erp_integration/sales_order'
   autoload :SalesOrderLine, 'erp_integration/sales_order_line'
+  autoload :SalesReturnReason, 'erp_integration/sales_return_reason'
   autoload :StockMove, 'erp_integration/stock_move'
   autoload :SupplierShipment, 'erp_integration/supplier_shipment'
+  autoload :TrackingNumber, 'erp_integration/tracking_number'
 
   module Resources
     autoload :Errors, 'erp_integration/resources/errors'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: erp_integration
 version: !ruby/object:Gem::Version
-  version: 0.11.0
+  version: 0.12.0
 platform: ruby
 authors:
 - Stefan Vermaas
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-02-11 00:00:00.000000000 Z
+date: 2022-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -284,8 +284,10 @@ files:
 - lib/erp_integration/fulfil/resources/purchase_request.rb
 - lib/erp_integration/fulfil/resources/sales_order.rb
 - lib/erp_integration/fulfil/resources/sales_order_line.rb
+- lib/erp_integration/fulfil/resources/sales_return_reason.rb
 - lib/erp_integration/fulfil/resources/stock_move.rb
 - lib/erp_integration/fulfil/resources/supplier_shipment.rb
+- lib/erp_integration/fulfil/resources/tracking_number.rb
 - lib/erp_integration/fulfil/where_clause.rb
 - lib/erp_integration/middleware/error_handling.rb
 - lib/erp_integration/product.rb
@@ -299,8 +301,10 @@ files:
 - lib/erp_integration/resources/validations.rb
 - lib/erp_integration/sales_order.rb
 - lib/erp_integration/sales_order_line.rb
+- lib/erp_integration/sales_return_reason.rb
 - lib/erp_integration/stock_move.rb
 - lib/erp_integration/supplier_shipment.rb
+- lib/erp_integration/tracking_number.rb
 - lib/erp_integration/version.rb
 homepage: https://www.github.com/mejuri-inc/erp-integration
 licenses:
@@ -325,7 +329,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.22
 signing_key: 
 specification_version: 4
 summary: Connects Mejuri with third-party ERP vendors