Jump to

• Request
• Response

Performs the Edit the Service Provider and Cost action for a shipment.

post

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

Request

Path Parameters

• shipment id(required): string

Header Parameters

• Prefer:
  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 actionRequest
• object type

{
    "allOf":[
        {
            "$ref":"#/components/schemas/actionRequest"
        },
        {
            "type":"object",
            "properties":{
                "serviceProviderId":{
                    "description":"serviceProviderId",
                    "type":"string"
                },
                "cost":{
                    "description":"cost",
                    "allOf":[
                        {
                            "$ref":"#/components/schemas/currencyType"
                        }
                    ]
                },
                "shipmentCosts":{
                    "description":"The shipment costs.",
                    "type":"array",
                    "items":{
                        "properties":{
                            "costType":{
                                "description":"costType",
                                "type":"string"
                            },
                            "shipmentCost":{
                                "description":"The shipment cost.",
                                "allOf":[
                                    {
                                        "$ref":"#/components/schemas/currencyType"
                                    }
                                ]
                            },
                            "isCostFixed":{
                                "description":"Indicates that the cost is fixed.",
                                "type":"boolean"
                            },
                            "processAsFlowThrough":{
                                "description":"Process as flow through.",
                                "type":"boolean"
                            },
                            "accessorialCode":{
                                "description":"An accessorial code.",
                                "type":"string"
                            },
                            "paymentMethodCode":{
                                "description":"The payment method code.",
                                "type":"string"
                            },
                            "adjustmentReason":{
                                "description":"The adjustment reason.",
                                "type":"string"
                            }
                        }
                    }
                }
            }
        }
    ]
}

Nested Schema : actionRequest

Type: object

Show Source

• pks: array pks
  Object primary keys that supports one or more multi-part (compound) keys
• reasonCodeGid: string
  A code describing the reason for the action.
• responsiblePartyGid: string
  Describes the person or people that will be affected by the action.
• statusCodeGid: string
  A code associated with the action to be performed.

{
    "properties":{
        "responsiblePartyGid":{
            "description":"Describes the person or people that will be affected by the action.",
            "type":"string"
        },
        "statusCodeGid":{
            "description":"A code associated with the action to be performed.",
            "type":"string"
        },
        "reasonCodeGid":{
            "description":"A code describing the reason for the action.",
            "type":"string"
        },
        "pks":{
            "description":"Object primary keys that supports one or more multi-part (compound) keys",
            "type":"array",
            "items":{
                "type":"array",
                "items":{
                    "type":"string"
                }
            }
        }
    }
}

Nested Schema : type

Type: object

Show Source

• cost: cost
  cost
• serviceProviderId: string
  serviceProviderId
• shipmentCosts: array shipmentCosts
  The shipment costs.

{
    "type":"object",
    "properties":{
        "serviceProviderId":{
            "description":"serviceProviderId",
            "type":"string"
        },
        "cost":{
            "description":"cost",
            "allOf":[
                {
                    "$ref":"#/components/schemas/currencyType"
                }
            ]
        },
        "shipmentCosts":{
            "description":"The shipment costs.",
            "type":"array",
            "items":{
                "properties":{
                    "costType":{
                        "description":"costType",
                        "type":"string"
                    },
                    "shipmentCost":{
                        "description":"The shipment cost.",
                        "allOf":[
                            {
                                "$ref":"#/components/schemas/currencyType"
                            }
                        ]
                    },
                    "isCostFixed":{
                        "description":"Indicates that the cost is fixed.",
                        "type":"boolean"
                    },
                    "processAsFlowThrough":{
                        "description":"Process as flow through.",
                        "type":"boolean"
                    },
                    "accessorialCode":{
                        "description":"An accessorial code.",
                        "type":"string"
                    },
                    "paymentMethodCode":{
                        "description":"The payment method code.",
                        "type":"string"
                    },
                    "adjustmentReason":{
                        "description":"The adjustment reason.",
                        "type":"string"
                    }
                }
            }
        }
    }
}

Nested Schema : pks

Type: array

Object primary keys that supports one or more multi-part (compound) keys

Show Source

• Array of: array items

{
    "description":"Object primary keys that supports one or more multi-part (compound) keys",
    "type":"array",
    "items":{
        "type":"array",
        "items":{
            "type":"string"
        }
    }
}

Nested Schema : items

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Nested Schema : cost

cost

Match All

Show Source

• object currencyType

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

Nested Schema : shipmentCosts

Type: array

The shipment costs.

Show Source

• Array of: object items

{
    "description":"The shipment costs.",
    "type":"array",
    "items":{
        "properties":{
            "costType":{
                "description":"costType",
                "type":"string"
            },
            "shipmentCost":{
                "description":"The shipment cost.",
                "allOf":[
                    {
                        "$ref":"#/components/schemas/currencyType"
                    }
                ]
            },
            "isCostFixed":{
                "description":"Indicates that the cost is fixed.",
                "type":"boolean"
            },
            "processAsFlowThrough":{
                "description":"Process as flow through.",
                "type":"boolean"
            },
            "accessorialCode":{
                "description":"An accessorial code.",
                "type":"string"
            },
            "paymentMethodCode":{
                "description":"The payment method code.",
                "type":"string"
            },
            "adjustmentReason":{
                "description":"The adjustment reason.",
                "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"
        }
    }
}

Nested Schema : items

Type: object

Show Source

• accessorialCode: string
  An accessorial code.
• adjustmentReason: string
  The adjustment reason.
• costType: string
  costType
• isCostFixed: boolean
  Indicates that the cost is fixed.
• paymentMethodCode: string
  The payment method code.
• processAsFlowThrough: boolean
  Process as flow through.
• shipmentCost: shipmentCost
  The shipment cost.

{
    "properties":{
        "costType":{
            "description":"costType",
            "type":"string"
        },
        "shipmentCost":{
            "description":"The shipment cost.",
            "allOf":[
                {
                    "$ref":"#/components/schemas/currencyType"
                }
            ]
        },
        "isCostFixed":{
            "description":"Indicates that the cost is fixed.",
            "type":"boolean"
        },
        "processAsFlowThrough":{
            "description":"Process as flow through.",
            "type":"boolean"
        },
        "accessorialCode":{
            "description":"An accessorial code.",
            "type":"string"
        },
        "paymentMethodCode":{
            "description":"The payment method code.",
            "type":"string"
        },
        "adjustmentReason":{
            "description":"The adjustment reason.",
            "type":"string"
        }
    }
}

Nested Schema : shipmentCost

The shipment cost.

Match All

Show Source

• object currencyType

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

Back to Top

Response

Supported Media Types

• application/json

200 Response

Default response.

Body ()

Root Schema : editServiceProviderAndCostResponse

Match All

Show Source

• object actionResponse
• object editServiceProviderAndCostResponse-allOf[1]

{
    "allOf":[
        {
            "$ref":"#/components/schemas/actionResponse"
        },
        {
            "type":"object",
            "properties":{
                "items":{
                    "description":"Edits the service provider and cost action response for a shipment.",
                    "type":"array",
                    "items":{
                        "$ref":"#/components/schemas/resultItem"
                    }
                }
            }
        }
    ]
}

Nested Schema : actionResponse

Type: object

Show Source

• success: string
  Success or failure.

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

Nested Schema : editServiceProviderAndCostResponse-allOf[1]

Type: object

Show Source

• items: array items
  Edits the service provider and cost action response for a shipment.

{
    "type":"object",
    "properties":{
        "items":{
            "description":"Edits the service provider and cost action response for a shipment.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/resultItem"
            }
        }
    }
}

Nested Schema : items

Type: array

Edits the service provider and cost action response for a shipment.

Show Source

• Array of: object resultItem

{
    "description":"Edits the service provider and cost action response for a shipment.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/resultItem"
    }
}

Nested Schema : resultItem

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

Show Source

• object dateTimeType

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

Nested Schema : startTime

The start time.

Match All

Show Source

• object dateTimeType

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

Nested Schema : totalActualCost

The total actual cost.

Match All

Show Source

• object currencyType

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

Nested Schema : totalWeightedCost

The total weighted cost.

Match All

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"
        }
    }
}

Back to Top