Solidus Melhor Envio

Gem utilizada para integrar o MelhorEnvio (cotação de frete) no Solidus.

Installation

Add solidus_melhor_envio to your Gemfile:

gem "solidus_melhor_envio"

Bundle your dependencies and run the installation generator:

bin/rails generate solidus_melhor_envio:install

Usage

Adicionar no aquivo /config/initializers/spree.rb a linha abaixo, para configurar como padrão o MelhorEnvio:

Spree.config do |config|

# +++
  config.stock.estimator_class = "SolidusMelhorEnvio::ShippingEstimator"
end

No arquivo /config/initializers/solidus_melhor_envio.rb definir as variáveis app_name (nome do aplicativo cadastrado no MelhorEnvio), postal_code_from (Código Postal de origem) e services (id dos serviços de frete desejados que retorne na requisição)

SolidusMelhorEnvio.configure do |config|

  config.app_name = "" # ex. 'app_name'
  config.postal_code_from = "" # ex.: '01555-000'
  config.services = "" # ex.: '1,2,3,4' - valores separados por vírgula
end

Após, criar a SolidusMelhorEnvio::Account, onde ficarão registrados os dados necessários para as requisições à API do MelhorEnvio. Exemplo:

SolidusMelhorEnvio::Account.create!({
  app_name: "app_name",
  api_base_url: "https://www.melhorenvio.com.br",
  client_id: "12345",
  client_secret: "123456",
  refresh_token: "1234",
  user_agent: "[email protected]"
})

Development

Testing the extension

First bundle your dependencies, then run bin/rake. bin/rake will default to building the dummy app if it does not exist, then it will run specs. The dummy app can be regenerated by using bin/rake extension:test_app.

bin/rake

To run Rubocop static code analysis run

bundle exec rubocop

When testing your application's integration with this extension you may use its factories. You can load Solidus core factories along with this extension's factories using this statement:

SolidusDevSupport::TestingSupport::Factories.load_for(SolidusMelhorEnvio::Engine)

Running the sandbox

To run this extension in a sandboxed Solidus application, you can run bin/sandbox. The path for the sandbox app is ./sandbox and bin/rails will forward any Rails commands to sandbox/bin/rails.

Here's an example:

$ bin/rails server
=> Booting Puma
=> Rails 6.0.2.1 application starting in development
* Listening on tcp://127.0.0.1:3000
Use Ctrl-C to stop

Releasing new versions

Please refer to the dedicated page in the Solidus wiki.