Jump to

• Request
• Response

Performs the Change Service Provider action by shipment ID

post

/custom-actions/changeServiceProvider/shipments/{shipment id}

Request

Path Parameters

• shipment id(required): integer

Header Parameters

• Prefer: string
  An optional header parameter that allows you to process the request asynchronously. Set the request header "Prefer" to "respond-async" for asynchronous processing. For synchronous processing, leave the parameter blank or do not define it.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Match All

Show Source

• object type

{
    "allOf":[
        {
            "type":"object",
            "properties":{
                "pk":{
                    "description":"Object primary key that supports one multi-part (compound) key",
                    "type":"string"
                },
                "rateGeoGid":{
                    "description":"Rate geo GID.",
                    "type":"string"
                },
                "equipmentGroup":{
                    "description":"The equipment group.",
                    "type":"string"
                }
            }
        }
    ]
}

Nested Schema : type

Type: object

Show Source

• equipmentGroup: string
  The equipment group.
• pk: string
  Object primary key that supports one multi-part (compound) key
• rateGeoGid: string
  Rate geo GID.

{
    "type":"object",
    "properties":{
        "pk":{
            "description":"Object primary key that supports one multi-part (compound) key",
            "type":"string"
        },
        "rateGeoGid":{
            "description":"Rate geo GID.",
            "type":"string"
        },
        "equipmentGroup":{
            "description":"The equipment group.",
            "type":"string"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Success! A successful POST method returns a 200 status code.

Body ()

Root Schema : changeServiceProviderResponse

Match All

Show Source

• object actionResponse
• object changeServiceProviderResponse-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/actionResponse"
        },
        {
            "type":"object",
            "properties":{
                "items":{
                    "description":"The Change Service Provider action response for a shipment.",
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/changeServiceProviderResultItem"
                    }
                }
            }
        }
    ]
}

Nested Schema : actionResponse

Type: object

Show Source

• success: string
  Success or failure.

{
    "properties":{
        "success":{
            "description":"Success or failure.",
            "type":"string"
        }
    }
}

Nested Schema : changeServiceProviderResponse-allOf[1]

Type: object

Show Source

• items: array items
  The Change Service Provider action response for a shipment.

{
    "type":"object",
    "properties":{
        "items":{
            "description":"The Change Service Provider action response for a shipment.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/changeServiceProviderResultItem"
            }
        }
    }
}

Nested Schema : items

Type: array

The Change Service Provider action response for a shipment.

Show Source

• Array of: object changeServiceProviderResultItem

{
    "description":"The Change Service Provider action response for a shipment.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/changeServiceProviderResultItem"
    }
}

Nested Schema : changeServiceProviderResultItem

Type: object

Show Source

• endTime: endTime
  The end time.
• equipmentGroup: string
  The equipment group.
• rateOffering: string
  The rate offering.
• serviceProviderID: string
  The service provider ID.
• shipmentPk: string
  The primary key for the shipment.
• startTime: startTime
  The start time.
• totalActualCost: totalActualCost
  The total actual cost.
• totalWeightedCost: totalWeightedCost
  The total weighted cost.
• transportMode: string
  The transport mode.

{
    "properties":{
        "shipmentPk":{
            "description":"The primary key for the shipment.",
            "type":"string"
        },
        "totalActualCost":{
            "description":"The total actual cost.",
            "allOf":[
                {
                    "$ref":"#/components/schemas/currencyType"
                }
            ]
        },
        "totalWeightedCost":{
            "description":"The total weighted cost.",
            "allOf":[
                {
                    "$ref":"#/components/schemas/currencyType"
                }
            ]
        },
        "startTime":{
            "description":"The start time.",
            "allOf":[
                {
                    "$ref":"#/components/schemas/dateTimeType"
                }
            ]
        },
        "endTime":{
            "description":"The end time.",
            "allOf":[
                {
                    "$ref":"#/components/schemas/dateTimeType"
                }
            ]
        },
        "serviceProviderID":{
            "description":"The service provider ID.",
            "type":"string"
        },
        "transportMode":{
            "description":"The transport mode.",
            "type":"string"
        },
        "rateOffering":{
            "description":"The rate offering.",
            "type":"string"
        },
        "equipmentGroup":{
            "description":"The equipment group.",
            "type":"string"
        }
    }
}

Nested Schema : endTime

The end time.

Match All

The end time.

Show Source

• object dateTimeType

{
    "description":"The end time.",
    "allOf":[
        {
            "$ref":"#/components/schemas/dateTimeType"
        }
    ]
}

Nested Schema : startTime

The start time.

Match All

The start time.

Show Source

• object dateTimeType

{
    "description":"The start time.",
    "allOf":[
        {
            "$ref":"#/components/schemas/dateTimeType"
        }
    ]
}

Nested Schema : totalActualCost

The total actual cost.

Match All

The total actual cost.

Show Source

• object currencyType

{
    "description":"The total actual cost.",
    "allOf":[
        {
            "$ref":"#/components/schemas/currencyType"
        }
    ]
}

Nested Schema : totalWeightedCost

The total weighted cost.

Match All

The total weighted cost.

Show Source

• object currencyType

{
    "description":"The total weighted cost.",
    "allOf":[
        {
            "$ref":"#/components/schemas/currencyType"
        }
    ]
}

Nested Schema : dateTimeType

Type: object

Show Source

• timezone: string
  Timezone in Olson database format
• value: string (date-time)
  Date in ISO 8601 format

{
    "properties":{
        "value":{
            "description":"Date in ISO 8601 format",
            "type":"string",
            "format":"date-time"
        },
        "timezone":{
            "description":"Timezone in Olson database format",
            "type":"string"
        }
    }
}

Nested Schema : currencyType

Type: object

Show Source

• currency: string
  ISO 4217 currency code
• value: number
  Numeric value that specifies a currency

{
    "properties":{
        "value":{
            "description":"Numeric value that specifies a currency",
            "type":"number"
        },
        "currency":{
            "description":"ISO 4217 currency code",
            "type":"string"
        }
    }
}

400 Response

Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.

Body ()

Root Schema : errorResponse

Type: object

Show Source

• detail(required): string
  Provides more information about the error.
• status(required): number
  HTTP status code.
• title(required): string
  Provides a short summary message.

{
    "properties":{
        "status":{
            "description":"HTTP status code.",
            "type":"number"
        },
        "title":{
            "description":"Provides a short summary message.",
            "type":"string"
        },
        "detail":{
            "description":"Provides more information about the error.",
            "type":"string"
        }
    },
    "required":[
        "status",
        "title",
        "detail"
    ]
}

401 Response

Unauthorized, the request was not successful because it lacks valid authentication credentials for the requested resource.

Body ()

Root Schema : errorResponse

Type: object

Show Source

• detail(required): string
  Provides more information about the error.
• status(required): number
  HTTP status code.
• title(required): string
  Provides a short summary message.

{
    "properties":{
        "status":{
            "description":"HTTP status code.",
            "type":"number"
        },
        "title":{
            "description":"Provides a short summary message.",
            "type":"string"
        },
        "detail":{
            "description":"Provides more information about the error.",
            "type":"string"
        }
    },
    "required":[
        "status",
        "title",
        "detail"
    ]
}

403 Response

Access to the specified resource has been forbidden.

Body ()

Root Schema : errorResponse

Type: object

Show Source

• detail(required): string
  Provides more information about the error.
• status(required): number
  HTTP status code.
• title(required): string
  Provides a short summary message.

{
    "properties":{
        "status":{
            "description":"HTTP status code.",
            "type":"number"
        },
        "title":{
            "description":"Provides a short summary message.",
            "type":"string"
        },
        "detail":{
            "description":"Provides more information about the error.",
            "type":"string"
        }
    },
    "required":[
        "status",
        "title",
        "detail"
    ]
}

500 Response

The server encountered something unexpected that prevented it from completing the request.

Body ()

Root Schema : errorResponse

Type: object

Show Source

• detail(required): string
  Provides more information about the error.
• status(required): number
  HTTP status code.
• title(required): string
  Provides a short summary message.

{
    "properties":{
        "status":{
            "description":"HTTP status code.",
            "type":"number"
        },
        "title":{
            "description":"Provides a short summary message.",
            "type":"string"
        },
        "detail":{
            "description":"Provides more information about the error.",
            "type":"string"
        }
    },
    "required":[
        "status",
        "title",
        "detail"
    ]
}

Back to Top