Create Return Shipment Booking

Overview

The Create Return Shipment Booking step creates a return shipping booking with the carrier. This generates a return label that can be included with the shipment or sent to the customer.

Identifier

Configuration Properties

This step has no configurable properties. Return product is configured on the shipping option.

Behavior

What It Does

1. Identifies the shipment to create return booking for:
   • Uses current shipment if at shipment level
   • Uses last shipped shipment if at order level
2. Looks up shipping option for the shipment's method
3. Validates ShipmentReturnProduct is configured on the option
4. Creates a return shipment booking with the shipping provider
5. Returns return label link in result

Prerequisites

• Shipment must exist (shipped for order level)
• Shipping option must have ShipmentReturnProduct configured
• Shipping provider must support return bookings

Side Effects

• Return booking created with carrier
• Return label generated
• Return tracking number assigned

Business Cases

When to Use

• Proactive returns: Include return label in package
• Easy returns: Generate return label when order ships
• Return policy: Automatically provide return shipping

Example Scenarios

Scenario 1: Standard Return Label Order ships. Step creates return booking, returns PDF label link.

Scenario 2: No Return Product Shipping option doesn't have return product configured. Step returns warning.

Scenario 3: No Shipped Shipments No shipments in shipped status at order level. Step returns warning.

Error Handling

Related Steps

• Complete Shipment - Ships the order first
• Print Shipping Label - Print the return label