Melhor Envio Fulfillment for MedusaJS

Add integrated shipping calculation in your MedusaJS project with most product carriers in Latin America, such as: Correios (Sedex, PAC, etc.), Buslog, JeT Express, JadLog, Loggi, Azul Cargo among others.

Prerequisites

• Medusa backend
• Melhor Envio account

Contribute with:

• ⭐ Starred this repository
• Follow me in github
• Report Inssues

How to Install

1. Run the following command in the directory of the Medusa backend:

#Using npm
npm install @marcosgn/medusa-fulfillment-melhor-envio

#Using yarn
yarn add @marcosgn/medusa-fulfillment-melhor-envio

2. Set the following environment variables in .env:

MELHOR_ENVIO_API_TOKEN=<your-token>
MELHOR_ENVIO_POSTAL_CODE=<from-postal-code>

Get your token from the Melhor Envio dashboard: https://melhorenvio.com.br.

Set origin zip code in the variable MELHOR_ENVIO_POSTAL_CODE with only numbers. This is used for shipping calculation.

3. In medusa-config.js add the following at the end of the plugins array:

const plugins = [
  // ...
  {
    resolve: `@marcosgn/medusa-fulfillment-melhor-envio`,
    options: {
      apiToken: process.env.MELHOR_ENVIO_API_TOKEN,
      postalCode: process.env.MELHOR_ENVIO_POSTAL_CODE,
      sandbox: process.env.ENVIRONMENT, // Set true or "development" to use the sandbox environment
    },
  },
];

Test the Plugin

1. Run the following command in the directory of the Medusa backend to run the backend:

#Using npm
npm run dev

#Using
yarn dev

2. Add Shipping Methods in a region in the admin panel. You can refer to this User Guide and this (Manage Shipping) to learn how to do that. Alternatively, you can use the Admin APIs.

3. Get a shipping methods from Cart ID in a storefront or the Store APIs.

Storefront Usage

Nuxt Exaple using MedusaJS client

const client = useMedusaClient(); //with NuxtJS Example...

const shippingOptions = await client.shippingOptions.listCartOptions(
  "cart_EXAMPLE_CART_ID"
);

Support and Contribution

If you encounter any issues or have suggestions for improvements, feel free to open an issue on the GitHub repository.

If you want to contribute, please open a pull request in the repository.