me_api 2.3.0 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3942e2db2028d21e0b113511557db26e3983b8a4da443f786210d4dfe52da15b
-  data.tar.gz: 82ac71f265cad50574709106ddfe4ae2517b5c340e99f23dba14e21129b7f4a1
+  metadata.gz: eba26dc8650233f06f9e7a6fd2a7f0c39c4efad985fdef065900dba0ed1d520f
+  data.tar.gz: 2f3b45d5a3c8052d8c326fcab320e7fd92d40f87d55903e24c320e608bbecdc2
 SHA512:
-  metadata.gz: 4ee347a27811c6a1d3cc34b40d87242c0e5a6583c621581b4333901288eff7ddb50eae697f28c447bfc27c7def09ff3e2b21f0da46689c17e4e9b1b63f0696c6
-  data.tar.gz: 4deb41586578128a1fb7ed55ecda83428ed177352ac0daf82b9afc4d55e1ed7beb45bb10e6142f0931aa9a303d9ed110db2924b33dbfab8c181110385cb35186
+  metadata.gz: 83db71da4de61236728c80a9694949695dd29e98bf114aba171565e51dffb4be51b981754d2562a18fbb0cf8c51d930ca2a66d03909d63b6be33069960c3c760
+  data.tar.gz: 8ea06416c60b8759bb412adc62ff082aa40edae08832fdce9b8f40607f27bf7aa4120abcccd5061195b92603c32ba559672623de118631bc91b999256b58503d

data/lib/me_api/client_production.rb

@@ -0,0 +1,158 @@
+module MeApi
+  class ClientProduction < Ac::Base
+    BASE_URL = "https://melhorenvio.com.br"
+    SAVE_RESPONSES = true
+
+    attr_reader :refresh_token, :client_id, :client_secret, :test_mode, :token_expires_at
+    def initialize(access_token: nil, refresh_token: nil, client_id: , client_secret:, token_expires_at:, test_mode: false)
+      @access_token = access_token
+      @refresh_token = refresh_token
+      @client_id = client_id
+      @client_secret = client_secret
+      @test_mode = test_mode
+      @token_expires_at = token_expires_at
+    end
+
+    def refresh_token(client_id:, client_secret:, refresh_token:)
+      body = {
+        grant_type: "refresh_token",
+        client_id: client_id,
+        client_secret: client_secret,
+        refresh_token: refresh_token
+      }
+      post("/oauth/token", body:, skip_authentication: true)
+    end
+
+    def authorize client_id:, client_secret:, code:, redirect_url:
+      body = {
+        grant_type: "authorization_code",
+        client_id: client_id,
+        client_secret: client_secret,
+        code: code,
+        redirect_uri: redirect_url
+      }
+      post("/oauth/token", body:, skip_authentication: true)
+    end
+
+    def default_options
+      {
+        headers: {
+          "Accept" => "application/json",
+          "Content-Type" => "application/json"
+        }
+      }
+    end
+
+    # @param volume [Object<MeApi::Volume>] Volume object containing width_cm, height_cm, length_cm, and weight_kg
+    def rates(from_postal_code:, to_postal_code:, volume:, contents_value_brl:)
+      body = {
+        from: {
+          postal_code: from_postal_code
+        },
+        to: {
+          postal_code: to_postal_code
+        },
+        package: volume.to_api_format,
+        options: {
+          insurance_value: contents_value_brl,
+          receipt: false,
+          own_hand: false
+        },
+        services: "1,2,3,4,17,33"
+      }
+      post("api/v2/me/shipment/calculate", body:) { _1.first.name }
+    end
+
+    # @param products [Array<MeApi::Product>] Array of product objects containing name, quantity, and unitary_value
+    # @param volumes [Array<MeApi::Volume>] Array of volume objects containing width_cm, height_cm, length_cm, and weight_kg
+    def add_label_to_cart(service_id:, from_name:, from_phone:, from_email:, from_address:, from_address_complement:, from_address_number:, from_address_district:, from_address_city:, from_postal_code:, from_address_state_abbr:, from_tax_id:, to_name:, to_phone:, to_email:, to_address:, to_address_complement:, to_address_number:, to_address_district:, to_address_city:, to_postal_code:, to_address_state_abbr:, to_tax_id:, products:, volumes:, insurance_value:)
+
+      from_tax_id_clean = cleaned_tax_id(from_tax_id)
+      to_tax_id_clean = cleaned_tax_id(to_tax_id)
+      
+      body = {
+        service: service_id,
+        from: {
+            name: from_name,
+            phone: from_phone,
+            email: from_email,
+            address: from_address,
+            complement: from_address_complement,
+            number: from_address_number,
+            district: from_address_district,
+            city: from_address_city,
+            postal_code: from_postal_code,
+            state_abbr: from_address_state_abbr
+          },
+
+        to: {
+          name: to_name,
+          phone: to_phone,
+          email: to_email,
+          address: to_address,
+          complement: to_address_complement,
+          number: to_address_number,
+          district: to_address_district,
+          city: to_address_city,
+          postal_code: to_postal_code,
+          state_abbr: to_address_state_abbr
+        },
+        products: products.map do |product|
+          product.to_api_format
+        end,
+        volumes: volumes.map do |volume|
+          volume.to_api_format
+        end,
+        options: {
+          insurance_value: insurance_value,
+        }
+      }
+
+      add_tax_document_to_address(body[:from], from_tax_id_clean)
+      add_tax_document_to_address(body[:to], to_tax_id_clean)
+
+      post("/api/v2/me/cart", body:)
+    end
+
+    def pay_label(order_id)
+      body = {
+        orders: [order_id.to_s]
+      }
+      post("/api/v2/me/shipment/checkout", body:)
+    end
+
+    def generate_label(order_id)
+      body = {
+        orders: [order_id.to_s]
+      }
+      post("/api/v2/me/shipment/generate", body:)
+    end
+
+    def print_label(order_id)
+      get("/api/v2/me/imprimir/pdf/#{order_id}") { _1[0].include? order_id }
+    end
+
+    def get_label(order_id)
+      get("/api/v2/me/orders/#{order_id}")
+    end
+
+    def get_account_data
+      get("/api/v2/me")
+    end
+
+    def get_balance
+      get("/api/v2/me/balance")
+    end
+
+    private
+    
+    def cleaned_tax_id(tax_id)
+      tax_id.gsub(/\D/, "")
+    end
+
+    def add_tax_document_to_address(address_hash, tax_id)
+      document_key = tax_id.length == 11 ? :document : :company_document
+      address_hash[document_key] = tax_id
+    end
+  end
+end

data/lib/me_api/client_sandbox.rb

@@ -0,0 +1,5 @@
+module MeApi
+  class ClientSandbox < ClientProduction
+    BASE_URL = "https://sandbox.melhorenvio.com.br"
+  end
+end

data/lib/me_api/product.rb

@@ -0,0 +1,19 @@
+module MeApi
+  class Product
+    attr_accessor :name, :quantity, :unitary_value
+
+    def initialize(name:, quantity:, unitary_value:)
+      @name = name
+      @quantity = quantity
+      @unitary_value = unitary_value
+    end
+
+    def to_api_format
+      {
+        name: name,
+        quantity: quantity,
+        unitary_value: unitary_value
+      }
+    end
+  end
+end

data/lib/me_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MeApi
-  VERSION = "2.3.0"
+  VERSION = "2.4.0"
 end

data/lib/me_api/volume.rb

@@ -0,0 +1,21 @@
+module MeApi
+  class Volume
+    attr_accessor :width_cm, :height_cm, :length_cm, :weight_kg
+
+    def initialize(width_cm:, height_cm:, length_cm:, weight_kg:)
+      @width_cm = width_cm
+      @height_cm = height_cm
+      @length_cm = length_cm
+      @weight_kg = weight_kg
+    end
+
+    def to_api_format
+      {
+        width: width_cm,
+        height: height_cm,
+        length: length_cm,
+        weight: weight_kg
+      }
+    end
+  end
+end

data/lib/me_api.rb

@@ -2,9 +2,21 @@
 
 require "ac"
 require_relative "me_api/version"
-require_relative "me_api/client"
+require_relative "me_api/client_production"
+require_relative "me_api/client_sandbox"
+require_relative "me_api/product"
+require_relative "me_api/volume"
 
 module MeApi
   class Error < StandardError; end
-  # Your code goes here...
+
+  class Client 
+    def self.new **args
+      if args[:test_mode]
+        ClientSandbox.new(**args)
+      else
+        ClientProduction.new(**args)
+      end      
+    end
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: me_api
 version: !ruby/object:Gem::Version
-  version: 2.3.0
+  version: 2.4.0
 platform: ruby
 authors:
 - Todas Essas Coisas
 bindir: exe
 cert_chain: []
-date: 2025-07-31 00:00:00.000000000 Z
+date: 2025-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ac
@@ -36,8 +36,11 @@ files:
 - README.md
 - Rakefile
 - lib/me_api.rb
-- lib/me_api/client.rb
+- lib/me_api/client_production.rb
+- lib/me_api/client_sandbox.rb
+- lib/me_api/product.rb
 - lib/me_api/version.rb
+- lib/me_api/volume.rb
 homepage: https://github.com/todasessascoisas/me_api
 licenses:
 - MIT

data/lib/me_api/client.rb

@@ -1,117 +0,0 @@
-module MeApi
-  class Client < Ac::Base
-    BASE_URL = "https://melhorenvio.com.br"
-    SAVE_RESPONSES = true
-    Rate = Data.define(:id, :from, :to, :price, :min_delivery_time, :max_delivery_time, :service_name, :carrier_name, :carrier_logo_url)
-
-    def rates(from:, to:, weight_kg:, contents_value_brl:, height_cm:, width_cm:, length_cm:)
-      body = {
-        "from" => {
-          "postal_code" => from
-        },
-        "to" => {
-          "postal_code" => to
-        },
-        "package" => {
-          "weight" => weight_kg,
-          "height" => height_cm,
-          "width" => width_cm,
-          "length" => length_cm
-        },
-        "options" => {
-          "insurance_value" => contents_value_brl,
-          "receipt" => false,
-          "own_hand" => false
-        },
-        "services" => "1,2,3,4,17,33"
-      }
-      response = post("api/v2/me/shipment/calculate", body:) { _1.first.name }
-      response.map do |rate|
-        next unless rate["error"].blank? && rate["price"]
-        Rate.new(
-          id: rate.id,
-          from: from,
-          to: to,
-          price: rate.price.to_f,
-          min_delivery_time: rate.delivery_range.min,
-          max_delivery_time: rate.delivery_range.max,
-          service_name: rate.name,
-          carrier_name: rate.company.name,
-          carrier_logo_url: rate.company.picture
-        )
-      end.compact
-    end
-
-    def refresh_token(client_id:, client_secret:, refresh_token:)
-      body = {
-        grant_type: "refresh_token",
-        client_id: client_id,
-        client_secret: client_secret,
-        refresh_token: refresh_token
-      }
-      post("/oauth/token", body:)
-    end
-
-    def authorize client_id:, client_secret:, code:, redirect_url:
-      body = {
-        grant_type: "authorization_code",
-        client_id: client_id,
-        client_secret: client_secret,
-        code: code,
-        redirect_uri: redirect_url
-      }
-      post("/oauth/token", body:, skip_authentication: true)
-    end
-
-    def default_options
-      {
-        headers: {
-          "Accept" => "application/json",
-          "Content-Type" => "application/json"
-        }
-      }
-    end
-
-    def insert_package_into_cart(service_id:, from:, to:, products:, volumes:, options:)
-      body = {
-        service: service_id,
-        from: from,
-        to: to,
-        products: products,
-        volumes: volumes,
-        options: options
-      }
-      post("/api/v2/me/cart", body:)
-    end
-
-    def payment_ticket(order_id)
-      body = {
-        orders: [order_id.to_s]
-      }
-      post("/api/v2/me/shipment/checkout", body:)
-    end
-
-    def generate_ticket(order_id)
-      body = {
-        orders: [order_id.to_s]
-      }
-      post("/api/v2/me/shipment/generate", body:)
-    end
-
-    def print_ticket(order_id)
-      get("/api/v2/me/imprimir/pdf/#{order_id}") { _1[0].include? order_id }
-    end
-
-    def get_ticket(order_id)
-      get("/api/v2/me/orders/#{order_id}")
-    end
-
-    def get_account_data
-      get("/api/v2/me")
-    end
-
-    def get_balance
-      get("/api/v2/me/balance")
-    end
-  end
-end