magento 0.5.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4034005945e350699f74bfd858941a2e0295e2f8e3b6fd1d19c605d68da703fe
-  data.tar.gz: 8d6dbbe72502d09f6ea1f437bb52151c767e28ff1ec3e2ab697594b8e59e836e
+  metadata.gz: 9c96180295e2e45d66ac2ea4aa956ec516c3c5045d81db431538cd5462b5efcc
+  data.tar.gz: b2d13f614c5af4b956e97b87c7e2476d1a40fd1ada11cb94270698630d44f9b2
 SHA512:
-  metadata.gz: 84b758c7a69c84f75dc877475d24a61518e609339b3bac0d93a3561241d5a7bb6214d2e909923100ed44626bd1eeead86370af7dc03a6c43c5d5c8bcb688d011
-  data.tar.gz: ea6359f11056d8defd7fe4b9d8b1a27c0d45e441a56e9f72ca0cd042b52d87d4c6832c3d14b5c6c1bc7ee9401b623ae859dd22dd503f1b209fccdc5f977c0745
+  metadata.gz: 512781570485d5af44f8567b31c4988d096682f0e3fe6119803c18385842cecbfc28bdb2a16fb02091d0000cbf2cbae2b5174cf3b0489d398450957c76377069
+  data.tar.gz: 51dd50c0b4a2542e6467dff88553eb5a0542f7efff10de0430a6fb3bdba32e5e8232bf4ef4e5f07b886eeebf6835aad8127791c3d84ddc89632db6ed73d35c0d

data/README.md

@@ -5,7 +5,7 @@
 Add in your Gemfile
 
 ```rb
-gem 'magento', '~> 0.5.1'
+gem 'magento', '~> 0.7.0'
 ```
 
 or run
@@ -20,6 +20,10 @@ gem install magento
 Magento.url   = 'https://yourstore.com'
 Magento.token = 'MAGENTO_API_KEY'
 Magento.store = :default # optional, Default is :all
+
+Magento.with_config(store: :other_store) do # accepts store, url and token parameters
+  Magento::Product.find('sku')
+end
 ```
 
 ## Models
@@ -151,6 +155,12 @@ products.size
 products.current_page
 >> 1
 
+products.next_page
+>> 2
+
+products.last_page?
+>> false
+
 products.page_size
 >> 5
 
@@ -166,6 +176,8 @@ All Methods:
 ```rb
 # Information about search criteria
 :current_page
+:next_page
+:last_page?
 :page_size
 :total_count
 :filter_groups
@@ -276,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:
@@ -284,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 }
@@ -35,6 +37,22 @@ module Magento
   self.token          = ENV['MAGENTO_TOKEN']
   self.store          = ENV['MAGENTO_STORE'] || :all
 
+  def self.with_config(utl: Magento.url, token: Magento.token, store: Magento.store)
+    @old_url   = self.url
+    @old_token = self.token
+    @old_store = self.store
+    
+    self.url   = utl
+    self.token = token
+    self.store = store
+
+    yield
+  ensure
+    self.url   = @old_url
+    self.token = @old_token
+    self.store = @old_store
+  end
+
   def self.production?
     ENV['RACK_ENV'] == 'production' ||
       ENV['RAILS_ENV'] == 'production' ||

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/model.rb

@@ -77,7 +77,7 @@ module Magento
       end
 
       def request
-        @request ||= Request.new
+        Request.new
       end
     end
   end

data/lib/magento/order.rb

@@ -1,6 +1,109 @@
+# frozen_string_literal: true
+
 module Magento
   class Order < Model
     self.primary_key = :entity_id
     self.entity_key = :entity
+
+    def save
+      raise NotImplementedError
+    end
+
+    def update(attrs)
+      raise "'entity_id' not found" if @entity_id.nil?
+
+      attrs[:entity_id] = @entity_id
+      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
+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/record_collection.rb

@@ -23,6 +23,17 @@ module Magento
 
     alias per page_size
 
+    def last_page?
+      current_page * page_size >= total_count
+    end
+
+    #
+    # Returns the {number} of the next page or {nil} 
+    # when the current_page is the last page
+    def next_page
+      current_page + 1 unless last_page?
+    end
+
     class << self
       def from_magento_response(response, model:, iterable_field: 'items')
         Magento::RecordCollection.new(

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.5.1'
+  VERSION = '0.7.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: magento
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  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