取消配送

delete https://sellingpartnerapi-na.amazon.com/mfn/v0/shipments/{shipmentId}

Cancel the shipment indicated by the specified shipment identifier.

Usage Plan:

Rate (requests per second)	Burst
1	1

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that are applied to the requested operation when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the SP-API.

Responses

Response body

object

payload

object

The details of a shipment. Includes the shipment status.

ShipmentId

string

required

An Amazon-defined shipment identifier.

AmazonOrderId

string

required

亚马逊定义的订单编码，采用 3-7-7 格式。

SellerOrderId

string

length ≤ 64

A seller-defined order identifier.

ItemList

array of objects

required

The list of items you want to include in a shipment.

ItemList*

object

OrderItemId

string

required

An Amazon-defined identifier for an individual item in an order.

数量

int32

required

The number of items.

ItemWeight

object

The weight.

ItemDescription

string

The description of the item.

TransparencyCodeList

array of strings

A list of transparency codes.

TransparencyCodeList

ItemLevelSellerInputsList

array of objects

A list of additional seller input pairs required to purchase shipping.

ItemLevelSellerInputsList

object

AdditionalInputFieldName

string

required

The name of the additional input field.

AdditionalSellerInput

object

required

Additional information required to purchase shipping.

LiquidVolume

object

Liquid volume.

IsHazmat

布尔值

When true, the item qualifies as hazardous materials (hazmat). Defaults to false.

DangerousGoodsDetails

object

Details related to any dangerous goods or items that are shipped.

ShipFromAddress

object

required

The postal address information.

ShipToAddress

object

required

The postal address information.

包装尺寸

object

required

The dimensions of a package contained in a shipment.

重量

object

required

The weight.

Insurance

object

required

货币类型和金额。

配送服务

object

required

A shipping service offer made by a carrier.

标签

object

required

Data for creating a shipping label and dimensions for printing the label.

状态

string

required

The shipment status.

Purchased RefundPending RefundRejected RefundApplied

Show Details

Purchased	The seller purchased a label by calling the `createShipment` operation.
RefundPending	The seller requested a label refund by calling the `cancelShipment` operation, and the refund request is being processed by the carrier. Note: A seller can create a new shipment for an order while `Status = RefundPending` for a canceled shipment. After you request a label refund (by calling `cancelShipment`), the status of the order remains `Shipped`.
RefundRejected	The label refund request is rejected by the carrier. A refund request is rejected because the cancellation window has expired or the carrier has already accepted the shipment for delivery. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help for your marketplace.
RefundApplied	The refund has been approved and credited to the seller's account.

TrackingId

string

The shipment tracking identifier provided by the carrier.

CreatedDate

date-time

required

Date-time formatted timestamp.

LastUpdatedDate

date-time

Date-time formatted timestamp.

errors

array of objects

请求失败时返回的错误响应的列表。

errors

object

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition in a human-readable form.

details

string

Additional details that can help the caller understand or fix the issue.

标题

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The details of a shipment. Includes the shipment status.

ShipmentId

string

required

An Amazon-defined shipment identifier.

AmazonOrderId

string

required

亚马逊定义的订单编码，采用 3-7-7 格式。

SellerOrderId

string

length ≤ 64

A seller-defined order identifier.

ItemList

array of objects

required

The list of items you want to include in a shipment.

ItemList*

object

OrderItemId

string

required

An Amazon-defined identifier for an individual item in an order.

数量

int32

required

The number of items.

ItemWeight

object

The weight.

ItemDescription

string

The description of the item.

TransparencyCodeList

array of strings

A list of transparency codes.

TransparencyCodeList

ItemLevelSellerInputsList

array of objects

A list of additional seller input pairs required to purchase shipping.

ItemLevelSellerInputsList

object

AdditionalInputFieldName

string

required

The name of the additional input field.

AdditionalSellerInput

object

required

Additional information required to purchase shipping.

LiquidVolume

object

Liquid volume.

IsHazmat

布尔值

When true, the item qualifies as hazardous materials (hazmat). Defaults to false.

DangerousGoodsDetails

object

Details related to any dangerous goods or items that are shipped.

ShipFromAddress

object

required

The postal address information.

ShipToAddress

object

required

The postal address information.

包装尺寸

object

required

The dimensions of a package contained in a shipment.

重量

object

required

The weight.

Insurance

object

required

货币类型和金额。

配送服务

object

required

A shipping service offer made by a carrier.

标签

object

required

Data for creating a shipping label and dimensions for printing the label.

状态

string

required

The shipment status.

Purchased RefundPending RefundRejected RefundApplied

Show Details

Purchased	The seller purchased a label by calling the `createShipment` operation.
RefundPending	The seller requested a label refund by calling the `cancelShipment` operation, and the refund request is being processed by the carrier. Note: A seller can create a new shipment for an order while `Status = RefundPending` for a canceled shipment. After you request a label refund (by calling `cancelShipment`), the status of the order remains `Shipped`.
RefundRejected	The label refund request is rejected by the carrier. A refund request is rejected because the cancellation window has expired or the carrier has already accepted the shipment for delivery. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help for your marketplace.
RefundApplied	The refund has been approved and credited to the seller's account.

TrackingId

string

The shipment tracking identifier provided by the carrier.

CreatedDate

date-time

required

Date-time formatted timestamp.

LastUpdatedDate

date-time

Date-time formatted timestamp.

errors

array of objects

请求失败时返回的错误响应的列表。

errors

object

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition in a human-readable form.

details

string

Additional details that can help the caller understand or fix the issue.

标题

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The details of a shipment. Includes the shipment status.

ShipmentId

string

required

An Amazon-defined shipment identifier.

AmazonOrderId

string

required

亚马逊定义的订单编码，采用 3-7-7 格式。

SellerOrderId

string

length ≤ 64

A seller-defined order identifier.

ItemList

array of objects

required

The list of items you want to include in a shipment.

ItemList*

object

OrderItemId

string

required

An Amazon-defined identifier for an individual item in an order.

数量

int32

required

The number of items.

ItemWeight

object

The weight.

ItemDescription

string

The description of the item.

TransparencyCodeList

array of strings

A list of transparency codes.

TransparencyCodeList

ItemLevelSellerInputsList

array of objects

A list of additional seller input pairs required to purchase shipping.

ItemLevelSellerInputsList

object

AdditionalInputFieldName

string

required

The name of the additional input field.

AdditionalSellerInput

object

required

Additional information required to purchase shipping.

LiquidVolume

object

Liquid volume.

IsHazmat

布尔值

When true, the item qualifies as hazardous materials (hazmat). Defaults to false.

DangerousGoodsDetails

object

Details related to any dangerous goods or items that are shipped.

ShipFromAddress

object

required

The postal address information.

ShipToAddress

object

required

The postal address information.

包装尺寸

object

required

The dimensions of a package contained in a shipment.

重量

object

required

The weight.

Insurance

object

required

货币类型和金额。

配送服务

object

required

A shipping service offer made by a carrier.

标签

object

required

Data for creating a shipping label and dimensions for printing the label.

状态

string

required

The shipment status.

Purchased RefundPending RefundRejected RefundApplied

Show Details

Purchased	The seller purchased a label by calling the `createShipment` operation.
RefundPending	The seller requested a label refund by calling the `cancelShipment` operation, and the refund request is being processed by the carrier. Note: A seller can create a new shipment for an order while `Status = RefundPending` for a canceled shipment. After you request a label refund (by calling `cancelShipment`), the status of the order remains `Shipped`.
RefundRejected	The label refund request is rejected by the carrier. A refund request is rejected because the cancellation window has expired or the carrier has already accepted the shipment for delivery. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help for your marketplace.
RefundApplied	The refund has been approved and credited to the seller's account.

TrackingId

string

The shipment tracking identifier provided by the carrier.

CreatedDate

date-time

required

Date-time formatted timestamp.

LastUpdatedDate

date-time

Date-time formatted timestamp.

errors

array of objects

请求失败时返回的错误响应的列表。

errors

object

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition in a human-readable form.

details

string

Additional details that can help the caller understand or fix the issue.

标题

object

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The details of a shipment. Includes the shipment status.

ShipmentId

string

required

An Amazon-defined shipment identifier.

AmazonOrderId

string

required

亚马逊定义的订单编码，采用 3-7-7 格式。

SellerOrderId

string

length ≤ 64

A seller-defined order identifier.

ItemList

array of objects

required

The list of items you want to include in a shipment.

ItemList*

object

OrderItemId

string

required

An Amazon-defined identifier for an individual item in an order.

数量

int32

required

The number of items.

ItemWeight

object

The weight.

ItemDescription

string

The description of the item.

TransparencyCodeList

array of strings

A list of transparency codes.

TransparencyCodeList

ItemLevelSellerInputsList

array of objects

A list of additional seller input pairs required to purchase shipping.

ItemLevelSellerInputsList

object

AdditionalInputFieldName

string

required

The name of the additional input field.

AdditionalSellerInput

object

required

Additional information required to purchase shipping.

LiquidVolume

object

Liquid volume.

IsHazmat

布尔值

When true, the item qualifies as hazardous materials (hazmat). Defaults to false.

DangerousGoodsDetails

object

Details related to any dangerous goods or items that are shipped.

ShipFromAddress

object

required

The postal address information.

ShipToAddress

object

required

The postal address information.

包装尺寸

object

required

The dimensions of a package contained in a shipment.

重量

object

required

The weight.

Insurance

object

required

货币类型和金额。

配送服务

object

required

A shipping service offer made by a carrier.

标签

object

required

Data for creating a shipping label and dimensions for printing the label.

状态

string

required

The shipment status.

Purchased RefundPending RefundRejected RefundApplied

Show Details

Purchased	The seller purchased a label by calling the `createShipment` operation.
RefundPending	The seller requested a label refund by calling the `cancelShipment` operation, and the refund request is being processed by the carrier. Note: A seller can create a new shipment for an order while `Status = RefundPending` for a canceled shipment. After you request a label refund (by calling `cancelShipment`), the status of the order remains `Shipped`.
RefundRejected	The label refund request is rejected by the carrier. A refund request is rejected because the cancellation window has expired or the carrier has already accepted the shipment for delivery. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help for your marketplace.
RefundApplied	The refund has been approved and credited to the seller's account.

TrackingId

string

The shipment tracking identifier provided by the carrier.

CreatedDate

date-time

required

Date-time formatted timestamp.

LastUpdatedDate

date-time

Date-time formatted timestamp.

errors

array of objects

请求失败时返回的错误响应的列表。

errors

object

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition in a human-readable form.

details

string

Additional details that can help the caller understand or fix the issue.

标题

object

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The details of a shipment. Includes the shipment status.

ShipmentId

string

required

An Amazon-defined shipment identifier.

AmazonOrderId

string

required

亚马逊定义的订单编码，采用 3-7-7 格式。

SellerOrderId

string

length ≤ 64

A seller-defined order identifier.

ItemList

array of objects

required

The list of items you want to include in a shipment.

ItemList*

object

OrderItemId

string

required

An Amazon-defined identifier for an individual item in an order.

数量

int32

required

The number of items.

ItemWeight

object

The weight.

ItemDescription

string

The description of the item.

TransparencyCodeList

array of strings

A list of transparency codes.

TransparencyCodeList

ItemLevelSellerInputsList

array of objects

A list of additional seller input pairs required to purchase shipping.

ItemLevelSellerInputsList

object

AdditionalInputFieldName

string

required

The name of the additional input field.

AdditionalSellerInput

object

required

Additional information required to purchase shipping.

LiquidVolume

object

Liquid volume.

IsHazmat

布尔值

When true, the item qualifies as hazardous materials (hazmat). Defaults to false.

DangerousGoodsDetails

object

Details related to any dangerous goods or items that are shipped.

ShipFromAddress

object

required

The postal address information.

ShipToAddress

object

required

The postal address information.

包装尺寸

object

required

The dimensions of a package contained in a shipment.

重量

object

required

The weight.

Insurance

object

required

货币类型和金额。

配送服务

object

required

A shipping service offer made by a carrier.

标签

object

required

Data for creating a shipping label and dimensions for printing the label.

状态

string

required

The shipment status.

Purchased RefundPending RefundRejected RefundApplied

Show Details

Purchased	The seller purchased a label by calling the `createShipment` operation.
RefundPending	The seller requested a label refund by calling the `cancelShipment` operation, and the refund request is being processed by the carrier. Note: A seller can create a new shipment for an order while `Status = RefundPending` for a canceled shipment. After you request a label refund (by calling `cancelShipment`), the status of the order remains `Shipped`.
RefundRejected	The label refund request is rejected by the carrier. A refund request is rejected because the cancellation window has expired or the carrier has already accepted the shipment for delivery. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help for your marketplace.
RefundApplied	The refund has been approved and credited to the seller's account.

TrackingId

string

The shipment tracking identifier provided by the carrier.

CreatedDate

date-time

required

Date-time formatted timestamp.

LastUpdatedDate

date-time

Date-time formatted timestamp.

errors

array of objects

请求失败时返回的错误响应的列表。

errors

object

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition in a human-readable form.

details

string

Additional details that can help the caller understand or fix the issue.

标题

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The details of a shipment. Includes the shipment status.

ShipmentId

string

required

An Amazon-defined shipment identifier.

AmazonOrderId

string

required

亚马逊定义的订单编码，采用 3-7-7 格式。

SellerOrderId

string

length ≤ 64

A seller-defined order identifier.

ItemList

array of objects

required

The list of items you want to include in a shipment.

ItemList*

object

OrderItemId

string

required

An Amazon-defined identifier for an individual item in an order.

数量

int32

required

The number of items.

ItemWeight

object

The weight.

ItemDescription

string

The description of the item.

TransparencyCodeList

array of strings

A list of transparency codes.

TransparencyCodeList

ItemLevelSellerInputsList

array of objects

A list of additional seller input pairs required to purchase shipping.

ItemLevelSellerInputsList

object

AdditionalInputFieldName

string

required

The name of the additional input field.

AdditionalSellerInput

object

required

Additional information required to purchase shipping.

LiquidVolume

object

Liquid volume.

IsHazmat

布尔值

When true, the item qualifies as hazardous materials (hazmat). Defaults to false.

DangerousGoodsDetails

object

Details related to any dangerous goods or items that are shipped.

ShipFromAddress

object

required

The postal address information.

ShipToAddress

object

required

The postal address information.

包装尺寸

object

required

The dimensions of a package contained in a shipment.

重量

object

required

The weight.

Insurance

object

required

货币类型和金额。

配送服务

object

required

A shipping service offer made by a carrier.

标签

object

required

Data for creating a shipping label and dimensions for printing the label.

状态

string

required

The shipment status.

Purchased RefundPending RefundRejected RefundApplied

Show Details

Purchased	The seller purchased a label by calling the `createShipment` operation.
RefundPending	The seller requested a label refund by calling the `cancelShipment` operation, and the refund request is being processed by the carrier. Note: A seller can create a new shipment for an order while `Status = RefundPending` for a canceled shipment. After you request a label refund (by calling `cancelShipment`), the status of the order remains `Shipped`.
RefundRejected	The label refund request is rejected by the carrier. A refund request is rejected because the cancellation window has expired or the carrier has already accepted the shipment for delivery. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help for your marketplace.
RefundApplied	The refund has been approved and credited to the seller's account.

TrackingId

string

The shipment tracking identifier provided by the carrier.

CreatedDate

date-time

required

Date-time formatted timestamp.

LastUpdatedDate

date-time

Date-time formatted timestamp.

errors

array of objects

请求失败时返回的错误响应的列表。

errors

object

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition in a human-readable form.

details

string

Additional details that can help the caller understand or fix the issue.

标题

object

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The details of a shipment. Includes the shipment status.

ShipmentId

string

required

An Amazon-defined shipment identifier.

AmazonOrderId

string

required

亚马逊定义的订单编码，采用 3-7-7 格式。

SellerOrderId

string

length ≤ 64

A seller-defined order identifier.

ItemList

array of objects

required

The list of items you want to include in a shipment.

ItemList*

object

OrderItemId

string

required

An Amazon-defined identifier for an individual item in an order.

数量

int32

required

The number of items.

ItemWeight

object

The weight.

ItemDescription

string

The description of the item.

TransparencyCodeList

array of strings

A list of transparency codes.

TransparencyCodeList

ItemLevelSellerInputsList

array of objects

A list of additional seller input pairs required to purchase shipping.

ItemLevelSellerInputsList

object

AdditionalInputFieldName

string

required

The name of the additional input field.

AdditionalSellerInput

object

required

Additional information required to purchase shipping.

LiquidVolume

object

Liquid volume.

IsHazmat

布尔值

When true, the item qualifies as hazardous materials (hazmat). Defaults to false.

DangerousGoodsDetails

object

Details related to any dangerous goods or items that are shipped.

ShipFromAddress

object

required

The postal address information.

ShipToAddress

object

required

The postal address information.

包装尺寸

object

required

The dimensions of a package contained in a shipment.

重量

object

required

The weight.

Insurance

object

required

货币类型和金额。

配送服务

object

required

A shipping service offer made by a carrier.

标签

object

required

Data for creating a shipping label and dimensions for printing the label.

状态

string

required

The shipment status.

Purchased RefundPending RefundRejected RefundApplied

Show Details

Purchased	The seller purchased a label by calling the `createShipment` operation.
RefundPending	The seller requested a label refund by calling the `cancelShipment` operation, and the refund request is being processed by the carrier. Note: A seller can create a new shipment for an order while `Status = RefundPending` for a canceled shipment. After you request a label refund (by calling `cancelShipment`), the status of the order remains `Shipped`.
RefundRejected	The label refund request is rejected by the carrier. A refund request is rejected because the cancellation window has expired or the carrier has already accepted the shipment for delivery. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help for your marketplace.
RefundApplied	The refund has been approved and credited to the seller's account.

TrackingId

string

The shipment tracking identifier provided by the carrier.

CreatedDate

date-time

required

Date-time formatted timestamp.

LastUpdatedDate

date-time

Date-time formatted timestamp.

errors

array of objects

请求失败时返回的错误响应的列表。

errors

object

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition in a human-readable form.

details

string

Additional details that can help the caller understand or fix the issue.

标题

object

x-amzn-RequestId

string

Unique request reference identifier.

Response body

object

payload

object

The details of a shipment. Includes the shipment status.

ShipmentId

string

required

An Amazon-defined shipment identifier.

AmazonOrderId

string

required

亚马逊定义的订单编码，采用 3-7-7 格式。

SellerOrderId

string

length ≤ 64

A seller-defined order identifier.

ItemList

array of objects

required

The list of items you want to include in a shipment.

ItemList*

object

OrderItemId

string

required

An Amazon-defined identifier for an individual item in an order.

数量

int32

required

The number of items.

ItemWeight

object

The weight.

ItemDescription

string

The description of the item.

TransparencyCodeList

array of strings

A list of transparency codes.

TransparencyCodeList

ItemLevelSellerInputsList

array of objects

A list of additional seller input pairs required to purchase shipping.

ItemLevelSellerInputsList

object

AdditionalInputFieldName

string

required

The name of the additional input field.

AdditionalSellerInput

object

required

Additional information required to purchase shipping.

LiquidVolume

object

Liquid volume.

IsHazmat

布尔值

When true, the item qualifies as hazardous materials (hazmat). Defaults to false.

DangerousGoodsDetails

object

Details related to any dangerous goods or items that are shipped.

ShipFromAddress

object

required

The postal address information.

ShipToAddress

object

required

The postal address information.

包装尺寸

object

required

The dimensions of a package contained in a shipment.

重量

object

required

The weight.

Insurance

object

required

货币类型和金额。

配送服务

object

required

A shipping service offer made by a carrier.

标签

object

required

Data for creating a shipping label and dimensions for printing the label.

状态

string

required

The shipment status.

Purchased RefundPending RefundRejected RefundApplied

Show Details

Purchased	The seller purchased a label by calling the `createShipment` operation.
RefundPending	The seller requested a label refund by calling the `cancelShipment` operation, and the refund request is being processed by the carrier. Note: A seller can create a new shipment for an order while `Status = RefundPending` for a canceled shipment. After you request a label refund (by calling `cancelShipment`), the status of the order remains `Shipped`.
RefundRejected	The label refund request is rejected by the carrier. A refund request is rejected because the cancellation window has expired or the carrier has already accepted the shipment for delivery. Cancellation policies vary by carrier. For more information about carrier cancellation policies, refer to the Seller Central Help for your marketplace.
RefundApplied	The refund has been approved and credited to the seller's account.

TrackingId

string

The shipment tracking identifier provided by the carrier.

CreatedDate

date-time

required

Date-time formatted timestamp.

LastUpdatedDate

date-time

Date-time formatted timestamp.

errors

array of objects

请求失败时返回的错误响应的列表。

errors

object

code

string

required

An error code that identifies the type of error that occurred.

message

string

required

A message that describes the error condition in a human-readable form.

details

string

Additional details that can help the caller understand or fix the issue.

标题

object

x-amzn-RequestId

string

Unique request reference identifier.

语言


xxxxxxxxxx
1
curl --request DELETE \
2
     --url https://sellingpartnerapi-na.amazon.com/mfn/v0/shipments/shipmentId \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success.

400请求缺少参数或参数无效，无法解析。

401The request's authorization header is not formatted correctly or does not contain a valid token.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.