FedEx has convenient shipment returns process which empower users to return shipments in a hassle-free way. The Returns API enables you to easily process and submit return requests by generating return shipping labels. It also enables you to track the return status and cancel the return requests which are not tendered. In addition to this, it also provides an option of printer-less return experience via QR code.

This service is applicable for Parcel returns, Package-less returns via participating FedEx retail locations.

The Returns API enables you to use either the returns label which provides information required for returning the shipment to the respective retailer or generate QR code, which can be presented at one of the FedEx drop-off locations and return the shipment instantaneously without printing a label.

The following are the key features associated with the Return API Details:

Generating a return record along with a return shipping labels for the supported return services which means convenience of obtaining proper documentation for returns process at any location.

Easily manage your return program by configuring returns business rules, monitor the status of your returns, dynamically route return products or cancel return requests based on your desired business rules.

Provide QR codes to your customers for a printer-less returns experience by passing the copy of the label to the FedEx Returns Technology. Add the convenience of package-less returns for eligible returns at participating FedEx retail locations. This means you can swiftly and efficiently cycle returned products back into inventory for faster re-deployment into the market—generating revenue and reducing the effects of product depreciation.

Note: You must have an active profile in the FedEx Returns Technology portal to use the FedEx Returns API. Refer to returns.fedex.com or contact your FedEx account executive or customer technology executive for more details.

The FedEx Returns API uses the below endpoints to create Return Merchandise Authorization, and generate labels. The following section describes the key inputs and responses for the endpoint:

Return Merchandize Authorization

This endpoint provides an option to create new RMAs and provides the complete item level details required for returning a shipment. It creates a return record based on the configuration settings in the FedEx Returns Technology portal. After the record is created, you can access the portal to view the status of the returns

Note: This endpoint also comprises a flag to depict whether a label is required to return shipment or not. It also enables the retailer to specify if they want a packing slip along with the label.

The key input information associated with this request are as follows:

• rmaNumber details
• customer details
• orders details
• trackingNumber
• shippingService
• declaredValue
• createItemIfNotExists
• labelRequired

The successful result of this request creates the RMA with details such as rmaId, rmaNumber, status, shipments, rmaEnrolledInPolyMailer, affiliatedMerchant along with transactionID, and customerTransactionId.

Label

This endpoint enables you to retrieve FedEx labels for the respective label ID generated during RMA creation.

The key input information associated with this request are as follows:

• labelId

The successful result of this request retrieves FedEx labels details such as labelContent, trackingNumber of the label, labelURL along with transactionID, and customerTransactionId.

• Packages containing hazardous materials are not eligible for same day return options, except for packages shipped by preapproved shippers using the FedEx Ground Package Returns Program.
• A $1000 limit of liability is applicable for declared value, for FedEx Express^® and FedEx Ground return labels and declared value is not applicable for FedEx Ground ^®Economy shipments.
• Shipments containing dangerous goods are not eligible for FedEx return options, except dry ice, which may be shipped using the FedEx Print Return Label and the FedEx Email Return Label.
• The minimum package size for FedEx Ground^® Economy Returns must be 6" L x 4" W x 1/2" H. The maximum package size cannot exceed 27" L x 17" W x 17" H. Maximum package weight of 70 lbs.
• The maximum number of packages for a single returns with FedEx Returns technology is 30 for FedEx Ground, FedEx Express and FedEx Ground ^® Economy.
• Delivery Confirmation and Ancillary Endorsements services are not applicable for same day shipments.