HomeDocumentationCode SamplesAPI ReferenceAnnouncementsModelsRelease NotesFAQGitHubVideos
Developer HubAPI StatusSupport
API Reference
Developer HubAPI StatusSupport
Start typing to search…

getFulfillmentPreview

post https://sellingpartnerapi-na.amazon.com/fba/outbound/2020-07-01/fulfillmentOrders/preview

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

Usage Plan:

Rate (requests per second)Burst
230

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above 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 Selling Partner API.

Body Params

GetFulfillmentPreviewRequest parameter

string

The marketplace the fulfillment order is placed against.

address
object
required

A physical address.

items
array of objects
required

An array of fulfillment preview item information.

items*
shippingSpeedCategories
array of strings

ShippingSpeedCategory List

Show Details
StandardStandard shipping method.
ExpeditedExpedited shipping method.
PriorityPriority shipping method.
ScheduledDeliveryScheduled Delivery shipping method. This is only available in the JP marketplace.
shippingSpeedCategories
boolean

When true, returns all fulfillment order previews both for COD and not for COD. Otherwise, returns only fulfillment order previews that are not for COD.

boolean

When true, returns 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.

featureConstraints
array of objects

A list of features and their fulfillment policies to apply to the order.

featureConstraints
Responses

Response body
object
payload
object

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

fulfillmentPreviews
array of objects

An array of fulfillment preview information.

fulfillmentPreviews
object
string
required

The shipping method used for the fulfillment order. When this value is ScheduledDelivery, choose Ship for the fulfillmentAction. Hold is not a valid fulfillmentAction value when the shippingSpeedCategory value is ScheduledDelivery.
Note: Shipping method service level agreements vary by marketplace. Sellers should refer to the Seller Central website in their marketplace for shipping method service level agreements and fulfillment fees.

Standard Expedited Priority ScheduledDelivery

Show Details
StandardStandard shipping method.
ExpeditedExpedited shipping method.
PriorityPriority shipping method.
ScheduledDeliveryScheduled Delivery shipping method. This is only available in the JP marketplace.
scheduledDeliveryInfo
object

Delivery information for a scheduled delivery. This is only available in the JP marketplace.

boolean
required

When true, this fulfillment order preview is fulfillable.

boolean
required

When true, this fulfillment order preview is for COD (Cash On Delivery).

estimatedShippingWeight
object

The weight.

estimatedFees
array of objects

An array of fee type and cost pairs.

estimatedFees
object
string
required

The type of fee.

FBAPerUnitFulfillmentFee FBAPerOrderFulfillmentFee FBATransportationFee FBAFulfillmentCODFee

Show Details
FBAPerUnitFulfillmentFeeEstimated fee for each unit in the fulfillment order.
FBAPerOrderFulfillmentFeeEstimated order-level fee.
FBATransportationFeeEstimated shipping fee.
FBAFulfillmentCODFeeEstimated COD (Cash On Delivery) fee. This fee applies only to fulfillment order previews for COD.
amount
object
required

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

fulfillmentPreviewShipments
array of objects

An array of fulfillment preview shipment information.

fulfillmentPreviewShipments
object
date-time

Date timestamp

date-time

Date timestamp

date-time

Date timestamp

date-time

Date timestamp

shippingNotes
array of strings

Provides additional insight into the shipment timeline when exact delivery dates are not able to be precomputed.

shippingNotes
fulfillmentPreviewItems
array of objects
required

An array of fulfillment preview item information.

fulfillmentPreviewItems*
object
string
required

The seller SKU of the item.

int32
required

The item quantity.

string
required

A fulfillment order item identifier that the seller created with a call to the createFulfillmentOrder operation.

estimatedShippingWeight
object

The weight.

string

The method used to calculate the estimated shipping weight.

Package Dimensional

Show Details
PackageBased on the actual weight of the items.
DimensionalBased on the cubic space that the items occupy.
unfulfillablePreviewItems
array of objects

An array of unfulfillable preview item information.

unfulfillablePreviewItems
object
string
required
length ≤ 50

The seller SKU of the item.

int32
required

The item quantity.

string
required
length ≤ 50

A fulfillment order item identifier created with a call to the getFulfillmentPreview operation.

itemUnfulfillableReasons
array of strings

String list

itemUnfulfillableReasons
orderUnfulfillableReasons
array of strings

String list

orderUnfulfillableReasons
string
required

The marketplace the fulfillment order is placed against.

featureConstraints
array of objects

A list of features and their fulfillment policies to apply to the order.

featureConstraints
object
string

The name of the feature.

string

Specifies the policy to use when fulfilling an order.

Required NotRequired

Show Details
RequiredIf the offer can't be shipped with the selected feature, reject the order.
NotRequiredThe feature is not required for shipping.
errors
array of objects

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

errors
object
string
required

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

string
required

A message that describes the error condition.

string

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

Headers
object
string

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

string

Unique request reference identifier.

Updated 3 months ago

Did this page help you?
Language

Updated 3 months ago

Did this page help you?