fbaInbound_generateDeliveryWindowOptions

Start generating delivery window options for one shipment (USE_YOUR_OWN_CARRIER).

writeAmazon Seller (SP-API)sp.fulfillmentInbound_2024-03-20

Amazon SP-API · generateDeliveryWindowOptions · POST /inbound/fba/2024-03-20/inboundPlans/{inboundPlanId}/shipments/{shipmentId}/deliveryWindowOptions Gate: approve — interactive: show the change (Amazon's preview first where one exists), wait for an explicit approve; autopilot: only when the seller's own words asked for this change; otherwise ask. Non-partnered carrier flow only. Amazon generates available delivery windows asynchronously — poll the returned operationId, then call fbaInbound_listDeliveryWindowOptions. Not supported in the IN marketplace ("GenerateDeliveryWindowOptions is not supported for the Indian marketplace") — on IN, confirm transportation directly without a delivery window.

Call it

In an AI client (MCP)

tools/call
{
  "name": "fbaInbound_generateDeliveryWindowOptions",
  "arguments": {
    "store": "myStore-US",
    "plan_id": "<plan_id>",
    "shipment_id": "<shipment_id>"
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/fbaInbound_generateDeliveryWindowOptions \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","plan_id":"<plan_id>","shipment_id":"<shipment_id>"}'
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.
plan_idrequiredstringthe inboundPlanId (from fbaInbound_createInboundPlan or fbaInbound_listInboundPlans).
shipment_idrequiredstringthe shipmentId (from the placement option's shipmentIds in fbaInbound_listPlacementOptions, or fbaInbound_getInboundPlan once a placement is confirmed).

Result

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

  • data.operationId — poll with fbaInbound_getInboundOperationStatus until SUCCESS.
  • data.status — 'IN_PROGRESS'.

Workflow

  • 1. fbaInbound_generateTransportationOptions for the placement reached SUCCESS (an own-carrier option exists). 2. Call this tool per shipment, poll the operation, then fbaInbound_listDeliveryWindowOptions. 3. Confirm the window (fbaInbound_confirmDeliveryWindowOptions, after the placement is confirmed) BEFORE fbaInbound_confirmTransportationOptions.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude