Shipment Special Processing Properties

Overview

In certain cases, you may need special handling for a given shipment. In that case, there are several options you can specify as part of the Shipment entity, or when using the Carrier and Method Selection with Label single call.

Special processing and accessorial options

This table shows the optional special processing elements that can be included as part of the element:

PropertyProperty ContentsDescription
"deliverySignatureOption"string enumeration

Values are:
none (the default)
signature
resident_signature
adult_signature
adult_resident_signature
If you pass an optional deliverySignatureOption, its value is used to select only ship methods which support the specified delivery confirmation type.

Note: only FedEx, UPS and USPS support adult_resident_signature. It is the most restrictive signature option.

If you do not need a resident specifically, use signature, which is the most broadly supported across carriers.
"saturdayDelivery"booleanSome carrier service methods deliver on Saturday for free, whereas some charge an additional fee for Saturday delivery. If you do not want to incur extra charges for Saturday delivery, this flag should be set to false, which is the default setting. Service methods that deliver for free on Saturday will still be considered during carrier selection. However, if you are willing to incur more cost and upgrade the carrier service method to meet a Saturday delivery, you can set this flag to true. If this flag is true, only carrier service methods that can deliver on Saturday will be considered. All other service methods will be filtered out of carrier selection.

Note: Setting this flag to true does not guarantee a Saturday delivery, which is dependent upon the carrier. If you have included a desired delivery date (DDD) of Saturday, setting this flag to false does not impact the DDD for a Saturday delivery.
"transportationType"string enumeration

Values are:
any (the default)
air
ground
By passing a transportationType, you can limit the set of possible methods for this shipment.

Note: Specifying transportationType may increase the shipment cost. Use sparingly, if at all.

Customs information

For shipments which require customs information to be passed, callers must specify the additional fields below in the customsInfo object as a child of the shipmentParameters object.

PropertyProperty ContentsDescription
"customsDescription"stringA brief but detailed description of the items being shipped.
Example: "9 mm steel screws"
"totalCustomsValue"decimal valueThe total customs value of the package in totalCustomsValueCurrency units.
Example: 11.22
"totalCustomsValueCurrency"valid ISO 4217 currency codeThe currency to use for the package value in the totalCustomsValue field.
Example: "USD"
"customsItems"array of customsItem objectsA listing of customs details for each of the items contained within the package.

Customs items

This table shows the customs information:

PropertyProperty ContentsDescription
"commodityDescription"stringDescription of the product (freeform).
"countryOfManufacture"valid ISO-3166 2-digit country codeThe country of manufacture for this product.
"customsValue"decimal valueThe customs value of the product in customsValueCurrency units.

Example: 11.22
"customsValueCurrency"valid ISO 4217 currency codeThe currency to use for the product value in the customsValue field.

Example: "USD"
"customsWeight"object (see elements below)An object representing the weight of the product, containing both a weight and a weightUnit element.
"customsWeight.weight"decimal valueThe weight of the product in customsWeight.weightUnit units.

Example: 1.4
"customsWeight.weightUnit"enumeration
One of:
"g"
"kg"
"lb"
"oz"
The unit of weight for the product's weight as represented by customsWeight.weight

Example: "kg"

Customs information example

The example below shows customs data passed as part of the customsInfo:

{
  "shipmentParameters": {
    "customsInfo": {
      "totalCustomsValue": 0,
      "totalCustomsValueCurrency": "string",  //valid ISO 4217 currency code
      "customsDescription": "string",
      "customsItems": [
        {
          "commodityDescription": "string",
          "countryOfManufacture": "string",  //ISO-3166 2 digit country code
          "customsValue": 0,
          "customsValueCurrency": "string",  //valid ISO 4217 currency code
          "customsWeight": {
            "weight": 0,
            "weightUnit": "string"  //"g" | "kg" | "lb" | "oz"
          },
          "productId": "string",  //optional
          "quantity": 0
        }
      ]
    }
  }
}