erp_integration 0.34.0 → 0.36.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46c2613fa4d588241f06f9a130cdc5fece97ba69c5e732d66d4ff141adabb080
-  data.tar.gz: 71e0908f8b3fbfcf89a28d15445cd8d3b170a19ba81182c0af03be0933a64631
+  metadata.gz: 60981ef82d7fc4ee99a747def31bb01d5bac2c6596e258e1025f11a52b60be09
+  data.tar.gz: 2bd4161b4acd66ef8878d4736a0909948e22b066c93de4c218a7f49246c887d4
 SHA512:
-  metadata.gz: 273b05cc0dbf4030cb6a0a39788614165aba29392795e196228987300a74043a81760ded720d8ba548f0c74708293bb0e845add3b4f3ecef7d69e3939fb5a558
-  data.tar.gz: 0e8969487347f3a661ffaa5c789b65fae4da98f1c2e117f19aef0286e86a8856b70f70e71b095c48d5698f39112fea808ef28620935308f268fb74574b211a69
+  metadata.gz: b9f9d08096d1856a28b219d80a375a67d1e6b442785e531ee40e79148af2ea95d4cba9af23d4a20d9b6c15c6a818707cb7b2a3790140e57dfa1e9a4ba878a760
+  data.tar.gz: a48d617a9e48b83d015ce237e6c5a4e11cbfd0b132f0eb76a557a3c8cb9b42c6608ff1fff0ce253a766796be1451b59e2a9e864d3d29b4fa8230ecf568a28953

data/.rubocop.yml

@@ -82,6 +82,8 @@ Naming/PredicateName:
   Enabled: true
 
 Metrics/ClassLength:
+  Exclude:
+    - lib/erp_integration/configuration.rb
   Enabled: true
 
 Style/AndOr:

data/lib/erp_integration/configuration.rb

@@ -57,6 +57,16 @@ module ErpIntegration
     # @return [Symbol] The configured adapter for the products.
     attr_writer :product_adapter
 
+    # Allows configuring an adapter for the `ProductCategory` resource. When none is
+    # configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the product category.
+    attr_writer :product_category_adapter
+
+    # Allows configuring an adapter for the `ProductTemplate` resource. When none is
+    # configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the product templates.
+    attr_writer :product_template_adapter
+
     # Allows configuring an adapter for the `ProductionOrder` resource. When
     # none is configured, it will default to Fulfil.
     # @return [Symbol] The configured adapter for the production_order.
@@ -97,6 +107,11 @@ module ErpIntegration
     # @return [Symbol] The configured adapter for the supplier shipment.
     attr_writer :supplier_shipment_adapter
 
+    # Allows configuring an adapter for the `StockBinTransfer` resource. When
+    # none is configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the stock bin transfer.
+    attr_writer :stock_bin_transfer_adapter
+
     # Allows configuring an adapter for the `StockMove` resource. When
     # none is configured, it will default to Fulfil.
     # @return [Symbol] The configured adapter for the stock move.
@@ -167,6 +182,14 @@ module ErpIntegration
       @product_adapter || :fulfil
     end
 
+    def product_category_adapter
+      @product_category_adapter || :fulfil
+    end
+
+    def product_template_adapter
+      @product_template_adapter || :fulfil
+    end
+
     def production_order_adapter
       @production_order_adapter || :fulfil
     end
@@ -199,6 +222,10 @@ module ErpIntegration
       @supplier_shipment_adapter || :fulfil
     end
 
+    def stock_bin_transfer_adapter
+      @stock_bin_transfer_adapter || :fulfil
+    end
+
     def stock_move_adapter
       @stock_move_adapter || :fulfil
     end

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

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

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

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

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

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative '../api_resource'
+
+module ErpIntegration
+  module Fulfil
+    module Resources
+      class StockBinTransfer < ApiResource
+        self.model_name = 'stock.bin_transfer'
+
+        # Allows bulk force assign bin transfers over the API to move assigned
+        # inventory to the new bin location.
+        # @param id [Integer|String] The ID of the stock bin transfer.
+        # @return [boolean] Whether the stock bin transfer was assigned force successfully or not.
+        def assign_force(id)
+          client.put("model/stock.bin_transfer/#{id}/assign_force")
+          true
+
+        # Fulfil will return an 400 (a.k.a. "Bad Request") status code when a bin trasfer couldn't
+        # be done. If a bit trasfer isn't assignable by design, no exception should be raised.
+        #
+        # See the Fulfil's documentation for more information:
+        # https://developers.fulfil.io/rest_api/model/stock.bin_transfer/#force-allocate-inventory-to-the-transfer
+        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
+
+        # Allows bulk mark the bin transfers as done over the API to finish
+        # moving the inventory to the new bin location.
+        # It is better practice for inventory accuracy to mark the bin transfer
+        # as done once the inventory is physically moved to the new location.
+        # @param id [Integer|String] The ID of the stock bin transfer.
+        # @return [boolean] Whether the stock bin transfer was mark as done successfully or not.
+        def done(id)
+          client.put("model/stock.bin_transfer/#{id}/done")
+          true
+
+        # Fulfil will return an 400 (a.k.a. "Bad Request") status code when a bin trasfer couldn't
+        # be done. If a bit trasfer isn't doneable by design, no exception should be raised.
+        #
+        # See the Fulfil's documentation for more information:
+        # https://developers.fulfil.io/rest_api/model/stock.bin_transfer/#mark-transfer-as-done
+        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
+end

data/lib/erp_integration/product_category.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # The `ErpIntegration::ProductTemplate` exposes an uniformed API for interaction with
+  # third-party ERP vendors.
+  class ProductCategory < Resource
+    attr_accessor :id, :name, :parent
+  end
+end

data/lib/erp_integration/product_template.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # The `ErpIntegration::ProductTemplate` exposes an uniformed API for interaction with
+  # third-party ERP vendors.
+  class ProductTemplate < Resource
+    attr_accessor :id, :name, :account_category
+  end
+end

data/lib/erp_integration/stock_bin_transfer.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  class StockBinTransfer < Resource
+    attr_accessor :id, :attachments, :company, :create_date, :create_uid,
+                  :description, :effective_date, :messages, :metadata,
+                  :metafields, :moves, :number, :origin, :picker, :priority,
+                  :picking_status, :planned_date, :private_notes, :public_notes,
+                  :quantity_total, :rec_blurb, :rec_name, :reference, :state,
+                  :storage_zone, :warehouse, :write_date, :write_uid
+
+    def assign_force
+      self.class.adapter.assign_force(id)
+    end
+
+    def done
+      self.class.adapter.done(id)
+    end
+  end
+end

data/lib/erp_integration/version.rb

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

data/lib/erp_integration.rb

@@ -31,6 +31,8 @@ module ErpIntegration
   autoload :CustomerShipment, 'erp_integration/customer_shipment'
   autoload :CustomerShipmentReturn, 'erp_integration/customer_shipment_return'
   autoload :Product, 'erp_integration/product'
+  autoload :ProductCategory, 'erp_integration/product_category'
+  autoload :ProductTemplate, 'erp_integration/product_template'
   autoload :ProductionOrder, 'erp_integration/production_order'
   autoload :PurchaseOrder, 'erp_integration/purchase_order'
   autoload :PurchaseOrderLine, 'erp_integration/purchase_order_line'
@@ -39,6 +41,7 @@ module ErpIntegration
   autoload :SalesOrder, 'erp_integration/sales_order'
   autoload :SalesOrderLine, 'erp_integration/sales_order_line'
   autoload :SalesReturnReason, 'erp_integration/sales_return_reason'
+  autoload :StockBinTransfer, 'erp_integration/stock_bin_transfer'
   autoload :StockMove, 'erp_integration/stock_move'
   autoload :SupplierShipment, 'erp_integration/supplier_shipment'
   autoload :Task, 'erp_integration/task'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: erp_integration
 version: !ruby/object:Gem::Version
-  version: 0.34.0
+  version: 0.36.0
 platform: ruby
 authors:
 - Stefan Vermaas
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-06-23 00:00:00.000000000 Z
+date: 2023-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -290,6 +290,8 @@ files:
 - lib/erp_integration/fulfil/resources/customer_shipment_return.rb
 - lib/erp_integration/fulfil/resources/gift_card.rb
 - lib/erp_integration/fulfil/resources/product.rb
+- lib/erp_integration/fulfil/resources/product_category.rb
+- lib/erp_integration/fulfil/resources/product_template.rb
 - lib/erp_integration/fulfil/resources/production_order.rb
 - lib/erp_integration/fulfil/resources/purchase_order.rb
 - lib/erp_integration/fulfil/resources/purchase_order_line.rb
@@ -297,6 +299,7 @@ files:
 - 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_bin_transfer.rb
 - lib/erp_integration/fulfil/resources/stock_move.rb
 - lib/erp_integration/fulfil/resources/supplier_shipment.rb
 - lib/erp_integration/fulfil/resources/task.rb
@@ -306,6 +309,8 @@ files:
 - lib/erp_integration/gift_card.rb
 - lib/erp_integration/middleware/error_handling.rb
 - lib/erp_integration/product.rb
+- lib/erp_integration/product_category.rb
+- lib/erp_integration/product_template.rb
 - lib/erp_integration/production_order.rb
 - lib/erp_integration/purchase_order.rb
 - lib/erp_integration/purchase_order_line.rb
@@ -317,6 +322,7 @@ files:
 - lib/erp_integration/sales_order.rb
 - lib/erp_integration/sales_order_line.rb
 - lib/erp_integration/sales_return_reason.rb
+- lib/erp_integration/stock_bin_transfer.rb
 - lib/erp_integration/stock_move.rb
 - lib/erp_integration/supplier_shipment.rb
 - lib/erp_integration/task.rb
@@ -347,7 +353,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Connects Mejuri with third-party ERP vendors