SHshipium
carrier-selection

Cancel an existing carrier selection.

Changed on
delete/api/v1/deliveryexperience/shipment/{shipmentId}/carrierSelection/{carrierSelectionId}

Request

Path parameters

shipmentIdstring required

The shipiumShipmentId or partnerShipmentId.

carrierSelectionIdstring required

The Shipium carrierSelectionId.

Query parameters

cancellationDateTimestring date-time

The date that this carrier selection was cancelled. Defaults to now.

Response

CarrierSelection successfully cancelled.

carrierSelectionIdstring

Unique id of the carrier selection for later lookup.

shipiumShipmentIdstring

The unique identifier for this shipment.

partnerShipmentIdstring

The optional unique identifier that may be used for this shipment.

shipiumTenantIdstring

The shipium generated tenant ID. When present, this is used to indicate the tenant associated with the shipment.

partnerTenantIdstring

The partner provided tenant ID. When present, this is used to indicate the tenant associated with the shipment.

costAdjustConfigIdstring

If specified, this is the dynamic costing config applied for the carrier selection

carrierSelectionDateTimestring date-time

ISO-8601 formatted date when the carrier selection decision was made.

carrierSelectionExpirationstring date-time

ISO-8601 formatted date defining the point in time when the carrier selection details expire and cannot be acted upon.

cancellationDateTimestring date-time

The timestamp for when a carrier selection was cancelled. This field will default to null when the carrier selection is not cancelled. A carrier selection cannot be cancelled if it is associated with an active label

currencyCodestring

Currency in which all the rates for shipping carrier selection costs were calculated in.

Example response

{
  "carrierDecision": {
    "injectionDetails": {
      "injectionCostDetails": {
        "injectionLineItemRate": 2.3,
        "injectionLineItemCurrencyCode": "usd"
      }
    },
    "currencyCode": "USD"
  },
  "laneMatch": {
    "laneId": "asdqwdq-qwd123ds-123asdwd-123asd",
    "partnerLaneId": "custom partner provided id"
  },
  "cancellationDateTime": "2024-10-31T10:50:11.123456Z",
  "currencyCode": "USD"
}

Changes