market_hub 0.1.0 → 0.23.5

data/lib/market_hub/api/mercado_livre/order.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module MarketHub
+  module API
+    module MercadoLivre
+      # Classe API de Pedidos
+      class Order
+
+        attr_accessor :access_token
+        attr_accessor :user_id
+
+        def initialize(access_token, user_id)
+          @access_token = access_token
+          @user_id = user_id
+        end
+
+        # Principais status existentes: paid, cancelled e invalid
+        def all(status: 'paid', options: {})
+          host = MarketHub.configure.meli_api_uri
+          path = "/orders/search"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          params = { seller: @user_id }.merge(options)
+          params.merge!({ "order.status" => status }) if status
+          endpoint.query = URI.encode_www_form(params)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        # Principais status existentes: paid, cancelled e invalid
+        def recent(status: 'paid', options: {})
+          host = MarketHub.configure.meli_api_uri
+          path = "/orders/search/recent"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          params = { seller: @user_id }.merge(options)
+          params.merge!({ "order.status" => status }) if status
+          endpoint.query = URI.encode_www_form(params)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def find(order_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/orders/#{order_id}"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def notes(order_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/orders/#{order_id}/notes"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def billing_info(order_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/orders/#{order_id}/billing_info"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+      end
+    end
+  end
+end

data/lib/market_hub/api/mercado_livre/publication_type.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module MarketHub
+  module API
+    module MercadoLivre
+      # Classe API de Tipos de Publicação
+      class PublicationType
+
+        attr_accessor :access_token
+
+        def initialize(access_token)
+          @access_token = access_token
+        end
+
+        def listing_types(site_id, listing_type_id = nil)
+          host = MarketHub.configure.meli_api_uri
+          path = "/sites/#{site_id}/listing_types/"
+          path = path + listing_type_id.to_s unless listing_type_id.nil?
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint)
+          JSON.parse(response.body)
+        end
+
+        def listing_exposures(site_id,listing_exposure_id = nil)
+          host = MarketHub.configure.meli_api_uri
+          path = "/sites/#{site_id}/listing_exposures/"
+          path = path + listing_exposure_id.to_s unless listing_exposure_id.nil?
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint)
+          JSON.parse(response.body)
+        end
+
+        def listing_types_availables(reference_id, category_id = nil)
+          host = MarketHub.configure.meli_api_uri
+          params = {}
+          if category_id.nil?
+            path = "/items/#{reference_id}/available_listing_types"
+          else
+            path = "/users/#{reference_id}/available_listing_types"
+            params = params.merge({ category_id: category_id })
+          end
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          endpoint.query = URI.encode_www_form(params)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def listing_types_downgrades(item_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/items/#{item_id}/available_upgrades"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def listing_types_upgrades(item_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/items/#{item_id}/available_downgrades"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def update(item_id, listing_type_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/items/#{item_id}/listing_type"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.post(endpoint, headers: { authorization: "Bearer #{@access_token}" }, body: { id: listing_type_id })
+          JSON.parse(response.body)
+        end
+
+      end
+    end
+  end
+end

data/lib/market_hub/api/mercado_livre/question_answer.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module MarketHub
+  module API
+    module MercadoLivre
+      # Classe API de Perguntas e Respostas
+      class QuestionAnswer
+
+        attr_accessor :access_token
+        attr_accessor :user_id
+  
+        def initialize(access_token, user_id)
+          @access_token = access_token
+          @user_id = user_id
+        end
+
+        def metrics
+          host = MarketHub.configure.meli_api_uri
+          path = "/users/#{@user_id}/questions/response_time"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def all(options = {})
+          host = MarketHub.configure.meli_api_uri
+          path = "/questions/search"
+          params = { seller_id: @user_id, api_version: 4 }.merge(options)
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          endpoint.query = URI.encode_www_form(params)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def find(question_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/questions/#{question_id}"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          endpoint.query = URI.encode_www_form({ api_version: 4 })
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def anwser(question_id, text)
+          host = MarketHub.configure.meli_api_uri
+          path = "/answers"
+          body = { question_id: question_id, text: text }
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.post(endpoint, headers: { authorization: "Bearer #{@access_token}" }, body: body)
+          JSON.parse(response.body)
+        end
+
+        def destroy(question_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/questions/#{question_id}"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.delete(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+      end
+    end
+  end
+end

data/lib/market_hub/api/mercado_livre/shipment.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module MarketHub
+  module API
+    module MercadoLivre
+      # Classe API de Transporte
+      class Shipment
+
+        attr_accessor :access_token
+        attr_reader :types
+
+        def initialize(access_token)
+          @access_token = access_token
+          @types = %w(items costs payments lead_time delays history carrier billing_info)
+        end
+
+        def find(shipment_id, type = nil)
+          host = MarketHub.configure.meli_api_uri
+          path = "/shipments/#{shipment_id}/"
+          path = path + type.to_s unless type.nil?
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def labels(shipment_ids, response_type = 'pdf')
+          shipment_ids = shipment_ids.join(',') if shipment_ids.is_a?(Array)
+          host = MarketHub.configure.meli_api_uri
+          path = "/shipment_labels"
+          params = { shipment_ids: shipment_ids, response_type: response_type }
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          endpoint.query = URI.encode_www_form(params)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          try_to_convert_to_json(response.body)
+        end
+
+        private
+
+          def try_to_convert_to_json(body)
+            JSON.parse(body)
+          rescue
+            body
+          end
+
+      end
+    end
+  end
+end

data/lib/market_hub/api/mercado_livre/user.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module MarketHub
+  module API
+    module MercadoLivre
+      # Classe API do Usuário
+      class User
+
+        attr_accessor :access_token
+  
+        def initialize(access_token)
+          @access_token = access_token
+        end
+
+        def me
+          host = MarketHub.configure.meli_api_uri
+          path = "/users/me"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def currency
+          host = MarketHub.configure.meli_api_uri
+          path = "/classified_locations/countries/#{me['country_id']}"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+      end
+    end
+  end
+end

data/lib/market_hub/api/mercado_livre/variation.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module MarketHub
+  module API
+    module MercadoLivre
+      # Classe API de Variação
+      class Variation
+
+        attr_accessor :access_token
+  
+        def initialize(access_token)
+          @access_token = access_token
+        end
+
+        def all(item_id, params = {})
+          host = MarketHub.configure.meli_api_uri
+          path = "/items/#{item_id}/variations/"
+          if params[:variation_id]
+            path = path + params[:variation_id]
+            params.delete(:variation_id)
+          end
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          endpoint.query = URI.encode_www_form(params)
+          response = MarketHub::HTTP.get(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+        def find(item_id, variation_id)
+          all(item_id, { variation_id: variation_id })
+        end
+
+        def create(item_id, body)
+          host = MarketHub.configure.meli_api_uri
+          path = "/items/#{item_id}/variations"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.post(endpoint, headers: { authorization: "Bearer #{@access_token}" }, body: body)
+          JSON.parse(response.body)
+        end
+
+        def update(item_id, variation_id, body)
+          host = MarketHub.configure.meli_api_uri
+          path = "/items/#{item_id}/variations/#{variation_id}"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.put(endpoint, headers: { authorization: "Bearer #{@access_token}" }, body: body)
+          JSON.parse(response.body)
+        end
+
+        def destroy(item_id, variation_id)
+          host = MarketHub.configure.meli_api_uri
+          path = "/items/#{item_id}/variations/#{variation_id}"
+          endpoint = URI::HTTPS.build(host: host, path: path)
+          response = MarketHub::HTTP.delete(endpoint, headers: { authorization: "Bearer #{@access_token}" })
+          JSON.parse(response.body)
+        end
+
+      end
+    end
+  end
+end

data/lib/market_hub/base.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module MarketHub
+  # Classe genérica para todas outras classes base da biblioteca
+  class Base
+
+    def initialize
+    end
+
+  end
+end

data/lib/market_hub/client.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module MarketHub
+  # Principal classe que manipula todas integrações
+  class Client < MarketHub::API::Base
+
+    def initialize
+    end
+
+  end
+end

data/lib/market_hub/configuration.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module MarketHub
+  # Classe base para parametrização da biblioteca
+  class Configuration
+
+    attr_accessor :currency_id
+
+    attr_accessor :meli_client_id
+    attr_accessor :meli_client_secret
+    attr_accessor :meli_redirect_uri
+    attr_accessor :meli_auth_uri
+    attr_accessor :meli_api_uri
+
+    def initialize
+      @meli_client_id = nil
+      @meli_client_secret = nil
+      @meli_redirect_uri = nil
+      @meli_auth_uri = 'auth.mercadolivre.com.br'
+      @meli_api_uri = 'api.mercadolibre.com'
+      @currency_id = 'BRL'
+    end
+
+    def self.default
+      @default ||= Configuration.new
+    end
+
+  end
+end

data/lib/market_hub/exception.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module MarketHub
+
+  class Error < StandardError
+  end
+
+  class NotImplemented < RuntimeError
+  end
+
+end

data/lib/market_hub/models/base.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module MarketHub
+  module Models
+    # Classe base para todos os modelos (Models)
+    class Base < MarketHub::Base
+
+      include MarketHub::Utils::Validation
+
+      attr_reader :id
+      attr_reader :client
+      attr_reader :body
+
+      def initialize(client, body = {}, options = {})
+        @client = client
+        @body = body
+        @options = options
+      end
+
+      def save
+        raise MarketHub::NotImplemented, 'Sobreescreva este método na classe referente ao marketplace que você esta criando'
+      end
+
+      def destroy
+        raise MarketHub::NotImplemented, 'Sobreescreva este método na classe referente ao marketplace que você esta criando'
+      end
+
+      def active!
+        raise MarketHub::NotImplemented, 'Sobreescreva este método na classe referente ao marketplace que você esta criando'
+      end
+
+      def paused!
+        raise MarketHub::NotImplemented, 'Sobreescreva este método na classe referente ao marketplace que você esta criando'
+      end
+
+      def new?
+        @id.to_s == "" ? true : false
+      end
+
+      def update?
+        !new?
+      end
+
+      def self.find(client, id)
+        if client.connected?
+          self.new(client, client.find(id), { action: 'find' })
+        end
+      end
+
+      def self.create(client, body)
+        if client.connected?
+          object = self.new(client, body, { action: 'create' })
+          object.save
+          object
+        end
+      end
+
+    end
+  end
+end

data/lib/market_hub/models/mercado_livre/item.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+module MarketHub
+  module Models
+    module MercadoLivre
+      # Classe que representa um Item no Mercado Livre
+      class Item < MarketHub::Models::Base
+
+        attr_accessor :item_id, :title, :description, :category_id, :price, :available_quantity, :sale_terms, :listing_type_id, :condition, :pictures,
+                      :video_id, :local_pick_up, :free_shipping, :attributes, :status, :catalog_product_id, :channel_markeplace, :channel_mshops
+
+        validates_presence_of :title, :category_id, :price, :available_quantity, :listing_type_id, :attributes, message: 'não pode estar em branco.'
+
+        def initialize(client, body = {}, options = {})
+          super(client, body, options)
+          unless body.empty?
+            @id = body.dig(:item_id) || body.dig('id')
+            @item_id = body.dig(:item_id) || body.dig('id')
+            @title = body.dig(:title) || body.dig('title')
+            @description = body.dig(:description) || (client.description.find(@item_id).dig('plain_text') if options[:action] == 'find' && @item_id)
+            @category_id = body.dig(:category_id) || body.dig('category_id')
+            @price = (body.dig(:price) || body.dig('price')).to_f
+            @available_quantity = body.dig(:available_quantity) || body.dig('available_quantity')
+            @sale_terms = body.dig(:sale_terms) || body.dig('sale_terms')
+            @listing_type_id = body.dig(:listing_type_id) || body.dig('listing_type_id')
+            @condition = body.dig(:condition) || body.dig('condition')
+            @pictures = body.dig(:pictures) || body.dig('pictures')
+            @video_id = body.dig(:video_id) || body.dig('video_id')
+            @local_pick_up = body.dig(:local_pick_up) || body.dig('shipping', 'local_pick_up')
+            @free_shipping = body.dig(:free_shipping) || body.dig('shipping', 'free_shipping')
+            @attributes = body.dig(:attributes) || body.dig('attributes')
+            @status = body.dig(:status) || body.dig('status')
+            @catalog_product_id = body.dig(:catalog_product_id) || body.dig('catalog_product_id')
+            @channel_markeplace = (body.dig('channels') ? body.dig('channels').include?("marketplace") : body.dig(:channel_markeplace))
+            @channel_mshops = (body.dig('channels') ? body.dig('channels').include?("mshops") : body.dig(:channel_mshops))
+          end
+        end
+
+        def item_id=(value)
+          @id = value
+          @item_id = value
+        end
+
+        def save
+          if client.connected?
+            if valid?
+              @was_new = new?
+              @was_update = update?
+
+              if new?
+                json = client.item.create(new_layout)
+              else
+                json = client.item.update(@item_id, update_layout)
+              end
+
+              if json['id']
+                @id = json['id']
+                @item_id = json['id']
+                if !@description.to_s.empty? && (@was_new || client.description.find(@item_id).empty?)
+                  client.description.create(@item_id, @description)
+                else
+                  client.description.update(@item_id, @description)
+                end
+              elsif json['error']
+                errors.add(:item, (json['cause'].to_a.empty? ? json['message'] : json['cause'].to_a.map { |e| e['message'] }.join('. ')))
+              else
+                errors.add(:item, "Ocorreu um erro ao enviar o item para o marketplace.")
+              end
+            end
+          else
+            errors.add(:client, "não conectado.")
+          end
+
+          errors.size.zero?
+        end
+
+        def destroy
+          if client.connected? && update?
+            client.item.destroy(@item_id)
+          end
+        end
+
+        def active!
+          @status = 'active'
+          save
+        end
+
+        def paused!
+          @status = 'paused'
+          save
+        end
+
+        private
+
+          def new_layout
+            layout = {}
+            layout[:title] = @title
+            layout[:category_id] = @category_id
+            layout[:price] = @price
+            layout[:currency_id] = Configuration.default.currency_id
+            layout[:available_quantity] = @available_quantity
+            layout[:sale_terms] = @sale_terms
+            layout[:buying_mode] = "buy_it_now"
+            layout[:listing_type_id] = @listing_type_id
+            layout[:condition] = @condition
+            layout[:pictures] = @pictures
+            layout[:video_id] = @video_id
+            layout[:shipping] = { local_pick_up: @local_pick_up, free_shipping: @free_shipping }
+            layout[:attributes] = @attributes
+            layout[:status] = @status
+            layout[:catalog_product_id] = @catalog_product_id
+            layout[:catalog_listing] = !(@catalog_product_id.to_s == "")
+            layout[:channels] = []
+            layout[:channels].push("marketplace") if @channel_markeplace
+            layout[:channels].push("mshops") if @channel_mshops
+            layout
+          end
+
+          def update_layout
+            @has_bids = (client.item.find(@item_id).dig('sold_quantity').to_i > 0) unless @has_bids
+
+            layout = new_layout
+            if @has_bids
+              layout.delete(:title)
+              layout.delete(:category_id)
+              layout.delete(:condition)
+            end
+            layout.delete(:currency_id)
+            layout.delete(:buying_mode)
+            layout.delete(:listing_type_id)
+            layout.delete(:catalog_product_id)
+            layout.delete(:catalog_listing)
+            layout
+          end
+
+      end
+    end
+  end
+end