Fulfillment Outbound API v2020-07-01 reference

AmazonSPAPI

# Overview

The Selling Partner API for Fulfillment Outbound lets you create applications that help a seller fulfill Multi-Channel Fulfillment orders using their inventory in Amazon's fulfillment network. You can get information on both potential and existing fulfillment orders.

# Version information

Version : 2020-07-01

# Operations

getFulfillmentPreview
listAllFulfillmentOrders
createFulfillmentOrder
getPackageTrackingDetails
listReturnReasonCodes
createFulfillmentReturn
getFulfillmentOrder
updateFulfillmentOrder
cancelFulfillmentOrder
getFeatures
getFeatureInventory
getFeatureSKU

# Paths

# getFulfillmentPreview

POST /fba/outbound/2020-07-01/fulfillmentOrders/preview

# Description

Returns a list of fulfillment order previews based on shipping criteria that you specify.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Body body
required
The request body schema for the getFulfillmentPreview operation. GetFulfillmentPreviewRequest

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentPreviewResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentPreviewResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentPreviewResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentPreviewResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentPreviewResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentPreviewResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentPreviewResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentPreviewResponse

# listAllFulfillmentOrders

GET /fba/outbound/2020-07-01/fulfillmentOrders

# Description

Returns a list of fulfillment orders fulfilled after (or at) a specified date-time, or indicated by the next token parameter.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Query queryStartDate
optional
A date used to select fulfillment orders that were last updated after (or at) a specified time. An update is defined as any change in fulfillment order status, including the creation of a new fulfillment order. string (date-time)
Query nextToken
optional
A string token returned in the response to your previous request. string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
ListAllFulfillmentOrdersResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
ListAllFulfillmentOrdersResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ListAllFulfillmentOrdersResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
ListAllFulfillmentOrdersResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
ListAllFulfillmentOrdersResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ListAllFulfillmentOrdersResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ListAllFulfillmentOrdersResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ListAllFulfillmentOrdersResponse

# createFulfillmentOrder

POST /fba/outbound/2020-07-01/fulfillmentOrders

# Description

Requests that Amazon ship items from the seller's inventory in Amazon's fulfillment network to a destination address.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Body body
required
The request body schema for the createFulfillmentOrder operation. CreateFulfillmentOrderRequest

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentOrderResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentOrderResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentOrderResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentOrderResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentOrderResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentOrderResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentOrderResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentOrderResponse

# getPackageTrackingDetails

GET /fba/outbound/2020-07-01/tracking

# Description

Returns delivery tracking information for a package in an outbound shipment for a Multi-Channel Fulfillment order.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Query packageNumber
required
The unencrypted package identifier returned by the getFulfillmentOrder operation. integer (int32)

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetPackageTrackingDetailsResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetPackageTrackingDetailsResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetPackageTrackingDetailsResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
GetPackageTrackingDetailsResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetPackageTrackingDetailsResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetPackageTrackingDetailsResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetPackageTrackingDetailsResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetPackageTrackingDetailsResponse

# listReturnReasonCodes

GET /fba/outbound/2020-07-01/returnReasonCodes

# Description

Returns a list of return reason codes for a seller SKU in a given marketplace.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Query sellerSku
required
The seller SKU for which return reason codes are required. string
Query marketplaceId
optional
The marketplace for which the seller wants return reason codes. string
Query sellerFulfillmentOrderId
optional
The identifier assigned to the item by the seller when the fulfillment order was created. The service uses this value to determine the marketplace for which the seller wants return reason codes. string
Query language
required
The language that the TranslatedDescription property of the ReasonCodeDetails response object should be translated into. string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
ListReturnReasonCodesResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
ListReturnReasonCodesResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ListReturnReasonCodesResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
ListReturnReasonCodesResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
ListReturnReasonCodesResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ListReturnReasonCodesResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ListReturnReasonCodesResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
ListReturnReasonCodesResponse

# createFulfillmentReturn

PUT /fba/outbound/2020-07-01/fulfillmentOrders/{sellerFulfillmentOrderId}/return

# Description

Creates a fulfillment return.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Body body
required
The createFulfillmentReturn operation creates a fulfillment return for items that were fulfilled using the createFulfillmentOrder operation. For calls to createFulfillmentReturn, you must include ReturnReasonCode values returned by a previous call to the listReturnReasonCodes operation. CreateFulfillmentReturnRequest
Path sellerFulfillmentOrderId
required
An identifier assigned by the seller to the fulfillment order at the time it was created. The seller uses their own records to find the correct SellerFulfillmentOrderId value based on the buyer's request to return items. string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentReturnResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentReturnResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentReturnResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentReturnResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentReturnResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentReturnResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentReturnResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CreateFulfillmentReturnResponse

# getFulfillmentOrder

GET /fba/outbound/2020-07-01/fulfillmentOrders/{sellerFulfillmentOrderId}

# Description

Returns the fulfillment order indicated by the specified order identifier.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Path sellerFulfillmentOrderId
required
The identifier assigned to the item by the seller when the fulfillment order was created.
maxLength : 40
string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentOrderResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentOrderResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentOrderResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentOrderResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentOrderResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentOrderResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentOrderResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFulfillmentOrderResponse

# updateFulfillmentOrder

PUT /fba/outbound/2020-07-01/fulfillmentOrders/{sellerFulfillmentOrderId}

# Description

Updates and/or requests shipment for a fulfillment order with an order hold on it.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Body body
required
- UpdateFulfillmentOrderRequest
Path sellerFulfillmentOrderId
required
The identifier assigned to the item by the seller when the fulfillment order was created.
maxLength : 40
string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
UpdateFulfillmentOrderResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
UpdateFulfillmentOrderResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
UpdateFulfillmentOrderResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
UpdateFulfillmentOrderResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
UpdateFulfillmentOrderResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
UpdateFulfillmentOrderResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
UpdateFulfillmentOrderResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
UpdateFulfillmentOrderResponse

# cancelFulfillmentOrder

PUT /fba/outbound/2020-07-01/fulfillmentOrders/{sellerFulfillmentOrderId}/cancel

# Description

Requests that Amazon stop attempting to fulfill the fulfillment order indicated by the specified order identifier.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Path sellerFulfillmentOrderId
required
The identifier assigned to the item by the seller when the fulfillment order was created.
maxLength : 40
string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CancelFulfillmentOrderResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CancelFulfillmentOrderResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CancelFulfillmentOrderResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
CancelFulfillmentOrderResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
CancelFulfillmentOrderResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CancelFulfillmentOrderResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CancelFulfillmentOrderResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
CancelFulfillmentOrderResponse

# getFeatures

GET /fba/outbound/2020-07-01/features

# Description

Returns a list of features available for Multi-Channel Fulfillment orders in the marketplace you specify, and whether the seller for which you made the call is enrolled for each feature.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Query marketplaceId
required
The marketplace for which to return the list of features. string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeaturesResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeaturesResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeaturesResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeaturesResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeaturesResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeaturesResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeaturesResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeaturesResponse

# getFeatureInventory

GET /fba/outbound/2020-07-01/features/inventory/{featureName}

# Description

Returns a list of inventory items that are eligible for the fulfillment feature you specify.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Query marketplaceId
required
The marketplace for which to return a list of the inventory that is eligible for the specified feature. string
Path featureName
required
The name of the feature for which to return a list of eligible inventory. string
Query nextToken
optional
A string token returned in the response to your previous request that is used to return the next response page. A value of null will return the first page. string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureInventoryResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureInventoryResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureInventoryResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureInventoryResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureInventoryResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureInventoryResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureInventoryResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureInventoryResponse

# getFeatureSKU

GET /fba/outbound/2020-07-01/features/inventory/{featureName}/{sellerSku}

# Description

Returns the number of items with the sellerSKU you specify that can have orders fulfilled using the specified feature. Note that if the sellerSKU isn't eligible, the response will contain an empty skuInfo object.

Usage Plan:

Rate (requests per second) Burst
2 30

For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

# Parameters

Type Name Description Schema
Query marketplaceId
required
The marketplace for which to return the count. string
Path featureName
required
The name of the feature. string
Path sellerSku
required
Used to identify an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit. string

# Responses

HTTP Code Description Schema
200 Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureSkuResponse
400 Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureSkuResponse
401 The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureSkuResponse
403 Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureSkuResponse
404 The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureSkuResponse
429 The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureSkuResponse
500 An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureSkuResponse
503 Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference identifier.
GetFeatureSkuResponse

# Definitions

# Error

Error response returned when the request is unsuccessful.

Name Description Schema
code
required
An error code that identifies the type of error that occurred. string
message
required
A message that describes the error condition. string
details
optional
Additional details that can help the caller understand or fix the issue. string

# ErrorList

A list of error responses returned when a request is unsuccessful.

Type : < Error > array

# Address

A physical address.

Name Description Schema
name
required
The name of the person, business or institution at the address. string
addressLine1
required
The first line of the address. string
addressLine2
optional
Additional address information, if required. string
addressLine3
optional
Additional address information, if required. string
city
optional
The city where the person, business, or institution is located. string
districtOrCounty
optional
The district or county where the person, business, or institution is located. string
stateOrRegion
required
The state or region where the person, business or institution is located. string
postalCode
optional
The postal code of the address. string
countryCode
required
The two digit country code. In ISO 3166-1 alpha-2 format. string
phone
optional
The phone number of the person, business, or institution located at the address. string

# CODSettings

The COD (Cash On Delivery) charges that you associate with a COD fulfillment order.

Name Description Schema
isCodRequired
required
When true, this fulfillment order requires a COD (Cash On Delivery) payment. boolean
codCharge
optional
The amount of the COD charge to be collected from the recipient for a COD order. Money
codChargeTax
optional
The amount of the tax on the COD charge to be collected from the recipient for a COD order. Money
shippingCharge
optional
The amount of the tax on the COD charge to be collected from the recipient for a COD order. Money
shippingChargeTax
optional
The amount of the tax on the shipping charge to be collected from the recipient for a COD order. Money

# CreateFulfillmentOrderItem

Item information for creating a fulfillment order.

Name Description Schema
sellerSku
required
The seller SKU of the item.
maxLength : 50
string
sellerFulfillmentOrderItemId
required
A fulfillment order item identifier that the seller creates to track fulfillment order items. Used to disambiguate multiple fulfillment items that have the same SellerSKU. For example, the seller might assign different SellerFulfillmentOrderItemId values to two items in a fulfillment order that share the same SellerSKU but have different GiftMessage values.
maxLength : 50
string
quantity
required
The item quantity. Quantity
giftMessage
optional
A message to the gift recipient, if applicable.
maxLength : 512
string
displayableComment
optional
Item-specific text that displays in recipient-facing materials such as the outbound shipment packing slip.
maxLength : 250
string
fulfillmentNetworkSku
optional
Amazon's fulfillment network SKU of the item. string
perUnitDeclaredValue
optional
The monetary value assigned by the seller to this item. Money
perUnitPrice
optional
The amount to be collected from the recipient for this item in a COD (Cash On Delivery) order. Money
perUnitTax
optional
The tax on the amount to be collected from the recipient for this item in a COD (Cash On Delivery) order. Money

# CreateFulfillmentOrderItemList

An array of item information for creating a fulfillment order.

Type : < CreateFulfillmentOrderItem > array

# FulfillmentPolicy

The FulfillmentPolicy value specified when you submitted the createFulfillmentOrder operation.

Type : enum

Value Description
FillOrKill If an item in a fulfillment order is determined to be unfulfillable before any shipment in the order has acquired the status of Pending (the process of picking units from inventory has begun), then the entire order is considered unfulfillable. However, if an item in a fulfillment order is determined to be unfulfillable after a shipment in the order has acquired the status of Pending, Amazon cancels as much of the fulfillment order as possible. See the FulfillmentShipment object for shipment status definitions.
FillAll All fulfillable items in the fulfillment order are shipped. The fulfillment order remains in a processing state until all items are either shipped by Amazon or cancelled by the seller.
FillAllAvailable All fulfillable items in the fulfillment order are shipped. All unfulfillable items in the order are cancelled.

# FulfillmentOrderStatus

The current status of the fulfillment order.

Type : enum

Value Description
New The fulfillment order was received but not yet validated.
Received The fulfillment order was received and validated. Validation includes determining that the destination address is valid and that Amazon's records indicate that the seller has enough sellable (undamaged) inventory to fulfill the order. The seller can cancel a fulfillment order that has a status of Received.
Planning The fulfillment order has been sent to Amazon's fulfillment network to begin shipment planning, but no unit in any shipment has been picked from inventory yet. The seller can cancel a fulfillment order that has a status of Planning.
Processing The process of picking units from inventory has begun on at least one shipment in the fulfillment order. The seller cannot cancel a fulfillment order that has a status of Processing.
Cancelled The fulfillment order has been cancelled by the seller.
Complete All item quantities in the fulfillment order have been fulfilled.
CompletePartialled Some item quantities in the fulfillment order were fulfilled; the rest were either cancelled or unfulfillable.
Unfulfillable No item quantities in the fulfillment order could be fulfilled because the Amazon fulfillment center workers found no inventory for those items or found no inventory that was in sellable (undamaged) condition.
Invalid The fulfillment order was received but could not be validated. The reasons for this include an invalid destination address or Amazon's records indicating that the seller does not have enough sellable inventory to fulfill the order. When this happens, the fulfillment order is invalid and no items in the order will ship.

# CreateFulfillmentOrderRequest

The request body schema for the createFulfillmentOrder operation.

Name Description Schema
marketplaceId
optional
The marketplace the fulfillment order is placed against. string
sellerFulfillmentOrderId
required
A fulfillment order identifier that the seller creates to track their fulfillment order. The SellerFulfillmentOrderId must be unique for each fulfillment order that a seller creates. If the seller's system already creates unique order identifiers, then these might be good values for them to use.
maxLength : 40
string
displayableOrderId
required
A fulfillment order identifier that the seller creates. This value displays as the order identifier in recipient-facing materials such as the outbound shipment packing slip. The value of DisplayableOrderId should match the order identifier that the seller provides to the recipient. The seller can use the SellerFulfillmentOrderId for this value or they can specify an alternate value if they want the recipient to reference an alternate order identifier.

The value must be an alpha-numeric or ISO 8859-1 compliant string from one to 40 characters in length. Cannot contain two spaces in a row. Leading and trailing white space is removed.
maxLength : 40
string
displayableOrderDate
required
The date and time of the fulfillment order. Displays as the order date in recipient-facing materials such as the outbound shipment packing slip. Timestamp
displayableOrderComment
required
Order-specific text that appears in recipient-facing materials such as the outbound shipment packing slip.
maxLength : 1000
string
shippingSpeedCategory
required
The shipping method for the fulfillment order. ShippingSpeedCategory
deliveryWindow
optional
The time range within which a Scheduled Delivery fulfillment order should be delivered. DeliveryWindow
destinationAddress
required
The destination address for the fulfillment order. Address
fulfillmentAction
optional
Specifies whether the fulfillment order should ship now or have an order hold put on it. FulfillmentAction
fulfillmentPolicy
optional
The FulfillmentPolicy value specified when you submitted the createFulfillmentOrder operation. FulfillmentPolicy
codSettings
optional
The COD (Cash On Delivery) charges that you associate with a COD fulfillment order. CODSettings
shipFromCountryCode
optional
The two-character country code for the country from which the fulfillment order ships. Must be in ISO 3166-1 alpha-2 format. string
notificationEmails
optional
A list of email addresses that the seller provides that are used by Amazon to send ship-complete notifications to recipients on behalf of the seller. NotificationEmailList
featureConstraints
optional
A list of features and their fulfillment policies to apply to the order. < FeatureSettings > array
items
required
A list of items to include in the fulfillment order preview, including quantity. CreateFulfillmentOrderItemList

# CreateFulfillmentReturnRequest

The createFulfillmentReturn operation creates a fulfillment return for items that were fulfilled using the createFulfillmentOrder operation. For calls to createFulfillmentReturn, you must include ReturnReasonCode values returned by a previous call to the listReturnReasonCodes operation.

Name Description Schema
items
required
An array of items to be returned. CreateReturnItemList

# CreateFulfillmentReturnResult

Name Description Schema
returnItems
optional
An array of items that Amazon accepted for return. Returns empty if no items were accepted for return. ReturnItemList
invalidReturnItems
optional
An array of invalid return item information. InvalidReturnItemList
returnAuthorizations
optional
An array of return authorization information. ReturnAuthorizationList

# CreateFulfillmentReturnResponse

The response schema for the createFulfillmentReturn operation.

Name Description Schema
payload
optional
The payload for the createFulfillmentReturn operation. CreateFulfillmentReturnResult
errors
optional
One or more unexpected errors occurred during the createFulfillmentReturn operation. ErrorList

# CreateReturnItem

An item that Amazon accepted for return.

Name Description Schema
sellerReturnItemId
required
An identifier assigned by the seller to the return item.
maxLength : 80
string
sellerFulfillmentOrderItemId
required
The identifier assigned to the item by the seller when the fulfillment order was created. string
amazonShipmentId
required
The identifier for the shipment that is associated with the return item. string
returnReasonCode
required
The return reason code assigned to the return item by the seller. string
returnComment
optional
An optional comment about the return item.
maxLength : 1000
string

# CreateReturnItemList

An array of items to be returned.

Type : < CreateReturnItem > array

# Money

An amount of money, including units in the form of currency.

Name Description Schema
currencyCode
required
Three digit currency code in ISO 4217 format. string
value
required
A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation. Decimal

# Decimal

A decimal number with no loss of precision. Useful when precision loss is unacceptable, as with currencies. Follows RFC7159 for number representation.

Type : string

# DeliveryWindow

The time range within which a Scheduled Delivery fulfillment order should be delivered.

Name Description Schema
startDate
required
The date and time of the start of the Scheduled Delivery window, in ISO 8601 date time format. Timestamp
endDate
required
The date and time of the end of the Scheduled Delivery window, in ISO 8601 date time format. Timestamp

# DeliveryWindowList

An array of delivery windows.

Type : < DeliveryWindow > array

# Fee

Fee type and cost.

Name Description Schema
name
required
The type of fee. enum (Name)
amount
required
The amount of the fee. Money

# FeeList

An array of fee type and cost pairs.

Type : < Fee > array

# FulfillmentAction

Specifies whether the fulfillment order should ship now or have an order hold put on it.

Type : enum

Value Description
Ship The fulfillment order ships now.
Hold An order hold is put on the fulfillment order.

# FulfillmentOrder

General information about a fulfillment order, including its status.

Name Description Schema
sellerFulfillmentOrderId
required
The fulfillment order identifier submitted with the createFulfillmentOrder operation. string
marketplaceId
required
The identifier for the marketplace the fulfillment order is placed against. string
displayableOrderId
required
A fulfillment order identifier submitted with the createFulfillmentOrder operation. Displays as the order identifier in recipient-facing materials such as the packing slip. string
displayableOrderDate
required
A date and time submitted with the createFulfillmentOrder operation. Displays as the order date in recipient-facing materials such as the packing slip. Timestamp
displayableOrderComment
required
A text block submitted with the createFulfillmentOrder operation. Displays in recipient-facing materials such as the packing slip. string
shippingSpeedCategory
required
The shipping method used for the fulfillment order. ShippingSpeedCategory
deliveryWindow
optional
The time range within which a Scheduled Delivery fulfillment order should be delivered. DeliveryWindow
destinationAddress
required
The destination address submitted with the createFulfillmentOrder operation. Address
fulfillmentAction
optional
Specifies whether the fulfillment order should ship now or have an order hold put on it. FulfillmentAction
fulfillmentPolicy
optional
The FulfillmentPolicy value specified when you submitted the createFulfillmentOrder operation. FulfillmentPolicy
codSettings
optional
The COD (Cash On Delivery) charges that you associate with a COD fulfillment order. CODSettings
receivedDate
required
The date and time that the fulfillment order was received by an Amazon fulfillment center. Timestamp
fulfillmentOrderStatus
required
The current status of the fulfillment order. FulfillmentOrderStatus
statusUpdatedDate
required
The date and time that the status of the fulfillment order last changed, in ISO 8601 date time format. Timestamp
notificationEmails
optional
A list of email addresses that the seller provides that are used by Amazon to send ship-complete notifications to recipients on behalf of the seller. NotificationEmailList
featureConstraints
optional
A list of features and their fulfillment policies to apply to the order. < FeatureSettings > array

# FulfillmentOrderItem

Item information for a fulfillment order.

Name Description Schema
sellerSku
required
The seller SKU of the item. string
sellerFulfillmentOrderItemId
required
A fulfillment order item identifier submitted with a call to the createFulfillmentOrder operation. string
quantity
required
The item quantity. Quantity
giftMessage
optional
A message to the gift recipient, if applicable. string
displayableComment
optional
Item-specific text that displays in recipient-facing materials such as the outbound shipment packing slip. string
fulfillmentNetworkSku
optional
Amazon's fulfillment network SKU of the item. string
orderItemDisposition
optional
Indicates whether the item is sellable or unsellable. string
cancelledQuantity
required
The item quantity that was cancelled by the seller. Quantity
unfulfillableQuantity
required
The item quantity that is unfulfillable. Quantity
estimatedShipDate
optional
The estimated date and time that the item quantity is scheduled to ship from the fulfillment center. Note that this value can change over time. If the shipment that contains the item quantity has been cancelled, estimatedShipDate is not returned. Timestamp
estimatedArrivalDate
optional
The estimated arrival date and time of the item quantity. Note that this value can change over time. If the shipment that contains the item quantity has been cancelled, estimatedArrivalDate is not returned. Timestamp
perUnitPrice
optional
The amount to be collected from the recipient for this item in a COD (Cash On Delivery) order. Money
perUnitTax
optional
The tax on the amount to be collected from the recipient for this item in a COD (Cash On Delivery) order. Money
perUnitDeclaredValue
optional
The monetary value assigned by the seller to this item. Money

# FulfillmentOrderItemList

An array of fulfillment order item information.

Type : < FulfillmentOrderItem > array

# FulfillmentPreview

Information about a fulfillment order preview, including delivery and fee information based on shipping method.

Name Description Schema
shippingSpeedCategory
required
The shipping method used for the fulfillment order. ShippingSpeedCategory
scheduledDeliveryInfo
optional
Delivery information for a scheduled delivery. ScheduledDeliveryInfo
isFulfillable
required
When true, this fulfillment order preview is fulfillable. boolean
isCODCapable
required
When true, this fulfillment order preview is for COD (Cash On Delivery). boolean
estimatedShippingWeight
optional
Estimated shipping weight for this fulfillment order preview. Weight
estimatedFees
optional
The estimated fulfillment fees for this fulfillment order preview, if applicable. FeeList
fulfillmentPreviewShipments
optional
An array of fulfillment preview shipment information. FulfillmentPreviewShipmentList
unfulfillablePreviewItems
optional
An array of unfulfillable preview item information. UnfulfillablePreviewItemList
orderUnfulfillableReasons
optional
Error codes associated with the fulfillment order preview that indicate why the order is not fulfillable.

Error code examples:

DeliverySLAUnavailable
InvalidDestinationAddress
StringList
marketplaceId
required
The marketplace the fulfillment order is placed against. string
featureConstraints
optional
A list of features and their fulfillment policies to apply to the order. < FeatureSettings > array

# FulfillmentPreviewItem

Item information for a shipment in a fulfillment order preview.

Name Description Schema
sellerSku
required
The seller SKU of the item. string
quantity
required
The item quantity. Quantity
sellerFulfillmentOrderItemId
required
A fulfillment order item identifier that the seller created with a call to the createFulfillmentOrder operation. string
estimatedShippingWeight
optional
The estimated shipping weight of the item quantity for a single item, as identified by sellerSku, in a shipment. Weight
shippingWeightCalculationMethod
optional
The method used to calculate the estimated shipping weight. enum (ShippingWeightCalculationMethod)

# FulfillmentPreviewItemList

An array of fulfillment preview item information.

Type : < FulfillmentPreviewItem > array

# FulfillmentPreviewList

An array of fulfillment preview information.

Type : < FulfillmentPreview > array

# FulfillmentPreviewShipment

Delivery and item information for a shipment in a fulfillment order preview.

Name Description Schema
earliestShipDate
optional
The earliest date that the shipment is expected to be sent from the fulfillment center, in ISO 8601 date time format. Timestamp
latestShipDate
optional
The latest date that the shipment is expected to be sent from the fulfillment center, in ISO 8601 date time format. Timestamp
earliestArrivalDate
optional
The earliest date that the shipment is expected to arrive at its destination. Timestamp
latestArrivalDate
optional
The latest date that the shipment is expected to arrive at its destination, in ISO 8601 date time format. Timestamp
shippingNotes
optional
Provides additional insight into the shipment timeline when exact delivery dates are not able to be precomputed. < string > array
fulfillmentPreviewItems
required
Information about the items in the shipment. FulfillmentPreviewItemList

# FulfillmentPreviewShipmentList

An array of fulfillment preview shipment information.

Type : < FulfillmentPreviewShipment > array

# FulfillmentReturnItemStatus

Indicates if the return item has been processed by a fulfillment center.

Type : enum

Value Description
New The return item has not yet been processed by a fulfillment center.
Processed The return item has been processed by a fulfillment center.

# FulfillmentShipment

Delivery and item information for a shipment in a fulfillment order.

Name Description Schema
amazonShipmentId
required
A shipment identifier assigned by Amazon. string
fulfillmentCenterId
required
An identifier for the fulfillment center that the shipment will be sent from. string
fulfillmentShipmentStatus
required
The current status of the shipment. enum (FulfillmentShipmentStatus)
shippingDate
optional
The meaning of the shippingDate value depends on the current status of the shipment. If the current value of FulfillmentShipmentStatus is:

  • Pending - shippingDate represents the estimated time that the shipment will leave the Amazon fulfillment center.

  • Shipped - shippingDate represents the date that the shipment left the Amazon fulfillment center.

  • If a shipment includes more than one package, shippingDate applies to all of the packages in the shipment. If the value of FulfillmentShipmentStatus is CancelledByFulfiller or CancelledBySeller, shippingDate is not returned. The value must be in ISO 8601 date time format.
    Timestamp
    estimatedArrivalDate
    optional
    The estimated arrival date and time of the shipment, in ISO 8601 date time format. Note that this value can change over time. If a shipment includes more than one package, estimatedArrivalDate applies to all of the packages in the shipment. If the shipment has been cancelled, estimatedArrivalDate is not returned. Timestamp
    shippingNotes
    optional
    Provides additional insight into shipment timeline. Primairly used to communicate that actual delivery dates aren't available. < string > array
    fulfillmentShipmentItem
    required
    An array of fulfillment shipment item information. FulfillmentShipmentItemList
    fulfillmentShipmentPackage
    optional
    An array of fulfillment shipment package information. FulfillmentShipmentPackageList

    # FulfillmentShipmentItem

    Item information for a shipment in a fulfillment order.

    Name Description Schema
    sellerSku
    required
    The seller SKU of the item. string
    sellerFulfillmentOrderItemId
    required
    The fulfillment order item identifier that the seller created and submitted with a call to the createFulfillmentOrder operation. string
    quantity
    required
    The item quantity. Quantity
    packageNumber
    optional
    An identifier for the package that contains the item quantity. integer (int32)
    serialNumber
    optional
    The serial number of the shipped item. string

    # FulfillmentShipmentItemList

    An array of fulfillment shipment item information.

    Type : < FulfillmentShipmentItem > array

    # FulfillmentShipmentList

    An array of fulfillment shipment information.

    Type : < FulfillmentShipment > array

    # FulfillmentShipmentPackage

    Package information for a shipment in a fulfillment order.

    Name Description Schema
    packageNumber
    required
    Identifies a package in a shipment. integer (int32)
    carrierCode
    required
    Identifies the carrier who will deliver the shipment to the recipient. string
    trackingNumber
    optional
    The tracking number, if provided, can be used to obtain tracking and delivery information. string
    estimatedArrivalDate
    optional
    The estimated arrival date and time of the package, in ISO 8601 date time format. Timestamp

    # FulfillmentShipmentPackageList

    An array of fulfillment shipment package information.

    Type : < FulfillmentShipmentPackage > array

    # GetFulfillmentOrderResult

    Name Description Schema
    fulfillmentOrder
    required
    General information about a fulfillment order, including its status. FulfillmentOrder
    fulfillmentOrderItems
    required
    An array of fulfillment order item information. FulfillmentOrderItemList
    fulfillmentShipments
    optional
    An array of fulfillment shipment information. FulfillmentShipmentList
    returnItems
    required
    An array of items that Amazon accepted for return. Returns empty if no items were accepted for return. ReturnItemList
    returnAuthorizations
    required
    An array of return authorization information. ReturnAuthorizationList

    # GetFulfillmentOrderResponse

    The response schema for the getFulfillmentOrder operation.

    Name Description Schema
    payload
    optional
    The payload for the getFulfillmentOrder operation. GetFulfillmentOrderResult
    errors
    optional
    One or more unexpected errors occurred during the getFulfillmentOrder operation. ErrorList

    # GetFulfillmentPreviewItem

    Item information for a fulfillment order preview.

    Name Description Schema
    sellerSku
    required
    The seller SKU of the item.
    maxLength : 50
    string
    quantity
    required
    The item quantity. Quantity
    perUnitDeclaredValue
    optional
    The monetary value assigned by the seller to this item. This is a required field if this order is an export order. Money
    sellerFulfillmentOrderItemId
    required
    A fulfillment order item identifier that the seller creates to track items in the fulfillment preview.
    maxLength : 50
    string

    # GetFulfillmentPreviewItemList

    An array of fulfillment preview item information.

    Type : < GetFulfillmentPreviewItem > array

    # GetFulfillmentPreviewRequest

    The request body schema for the getFulfillmentPreview operation.

    Name Description Schema
    marketplaceId
    optional
    The marketplace the fulfillment order is placed against. string
    address
    required
    The destination address for the fulfillment order preview. Address
    items
    required
    Identifying information and quantity information for the items in the fulfillment order preview. GetFulfillmentPreviewItemList
    shippingSpeedCategories
    optional
    A list of shipping methods used for creating fulfillment order previews.

    Possible values:

  • Standard - Standard shipping method.

  • Expedited - Expedited shipping method.

  • Priority - Priority shipping method.

  • ScheduledDelivery - Scheduled Delivery shipping method.

  • Note: Shipping method service level agreements vary by marketplace. Sellers should see the Seller Central website in their marketplace for shipping method service level agreements and fulfillment fees.
    ShippingSpeedCategoryList
    includeCODFulfillmentPreview
    optional
    Specifies whether to return fulfillment order previews that are for COD (Cash On Delivery).

    Possible values:

  • true - Returns all fulfillment order previews (both for COD and not for COD).

  • false - Returns only fulfillment order previews that are not for COD.
  • boolean
    includeDeliveryWindows
    optional
    Specifies whether to return the ScheduledDeliveryInfo response object, which contains the available delivery windows for a Scheduled Delivery. The ScheduledDeliveryInfo response object can only be returned for fulfillment order previews with ShippingSpeedCategories = ScheduledDelivery. boolean
    featureConstraints
    optional
    A list of features and their fulfillment policies to apply to the order. < FeatureSettings > array

    # GetFulfillmentPreviewResult

    A list of fulfillment order previews, including estimated shipping weights, estimated shipping fees, and estimated ship dates and arrival dates.

    Name Description Schema
    fulfillmentPreviews
    optional
    An array of fulfillment preview information. FulfillmentPreviewList

    # GetFulfillmentPreviewResponse

    The response schema for the getFulfillmentPreview operation.

    Name Description Schema
    payload
    optional
    The response payload for the getFulfillmentPreview operation. GetFulfillmentPreviewResult
    errors
    optional
    One or more unexpected errors occurred during the getFulfillmentPreview operation. ErrorList

    # InvalidItemReasonCode

    A code for why the item is invalid for return.

    Type : enum

    Value Description
    InvalidValues The item was not found in a fulfillment order.
    DuplicateRequest A fulfillment return has already been requested for this item.
    NoCompletedShipItems The fulfillment order containing this item has not yet shipped.
    NoReturnableQuantity All item quantity available for return has been allocated to other return items.

    # InvalidItemReason

    The reason that the item is invalid for return.

    Name Description Schema
    invalidItemReasonCode
    required
    A code for why the item is invalid for return. InvalidItemReasonCode
    description
    required
    A human readable description of the invalid item reason code. string

    # InvalidReturnItem

    An item that is invalid for return.

    Name Description Schema
    sellerReturnItemId
    required
    An identifier assigned by the seller to the return item. string
    sellerFulfillmentOrderItemId
    required
    The identifier assigned to the item by the seller when the fulfillment order was created. string
    invalidItemReason
    required
    The reason that the item is invalid for return. InvalidItemReason

    # InvalidReturnItemList

    An array of invalid return item information.

    Type : < InvalidReturnItem > array

    # ListAllFulfillmentOrdersResult

    Name Description Schema
    nextToken
    optional
    When present and not empty, pass this string token in the next request to return the next response page. string
    fulfillmentOrders
    optional
    An array of fulfillment order information. < FulfillmentOrder > array

    # ListAllFulfillmentOrdersResponse

    The response schema for the listAllFulfillmentOrders operation.

    Name Description Schema
    payload
    optional
    The payload for the listAllFulfillmentOrders operation. ListAllFulfillmentOrdersResult
    errors
    optional
    One or more unexpected errors occurred during the listAllFulfillmentOrders operation. ErrorList

    # ListReturnReasonCodesResult

    Name Description Schema
    reasonCodeDetails
    optional
    An array of return reason code details. ReasonCodeDetailsList

    # ListReturnReasonCodesResponse

    The response schema for the listReturnReasonCodes operation.

    Name Description Schema
    payload
    optional
    The payload for the listReturnReasonCodes operation. ListReturnReasonCodesResult
    errors
    optional
    One or more unexpected errors occurred during the listReturnReasonCodes operation. ErrorList

    # NotificationEmailList

    A list of email addresses that the seller provides that are used by Amazon to send ship-complete notifications to recipients on behalf of the seller.

    Type : < string > array

    # CurrentStatus

    The current delivery status of the package.

    Type : enum

    Value Description
    IN_TRANSIT In transit to the destination address.
    DELIVERED Delivered to the destination address.
    RETURNING In the process of being returned to Amazon's fulfillment network.
    RETURNED Returned to Amazon's fulfillment network.
    UNDELIVERABLE Undeliverable because package was lost or destroyed.
    DELAYED Delayed.
    AVAILABLE_FOR_PICKUP Available for pickup.
    CUSTOMER_ACTION Requires customer action.
    UNKNOWN Unknown Status Code was returned.
    OUT_FOR_DELIVERY Out for Delivery.
    DELIVERY_ATTEMPTED Delivery Attempted.
    PICKUP_SUCCESSFUL Pickup Successful.
    PICKUP_CANCELLED Pickup Cancelled.
    PICKUP_ATTEMPTED Pickup Attempted.
    PICKUP_SCHEDULED Pickup Scheduled.
    RETURN_REQUEST_ACCEPTED Return Request Accepted.
    REFUND_ISSUED Refund Issued.
    RETURN_RECEIVED_IN_FC Return Received In FC.

    # AdditionalLocationInfo

    Additional location information.

    Type : enum

    Value Description
    AS_INSTRUCTED As instructed.
    CARPORT Carport.
    CUSTOMER_PICKUP Picked up by customer.
    DECK Deck.
    DOOR_PERSON Resident.
    FRONT_DESK Front desk.
    FRONT_DOOR Front door.
    GARAGE Garage.
    GUARD Residential guard.
    MAIL_ROOM Mail room.
    MAIL_SLOT Mail slot.
    MAILBOX Mailbox.
    MC_BOY Delivered to male child.
    MC_GIRL Delivered to female child.
    MC_MAN Delivered to male adult.
    MC_WOMAN Delivered to female adult.
    NEIGHBOR Delivered to neighbor.
    OFFICE Office.
    OUTBUILDING Outbuilding.
    PATIO Patio.
    PORCH Porch.
    REAR_DOOR Rear door.
    RECEPTIONIST Receptionist.
    RECEIVER Resident.
    SECURE_LOCATION Secure location.
    SIDE_DOOR Side door.

    # PackageTrackingDetails

    Name Description Schema
    packageNumber
    required
    The package identifier. integer (int32)
    trackingNumber
    optional
    The tracking number for the package. string
    customerTrackingLink
    optional
    Link on swiship.com that allows customers to track the package. string
    carrierCode
    optional
    The name of the carrier. string
    carrierPhoneNumber
    optional
    The phone number of the carrier. string
    carrierURL
    optional
    The URL of the carrier’s website. string
    shipDate
    optional
    The shipping date for the package. Timestamp
    estimatedArrivalDate
    optional
    The estimated arrival date. Timestamp
    shipToAddress
    optional
    The destination city for the package. TrackingAddress
    currentStatus
    optional
    The current delivery status of the package. CurrentStatus
    currentStatusDescription
    optional
    Description corresponding to the CurrentStatus value. string
    signedForBy
    optional
    The name of the person who signed for the package. string
    additionalLocationInfo
    optional
    Additional location information. AdditionalLocationInfo
    trackingEvents
    optional
    An array of tracking event information. TrackingEventList

    # GetPackageTrackingDetailsResponse

    The response schema for the getPackageTrackingDetails operation.

    Name Description Schema
    payload
    optional
    The payload for the getPackageTrackingDetails operation. PackageTrackingDetails
    errors
    optional
    One or more unexpected errors occurred during the getPackageTrackingDetails operation. ErrorList

    # ReasonCodeDetails

    A return reason code, a description, and an optional description translation.

    Name Description Schema
    returnReasonCode
    required
    A code that indicates a valid return reason. string
    description
    required
    A human readable description of the return reason code. string
    translatedDescription
    optional
    A translation of the description. The translation is in the language specified in the Language request parameter. string

    # ReasonCodeDetailsList

    An array of return reason code details.

    Type : < ReasonCodeDetails > array

    # ReturnAuthorization

    Return authorization information for items accepted for return.

    Name Description Schema
    returnAuthorizationId
    required
    An identifier for the return authorization. This identifier associates return items with the return authorization used to return them. string
    fulfillmentCenterId
    required
    An identifier for the Amazon fulfillment center that the return items should be sent to. string
    returnToAddress
    required
    The address of the Amazon fulfillment center that the return items should be sent to. Address
    amazonRmaId
    required
    The return merchandise authorization (RMA) that Amazon needs to process the return. string
    rmaPageURL
    required
    A URL for a web page that contains the return authorization barcode and the mailing label. This does not include pre-paid shipping. string

    # ReturnAuthorizationList

    An array of return authorization information.

    Type : < ReturnAuthorization > array

    # ReturnItem

    An item that Amazon accepted for return.

    Name Description Schema
    sellerReturnItemId
    required
    An identifier assigned by the seller to the return item. string
    sellerFulfillmentOrderItemId
    required
    The identifier assigned to the item by the seller when the fulfillment order was created. string
    amazonShipmentId
    required
    The identifier for the shipment that is associated with the return item. string
    sellerReturnReasonCode
    required
    The return reason code assigned to the return item by the seller. string
    returnComment
    optional
    An optional comment about the return item. string
    amazonReturnReasonCode
    optional
    The return reason code that the Amazon fulfillment center assigned to the return item. string
    status
    required
    Indicates if the return item has been processed by an Amazon fulfillment center. FulfillmentReturnItemStatus
    statusChangedDate
    required
    Indicates when the status last changed. Timestamp
    returnAuthorizationId
    optional
    Identifies the return authorization used to return this item. See ReturnAuthorization. string
    returnReceivedCondition
    optional
    The condition of the return item when received by an Amazon fulfillment center. ReturnItemDisposition
    fulfillmentCenterId
    optional
    The identifier for the Amazon fulfillment center that processed the return item. string

    # ReturnItemDisposition

    The condition of the return item when received by an Amazon fulfillment center.

    Type : enum

    Value Description
    Sellable Item is in sellable condition.
    Defective Item is defective.
    CustomerDamaged Item was damaged by the buyer or the seller.
    CarrierDamaged Item was damaged by the carrier.
    FulfillerDamaged Item was damaged by Amazon.

    # ReturnItemList

    An array of items that Amazon accepted for return. Returns empty if no items were accepted for return.

    Type : < ReturnItem > array

    # ScheduledDeliveryInfo

    Delivery information for a scheduled delivery.

    Name Description Schema
    deliveryTimeZone
    required
    The time zone of the destination address for the fulfillment order preview. Must be an IANA time zone name. Example: Asia/Tokyo. string
    deliveryWindows
    required
    An array of time ranges that are available for scheduled delivery. DeliveryWindowList

    # ShippingSpeedCategoryList

    Type : < ShippingSpeedCategory > array

    # StringList

    Type : < string > array

    # Timestamp

    Type : string (date-time)

    # TrackingAddress

    Address information for tracking the package.

    Name Description Schema
    city
    required
    The city.
    maxLength : 150
    string
    state
    required
    The state.
    maxLength : 150
    string
    country
    required
    The country.
    maxLength : 6
    string

    # EventCode

    The event code for the delivery event.

    Type : enum

    Value Description
    EVENT_101 Carrier notified to pick up package.
    EVENT_102 Shipment picked up from seller's facility.
    EVENT_201 Arrival scan.
    EVENT_202 Departure scan.
    EVENT_203 Arrived at destination country.
    EVENT_204 Initiated customs clearance process.
    EVENT_205 Completed customs clearance process.
    EVENT_206 In transit to pickup location.
    EVENT_301 Delivered.
    EVENT_302 Out for delivery.
    EVENT_304 Delivery attempted.
    EVENT_306 Customer contacted to arrange delivery.
    EVENT_307 Delivery appointment scheduled.
    EVENT_308 Available for pickup.
    EVENT_309 Returned to seller.
    EVENT_401 Held by carrier - incorrect address.
    EVENT_402 Customs clearance delay.
    EVENT_403 Customer moved.
    EVENT_404 Delay in delivery due to external factors.
    EVENT_405 Shipment damaged.
    EVENT_406 Held by carrier.
    EVENT_407 Customer refused delivery.
    EVENT_408 Returning to seller.
    EVENT_409 Lost by carrier.
    EVENT_411 Paperwork received - did not receive shipment.
    EVENT_412 Shipment received - did not receive paperwork.
    EVENT_413 Held by carrier - customer refused shipment due to customs charges.
    EVENT_414 Missorted by carrier.
    EVENT_415 Received from prior carrier.
    EVENT_416 Undeliverable.
    EVENT_417 Shipment missorted.
    EVENT_418 Shipment delayed.
    EVENT_419 Address corrected - delivery rescheduled.

    # TrackingEvent

    Information for tracking package deliveries.

    Name Description Schema
    eventDate
    required
    The date and time that the delivery event took place, in ISO 8601 date time format. Timestamp
    eventAddress
    required
    The city where the delivery event took place. TrackingAddress
    eventCode
    required
    The event code for the delivery event. EventCode
    eventDescription
    required
    A description for the corresponding event code. string

    # TrackingEventList

    An array of tracking event information.

    Type : < TrackingEvent > array

    # UnfulfillablePreviewItem

    Information about unfulfillable items in a fulfillment order preview.

    Name Description Schema
    sellerSku
    required
    The seller SKU of the item.
    maxLength : 50
    string
    quantity
    required
    The item quantity. Quantity
    sellerFulfillmentOrderItemId
    required
    A fulfillment order item identifier created with a call to the getFulfillmentPreview operation.
    maxLength : 50
    string
    itemUnfulfillableReasons
    optional
    Error codes associated with the fulfillment order preview that indicate why the item is unfulfillable. StringList

    # UnfulfillablePreviewItemList

    An array of unfulfillable preview item information.

    Type : < UnfulfillablePreviewItem > array

    # UpdateFulfillmentOrderItem

    Item information for updating a fulfillment order.

    Name Description Schema
    sellerSku
    optional
    The seller SKU of the item. string
    sellerFulfillmentOrderItemId
    required
    Identifies the fulfillment order item to update. Created with a previous call to the createFulfillmentOrder operation.
    maxLength : 50
    string
    quantity
    required
    The item quantity. Quantity
    giftMessage
    optional
    A message to the gift recipient, if applicable.
    maxLength : 512
    string
    displayableComment
    optional
    Item-specific text that displays in recipient-facing materials such as the outbound shipment packing slip.
    maxLength : 250
    string
    fulfillmentNetworkSku
    optional
    Amazon's fulfillment network SKU of the item. string
    orderItemDisposition
    optional
    Indicates whether the item is sellable or unsellable. string
    perUnitDeclaredValue
    optional
    The monetary value assigned by the seller to this item. Money
    perUnitPrice
    optional
    The amount to be collected from the recipient for this item in a COD (Cash On Delivery) order. Money
    perUnitTax
    optional
    The tax on the amount to be collected from the recipient for this item in a COD (Cash On Delivery) order. Money

    # UpdateFulfillmentOrderItemList

    An array of fulfillment order item information for updating a fulfillment order.

    Type : < UpdateFulfillmentOrderItem > array

    # UpdateFulfillmentOrderRequest

    Name Description Schema
    marketplaceId
    optional
    The marketplace the fulfillment order is placed against. string
    displayableOrderId
    optional
    A fulfillment order identifier that the seller creates. This value displays as the order identifier in recipient-facing materials such as the outbound shipment packing slip. The value of DisplayableOrderId should match the order identifier that the seller provides to the recipient. The seller can use the SellerFulfillmentOrderId for this value or they can specify an alternate value if they want the recipient to reference an alternate order identifier.
    maxLength : 40
    string
    displayableOrderDate
    optional
    The date and time of the fulfillment order. Displays as the order date in recipient-facing materials such as the outbound shipment packing slip. Timestamp
    displayableOrderComment
    optional
    Order-specific text that appears in recipient-facing materials such as the outbound shipment packing slip.
    maxLength : 1000
    string
    shippingSpeedCategory
    optional
    The shipping method used for the fulfillment order. ShippingSpeedCategory
    destinationAddress
    optional
    The destination address for the fulfillment order. Address
    fulfillmentAction
    optional
    Specifies whether the fulfillment order should ship now or have an order hold put on it. FulfillmentAction
    fulfillmentPolicy
    optional
    The FulfillmentPolicy value specified when you submitted the createFulfillmentOrder operation. FulfillmentPolicy
    shipFromCountryCode
    optional
    The two-character country code for the country from which the fulfillment order ships. Must be in ISO 3166-1 alpha-2 format. string
    notificationEmails
    optional
    A list of email addresses that the seller provides that are used by Amazon to send ship-complete notifications to recipients on behalf of the seller. NotificationEmailList
    featureConstraints
    optional
    A list of features and their fulfillment policies to apply to the order. < FeatureSettings > array
    items
    optional
    A list of items to include in the fulfillment order preview, including quantity. UpdateFulfillmentOrderItemList

    # UpdateFulfillmentOrderResponse

    The response schema for the updateFulfillmentOrder operation.

    Name Description Schema
    errors
    optional
    One or more unexpected errors occurred during the updateFulfillmentOrder operation. ErrorList

    # CreateFulfillmentOrderResponse

    The response schema for the createFulfillmentOrder operation.

    Name Description Schema
    errors
    optional
    One or more unexpected errors occurred during the createFulfillmentOrder operation. ErrorList

    # CancelFulfillmentOrderResponse

    The response schema for the cancelFulfillmentOrder operation.

    Name Description Schema
    errors
    optional
    One or more unexpected errors occurred during the cancelFulfillmentOrder operation. ErrorList

    # Weight

    The weight.

    Name Description Schema
    unit
    required
    The unit of weight. enum (Unit)
    value
    required
    The weight value. string

    # Quantity

    The item quantity.

    Type : integer (int32)

    # ShippingSpeedCategory

    The shipping method used for the fulfillment order.

    Type : enum

    Value Description
    Standard Standard shipping method.
    Expedited Expedited shipping method.
    Priority Priority shipping method.
    ScheduledDelivery Scheduled Delivery shipping method.

    # GetFeatureInventoryResponse

    The breakdown of eligibility inventory by feature.

    Name Description Schema
    payload
    optional
    The payload for the getEligibileInventory operation. GetFeatureInventoryResult
    errors
    optional
    One or more unexpected errors occurred during the getFeatureInventory operation. ErrorList

    # GetFeatureInventoryResult

    The payload for the getEligibileInventory operation.

    Name Description Schema
    marketplaceId
    required
    The requested marketplace. string
    featureName
    required
    The name of the feature. string
    nextToken
    optional
    When present and not empty, pass this string token in the next request to return the next response page. string
    featureSkus
    optional
    An array of SKUs eligible for this feature and the quantity available. < FeatureSku > array

    # FeatureSku

    Information about an SKU, including the count available, identifiers, and a list of overlapping SKUs that share the same inventory pool.

    Name Description Schema
    sellerSku
    optional
    Used to identify an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit. string
    fnSku
    optional
    The unique SKU used by Amazon's fulfillment network. string
    asin
    optional
    The Amazon Standard Identification Number (ASIN) of the item. string
    skuCount
    optional
    The number of SKUs available for this service. number
    overlappingSkus
    optional
    Other seller SKUs that are shared across the same inventory. < string > array

    # GetFeaturesResponse

    The response schema for the getFeatures operation.

    Name Description Schema
    payload
    optional
    The payload for the getFeatures operation. GetFeaturesResult
    errors
    optional
    A list of error responses returned when a request is unsuccessful. ErrorList

    # GetFeaturesResult

    The payload for the getFeatures operation.

    Name Description Schema
    features
    required
    An array of features. Features

    # Features

    An array of features.

    Type : < Feature > array

    # Feature

    A Multi-Channel Fulfillment feature.

    Name Description Schema
    featureName
    required
    The feature name. string
    featureDescription
    required
    The feature description. string
    sellerEligible
    optional
    When true, indicates that the seller is eligible to use the feature. boolean

    # GetFeatureSkuResponse

    The response schema for the getFeatureSKU operation.

    Name Description Schema
    payload
    optional
    The payload for the getFeatureSKU operation. GetFeatureSkuResult
    errors
    optional
    A list of error responses returned when a request is unsuccessful. ErrorList

    # GetFeatureSkuResult

    The payload for the getFeatureSKU operation.

    Name Description Schema
    marketplaceId
    required
    The requested marketplace. string
    featureName
    required
    The name of the feature. string
    isEligible
    required
    When true, the seller SKU is eligible for the requested feature. boolean
    ineligibleReasons
    optional
    A list of one or more reasons that the seller SKU is ineligibile for the feature.

    Possible values:
  • MERCHANT_NOT_ENROLLED - The merchant isn't enrolled for the feature.

  • SKU_NOT_ELIGIBLE - The SKU doesn't reside in a warehouse that supports the feature.

  • INVALID_SKU - There is an issue with the SKU provided.
  • < string > array
    skuInfo
    optional
    Information about the SKU, including the count available, identifiers, and a list of overlapping SKUs that share the same inventory pool. FeatureSku

    # FeatureSettings

    FeatureSettings allows users to apply fulfillment features to an order. To block an order from being shipped using Amazon Logistics (AMZL) and an AMZL tracking number, use featureName as BLOCK_AMZL and featureFulfillmentPolicy as Required. Blocking AMZL will incur an additional fee surcharge on your MCF orders and increase the risk of some of your orders being unfulfilled or delivered late if there are no alternative carriers available. Using BLOCK_AMZL in an order request will take precedence over your Seller Central account setting.

    Name Description Schema
    featureName
    optional
    The name of the feature. string
    featureFulfillmentPolicy
    optional
    Specifies the policy to use when fulfilling an order. enum (FeatureFulfillmentPolicy)

    # FulfillmentShipmentStatus

    The current status of the shipment.

    Type : enum

    Value Description
    PENDING The process of picking units from inventory has begun.
    SHIPPED All packages in the shipment have left the fulfillment center.
    CANCELLED_BY_FULFILLER The Amazon fulfillment center could not fulfill the shipment as planned. This might be because the inventory was not at the expected location in the fulfillment center. After cancelling the fulfillment order, Amazon immediately creates a new fulfillment shipment and again attempts to fulfill the order.
    CANCELLED_BY_SELLER The shipment was cancelled using the CancelFulfillmentOrder request.

    # FeatureFulfillmentPolicy

    Specifies the policy to use when fulfilling an order.

    Type : enum

    Value Description
    Required If the offer can't be shipped with the selected feature, reject the order.
    NotRequired The feature is not required for shipping.

    # Unit

    The unit of weight.

    Type : enum

    Value Description
    KG Kilograms.
    KILOGRAMS Kilograms.
    LB Pounds.
    POUNDS Pounds.

    # Name

    The type of fee.

    Type : enum

    Value Description
    FBAPerUnitFulfillmentFee Estimated fee for each unit in the fulfillment order.
    FBAPerOrderFulfillmentFee Estimated order-level fee.
    FBATransportationFee Estimated shipping fee.
    FBAFulfillmentCODFee Estimated COD (Cash On Delivery) fee. This fee applies only to fulfillment order previews for COD.

    # ShippingWeightCalculationMethod

    The method used to calculate the estimated shipping weight.

    Type : enum

    Value Description
    Package Based on the actual weight of the items.
    Dimensional Based on the cubic space that the items occupy.