erp_integration 0.3.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17355e9b381181f43c54715c29142911d1c698961b9e83316725cdd7d15d0482
-  data.tar.gz: 0dc34879a850e7bcac51d5f5250d97ff4abba11bf49dffdc1e1526dc07e35fc0
+  metadata.gz: ad8a8ac7a7ae3e4fdf89fb54a43c1c40733db2c0c9cb1a56567bc4988d981f76
+  data.tar.gz: 7607c3e4822aeac9ee4d4977f256345bf53a74af8e4ef4a35dd030ba76ccf29f
 SHA512:
-  metadata.gz: 7c20118ad5a092bafc6db0b98ca234055f03ec3aa468894389517091b56efab41bdc47b98b519be5dec7b8db286da52daee7167f287d91e9e31ff2765147a847
-  data.tar.gz: 3beffaa2d1c803448298f8023655a7653d4ad1f3ab14d7aa6a86279b2c8f831b1049f290cd6edfc6c42b151f861d03b341cdfe4e59c891ea554faed47d3d091a
+  metadata.gz: d1266d8a100256536c54e4990514ee69a8e3ceb6b1d9f82d72d570e0965699469bebd9ef4717f500233f9129fba7ec57965afebfa081aa523227d378fe4b7011
+  data.tar.gz: 9c40ac462de22c038446633a23fc0b45327a4a1b879cf397c6cb0de3ea12103c83fc7a15ea7f70aec4a9e82c1ae9e4a3bf98c2c9d25f9d45258a90d836f0434e

data/README.md

@@ -37,15 +37,15 @@ end
 After configuring the gem, one can easily query all the available ERP resources from the connected third-parties.
 
 ```ruby
-$ ErpIntegration::Order.where(reference: 'MT1000SKX')
-=> #<ErpIntegration::Fulfil::Collection @items=[<ErpIntegration::Order @id=100 />] />
+$ ErpIntegration::SalesOrder.where(reference: 'MT1000SKX')
+=> #<ErpIntegration::Fulfil::Collection @items=[<ErpIntegration::SalesOrder @id=100 />] />
 ```
 
 By default, only the `id` will be added to the found ERP resources. However, one can use the `select` method to include more fields.
 
 ```ruby
-$ ErpIntegration::Order.select(:id, :reference).where(reference: 'MT1000SKX')
-=> #<ErpIntegration::Fulfil::Collection @items=[<ErpIntegration::Order @id=100 @reference=MT1000SKX />] />
+$ ErpIntegration::SalesOrder.select(:id, :reference).where(reference: 'MT1000SKX')
+=> #<ErpIntegration::Fulfil::Collection @items=[<ErpIntegration::SalesOrder @id=100 @reference=MT1000SKX />] />
 ```
 
 There are also other type of `where` queries available:

data/bin/prerelease

@@ -17,4 +17,4 @@ git push origin "release_v.$VERSION"
 
 # Tag the new gem version.
 git tag v$VERSION
-git push --tags
+git push origin v$VERSION

data/erp_integration.gemspec

@@ -33,7 +33,7 @@ Gem::Specification.new do |spec|
 
   # Faraday is a HTTP/REST API client library to interact with third-party API vendors
   spec.add_dependency 'faraday', '>= 0.17.3', '< 1.9.0'
-  spec.add_dependency 'faraday_middleware', '~> 0.14.0'
+  spec.add_dependency 'faraday_middleware', '>= 0.14', '< 1.3'
 
   # Development dependencies
   spec.add_development_dependency 'byebug', '~> 11.0'

data/lib/erp_integration/configuration.rb

@@ -22,10 +22,10 @@ module ErpIntegration
     # @return [String] The merchant ID for Fulfil.
     attr_accessor :fulfil_merchant_id
 
-    # Allows configuring an adapter for the `Order` resource. When none is
+    # Allows configuring an adapter for the `Product` resource. When none is
     # configured, it will default to Fulfil.
-    # @return [Symbol] The configured adapter for the orders
-    attr_writer :order_adapter
+    # @return [Symbol] The configured adapter for the products.
+    attr_writer :product_adapter
 
     # Allows configuring an adapter for the `PurchaseOrder` resource. When none is
     # configured, it will default to Fulfil.
@@ -37,14 +37,39 @@ module ErpIntegration
     # @return [Symbol] The configured adapter for the purchase order lines.
     attr_writer :purchase_order_line_adapter
 
+    # Allows configuring an adapter for the `PurchaseRequest` resource. When
+    # none is configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the purchase request.
+    attr_writer :purchase_request_adapter
+
+    # Allows configuring an adapter for the `SalesOrder` resource. When none is
+    # configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the sales orders
+    attr_writer :sales_order_adapter
+
+    # Allows configuring an adapter for the `SalesOrderLine` resource. When none is
+    # configured, it will default to Fulfil.
+    # @return [Symbol] The configured adapter for the order lines.
+    attr_writer :sales_order_line_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.
+    attr_writer :supplier_shipment_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.
+    attr_writer :stock_move_adapter
+
     def initialize(**options)
       options.each_pair do |key, value|
         public_send("#{key}=", value) if respond_to?("#{key}=")
       end
     end
 
-    def order_adapter
-      @order_adapter || :fulfil
+    def product_adapter
+      @product_adapter || :fulfil
     end
 
     def purchase_order_adapter
@@ -54,6 +79,26 @@ module ErpIntegration
     def purchase_order_line_adapter
       @purchase_order_line_adapter || :fulfil
     end
+
+    def purchase_request_adapter
+      @purchase_request_adapter || :fulfil
+    end
+
+    def sales_order_line_adapter
+      @sales_order_line_adapter || :fulfil
+    end
+
+    def sales_order_adapter
+      @sales_order_adapter || :fulfil
+    end
+
+    def supplier_shipment_adapter
+      @supplier_shipment_adapter || :fulfil
+    end
+
+    def stock_move_adapter
+      @stock_move_adapter || :fulfil
+    end
   end
 
   # Returns ERP Integration's configuration.

data/lib/erp_integration/fulfil/query_methods.rb

@@ -13,14 +13,14 @@ module ErpIntegration
       # selecting multiple fields at once.
       #
       # @example
-      #   $ ErpIntegration::Order.select(:id, :name, 'product.name')
+      #   $ ErpIntegration::SalesOrder.select(:id, :name, 'product.name')
       #   # => <ErpIntegration::Fulfil::Resources::Order @selected_fields=[:id, :name, "product.name"] />
       #
       # When one calls the `all` method, it will fetch all the resources from Fulfil
       # and it will return all the given fields (if available).
       #
       # @example
-      #   $ ErpIntegration::Order.select(:id, :name, 'product.name').all
+      #   $ ErpIntegration::SalesOrder.select(:id, :name, 'product.name').all
       #   # => <ErpIntegration::Fulfil::Collection @items=[...] />
       #
       # Both a list of Strings, Symbols or a combination of these can be passed
@@ -41,8 +41,8 @@ module ErpIntegration
       # to query resources in Fulfil.
       #
       # @example
-      #   $ ErpIntegration::Order.where(id: 100).all
-      #   # => <ErpIntegration::Fulfil::Collection @items=[<ErpIntegration::Order @id=100 />] />
+      #   $ ErpIntegration::SalesOrder.where(id: 100).all
+      #   # => <ErpIntegration::Fulfil::Collection @items=[<ErpIntegration::SalesOrder @id=100 />] />
       #
       # If one adds the `comparison_operator` key to the arguments, it will use
       # that comparison operator to build the query to Fulfil.
@@ -74,10 +74,26 @@ module ErpIntegration
         where(args.merge(comparison_operator: 'in'))
       end
 
+      def where_less_than(args)
+        where(args.merge(comparison_operator: '<'))
+      end
+
+      def where_less_or_equal_to(args)
+        where(args.merge(comparison_operator: '<='))
+      end
+
       def where_like(args)
         where(args.merge(comparison_operator: 'like'))
       end
 
+      def where_more_than(args)
+        where(args.merge(comparison_operator: '>'))
+      end
+
+      def where_more_or_equal_to(args)
+        where(args.merge(comparison_operator: '>='))
+      end
+
       def where_not(args)
         where(args.merge(comparison_operator: '!='))
       end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative '../api_resource'
+
+module ErpIntegration
+  module Fulfil
+    module Resources
+      class Product < ApiResource
+        self.model_name = 'product.product'
+
+        # Checks whether a certain product is a BOM.
+        # @param sku [String] The product's SKU.
+        # @return [Boolean] Whether it's a BOM or not.
+        def bom?(sku)
+          select(:boms).where(code: sku).first.boms.any?
+        end
+        alias billing_of_materials? bom?
+      end
+    end
+  end
+end

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

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

data/lib/erp_integration/fulfil/resources/{order.rb → sales_order.rb}

@@ -5,7 +5,7 @@ require_relative '../api_resource'
 module ErpIntegration
   module Fulfil
     module Resources
-      class Order < ApiResource
+      class SalesOrder < ApiResource
         self.model_name = 'sale.sale'
 
         # Allows cancelling the entire sales order in Fulfil.
@@ -22,6 +22,11 @@ module ErpIntegration
         # https://developers.fulfil.io/rest_api/model/sale.sale/#cancel-a-sales-order
         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

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

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

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

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

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

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

data/lib/erp_integration/fulfil/where_clause.rb

@@ -18,7 +18,7 @@ module ErpIntegration
     #   # => <WhereClause @key="id" value="100" comparison_operator="=" />
     class WhereClause
       COMPARISON_OPERATORS = [
-        '=', '!=', '<', '<=', '=>', '>', 'like', 'ilike', 'in', 'not in'
+        '=', '!=', '<', '<=', '>=', '>', 'like', 'ilike', 'in', 'not in'
       ].freeze
 
       DEFAULT_COMPARISON_OPERATOR = '='
@@ -26,7 +26,7 @@ module ErpIntegration
       def initialize(key:, value:, comparison_operator: DEFAULT_COMPARISON_OPERATOR)
         @comparison_operator = verify_comparison_operator(comparison_operator)
         @key = key.to_s
-        @value = value.to_s
+        @value = value
       end
 
       # Transforms the `WhereClause` into a filter object for Fulfil.

data/lib/erp_integration/product.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # The `ErpIntegration::Product` exposes an uniformed API for interaction with
+  # third-party ERP vendors.
+  class Product < Resource
+    attr_accessor :id, :code, :cost_price, :cost_price_method, :quantity_available,
+                  :quantity_buildable, :quantity_inbound, :quantity_on_hand, :salable,
+                  :template, :variant_name, :abc_classification, :account_category,
+                  :account_cogs_used, :account_expense_used, :account_revenue_used,
+                  :account_stock_lost_found_used, :account_stock_production_used,
+                  :account_stock_supplier_used, :account_stock_used, :active,
+                  :asin, :attachments, :attribute_set, :attributes, :attributes_json,
+                  :average_daily_consumed, :average_daily_sales, :average_monthly_consumed,
+                  :average_monthly_sales, :average_price, :boms, :box_type, :brand, :channel_listings,
+                  :consumable, :country_of_origin, :create_date, :create_uid, :customs_description,
+                  :customs_value, :days_of_inventory_left, :default_uom, :default_uom_category,
+                  :description, :dimensions_uom, :ean, :fulfil_strategy, :gc_max, :gc_min,
+                  :gift_card_delivery_mode, :gift_card_prices, :google_product_category,
+                  :gross_margin, :gross_profit, :height, :hs_code, :is_gift_card, :landed_cost,
+                  :lead_time_in_days, :length, :list_price, :long_description, :metadata,
+                  :next_shipping_date, :product_suppliers, :purchasable, :purchase_uom,
+                  :quantity_on_confirmed_purchase_orders, :quantity_outbound, :quantity_returned,
+                  :quantity_sold, :quantity_waiting_consumption, :quantity_wip, :safety_stock_days,
+                  :sale_uom, :scan_required, :ship_from_stock_if_available, :type,
+                  :upc, :use_name_as_customs_description, :weight, :weight_uom,
+                  :width, :write_date, :write_uid
+  end
+end

data/lib/erp_integration/purchase_request.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # The `ErpIntegration::PurchaseRequest` exposes an uniformed API for interaction with
+  # third-party ERP vendors.
+  class PurchaseRequest < Resource
+    attr_accessor :id, :party, :product, :quantity, :attachments, :company,
+                  :create_date, :create_uid, :customer, :delivery_address,
+                  :metadata, :purchase, :purchase_date, :purchase_line, :state,
+                  :uom, :warehouse, :write_date, :write_uid
+  end
+end

data/lib/erp_integration/resource.rb

@@ -16,8 +16,8 @@ module ErpIntegration
   #     config.order_adapter = :fulfil
   #   end
   #
-  #   $ ErpIntegration::Order.adapter
-  #   => #<ErpIntegration::Orders::FulfilOrder />
+  #   $ ErpIntegration::SalesOrder.adapter
+  #   => #<ErpIntegration::SalesOrders::FulfilOrder />
   #
   # To add a new resource, follow these steps:
   #   1. Add a new `attr_writer` in the `ErpIntegration::Configuration` class.

data/lib/erp_integration/sales_order.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # The `ErpIntegration::SalesOrder` exposes an uniformed API for interaction with
+  # third-party ERP vendors.
+  class SalesOrder < Resource
+    attr_accessor :id, :channel, :number, :party, :sale_date, :shipment_address,
+                  :amount_invoiced, :attachments, :carrier, :carrier_service,
+                  :channel_identifier, :comment, :company, :confirmation_time,
+                  :create_date, :currency, :description, :gateway_transaction,
+                  :invoice_address, :invoice_method, :invoice_state, :invoices,
+                  :lines, :metadata, :payment_term, :payment_total, :price_list,
+                  :reference, :sales_person, :shipment_amount, :shipment_method,
+                  :shipment_state, :shipments, :shipping_start_date, :state,
+                  :tax_amount, :total_amount, :total_quantity, :total_shipment_cost,
+                  :untaxed_amount, :warehouse, :weight, :weight_uom, :write_date,
+                  :write_uid
+
+    def cancel
+      self.class.adapter.cancel(id)
+    end
+  end
+end

data/lib/erp_integration/sales_order_line.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  # The `ErpIntegration::SalesOrderLine` exposes an uniformed API for interaction with
+  # third-party ERP vendors.
+  class SalesOrderLine < Resource
+    attr_accessor :id, :product, :quantity, :unit, :unit_price, :amount, :attachments,
+                  :channel_identifier, :create_date, :create_uid, :delivery_address,
+                  :delivery_date, :delivery_mode, :description, :discount, :gift_message,
+                  :gross_profit_cpny_cc, :is_gift_card, :list_price, :listing_sku,
+                  :metadata, :note, :options, :purhcase_request, :quantity_canceled,
+                  :quantity_reserved, :quantity_shipped, :return_reason, :sale,
+                  :sequence, :shipping_date, :taxes, :type, :warehouse, :write_date,
+                  :write_uid
+  end
+end

data/lib/erp_integration/stock_move.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  class StockMove < Resource
+    attr_accessor :attachments, :children, :company, :cost_price, :create_date,
+                  :create_uid, :currency, :effective_date, :from_location,
+                  :from_sublocation, :id, :internal_quantity, :journal_entry,
+                  :metadata, :planned_date, :quantity, :quantity_available,
+                  :reference, :state, :to_location, :unit_price, :uom, :write_date,
+                  :write_uid
+  end
+end

data/lib/erp_integration/supplier_shipment.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module ErpIntegration
+  class SupplierShipment < Resource
+    attr_accessor :acknowledged_by_3pl_at, :attachments, :carrier, :carrier_service,
+                  :company, :contact_address, :cost, :cost_currency, :create_date,
+                  :create_uidcustomer_shipments, :effective_date, :id, :incoming_moves,
+                  :inventory_moves, :metadata, :moves, :number, :packages, :planned_date,
+                  :reference, :sent_to_3pl_at, :shipping_instructions, :shipping_manifest,
+                  :sscc_code, :state, :supplier, :supplier_location, :total_quantity,
+                  :tpl_status, :tracking_number, :warehouse, :weight, :weight_uom,
+                  :write_date, :write_uid
+  end
+end

data/lib/erp_integration/version.rb

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

data/lib/erp_integration.rb

@@ -20,8 +20,13 @@ require_relative 'erp_integration/fulfil/client'
 # The `ErpIntegration` integrates Mejuri with third-party ERP vendors.
 module ErpIntegration
   # Resources
-  autoload :Resource, 'erp_integration/resource'
-  autoload :Order, 'erp_integration/order'
+  autoload :Product, 'erp_integration/product'
   autoload :PurchaseOrder, 'erp_integration/purchase_order'
   autoload :PurchaseOrderLine, 'erp_integration/purchase_order_line'
+  autoload :PurchaseRequest, 'erp_integration/purchase_request'
+  autoload :Resource, 'erp_integration/resource'
+  autoload :SalesOrder, 'erp_integration/sales_order'
+  autoload :SalesOrderLine, 'erp_integration/sales_order_line'
+  autoload :StockMove, 'erp_integration/stock_move'
+  autoload :SupplierShipment, 'erp_integration/supplier_shipment'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: erp_integration
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Stefan Vermaas
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-10-07 00:00:00.000000000 Z
+date: 2021-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -48,16 +48,22 @@ dependencies:
   name: faraday_middleware
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.14'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 0.14.0
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.14'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: 0.14.0
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: byebug
   requirement: !ruby/object:Gem::Requirement
@@ -259,15 +265,25 @@ files:
 - lib/erp_integration/fulfil/client.rb
 - lib/erp_integration/fulfil/query.rb
 - lib/erp_integration/fulfil/query_methods.rb
-- lib/erp_integration/fulfil/resources/order.rb
+- lib/erp_integration/fulfil/resources/product.rb
 - lib/erp_integration/fulfil/resources/purchase_order.rb
 - lib/erp_integration/fulfil/resources/purchase_order_line.rb
+- 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/stock_move.rb
+- lib/erp_integration/fulfil/resources/supplier_shipment.rb
 - lib/erp_integration/fulfil/where_clause.rb
 - lib/erp_integration/middleware/error_handling.rb
-- lib/erp_integration/order.rb
+- lib/erp_integration/product.rb
 - lib/erp_integration/purchase_order.rb
 - lib/erp_integration/purchase_order_line.rb
+- lib/erp_integration/purchase_request.rb
 - lib/erp_integration/resource.rb
+- lib/erp_integration/sales_order.rb
+- lib/erp_integration/sales_order_line.rb
+- lib/erp_integration/stock_move.rb
+- lib/erp_integration/supplier_shipment.rb
 - lib/erp_integration/version.rb
 homepage: https://www.github.com/mejuri-inc/erp-integration
 licenses:

data/lib/erp_integration/order.rb

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