magento 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f899948f7690202bfadf8b2d0afbb066a864fd85f3e7d0c591df07b4f631d7bb
-  data.tar.gz: 63585fc1f5b5ba321a065e2796c253b52f544b3b057b941b933c027a04d63d07
+  metadata.gz: 9c96180295e2e45d66ac2ea4aa956ec516c3c5045d81db431538cd5462b5efcc
+  data.tar.gz: b2d13f614c5af4b956e97b87c7e2476d1a40fd1ada11cb94270698630d44f9b2
 SHA512:
-  metadata.gz: 0142acdd5ef93981d5170c39fecd73852458d8ea4a01d8b3c2ee28fd01c82ae26f2f16c533219908d8110648f50a99188b89a0f8537750b187fe62f003ff04c3
-  data.tar.gz: 39092a61524a5f09cc61ead86e66917f5833f2b30ca6a7155479c41af471a88394ccdbd233341a03ef6a8fadbd3e3dbd6b222d554b9eee590f0fec1b3b1f7006
+  metadata.gz: 512781570485d5af44f8567b31c4988d096682f0e3fe6119803c18385842cecbfc28bdb2a16fb02091d0000cbf2cbae2b5174cf3b0489d398450957c76377069
+  data.tar.gz: 51dd50c0b4a2542e6467dff88553eb5a0542f7efff10de0430a6fb3bdba32e5e8232bf4ef4e5f07b886eeebf6835aad8127791c3d84ddc89632db6ed73d35c0d

data/README.md

@@ -5,7 +5,7 @@
 Add in your Gemfile
 
 ```rb
-gem 'magento', '~> 0.6.0'
+gem 'magento', '~> 0.7.0'
 ```
 
 or run
@@ -288,6 +288,129 @@ 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(refund_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)
+
+
+## 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)
+
 ___
 
 ##TODO:
@@ -296,3 +419,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/atrelar_produto_loja.rb

@@ -0,0 +1,20 @@
+require './lib/magento'
+
+Magento.url   = 'https://maniadagua.com'
+Magento.token = 'f44251o3xjijz8ou78hoyh8a06kdtkmh'
+
+page = 245
+
+loop do
+  products = Magento::Product.page(page).per(5).all
+
+  products.each do |product|
+    Magento::Product.update(product.sku, extension_attributes: { website_ids: [1, 2] })
+    puts "update page #{page}, product: #{product.name}"
+  rescue => e
+    puts "ERRO ao cadastrar: #{product.name}, #{e.message}"
+  end
+
+  break if products.last_page?
+  page = products.next_page
+end

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.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
+
+    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::Order.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/#{order_id}/refund", invoice_params).parse
+      end
+    end
+  end
+end

data/lib/magento/order.rb

@@ -16,11 +16,94 @@ module Magento
       self.class.update(attrs)
     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
+
+    #
+    # 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
+
+      #
+      # 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
+
+      #
+      # 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.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: magento
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Wallas Faria
@@ -48,15 +48,18 @@ files:
 - ".gitignore"
 - Gemfile
 - README.md
+- atrelar_produto_loja.rb
 - lib/magento.rb
 - lib/magento/category.rb
 - lib/magento/country.rb
 - 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 +69,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