Seller Labs API (SLAPI) Documentation

RESOURCES

MACROS

VERBS

REPORTS

Send item to FBA /v1/doSendToFBA

The doSendToFBA macro is intended to greatly simply the process of adding items to an FBA shipment. It will add to existing shipments to the same fulfillment center if available. If attempting to add to an existing shipment fails, or if there is no open shipment to a fulfillment center, it will create new shipments for those items.

Internally it roughly performs the equivalent of the following API calls:

Creates an inbound shipment plan:

GET /fbaCreateInboundShipmentPlan?msku=[[MSKU]]&quantity=[[QUANTITY]] HTTP/1.1

For each shipment in the plan it:

Determine if we have an open shipment to the specified Fulfillment Center ID / Prep Type

GET /settings/OPEN_SHIPMENT_[[MERCHANT_ID]]_[[MARKETPLACE_ID]]_[[FULFILLMENT_CENTER_ID]]_[[PREP_TYPE]] HTTP/1.1

If no shipment is currenly open, it creates a new location:

POST /locations?type=fbaShipment&name=[[SHIPMENT_ID]] HTTP/1.1

Increments the quantity of the item at the location:

POST /itemLocations/[[itemLocationID]]?increment=[[QUANTITY_FOR_THIS_SHIPMENT]] HTTP/1.1

PUT /settings/OPEN_SHIPMENT_[[MERCHANT_ID]]_[[MARKETPLACE_ID]]_[[FULFILLMENT_CENTER_ID]]_[[PREP_TYPE]]?value=locationId HTTP/1.1

It does a number of other error-checking and error-catching things along the way to try and ensure that the process completes. For example, if the FBA Shipment is closed, it will create a new FBA shipment automatically.

Sample Request

    GET https://api.sellerlabs.com/v1/doSendToFBA?msku=abc12345&quantity=20&from=123 HTTP/1.1

Request Parameters

msku	REQUIRED The msku of the item that you'd like to send to FBA
quntity	REQUIRED The quantity of the item that you'd like to send to FBA
fromLocationId	CONDITIONALLY REQUIRED (if fromPurchaseId is not specified) The locationId of the location that you'd like to move the inventory from. If specified, the quantity in this location will be decremented
fromPurchaseId	CONDITIONALLY REQUIRED (if fromLocationId is not specified). The purchase this item is coming from.
venueId	CONDITIONALLY REQUIRED. If you have more than one Amazon account, you must specify the venueId for the account which you'd like to use

Sample Response

HTTP/1.1 200 OK
Content-Length: 253
Keep-Alive: timeout=5, max=99
Connection: Keep-Alive
Content-Type: application/json

{
    "status": "success",
    "code": 200,
    "httpCode": "200",
    "user": "117",
    "data": {
        "FBA1JSVKTD": {
            "shipmentId": "FBA1JSVKTD",
            "fnsku": "X000J7UMOJ",
            "fnskuLabel": "https:\/\/api.sellerlabs.com\/fnskuLabel?msku=ABC123&fnsku=X000J7UMOJ",
            "quantity": "1",
            "fc": "PHX6",
            "prepType": "SELLER_LABEL",
            "newShipment": false,
            "itemLocation": {
                "id": "69",
                "msku": "ABC123",
                "locationId": "92",
                "quantity": "2",
                "modified": "2013-12-30T19:14:59+00:00Z",
                "acknowledged": null,
                "link": "https:\/\/api.sellerlabs.com\/v1\/itemLocations\/69"
            }
        },
        "FBA1JSVDQZ": {
            "shipmentId": "FBA1JSVDQZ",
            "fnsku": "X000J7UMOJ",
            "fnskuLabel": "https:\/\/api.sellerlabs.com\/fnskuLabel?msku=ABC123&fnsku=X000J7UMOJ",
            "quantity": "2",
            "fc": "CHA1",
            "prepType": "SELLER_LABEL",
            "newShipment": false,
            "itemLocation": {
                "id": "68",
                "msku": "ABC123",
                "locationId": "91",
                "quantity": "6",
                "modified": "2013-12-30T19:14:59+00:00Z",
                "acknowledged": null,
                "link": "https:\/\/api.sellerlabs.com\/v1\/itemLocations\/68"
            }
        },
        "FBA1JSTV45": {
            "shipmentId": "FBA1JSTV45",
            "fnsku": "X000J7UMOJ",
            "fnskuLabel": "https:\/\/api.sellerlabs.com\/fnskuLabel?msku=ABC123&fnsku=X000J7UMOJ",
            "quantity": "2",
            "fc": "RIC2",
            "prepType": "SELLER_LABEL",
            "newShipment":false,
            "itemLocation": {
                "id": "66",
                "msku": "ABC123",
                "locationId": "89",
                "quantity": "14",
                "modified": "2013-12-30T19:15:00+00:00Z",
                "acknowledged": null,
                "link": "https:\/\/api.sellerlabs.com\/v1\/itemLocations\/66"
            }
        }
    }
}

Response Parameters

[[INDEX]]	The FBA Shipment ID
fnsku	The Fulfillment Center SKU (FNSKU), or Amazon FBA SKU for your item. These currently start with X000
fnskuLabel	A URL that can be used for viewing and printing the label. You can append a width= and height= parameter to this URL to limit the width and height of the label
quantity	The quantity of the item that belongs in this shipment that were just added. Note that if there were existing items with the same quantity in this shipment, this quantity is in ADDITION to those. The itemLocation.quantity parameter contains the total number of this msku in the shipment.
fc	The abbreviabation of the Fulfillment Center ID (ie: PHX6 or IND4)
prepType	The Prep Type required for this shipment. SELLER_LABEL means that the seller must label each individual item
newShipment	boolean parameter that alerts you if a new FBA shipment was created
itemLocation	A container for an itemLocations object. Note that the quantity under this parameter is the total quantity for the shipment if there were already items with this msku in the shipment

API Documentation

CONTENTS