Athenian FedEx Shipping Integration

Developer starting point

This baseline documents the FedEx integration architecture. It does not claim that a carrier request, rate, label, tracking update, or shipment has been exercised.

What Athenian FedEx Integration does

1. Brings live FedEx rates into WooCommerce checkout

Athenian FedEx Integration connects directly to the FedEx REST API for real-time rating during checkout. Merchants can:

• Request all available FedEx services or only selected services
• Limit shopper-visible options to approved FedEx service levels
• Choose account or list rates
• Apply flat handling fees and percentage-based rate adjustments
• Return transit-time information with rates when desired
• Control residential-versus-business rating behavior

This keeps carrier-backed pricing inside WooCommerce's native shipping-method model.

2. Converts catalog data into shipment-ready package logic

The plugin builds package payloads from WooCommerce product data, including:

• Weight
• Length, width, and height
• Quantity
• Store measurement units
• Fallback values when product data is incomplete

It supports multiple packaging strategies:

• 3D box packing with merchant-defined box definitions
• Single combined package mode
• One-package-per-item mode

This matters because shipping accuracy depends on package construction, not just cart totals.

3. Gives merchants practical control over FedEx service behavior

FedEx rates are only useful if the merchant can shape how they are presented. Athenian FedEx Integration lets stores:

• Set checkout titles for the shipping method
• Define allowed FedEx services
• Choose FedEx packaging types
• Configure pickup type defaults
• Set environment-specific credentials for staging and production
• Validate FedEx OAuth connectivity from WooCommerce settings

That gives operations and implementation teams tighter control over shipping behavior without leaving the admin.

4. Connects checkout selections to order-level shipping context

When a shopper selects a FedEx rate, the plugin captures and persists:

• FedEx service type
• Service name
• Rate type
• Transit-time details
• Delivery date details
• Currency
• Packed package metadata
• Environment context

That data is stored on the WooCommerce order and shipping item so the selected shipping path remains available after checkout.

5. Generates FedEx shipping labels directly from the order

After purchase, Athenian FedEx Integration can generate FedEx labels from WooCommerce order data. It:

• Builds shipment requests from stored or derived package information
• Uses the selected checkout service when available
• Falls back to a configured default service when needed
• Creates FedEx shipments through the FedEx shipping API
• Stores tracking numbers and tracking URLs on the order
• Persists PDF label files to disk
• Supports admin-triggered label generation from WooCommerce order actions

This reduces manual handoff between checkout and fulfillment while keeping shipment records attached to the transaction.

6. Fits Athenian shipment workflows beyond the storefront

The plugin extends beyond basic checkout rating by integrating with Athenian shipping operations. It:

• Registers FedEx as a carrier in the Athenian shipment manager layer
• Exposes callbacks for label generation and label readback
• Provides packed shipment metadata to downstream workflow hooks
• Supports label generation for vendor shipment and purchase-order flows
• Respects origin context passed from operational workflows when available

That makes it useful as both a storefront shipping method and a fulfillment service inside the Athenian ecosystem.

Ecosystem integration story

WooCommerce

Athenian FedEx Integration is implemented as a native WooCommerce shipping method. It uses shipping zones, instance settings, WooCommerce order actions, shipping-item metadata, and WooCommerce logging so merchants can manage FedEx shipping within the workflows they already use.

Athenian shipment workflows

The plugin extends beyond checkout by integrating with Athenian shipment-manager style flows and vendor or purchase-order label generation hooks. That makes it viable for merchants that need shipping execution to continue after rate selection.

Order and fulfillment continuity

Because service selection, package metadata, labels, and tracking details are persisted on the order, shipping context stays available to admins and downstream fulfillment workflows.