Create FBA shipments

The whole Send-to-Amazon run — plan, pack, compare placement fees, pick transport, print labels, upload tracking — by conversation or by code, with your STA sheet as the record.

In short

One sentence starts the plan. You see Amazon's placement fees before anything is confirmed. Labels and tracking follow. Every step is a tool your agent calls — and your own code can call the same tool with the same arguments.

The shipment day, step by step

Start with one sentence

"Create an FBA shipment for these 5 SKUs, 40 units each." fbaInbound_orchestrate_packing creates the inbound plan and starts Amazon's packing, placement and transport options in one call. fbaInbound_create_sta_sheet gives you an STA spreadsheet that records the whole run.

Compare placement fees before you commit

fbaInbound_listPlacementOptions shows Amazon's warehouse splits with their fees — often the difference between a free split across several warehouses and a paid single destination. You pick; your agent runs fbaInbound_confirm_plan_options, which confirms placement and transport in one step. Confirming cannot be undone for that plan, so the money is shown first.

Pack, label, hand over to the carrier

fbaInbound_setPackingInformation records what went into each box. fbaInbound_create_packing_list writes the packing list from Amazon's own box IDs, fbaInbound_get_labels downloads the box-label PDF into the plan folder, and fbaInbound_createMarketplaceItemLabels prints FNSKU labels when your products need them.

Track it until Amazon checks it in

fbaInbound_updateShipmentTrackingDetails uploads the carrier's tracking. fbaInbound_sync_shipment_status answers "has Amazon received it yet?" on any day after. Delivering it yourself? fbaInbound_getSelfShipAppointmentSlots and fbaInbound_scheduleSelfShipAppointment book the dock appointment.

Try asking

"Create an FBA shipment for SKU-A ×40 and SKU-B ×24 from my warehouse — show me the placement options and fees before you confirm anything."

Step 2, both ways

The same tool and the same arguments — through your AI client, or from your own code.

MCP — you ask: "Show me the placement options and fees for this plan before confirming anything." Your agent calls fbaInbound_listPlacementOptions, lays the splits and fees out for you, and waits for your pick.

In an AI client (MCP)

tools/call
{
  "name": "fbaInbound_listPlacementOptions",
  "arguments": {
    "store": "myStore-US",
    "plan_id": "<plan id from step 1>"
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/fbaInbound_listPlacementOptions \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","plan_id":"<plan id from step 1>"}'
Early access — the Tool API is open on request, contact us.

Write access required

Creating plans, confirming options, packing and uploading tracking change your seller account, so the store needs write access (see Stay in control). Reading plans, options and status works with read access.

Tools on this page

Pulled from the catalog at build time, each with its own access label. The workflow tools above call the single-step tools below for you; reach for those when you want to run one step on its own. Most generate/list pairs are asynchronous: generate starts the job on Amazon, list reads its result.

ToolAccessWhat it does
fbaInbound_orchestrate_packingwriteCreate an FBA inbound plan through to PLACEMENT OPTIONS and stop: setPrepDetails → createInboundPlan → generate and confirm the packing option → setPackingInformation → generatePla
fbaInbound_create_sta_sheetwriteCreate the plan workbook for an FBA inbound plan — the SAME workbook the sidebar's "Create STA SS" builds, so the sidebar buttons can continue any step: the stepper tab (STA-BoxFir
fbaInbound_listPlacementOptionsreadList placement options for a plan (read, one page).
fbaInbound_confirm_plan_optionsdestructiveConfirm the human's placement option and, per shipment, the transport option (+ delivery window) in one call — after the human approved them from fbaInbound_generate_shipment_optio
fbaInbound_setPackingInformationdestructiveSet box packing information per shipment/group (Amazon write, async).
fbaInbound_create_packing_listwritePacking list from Amazon's OWN box contents.
fbaInbound_get_labelswriteDownload the box-label PDF of a confirmed shipment (v0 getLabels): the server fetches Amazon's downloadURL, cuts the pages to the label size and returns the PDF base64.
fbaInbound_createMarketplaceItemLabelswriteCreate FNSKU item labels for a list of MSKUs (write).
fbaInbound_updateShipmentTrackingDetailsdestructiveUpload carrier tracking for one shipment to Amazon.
fbaInbound_sync_shipment_statusreadOne shipment's current Amazon status plus a terminal flag — a cheap poll; for the full shipment object use fbaInbound_getShipment.

Every FBA inbound tool:

ToolAccessWhat it does
fbaInbound_cancelInboundPlandestructiveCancel an FBA inbound plan.
fbaInbound_cancelSelfShipAppointmentdestructiveCancel a self-ship appointment (write, async).
fbaInbound_confirm_plan_optionsdestructiveConfirm the human's placement option and, per shipment, the transport option (+ delivery window) in one call — after the human approved them from fbaInbound_generate_shipment_optio
fbaInbound_confirmDeliveryWindowOptionsdestructiveConfirm a delivery window option for a shipment (write, async).
fbaInbound_confirmPackingOptiondestructiveConfirm a packing option (Amazon write — irreversible for this plan).
fbaInbound_confirmPlacementOptiondestructiveConfirm one placement option of an inbound plan; the server waits until Amazon's operation finishes.
fbaInbound_confirmShipmentContentUpdatePreviewdestructiveConfirm a content update preview, accepting the cost change (write, async).
fbaInbound_confirmTransportationOptionsdestructiveConfirm the chosen transportation option per shipment (write, async).
fbaInbound_create_packing_listwritePacking list from Amazon's OWN box contents.
fbaInbound_create_sta_sheetwriteCreate the plan workbook for an FBA inbound plan — the SAME workbook the sidebar's "Create STA SS" builds, so the sidebar buttons can continue any step: the stepper tab (STA-BoxFir
fbaInbound_createInboundPlanwriteCreate an FBA inbound plan on Amazon (single-step).
fbaInbound_createMarketplaceItemLabelswriteCreate FNSKU item labels for a list of MSKUs (write).
fbaInbound_generate_shipment_optionswriteThe transportation options + delivery windows for ONE placement option: the cheapest `limit` partnered options per shipping mode and, when named, one carrier type.
fbaInbound_generateDeliveryWindowOptionswriteStart generating delivery window options for one shipment (USE_YOUR_OWN_CARRIER).
fbaInbound_generatePackingOptionswriteStart generating packing options for a plan (async).
fbaInbound_generatePlacementOptionswriteStart generating placement options for a plan (async).
fbaInbound_generateSelfShipAppointmentSlotswriteGenerate self-ship appointment slots for a shipment (write, async).
fbaInbound_generateShipmentContentUpdatePreviewswriteGenerate content update previews for revised box content (write, async).
fbaInbound_generateTransportationOptionswriteStart generating transportation options for a placement option (async).
fbaInbound_get_labelswriteDownload the box-label PDF of a confirmed shipment (v0 getLabels): the server fetches Amazon's downloadURL, cuts the pages to the label size and returns the PDF base64.
fbaInbound_get_plan_statusreadList every placement option of an inbound plan (all pages) — a quick existence and stage probe before a phase.
fbaInbound_getDeliveryChallanDocumentreadFetch the delivery challan document of an India (IN) shipment that uses Amazon-partnered (PCP) transport (read).
fbaInbound_getInboundOperationStatusreadPoll getInboundOperationStatus for a previously started async operation.
fbaInbound_getInboundPlanreadFetch the raw inbound plan object from Amazon (read-only).
fbaInbound_getSelfShipAppointmentSlotsreadList available self-ship appointment slots (read, one page).
fbaInbound_getShipmentreadFetch a single shipment object from Amazon (read).
fbaInbound_getShipmentContentUpdatePreviewreadFetch a single content update preview (read).
fbaInbound_listDeliveryWindowOptionsreadList delivery window options for a shipment (after generate completed).
fbaInbound_listInboundPlanBoxesreadList all boxes in an inbound plan (read, one page).
fbaInbound_listInboundPlanItemsreadList the items (msku/fnsku/quantity/prep) in an inbound plan (read, one page).
fbaInbound_listInboundPlanPalletsreadList all pallets in an inbound plan (read, one page; LTL/FTL freight).
fbaInbound_listInboundPlansreadList inbound plans for a store (one page per call).
fbaInbound_listItemComplianceDetailsreadList inbound compliance (tax) details for MSKUs (read).
fbaInbound_listPackingGroupBoxesreadList boxes in a packing group (read, one page; provided via setPackingInformation).
fbaInbound_listPackingGroupItemsreadList items in a packing group (read, one page; Box First).
fbaInbound_listPackingOptionsreadList packing options after generatePackingOptions completed.
fbaInbound_listPlacementOptionsreadList placement options for a plan (read, one page).
fbaInbound_listPrepDetailsreadGet preparation details + owner constraints for MSKUs (read).
fbaInbound_listShipmentBoxesreadList boxes in a shipment (read, one page).
fbaInbound_listShipmentContentUpdatePreviewsreadList content update previews in a shipment (read, one page).
fbaInbound_listShipmentItemsreadList item packages in a shipment (read, one page).
fbaInbound_listShipmentPalletsreadList pallets in a shipment (read, one page; LTL/FTL freight).
fbaInbound_listTransportationOptionsreadList transportation options after generateTransportationOptions completed.
fbaInbound_orchestrate_packingwriteCreate an FBA inbound plan through to PLACEMENT OPTIONS and stop: setPrepDetails → createInboundPlan → generate and confirm the packing option → setPackingInformation → generatePla
fbaInbound_scheduleSelfShipAppointmentwriteBook, or reschedule, a self-ship appointment on a chosen slot (write, synchronous).
fbaInbound_setPackingInformationdestructiveSet box packing information per shipment/group (Amazon write, async).
fbaInbound_setPrepDetailsdestructiveSet preparation details (category + types) for MSKUs (write, async).
fbaInbound_sync_shipment_statusreadOne shipment's current Amazon status plus a terminal flag — a cheap poll; for the full shipment object use fbaInbound_getShipment.
fbaInbound_updateInboundPlanNamewriteRename an inbound plan (write, synchronous).
fbaInbound_updateItemComplianceDetailsdestructiveUpdate India (IN) compliance tax details for MSKUs (write, async).
fbaInbound_updateShipmentNamewriteRename a shipment (write, synchronous).
fbaInbound_updateShipmentSourceAddressdestructiveUpdate a shipment's source address (write, async).
fbaInbound_updateShipmentTrackingDetailsdestructiveUpload carrier tracking for one shipment to Amazon.
fbaInboundEligibility_getItemEligibilityPreviewreadCheck whether an ASIN is eligible for FBA inbound (or commingling) (read).
fbaInventory_getInventorySummariesreadLive FBA inventory for one or a few SKUs right now (read, one page) — e.g.

FAQ

Can I check stock before I plan?

Yes — fbaInventory_getInventorySummaries returns Amazon's live fulfillable and inbound counts for the SKUs you are about to send. See FBA inventory.

Will my agent pick an option for me?

Not unless you name the rule ("always take the cheapest placement"). Otherwise it shows you the options and waits.

Can I do this in the Google Sheets add-on instead?

Yes — the FBA panel of the add-on runs the same steps from the STA sheet. See the add-on buttons.

Is there a skill for this?

Yes — the fba-inbound skill walks your agent through the whole run. See Install the skills.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude