\n\n## Introduction\n\nThe FedEx Fulfillment Integration allows you to seamlessly connect your Medusa store with FedEx's shipping and fulfillment services. This integration enables you to manage shipments, track packages, and streamline your order fulfillment process.\n\nWith this plugin, you can integrate your Medusa store with FedEx to:\n\n- Retrieve real-time shipping rates from FedEx during checkout.\n- Create shipments and generate shipping labels with FedEx automatically when creating order shipments.\n- Streamline your fulfillment workflow by managing FedEx shipments directly from your Medusa admin or backend.\n\nThis ensures accurate shipping costs for your customers and simplifies the process of fulfilling and tracking orders using FedEx services.\n\n## Compatibility\n\nThis module/plugin is compatible with versions >= 2.4.0 of `@medusajs/medusa`. \n\n## Getting Started\n\nTo get started with the FedEx Fulfillment Integration, follow these steps:\n\n1. **Create a FedEx Account** \n - Go to the [FedEx website](https://www.fedex.com/) and sign up for a merchant account. \n - You can use a production or a sandbox account for testing purposes.\n\n2. **Register as a Developer** \n - Visit the [FedEx Developer Portal](https://developer.fedex.com/api/en-us/home.html). \n - Log in with your FedEx account and register as a developer if you haven't already.\n\n3. **Create an Application** \n - In the Developer Portal, create a new application. \n - Choose the APIs you want to use (e.g., Shipping, Tracking, etc.).\n\n4. **Generate API Keys** \n - After creating your application, generate your API credentials: \n - **Client ID** \n - **Client Secret** \n - **Account Number** \n - For sandbox testing, use the sandbox credentials provided.\n - **Important:** Save these credentials securely. You will need to use them later in your Medusa configuration.\n\n5. **Configure the Plugin** \n - Add your FedEx API credentials to your Medusa configuration as described in the plugin documentation.\n\n6. **Test the Integration** \n - Use your sandbox credentials to test the integration before switching to production.\n\nFor more details, refer to the [FedEx API Documentation](https://developer.fedex.com/api/en-us/home.html).\n\n## Installation\nTo install the FedEx Fulfillment Integration, follow these steps:\n\n1. **Install the package**\n\n ```bash\n npm install @blegaut/medusa-v2-fedex-fulfillment\n ```\n\n2. **Add the module and plugin to your `medusa-config.ts`**\n\n ```ts\n modules: [\n {\n resolve: \"@medusajs/medusa/fulfillment\",\n options: {\n providers: [\n {\n resolve: \"@blegaut/medusa-v2-fedex-fulfillment/providers/fedex\",\n id: \"fedex\",\n options: {\n isEnabled: true, // Enable or disable integration\n clientId: \"clientId\", // FedEx Client ID\n clientSecret: \"clientSecret\", // FedEx Client Secret\n accountNumber: \"accountNumber\", // FedEx Account Number\n isSandbox: true, // Enable sandbox mode for testing\n enableLogs: true, // Enable logging\n weightUnitOfMeasure: \"LB\", // Weight unit of measure\n // Optional: multiplier after converting FedEx charge to USD (default 1.03 = 3% conversion/payment fee)\n // shippingUsdFeeMultiplier: 1.03,\n },\n },\n ],\n },\n },\n ],\n plugins: [\n {\n resolve: \"@blegaut/medusa-v2-fedex-fulfillment\", // This is used to enable custom admin widgets to see the tracking URLs and labels\n options: {},\n }\n ]\n```\n\n> **⚠️ Alternative:** \n> **Alternatively, you can set up your FedEx API credentials directly in the Medusa Admin dashboard instead of the `medusa-config.ts` file.** \n> Go to the **Settings** page in your Medusa Admin, and you will see **FedEx** listed in the menu. \n> From there, you can enter your **Client ID**, **Client Secret**, and **Account Number** securely via the UI.\n\n
\n \n
\n\n> **How credentials are used:** \n> The module will first check for credentials stored in the database (set via the Admin UI). If these exist, they will be used for all FedEx API requests. \n> If no credentials are found in the database, the module will fall back to the credentials provided in your `medusa-config.ts` file.\n\n> **⚠️ WARNING:** \n> The FedEx sandbox environment is frequently unavailable or down. If you encounter issues during testing, this is likely the cause. \n> Check your logs for error messages indicating that the FedEx service is unavailable.\n> For production use, ensure you switch to your production credentials and disable sandbox mode.\n\n## Configuration\n\n### Configuring FedEx Shipping Options\n\nAfter installing the integration, you need to configure the FedEx shipping options in your Medusa Admin dashboard.\n\n#### 1. Enable Desired Shipping Options\n\nDecide which FedEx shipping services you want to offer to your customers.\n\n#### 2. Add a Calculated Shipping Option\n\n- Go to **Locations & Shipping** in the Medusa Admin dashboard.\n- Create a new shipping option and set the type to **Calculated**. This ensures shipping costs are retrieved directly from the FedEx API.\n\n#### 3. Select FedEx as Fulfillment Provider\n\n- In the shipping option settings, set **Fulfillment Provider** to **FedEx**.\n- Under **Fulfillment Option**, select the specific FedEx service you want to make available (e.g., FedEx Ground, FedEx Express).\n\n \n\n#### Example\n\n \n\n
\n \n
\n\n \n\n> **Tip:** You can create multiple shipping options for different FedEx services to give your customers more choices at checkout.\n\n## Generating Shipping Labels & Tracking\n\nWhen you create a shipment for an order in Medusa, the integration will **automatically generate a FedEx shipping label and tracking number**.\n\n- The label cost is charged to your FedEx account.\n- Shipping labels, tracking codes, and other relevant information are available in the Medusa Admin dashboard on the order view page.\n- You can **download the label PDF** and access the **tracking URL** directly from the order details.\n\n \n\n
\n \n
\n\n \n\n## Contributing\n\nWe welcome contributions to the FedEx Fulfillment Integration! If you have suggestions, improvements, or bug fixes, please follow these steps:\n\n1. **Fork the Repository** \n Create a personal copy of the repository by forking it on GitHub.\n\n2. **Create a New Branch** \n Create a new branch for your changes:\n ```bash\n git checkout -b my-feature-branch\n ```\n\n3. **Make Your Changes** \n Implement your changes in the codebase.\n\n4. **Test Your Changes** \n Ensure that your changes work as expected and do not break existing functionality.\n\n5. **Submit a Pull Request** \n Push your changes to your forked repository and submit a pull request to the main repository.\n\n## Support / Contact\n\nIf you need help or have questions about the FedEx Fulfillment Integration, please reach out to us:\n\n- **Email:** igorlmiura@gmail.com\n- **GitHub Issues:** [Submit an issue](https://github.com/igorppbr/medusa-fedex-fulfillment/issues)\n","readmeFilename":"README.md"}
![\"FedEx](\"https://raw.githubusercontent.com/gil--/shipping_carrier_icons/refs/heads/main/svg/fedex.svg\"){kind=icon}
\n ![\"FedEx](\"https://raw.githubusercontent.com/igorppbr/medusa-fedex-fulfillment/master/images/3.png\")
\n![\"FedEx](\"https://raw.githubusercontent.com/igorppbr/medusa-fedex-fulfillment/master/images/1.png\")
\n![\"FedEx](\"https://raw.githubusercontent.com/igorppbr/medusa-fedex-fulfillment/master/images/2.png\")
\n![\"PRs](\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat\"){kind=icon}
\n ![\"Follow](\"https://img.shields.io/badge/Follow%20on%20LinkedIn-blue?logo=linkedin\"){kind=icon}
\n