Shipment Ship Option Overview

Overview

You may optionally specify a shipOption parameter when constructing a shipment, either using the standard Shipment construction or using the more popular Carrier and Method Selection with Label Single Call mechanism.

Doing this gives you the ability to specify the kind of shipment performance that you want. Shipium's software will select the appropriate carrier and method based on this shipment performance criterion.

Specifying Ship Option

To specify ShipOption, include a value for it in the shipOption field that is part of the top-level Shipment object. You can do this either during Shipment creation or in shipmentParameters when using the all-in-one shipment and label method.

🚧

Warning

This does not guarantee that some specific method is selected, but rather that an appropriate method is selected to meet the requirements specified.

The following example works for either use case, specifying that the shipment should use a "TwoDay" ship option:

{ ...
    ...
    "shipOption": "TwoDay",
    ...
    ...
    ...
}

Ship Option values

This table shows shipOption values that can be specified in the API:

What happens if an option is not available?

If a particular shipOption value is not possible, a 4XX error from either label creation or the all-in-one shipment and label method will give details about the problem.