Documentation

FedEx Labels Configuration

Enable FedEx services, map packaging, and ensure compliant label generation.

FedEx account requirements

Before connecting, ensure you have: 1) An active FedEx shipping account with account number. 2) FedEx Developer credentials (API Key and Secret Key) from developer.fedex.com. 3) Meter number assigned to your account (request from FedEx if needed). 4) Ship-from address validated with FedEx. For production shipping, your developer account must be approved for production access—sandbox credentials won't generate real labels. Contact FedEx Developer Support if you need to upgrade from sandbox.

Connect FedEx to LollipopWMS

Go to Settings > Integrations > Carriers > FedEx. Click 'Add FedEx Account.' Enter: Account Number, API Key, Secret Key, and Meter Number. Select environment: Sandbox (testing) or Production (live shipping). Enter your default ship-from address. Click 'Validate Connection' to verify credentials. If validation succeeds, click 'Save.' The integration will display available services based on your account type.

Service and packaging mapping

Configure which FedEx services are available: **Ground**: FedEx Ground, FedEx Home Delivery. **Express**: Priority Overnight, Standard Overnight, 2Day, Express Saver. **Freight**: FedEx Freight (requires separate account setup). Map LollipopWMS packaging types to FedEx packaging: 'Small Box' → FEDEX_SMALL_BOX, 'Your Packaging' → YOUR_PACKAGING. Set default service for each shipping method in order rules. Configure Saturday delivery, signature requirements, and declared value options as needed.

Label format settings

FedEx labels must meet compliance requirements. Configure: **Label format**: PDF (4x6) for desktop printing, ZPL for thermal printers. **Label stock**: Select plain paper or thermal based on printer. **Thermal format**: ZPL 300 DPI recommended for Zebra printers. **Additional documents**: Enable commercial invoice for international shipments. Set 'Include return label' if offering prepaid returns. Test label output on actual printer before go-live to verify alignment and readability.

Testing and go-live

Start in sandbox mode: Create test shipments and verify labels generate correctly. Check that tracking numbers appear (sandbox numbers won't track). Validate rate accuracy against FedEx rate calculator. Test each service type you'll use in production. When ready for production: Switch environment to Production in integration settings. Ship a real package to yourself or a test address. Verify tracking works and delivery occurs. Monitor first week of production shipments for any errors. Keep sandbox credentials for future testing.

Frequently asked questions

Why are my rates different from FedEx.com?

API rates reflect your negotiated account discounts. Published rates on FedEx.com are retail prices. Verify your account has correct rate tables assigned.

Can I void a FedEx label?

Yes. Void from the shipment detail page within 24 hours of creation. Voided shipments are not billed. After 24 hours, contact FedEx directly.

How do I enable international shipping?

International requires additional setup: customs documentation, HS codes per product, and potentially an export license. Contact support for international configuration guidance.