fbaOutbound_getFulfillmentPreview

Preview an MCF order's fees and fulfillability BEFORE creating it.

readAmazon Seller (SP-API)sp.fulfillmentOutbound_2020-07-01

Amazon SP-API · getFulfillmentPreview · POST /fba/outbound/2020-07-01/fulfillmentOrders/preview Always preview first — it shows estimatedFees, isFulfillable, and available shippingSpeedCategory per option. Non-mutating.

Call it

In an AI client (MCP)

tools/call
{
  "name": "fbaOutbound_getFulfillmentPreview",
  "arguments": {
    "store": "myStore-US",
    "address": {},
    "items": []
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/fbaOutbound_getFulfillmentPreview \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","address":{},"items":[]}'
Early access — the Tool API is open on request, contact us.

Arguments

NameTypeDescription
storerequiredstringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
addressrequiredobjectDestination Address — name, addressLine1, postalCode, countryCode (ISO 3166-1 alpha-2) required; city/stateOrRegion/ phone optional.
itemsrequiredobject[]list of preview items — each {sellerSku, quantity, sellerFulfillmentOrderItemId (your tracking id), optional perUnitDeclaredValue {currencyCode, value}}.
shipping_speed_categoriesstring[]optional list of speed categories to preview; ScheduledDelivery requires include_delivery_windows here and a delivery_window on create. Allowed: Standard | Expedited | Priority | ScheduledDelivery.StandardExpeditedPriorityScheduledDelivery
include_codbooleanoptional bool — include Cash-On-Delivery previews.
include_delivery_windowsbooleanoptional bool — include scheduledDeliveryInfo.
feature_constraintsobject[]optional list of {featureName, featureFulfillmentPolicy} objects constraining carrier/packaging: featureName. Allowed: BLOCK_AMZL (block Amazon Logistics; surcharge) | BLANK_BOX (non-branded packaging) | OVERBOX | PACKING_SLIP | SIGNATURE_CONFIRMATION (US only; extra fee) | DELIVER_TOGETHER (ship all items together). featureFulfillmentPolicy Required rejects the order when the feature is unavailable.

Result

Every tool answers {notification, data, human_action}; data carries:

  • data.fulfillmentPreviews — one per shippingSpeedCategory — {shippingSpeedCategory, isFulfillable, isCODCapable, estimatedFees, fulfillmentPreviewShipments, unfulfillablePreviewItems, orderUnfulfillableReasons, scheduledDeliveryInfo}; the last three say why a preview is not fulfillable or when it can arrive.

Body (Amazon schema)

marketplaceId: string
address*: {name*, addressLine1*, addressLine2, addressLine3, city, districtOrCounty, stateOrRegion, postalCode*, countryCode*, phone}
items*: [{sellerSku* (max 50 chars), quantity*, perUnitDeclaredValue: {currencyCode*, value*}, sellerFulfillmentOrderItemId* (max 50 chars)}]
shippingSpeedCategories: [Standard | Expedited | Priority | ScheduledDelivery]
includeCODFulfillmentPreview: boolean
includeDeliveryWindows: boolean
featureConstraints: [{featureName, featureFulfillmentPolicy: Required | NotRequired}]

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude