Test Mode Transformations allow you to simulate shipment lifecycle events and quote request status changes directly from the dashboard. This self-service capability helps you test and validate your integration.

Transformations are only available for Test Mode resources and will trigger relevant events and notifications as configured in your organization settings.

How It Works

When viewing a Test Mode shipment or quote request in the Dashboard, you’ll see a Test Mode Transformations banner and action button. This button displays the available actions based on the resource’s current status and quote type. Selecting a transformation will prompt you to confirm before executing.

After confirmation, the transformation executes and updates the resource to its new status.

The Transformations button is only visible when:

• The resource is in Test Mode
• At least one transformation is available for the current status

Shipment Transformations

Shipment transformations allow you to advance shipments through their lifecycle stages. The available transformations depend on the shipment’s current status and quote type.

Lifecycle Progression

Pending → Confirmed For Premium, Select, and Parcel shipments, confirming sets pickup and delivery date ranges and assigns carrier services. For Self-Ship shipments, confirming generates sample test labels for all packages. These labels are for testing purposes only and cannot be used for actual shipping.

Confirmed → Collected Marks the shipment as collected and narrows the delivery window to a single day. For Parcel shipments, mock tracking information is also added to all packages.

Confirmed → In Transit Moves the shipment directly to In Transit status. This is available for all quote types.

Collected → In Transit Advances a collected shipment to In Transit status.

In Transit → Completed Marks the shipment as successfully delivered.

Cancellation You can cancel a shipment from any status except Completed. Cancelled shipments receive the reason “Test mode cancellation.” This action cannot be undone.

Quote Request Transformations

Quote request transformations allow you to move requests to terminal states for testing.

Setting a Quote Request to Expired From any status, you can transition a quote request to Expired. This simulates the natural expiration that occurs after 30 days without booking.

Setting a Quote Request to Disqualified To create a quote request that is automatically disqualified, enter 9,999,999 as the object value when creating the request. The request will be set to Disqualified with the reason “Test mode.”

Viewing Transformation History

Transformations are recorded in the History tab on the shipment or quote request detail page. Each entry shows the transformation performed, when it occurred, and who triggered it.