duodealer_api 1.0.0

data/lib/duodealer_api/resources/customer.rb

@@ -0,0 +1,29 @@
+module DuodealerAPI
+  class Customer < Base
+    include Metafields
+
+    def orders
+      Order.find(:all, params: {customer_id: self.id})
+    end
+
+    def self.search(params)
+      find(:all, from: :search, params: params)
+    end
+
+    def account_activation_url
+      resource = post(:account_activation_url, {}, only_id)
+      data = ActiveSupport::JSON.decode(resource.body.to_s)
+      result = nil
+
+      if data.key?('account_activation_url')
+        result = data['account_activation_url']
+      end
+      result
+    end
+
+    def send_invite(customer_invite = DuodealerAPI::CustomerInvite.new)
+      resource = post(:send_invite, {}, customer_invite.encode)
+      DuodealerAPI::CustomerInvite.new(DuodealerAPI::CustomerInvite.format.decode(resource.body))
+    end
+  end
+end

data/lib/duodealer_api/resources/customer_group.rb

@@ -0,0 +1,5 @@
+require 'duodealer_api/resources/customer_saved_search'
+
+module DuodealerAPI
+  CustomerGroup = CustomerSavedSearch
+end

data/lib/duodealer_api/resources/customer_invite.rb

@@ -0,0 +1,4 @@
+module DuodealerAPI
+  class CustomerInvite < Base
+  end
+end

data/lib/duodealer_api/resources/customer_saved_search.rb

@@ -0,0 +1,11 @@
+require 'duodealer_api/resources/customer'
+
+module DuodealerAPI
+  class CustomerSavedSearch < Base
+    early_july_pagination_release!
+
+    def customers(params = {})
+      Customer.search(params.merge({:customer_saved_search_id => self.id}))
+    end
+  end
+end

data/lib/duodealer_api/resources/discount_code.rb

@@ -0,0 +1,9 @@
+module DuodealerAPI
+  class DiscountCode < Base
+    init_prefix :price_rule
+
+    def price_rule_id
+      @prefix_options[:price_rule_id]
+    end
+  end
+end

data/lib/duodealer_api/resources/draft_order.rb

@@ -0,0 +1,14 @@
+module DuodealerAPI
+  class DraftOrder < Base
+    include Metafields
+
+    def send_invoice(draft_order_invoice = DuodealerAPI::DraftOrderInvoice.new)
+      resource = post(:send_invoice, {}, draft_order_invoice.encode)
+      DuodealerAPI::DraftOrderInvoice.new(DuodealerAPI::DraftOrder.format.decode(resource.body))
+    end
+
+    def complete(options = {})
+      load_attributes_from_response(put(:complete, options, nil))
+    end
+  end
+end

data/lib/duodealer_api/resources/draft_order_invoice.rb

@@ -0,0 +1,4 @@
+module DuodealerAPI
+  class DraftOrderInvoice < Base
+  end
+end

data/lib/duodealer_api/resources/event.rb

@@ -0,0 +1,8 @@
+module DuodealerAPI
+  class Event < Base
+    include DisablePrefixCheck
+
+    conditional_prefix :resource, true
+    early_july_pagination_release!
+  end
+end

data/lib/duodealer_api/resources/fulfillment.rb

@@ -0,0 +1,47 @@
+module DuodealerAPI
+  class Fulfillment < Base
+    init_prefix :order
+
+    def order_id
+      @prefix_options[:order_id]
+    end
+
+    def cancel; load_attributes_from_response(post(:cancel, {}, only_id)); end
+    def complete; load_attributes_from_response(post(:complete, {}, only_id)); end
+    def open; load_attributes_from_response(post(:open, {}, only_id)); end
+
+    def order_id=(order_id)
+      prefix_options[:order_id] = order_id
+    end
+
+    def load(attributes, remove_root = false, persisted = false)
+      order_id = attributes['order_id']
+      prefix_options[:order_id] = order_id if order_id
+      super(attributes, remove_root, persisted)
+    end
+
+    def save
+      if prefix_options[:order_id].present?
+        super
+      else
+        line_items = attributes['line_items_by_fulfillment_order'] || attributes[:line_items_by_fulfillment_order]
+        if line_items.blank?
+          raise DuodealerAPI::ValidationException,
+                "either 'line_items_by_fulfillment_order' or prefix_options[:order_id] is required"
+        end
+
+        fulfillmentV2 = FulfillmentV2.new(attributes)
+        result = fulfillmentV2.save
+        load(fulfillmentV2.attributes, false, true)
+        result
+      end
+    end
+
+    def update_tracking(tracking_info:, notify_customer:)
+      fulfillmentV2 = FulfillmentV2.new(attributes)
+      result = fulfillmentV2.update_tracking(tracking_info: tracking_info, notify_customer: notify_customer)
+      load(fulfillmentV2.attributes, false, true)
+      result
+    end
+  end
+end

data/lib/duodealer_api/resources/fulfillment_event.rb

@@ -0,0 +1,15 @@
+module DuodealerAPI
+  class FulfillmentEvent < Base
+    self.resource_prefix = "orders/:order_id/fulfillments/:fulfillment_id/"
+    self.collection_name = 'events'
+    self.element_name = 'event'
+
+    def order_id
+      @prefix_options[:order_id]
+    end
+
+    def fulfillment_id
+      @prefix_options[:fulfillment_id]
+    end
+  end
+end

data/lib/duodealer_api/resources/fulfillment_order.rb

@@ -0,0 +1,137 @@
+module DuodealerAPI
+  class FulfillmentOrder < Base
+    MINIMUM_VERSION = '2020-01'
+
+    def initialize(attributes = {}, persisted = false)
+      DuodealerAPI::Base.version_validation!(MINIMUM_VERSION)
+      super(attributes, persisted)
+    end
+
+    def self.find(scope, *args)
+      DuodealerAPI::Base.version_validation!(MINIMUM_VERSION)
+
+      if scope == :all
+        order_id = args.first&.dig(:params, :order_id)
+        raise DuodealerAPI::ValidationException, "'order_id' is required" if order_id.blank?
+
+        order = ::DuodealerAPI::Order.new(id: order_id)
+        order.fulfillment_orders(args.first[:params].except(:order_id))
+      else
+        super(scope, *args)
+      end
+    end
+
+    def fulfillments(options = {})
+      fulfillment_hashes = get(:fulfillments, options)
+      fulfillment_hashes.map { |fulfillment_hash| Fulfillment.new(fulfillment_hash) }
+    end
+
+    def locations_for_move
+      locations_for_move_hashes = get(:locations_for_move, {})
+
+      locations_for_move_hashes.map do |locations_for_move_hash|
+        FulfillmentOrderLocationsForMove.new(locations_for_move_hash)
+      end
+    end
+
+    def move(new_location_id:)
+      body = {
+        fulfillment_order: {
+          new_location_id: new_location_id
+        }
+      }
+      keyed_fulfillment_orders = keyed_fulfillment_orders_from_response(post(:move, {}, body.to_json))
+      load_keyed_fulfillment_order(keyed_fulfillment_orders, 'original_fulfillment_order')
+      keyed_fulfillment_orders
+    end
+
+    def cancel
+      keyed_fulfillment_orders = keyed_fulfillment_orders_from_response(post(:cancel, {}, only_id))
+      load_keyed_fulfillment_order(keyed_fulfillment_orders, 'fulfillment_order')
+      keyed_fulfillment_orders
+    end
+
+    def close(message: nil)
+      body = {
+        fulfillment_order: {
+          message: message
+        }
+      }
+      load_attributes_from_response(post(:close, {}, body.to_json))
+    end
+
+    def request_fulfillment(fulfillment_order_line_items: nil, message: nil)
+      body = {
+        fulfillment_request: {
+          fulfillment_order_line_items: fulfillment_order_line_items,
+          message: message
+        }
+      }
+      keyed_fulfillment_orders = keyed_fulfillment_orders_from_response(post(:fulfillment_request, {}, body.to_json))
+      load_keyed_fulfillment_order(keyed_fulfillment_orders, 'original_fulfillment_order')
+      keyed_fulfillment_orders
+    end
+
+    def accept_fulfillment_request(message: nil)
+      body = {
+        fulfillment_request: {
+          message: message
+        }
+      }
+      load_attributes_from_response(post('fulfillment_request/accept', {}, body.to_json))
+    end
+
+    def reject_fulfillment_request(message: nil)
+      body = {
+        fulfillment_request: {
+          message: message
+        }
+      }
+      load_attributes_from_response(post('fulfillment_request/reject', {}, body.to_json))
+    end
+
+    def request_cancellation(message: nil)
+      body = {
+        cancellation_request: {
+          message: message
+        }
+      }
+      load_attributes_from_response(post(:cancellation_request, {}, body.to_json))
+    end
+
+    def accept_cancellation_request(message: nil)
+      body = {
+        cancellation_request: {
+          message: message
+        }
+      }
+      load_attributes_from_response(post('cancellation_request/accept', {}, body.to_json))
+    end
+
+    def reject_cancellation_request(message: nil)
+      body = {
+        cancellation_request: {
+          message: message
+        }
+      }
+      load_attributes_from_response(post('cancellation_request/reject', {}, body.to_json))
+    end
+
+    private
+
+    def load_keyed_fulfillment_order(keyed_fulfillment_orders, key)
+      if keyed_fulfillment_orders[key]&.attributes
+        load(keyed_fulfillment_orders[key].attributes, false, true)
+      end
+    end
+
+    def keyed_fulfillment_orders_from_response(response)
+      return load_attributes_from_response(response) if response.code != '200'
+
+      keyed_fulfillment_orders = ActiveSupport::JSON.decode(response.body)
+      keyed_fulfillment_orders.transform_values do |fulfillment_order_attributes|
+        FulfillmentOrder.new(fulfillment_order_attributes) if fulfillment_order_attributes
+      end
+    end
+  end
+end

data/lib/duodealer_api/resources/fulfillment_order_locations_for_move.rb

@@ -0,0 +1,4 @@
+module DuodealerAPI
+  class FulfillmentOrderLocationsForMove < Base
+  end
+end

data/lib/duodealer_api/resources/fulfillment_request.rb

@@ -0,0 +1,15 @@
+module DuodealerAPI
+  class FulfillmentRequest < Base
+    init_prefix :order
+
+    def order_id
+      @prefix_options[:order_id]
+    end
+
+    def mark_as_failed
+      options = {}
+      options[:message] = failure_message if failure_message
+      load_attributes_from_response(put(:mark_as_failed, options))
+    end
+  end
+end

data/lib/duodealer_api/resources/fulfillment_service.rb

@@ -0,0 +1,4 @@
+module DuodealerAPI
+  class FulfillmentService < Base
+  end
+end

data/lib/duodealer_api/resources/fulfillment_v2.rb

@@ -0,0 +1,20 @@
+module DuodealerAPI
+  class FulfillmentV2 < Base
+    self.element_name = 'fulfillment'
+
+    def initialize(attributes = {}, persisted = false)
+      DuodealerAPI::Base.version_validation!(FulfillmentOrder::MINIMUM_VERSION)
+      super(attributes, persisted)
+    end
+
+    def update_tracking(tracking_info:, notify_customer:)
+      body = {
+        fulfillment: {
+          tracking_info: tracking_info,
+          notify_customer: notify_customer
+        }
+      }
+      load_attributes_from_response(post(:update_tracking, {}, body.to_json))
+    end
+  end
+end

data/lib/duodealer_api/resources/gift_card.rb

@@ -0,0 +1,7 @@
+module DuodealerAPI
+  class GiftCard < Base
+    def disable
+      load_attributes_from_response(post(:disable))
+    end
+  end
+end

data/lib/duodealer_api/resources/image.rb

@@ -0,0 +1,16 @@
+module DuodealerAPI
+  class Image < Base
+    init_prefix :product
+
+    # generate a method for each possible image variant
+    [:pico, :icon, :thumb, :small, :compact, :medium, :large, :grande, :original].each do |m|
+      reg_exp_match = "/\\1_#{m}.\\2"
+      define_method(m) { src.gsub(/\/(.*)\.(\w{2,4})/, reg_exp_match) }
+    end
+
+    def attach_image(data, filename = nil)
+      attributes['attachment'] = Base64.encode64(data)
+      attributes['filename'] = filename unless filename.nil?
+    end
+  end
+end

data/lib/duodealer_api/resources/inventory_item.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module DuodealerAPI
+  class InventoryItem < Base
+  end
+end

data/lib/duodealer_api/resources/inventory_level.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module DuodealerAPI
+  class InventoryLevel < Base
+
+    # The default path structure in ActiveResource for delete would result in:
+    # /admin/api/<version>/inventory_levels/#{ inventory_level.id }.json?#{ params }, but since
+    # InventroyLevels are a second class resource made up of a Where and a What
+    # (Location and InventoryItem), it does not have a resource ID. Here we
+    # redefine element_path to remove the id so HTTP DELETE requests go to
+    # /admin/api/<version>/inventory_levels.json?#{ params } instead.
+    #
+    def self.element_path(prefix_options = {}, query_options = nil)
+      prefix_options, query_options = split_options(prefix_options) if query_options.nil?
+      "#{prefix(prefix_options)}#{collection_name}.#{format.extension}#{query_string(query_options)}"
+    end
+
+    def destroy
+      load_attributes_from_response(
+        self.class.delete('/', location_id: location_id, inventory_item_id: inventory_item_id)
+      )
+    end
+
+    def connect(relocate_if_necessary: nil)
+      body = { location_id: location_id, inventory_item_id: inventory_item_id }
+      body[:relocate_if_necessary] = relocate_if_necessary unless relocate_if_necessary.nil?
+      load_attributes_from_response(
+        self.class.post(:connect, {}, body.to_json)
+      )
+    end
+
+    def set(new_available, disconnect_if_necessary: nil)
+      body = {
+        location_id: location_id,
+        inventory_item_id: inventory_item_id,
+        available: new_available
+      }
+      body[:disconnect_if_necessary] = disconnect_if_necessary unless disconnect_if_necessary.nil?
+      load_attributes_from_response(
+        self.class.post(:set, {}, body.to_json)
+      )
+    end
+
+    def adjust(available_adjustment)
+      body = {
+        location_id: location_id,
+        inventory_item_id: inventory_item_id,
+        available_adjustment: available_adjustment
+      }
+      load_attributes_from_response(
+        self.class.post(:adjust, {}, body.to_json)
+      )
+    end
+  end
+end

data/lib/duodealer_api/resources/line_item.rb

@@ -0,0 +1,14 @@
+module DuodealerAPI
+  class LineItem < Base
+    class Property < Base
+      def initialize(*args)
+        attributes = args[0] || {}
+        persisted = args[1] || false
+        super
+      rescue NameError
+        attributes = attributes.to_hash
+        self
+      end
+    end
+  end
+end