ClickCease

Magento 2 FedEx Dry Ice Shipping Extension User Guide - Installation & Configuration

Magento 2 FedEx Dry Ice Shipping Extension User Guide

This comprehensive guide will help you install, configure, and use the ToweringMedia FedEx Dry Ice Shipping Extension for Magento 2. This extension enables you to ship frozen and perishable goods using FedEx dry ice shipping services.

Table of Contents

Overview

The Magento 2 FedEx dry ice shipping extension provides specialized functionality for shipping frozen and perishable goods that require dry ice packaging. This extension integrates with the FedEx REST API to calculate accurate shipping rates including dry ice costs and ensure compliance with FedEx regulations.

Key Features

  • Automatic dry ice calculation - Calculates required dry ice amounts based on package requirements
  • Real-time shipping rates - Get accurate FedEx rates including dry ice costs at checkout
  • Box splitting - Automatically splits large orders into compliant packages
  • Compliance management - Ensures all shipments meet FedEx dry ice regulations
  • Temperature-sensitive product support - Designed for frozen goods and perishables

System Requirements

Magento Version

  • Magento 2.4.x (Magento 2.4.7, Magento 2.4.8, and other 2.4.x versions)
  • Compatible with both Magento Open Source and Adobe Commerce

PHP Requirements

  • PHP 8.1 or higher (PHP 8.2 recommended)

FedEx API Credentials

  • FedEx API Client ID
  • FedEx API Client Secret
  • Active FedEx API account with dry ice shipping capabilities

Installation

Step 1: Get Your License

Purchase the Magento 2 FedEx Dry Ice Shipping Extension from ToweringMedia. After purchase and invoicing, you'll receive Composer authentication credentials.

Step 2: Configure Composer Authentication

Add your credentials to auth.json in your Magento root directory.

Step 3: Install the Extension

composer require toweringmedia/fedex-dry-ice

Step 4: Enable and Configure Magento

php bin/magento module:enable Toweringmedia_FedexDryIce
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

Configuration

Navigate to Stores → Configuration → Sales → Shipping Methods → FedEx Dry Ice to configure the extension.

Basic Configuration

  • Enabled: Set to "Yes" to enable the shipping method
  • Client ID: Enter your FedEx API Client ID
  • Client Secret: Enter your FedEx API Client Secret
  • Sandbox Mode: Enable for testing

Dry Ice Settings

  • Default Dry Ice Amount: Set default dry ice amount per package if needed
  • Auto-Calculate Dry Ice: Enable automatic calculation based on package size and distance
  • Box Splitting: Enable automatic box splitting for large orders

Dry Ice Calculations

The extension automatically calculates the required amount of dry ice based on:

  • Package dimensions and volume
  • Shipping distance
  • Transit time
  • Product type and temperature requirements

These calculations ensure compliance with FedEx regulations while minimizing costs.

Testing

Test the extension with sample orders containing frozen or perishable products. Verify that:

  • Dry ice amounts are calculated correctly
  • Shipping rates include dry ice costs
  • Box splitting works for large orders
  • All shipments meet FedEx compliance requirements

Troubleshooting

Dry Ice Calculations Not Working

  • Verify FedEx API credentials are correct
  • Check that auto-calculate dry ice is enabled
  • Ensure product weight and dimensions are set correctly

Compliance Errors

  • Review FedEx dry ice regulations
  • Check that package sizes are within FedEx limits
  • Verify dry ice amounts meet minimum requirements

Frequently Asked Questions

What is dry ice shipping?

Dry ice shipping is used to keep frozen and perishable goods at the required temperature during transit. Dry ice sublimates (turns from solid to gas) and maintains very cold temperatures without creating liquid water.

What products require dry ice shipping?

Products that require dry ice shipping include frozen foods, pharmaceuticals, medical supplies, laboratory samples, and other temperature-sensitive products that must remain frozen during transit.

How does the extension calculate dry ice amounts?

The extension uses package dimensions, shipping distance, transit time, and product requirements to automatically calculate the minimum required dry ice amount to maintain proper temperature throughout shipment.

What are FedEx dry ice shipping regulations?

FedEx has specific regulations for dry ice shipping including labeling requirements, maximum package sizes, and dry ice amount limits. The extension ensures all shipments comply with these regulations automatically.

Additional Resources