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)
{
"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>"}'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.
| Tool | Access | What it does |
|---|---|---|
fbaInbound_orchestrate_packing | write | Create an FBA inbound plan through to PLACEMENT OPTIONS and stop: setPrepDetails → createInboundPlan → generate and confirm the packing option → setPackingInformation → generatePla |
fbaInbound_create_sta_sheet | write | Create 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_listPlacementOptions | read | List placement options for a plan (read, one page). |
fbaInbound_confirm_plan_options | destructive | Confirm 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_setPackingInformation | destructive | Set box packing information per shipment/group (Amazon write, async). |
fbaInbound_create_packing_list | write | Packing list from Amazon's OWN box contents. |
fbaInbound_get_labels | write | Download 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_createMarketplaceItemLabels | write | Create FNSKU item labels for a list of MSKUs (write). |
fbaInbound_updateShipmentTrackingDetails | destructive | Upload carrier tracking for one shipment to Amazon. |
fbaInbound_sync_shipment_status | read | One shipment's current Amazon status plus a terminal flag — a cheap poll; for the full shipment object use fbaInbound_getShipment. |
Every FBA inbound tool:
| Tool | Access | What it does |
|---|---|---|
fbaInbound_cancelInboundPlan | destructive | Cancel an FBA inbound plan. |
fbaInbound_cancelSelfShipAppointment | destructive | Cancel a self-ship appointment (write, async). |
fbaInbound_confirm_plan_options | destructive | Confirm 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_confirmDeliveryWindowOptions | destructive | Confirm a delivery window option for a shipment (write, async). |
fbaInbound_confirmPackingOption | destructive | Confirm a packing option (Amazon write — irreversible for this plan). |
fbaInbound_confirmPlacementOption | destructive | Confirm one placement option of an inbound plan; the server waits until Amazon's operation finishes. |
fbaInbound_confirmShipmentContentUpdatePreview | destructive | Confirm a content update preview, accepting the cost change (write, async). |
fbaInbound_confirmTransportationOptions | destructive | Confirm the chosen transportation option per shipment (write, async). |
fbaInbound_create_packing_list | write | Packing list from Amazon's OWN box contents. |
fbaInbound_create_sta_sheet | write | Create 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_createInboundPlan | write | Create an FBA inbound plan on Amazon (single-step). |
fbaInbound_createMarketplaceItemLabels | write | Create FNSKU item labels for a list of MSKUs (write). |
fbaInbound_generate_shipment_options | write | The transportation options + delivery windows for ONE placement option: the cheapest `limit` partnered options per shipping mode and, when named, one carrier type. |
fbaInbound_generateDeliveryWindowOptions | write | Start generating delivery window options for one shipment (USE_YOUR_OWN_CARRIER). |
fbaInbound_generatePackingOptions | write | Start generating packing options for a plan (async). |
fbaInbound_generatePlacementOptions | write | Start generating placement options for a plan (async). |
fbaInbound_generateSelfShipAppointmentSlots | write | Generate self-ship appointment slots for a shipment (write, async). |
fbaInbound_generateShipmentContentUpdatePreviews | write | Generate content update previews for revised box content (write, async). |
fbaInbound_generateTransportationOptions | write | Start generating transportation options for a placement option (async). |
fbaInbound_get_labels | write | Download 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_status | read | List every placement option of an inbound plan (all pages) — a quick existence and stage probe before a phase. |
fbaInbound_getDeliveryChallanDocument | read | Fetch the delivery challan document of an India (IN) shipment that uses Amazon-partnered (PCP) transport (read). |
fbaInbound_getInboundOperationStatus | read | Poll getInboundOperationStatus for a previously started async operation. |
fbaInbound_getInboundPlan | read | Fetch the raw inbound plan object from Amazon (read-only). |
fbaInbound_getSelfShipAppointmentSlots | read | List available self-ship appointment slots (read, one page). |
fbaInbound_getShipment | read | Fetch a single shipment object from Amazon (read). |
fbaInbound_getShipmentContentUpdatePreview | read | Fetch a single content update preview (read). |
fbaInbound_listDeliveryWindowOptions | read | List delivery window options for a shipment (after generate completed). |
fbaInbound_listInboundPlanBoxes | read | List all boxes in an inbound plan (read, one page). |
fbaInbound_listInboundPlanItems | read | List the items (msku/fnsku/quantity/prep) in an inbound plan (read, one page). |
fbaInbound_listInboundPlanPallets | read | List all pallets in an inbound plan (read, one page; LTL/FTL freight). |
fbaInbound_listInboundPlans | read | List inbound plans for a store (one page per call). |
fbaInbound_listItemComplianceDetails | read | List inbound compliance (tax) details for MSKUs (read). |
fbaInbound_listPackingGroupBoxes | read | List boxes in a packing group (read, one page; provided via setPackingInformation). |
fbaInbound_listPackingGroupItems | read | List items in a packing group (read, one page; Box First). |
fbaInbound_listPackingOptions | read | List packing options after generatePackingOptions completed. |
fbaInbound_listPlacementOptions | read | List placement options for a plan (read, one page). |
fbaInbound_listPrepDetails | read | Get preparation details + owner constraints for MSKUs (read). |
fbaInbound_listShipmentBoxes | read | List boxes in a shipment (read, one page). |
fbaInbound_listShipmentContentUpdatePreviews | read | List content update previews in a shipment (read, one page). |
fbaInbound_listShipmentItems | read | List item packages in a shipment (read, one page). |
fbaInbound_listShipmentPallets | read | List pallets in a shipment (read, one page; LTL/FTL freight). |
fbaInbound_listTransportationOptions | read | List transportation options after generateTransportationOptions completed. |
fbaInbound_orchestrate_packing | write | Create an FBA inbound plan through to PLACEMENT OPTIONS and stop: setPrepDetails → createInboundPlan → generate and confirm the packing option → setPackingInformation → generatePla |
fbaInbound_scheduleSelfShipAppointment | write | Book, or reschedule, a self-ship appointment on a chosen slot (write, synchronous). |
fbaInbound_setPackingInformation | destructive | Set box packing information per shipment/group (Amazon write, async). |
fbaInbound_setPrepDetails | destructive | Set preparation details (category + types) for MSKUs (write, async). |
fbaInbound_sync_shipment_status | read | One shipment's current Amazon status plus a terminal flag — a cheap poll; for the full shipment object use fbaInbound_getShipment. |
fbaInbound_updateInboundPlanName | write | Rename an inbound plan (write, synchronous). |
fbaInbound_updateItemComplianceDetails | destructive | Update India (IN) compliance tax details for MSKUs (write, async). |
fbaInbound_updateShipmentName | write | Rename a shipment (write, synchronous). |
fbaInbound_updateShipmentSourceAddress | destructive | Update a shipment's source address (write, async). |
fbaInbound_updateShipmentTrackingDetails | destructive | Upload carrier tracking for one shipment to Amazon. |
fbaInboundEligibility_getItemEligibilityPreview | read | Check whether an ASIN is eligible for FBA inbound (or commingling) (read). |
fbaInventory_getInventorySummaries | read | Live 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.