magento 0.6.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f899948f7690202bfadf8b2d0afbb066a864fd85f3e7d0c591df07b4f631d7bb
-  data.tar.gz: 63585fc1f5b5ba321a065e2796c253b52f544b3b057b941b933c027a04d63d07
+  metadata.gz: 84ae0187402170a5d338e8fe19f7ffa07211be073592c36aff70a5edef16e008
+  data.tar.gz: 7eed987d9b42e2ec86f9394c088c363658cb27cfcb664a8d2192ada23c0ee5b8
 SHA512:
-  metadata.gz: 0142acdd5ef93981d5170c39fecd73852458d8ea4a01d8b3c2ee28fd01c82ae26f2f16c533219908d8110648f50a99188b89a0f8537750b187fe62f003ff04c3
-  data.tar.gz: 39092a61524a5f09cc61ead86e66917f5833f2b30ca6a7155479c41af471a88394ccdbd233341a03ef6a8fadbd3e3dbd6b222d554b9eee590f0fec1b3b1f7006
+  metadata.gz: beef9d8552c025b306ad434b33701030e032b8a603545bfcfbc407be1b141f36625075ab4f873e8bac78b6369fd5334239af3da8cff0de04ebc445ed4f1fde3d
+  data.tar.gz: b8e897978815efe0416471903a3d398b5d4ed8593a59353852cda2d33b3843ae861929f168425072ab69caeb7dec0d360ba5c1345919a2ab81990f368134c744

data/README.md

@@ -5,7 +5,7 @@
 Add in your Gemfile
 
 ```rb
-gem 'magento', '~> 0.6.0'
+gem 'magento', '~> 0.9.0'
 ```
 
 or run
@@ -288,6 +288,182 @@ cart.payment_information(
 >> "234575" # return the order id
 ```
 
+## Invoice an Order
+
+```rb
+Magento::Order.invoice(order_id)
+>> 25 # return incoice id
+
+# or from instance
+
+order = Magento::Order.find(order_id)
+
+invoice_id = order.invoice
+
+# you can pass parameters too
+
+invoice_id = order.invoice(
+  capture: false,
+  appendComment: true,
+  items: [{ order_item_id: 123, qty: 1 }], # pass items to partial invoice
+  comment: {
+    extension_attributes: { },
+    comment: "string",
+    is_visible_on_front: 0
+  },
+  notify: true
+)
+```
+
+[Complete Invoice Documentation](https://magento.redoc.ly/2.4-admin/tag/orderorderIdinvoice#operation/salesInvoiceOrderV1ExecutePost)
+
+## Create refund for invoice
+
+```rb
+Magento::Invoice.invoice(invoice_id)
+>> 12 # return refund id
+
+# or from instance
+
+invoice = Magento::Invoice.find(invoice_id)
+
+refund_id = invoice.refund
+
+# you can pass parameters too
+
+invoice.refund(
+  items: [
+    {
+      extension_attributes: {},
+      order_item_id: 0,
+      qty: 0
+    }
+  ],
+  isOnline: true,
+  notify: true,
+  appendComment: true,
+  comment: {
+    extension_attributes: {},
+    comment: string,
+    is_visible_on_front: 0
+  },
+  arguments: {
+    shipping_amount: 0,
+    adjustment_positive: 0,
+    adjustment_negative: 0,
+    extension_attributes: {
+      return_to_stock_items: [0]
+    }
+  }
+)
+```
+
+[Complete Refund Documentation](https://magento.redoc.ly/2.4-admin/tag/invoicescomments#operation/salesRefundInvoiceV1ExecutePost)
+
+
+## Create offline refund for order
+
+```rb
+Magento::Order.refund(order_id)
+>> 12 # return refund id
+
+# or from instance
+
+order = Magento::Order.find(order_id)
+
+order.refund
+
+# you can pass parameters too
+
+order.refund(
+  items: [
+    {
+      extension_attributes: {},
+      order_item_id: 0,
+      qty: 0
+    }
+  ],
+  notify: true,
+  appendComment: true,
+  comment: {
+    extension_attributes: {},
+    comment: string,
+    is_visible_on_front: 0
+  },
+  arguments: {
+    shipping_amount: 0,
+    adjustment_positive: 0,
+    adjustment_negative: 0,
+    extension_attributes: {
+      return_to_stock_items: [0]
+    }
+  }
+)
+```
+
+[Complete Refund Documentation](https://magento.redoc.ly/2.4-admin/tag/invoicescomments#operation/salesRefundOrderV1ExecutePost)
+
+## Other Invoice methods
+
+```rb
+invoice = Magento::Invoice.find(invoice_id)
+
+invoice.capture # or
+Magento::Invoice.capture(invoice_id)
+
+invoice.void # or
+Magento::Invoice.void(invoice_id)
+
+invoice.send_email # or
+Magento::Invoice.send_email(invoice_id)
+
+Magento::Invoice.comments(invoice_id).all
+Magento::Invoice.comments(invoice_id).where(created_at_gt: Date.today.prev_day).all
+```
+
+## Creates new Shipment for given Order.
+
+```rb
+Magento::Order.ship(order_id)
+>> 25 # return shipment id
+
+# or from instance
+
+order = Magento::Order.find(order_id)
+
+order.ship
+
+# you can pass parameters too
+
+order.ship(
+  capture: false,
+  appendComment: true,
+  items: [{ order_item_id: 123, qty: 1 }], # pass items to partial shipment
+  tracks: [
+    {
+      extension_attributes: { },
+      track_number: "string",
+      title: "string",
+      carrier_code: "string"
+    }
+  ]
+  notify: true
+)
+```
+
+[Complete Shipment Documentation](https://magento.redoc.ly/2.4-admin/tag/orderorderIdship#operation/salesShipOrderV1ExecutePost)
+
+
+## Cancel an Order
+
+```rb
+order = Magento::Order.find(order_id)
+
+order.cancel # or
+
+Magento::Order.cancel(order_id)
+```
+
 ___
 
 ##TODO:
@@ -296,3 +472,31 @@ ___
 ```rb
 Magento::Product.search('tshort')
 ```
+
+### First result
+```rb
+Magento::Product.first
+>> <Magento::Product @sku="some-sku" ...>
+
+Magento::Product.where(name_like: 'some name%').first
+>> <Magento::Product @sku="some-sku" ...>
+```
+
+### Last result
+```rb
+Magento::Product.last
+>> <Magento::Product @sku="some-sku" ...>
+
+Magento::Product.where(name_like: 'some name%').last
+>> <Magento::Product @sku="some-sku" ...>
+```
+
+### Count result
+```rb
+Magento::Product.count
+>> 7855
+Magento::Product.where(name_like: 'some name%').count
+>> 15
+```
+
+### Tests

data/lib/magento.rb

@@ -6,6 +6,7 @@ require 'dry/inflector'
 require_relative 'magento/errors'
 require_relative 'magento/request'
 require_relative 'magento/model_mapper'
+require_relative 'magento/polymorphic_model'
 require_relative 'magento/model'
 require_relative 'magento/record_collection'
 require_relative 'magento/query'
@@ -14,6 +15,7 @@ require_relative 'magento/product'
 require_relative 'magento/country'
 require_relative 'magento/customer'
 require_relative 'magento/order'
+require_relative 'magento/invoice'
 require_relative 'magento/guest_cart'
 
 Dir[File.expand_path('magento/shared/*.rb', __dir__)].map { |f| require f }

data/lib/magento/invoice.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module Magento
+  class Invoice < Model
+    self.primary_key = :entity_id
+    self.entity_key = :entity
+
+    #
+    # Sets invoice capture.
+    def capture
+      self.class.capture(id)
+    end
+
+    #
+    # Voids a specified invoice.
+    #
+    # @return {Boolean}
+    def void
+      self.class.void(id)
+    end
+
+    #
+    # Emails a user a specified invoice.
+    #
+    # @return {Boolean}
+    def send_email
+      self.class.send_email(id)
+    end
+
+    #
+    # Create refund for invoice
+    #
+    # invoice = Magento::Invoice.find(invoice_id)
+    #
+    # invoice.refund # or you can pass parameters
+    # invoice.refund(isOnline: true) # See the refund class method for more information
+    #
+    # @return {Integer} return the refund id
+    def refund(refund_params = nil)
+      self.class.refund(id, refund_params)
+    end
+
+    class << self
+      def save
+        raise NotImplementedError
+      end
+
+      def update(_attributes)
+        raise NotImplementedError
+      end
+
+      def create(_attributes)
+        raise NotImplementedError
+      end
+
+      #
+      # Sets invoice capture.
+      def capture(invoice_id)
+        request.post("invoices/#{invoice_id}/capture").parse
+      end
+
+      #
+      # Voids a specified invoice.
+      #
+      # @return {Boolean}
+      def void(invoice_id)
+        request.post("invoices/#{invoice_id}/avoid").parse
+      end
+
+      #
+      # Emails a user a specified invoice.
+      #
+      # @return {Boolean}
+      def send_email(invoice_id)
+        request.post("invoices/#{invoice_id}/emails").parse
+      end
+
+      #
+      # Lists comments for a specified invoice.
+      #
+      # Magento::Invoice.comments(invoice_id).all
+      # Magento::Invoice.comments(invoice_id).where(created_at_gt: Date.today.prev_day).all
+      def comments(invoice_id)
+        api_resource = "invoices/#{invoice_id}/comments"
+        Query.new(PolymorphicModel.new(Comment, api_resource))
+      end
+
+      #
+      # Create refund for invoice
+      #
+      # Magento::Invoice.refund(invoice_id)
+      #
+      # or
+      #
+      # Magento::Invoice.refund(
+      #   invoice_id,
+      #   items: [
+      #     {
+      #       extension_attributes: {},
+      #       order_item_id: 0,
+      #       qty: 0
+      #     }
+      #   ],
+      #   isOnline: true,
+      #   notify: true,
+      #   appendComment: true,
+      #   comment: {
+      #     extension_attributes: {},
+      #     comment: string,
+      #     is_visible_on_front: 0
+      #   },
+      #   arguments: {
+      #     shipping_amount: 0,
+      #     adjustment_positive: 0,
+      #     adjustment_negative: 0,
+      #     extension_attributes: {
+      #       return_to_stock_items: [
+      #         0
+      #       ]
+      #     }
+      #   }
+      # )
+      #
+      # to complete [documentation](https://magento.redoc.ly/2.4-admin/tag/invoicescomments#operation/salesRefundInvoiceV1ExecutePost)
+      #
+      # @return {Integer} return the refund id
+      def refund(invoice_id, refund_params=nil)
+        request.post("invoice/#{invoice_id}/refund", refund_params).parse
+      end
+    end
+  end
+end

data/lib/magento/order.rb

@@ -16,11 +16,160 @@ module Magento
       self.class.update(attrs)
     end
 
+    def cancel
+      self.class.cancel(id)
+    end
+
+    #
+    # Invoice current order
+    #
+    # order = Magento::Order.find(order_id)
+    #
+    # order.invoice # or you can pass parameters
+    # order.invoice(capture: false) # See the invoice class method for more information
+    #
+    # @return String: return the invoice id
+    def invoice(params=nil)
+      self.class.invoice(id, params)
+    end
+
+    
+    #
+    # Create offline refund for order
+    #
+    # order = Magento::Order.find(order_id)
+    #
+    # order.refund # or you can pass parameters
+    # order.invoice(notify: false) # See the refund class method for more information
+    #
+    # @return {Integer} return the refund id
+    def refund(refund_params = nil)
+      self.class.refund(id, refund_params)
+    end
+
+    #
+    # Creates new Shipment for given Order.
+    #
+    # order = Magento::Order.find(order_id)
+    #
+    # order.ship # or you can pass parameters
+    # order.ship(notify: false) # See the shipment class method for more information
+    #
+    # Return the shipment id
+    def ship(params=nil)
+      self.class.ship(id, params)
+    end
+
     class << self
       def update(attributes)
         hash = request.put('orders/create', { entity_key => attributes }).parse
         build(hash)
       end
+
+      # @return {Boolean}
+      def cancel(order_id)
+        request.post("orders/#{order_id}/cancel").parse
+      end
+
+      #
+      # Invoice an order
+      #
+      # Magento::Order.invoice(order_id)
+      #
+      # or
+      #
+      # Magento::Order.invoice(
+      #   order_id,
+      #   capture: false,
+      #   appendComment: true,
+      #   items: [{ order_item_id: 123, qty: 1 }], # pass items to partial invoice
+      #   comment: {
+      #     extension_attributes: { },
+      #     comment: "string",
+      #     is_visible_on_front: 0
+      #   },
+      #   notify: true
+      # )
+      #
+      # to complete [documentation](https://magento.redoc.ly/2.4-admin/tag/orderorderIdinvoice#operation/salesInvoiceOrderV1ExecutePost)
+      #
+      # @return String: return the invoice id
+      def invoice(order_id, invoice_params=nil)
+        request.post("order/#{order_id}/invoice", invoice_params).parse
+      end
+
+      
+      #
+      # Create offline refund for order
+      #
+      # Magento::Order.refund(order_id)
+      #
+      # or
+      #
+      # Magento::Order.refund(
+      #   order_id,
+      #   items: [
+      #     {
+      #       extension_attributes: {},
+      #       order_item_id: 0,
+      #       qty: 0
+      #     }
+      #   ],
+      #   notify: true,
+      #   appendComment: true,
+      #   comment: {
+      #     extension_attributes: {},
+      #     comment: string,
+      #     is_visible_on_front: 0
+      #   },
+      #   arguments: {
+      #     shipping_amount: 0,
+      #     adjustment_positive: 0,
+      #     adjustment_negative: 0,
+      #     extension_attributes: {
+      #       return_to_stock_items: [
+      #         0
+      #       ]
+      #     }
+      #   }
+      # )
+      #
+      # to complete [documentation](https://magento.redoc.ly/2.4-admin/tag/invoicescomments#operation/salesRefundOrderV1ExecutePost)
+      #
+      # @return {Integer} return the refund id
+      def refund(order_id, refund_params = nil)
+        request.post("order/#{order_id}/refund", refund_params).parse
+      end
+
+      #
+      # Creates new Shipment for given Order.
+      #
+      # Magento::Order.ship(order_id)
+      #
+      # or
+      #
+      # Magento::Order.ship(
+      #   order_id,
+      #   capture: false,
+      #   appendComment: true,
+      #   items: [{ order_item_id: 123, qty: 1 }], # pass items to partial shipment
+      #   tracks: [
+      #     {
+      #       extension_attributes: { },
+      #       track_number: "string",
+      #       title: "string",
+      #       carrier_code: "string"
+      #     }
+      #   ]
+      #   notify: true
+      # )
+      #
+      # to complete [documentation](https://magento.redoc.ly/2.4-admin/tag/orderorderIdship#operation/salesShipOrderV1ExecutePost)
+      #
+      # @return {String}: return the shipment id
+      def ship(order_id, shipment_params = nil)
+        request.post("order/#{order_id}/ship", shipment_params).parse
+      end
     end
   end
 end

data/lib/magento/polymorphic_model.rb

@@ -0,0 +1,18 @@
+module Magento
+  class PolymorphicModel
+    attr_reader :api_resource
+
+    def initialize(model, api_resource)
+      @model = model
+      @api_resource = api_resource
+    end
+
+    def new
+      @model.new
+    end
+
+    def build(attributes)
+      @model.build(attributes)
+    end
+  end
+end

data/lib/magento/shared/comment.rb

@@ -0,0 +1,5 @@
+module Magento
+  class Comment
+    include Magento::ModelParser
+  end
+end

data/lib/magento/version.rb

@@ -1,3 +1,3 @@
 module Magento
-  VERSION = '0.6.0'
+  VERSION = '0.9.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: magento
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Wallas Faria
@@ -54,9 +54,11 @@ files:
 - lib/magento/customer.rb
 - lib/magento/errors.rb
 - lib/magento/guest_cart.rb
+- lib/magento/invoice.rb
 - lib/magento/model.rb
 - lib/magento/model_mapper.rb
 - lib/magento/order.rb
+- lib/magento/polymorphic_model.rb
 - lib/magento/product.rb
 - lib/magento/query.rb
 - lib/magento/record_collection.rb
@@ -66,6 +68,7 @@ files:
 - lib/magento/shared/billing_address.rb
 - lib/magento/shared/bundle_product_option.rb
 - lib/magento/shared/category_link.rb
+- lib/magento/shared/comment.rb
 - lib/magento/shared/configurable_product_option.rb
 - lib/magento/shared/currency.rb
 - lib/magento/shared/custom_attribute.rb