createInboundPlan

post https://sellingpartnerapi-na.amazon.com/inbound/fba/2024-03-20/inboundPlans

Creates an inbound plan. An inbound plan contains all the necessary information to send shipments into Amazon's fufillment network.

Usage Plan:

Rate (requests per second)	Burst
2	2

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.

Body Params

The body of the request to createInboundPlan.

destinationMarketplaces

array of strings

required

length between 1 and 1

Marketplaces where the items need to be shipped to. Currently only one marketplace can be selected in this request.

destinationMarketplaces*

items

array of objects

required

length between 1 and 2000

Items included in this plan.

items*

expiration

string

The expiration date of the MSKU. In ISO 8601 datetime format with pattern YYYY-MM-DD. Items with the same MSKU but different expiration dates cannot go into the same box.

labelOwner

string

required

Specifies who will label the items. Options include AMAZON, SELLER or NONE.

Show Details

AMAZON	Amazon provides the information.
SELLER	Seller provides the information.
NONE	No owner is required for the labelling.

manufacturingLotCode

string

length between 1 and 256

The manufacturing lot code.

msku

string

required

length between 1 and 40

The merchant SKU, a merchant-supplied identifier of a specific SKU.

prepOwner

string

required

The owner of the preparations, if special preparations are required.

Show Details

AMAZON	Amazon provides the information.
SELLER	The seller provides the information.
NONE	No owner is required for the preparations.

quantity

integer

required

1 to 10000

The number of units of the specified MSKU that will be shipped.

name

string

length between 1 and 40

Name for the Inbound Plan. If one isn't provided, a default name will be provided.

sourceAddress

object

required

Specific details to identify a place.

202

CreateInboundPlan 202 response

400

Request has missing or invalid parameters and cannot be parsed.

403

Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404

The resource specified does not exist.

413

The request size exceeded the maximum accepted size.

415

The request payload is in an unsupported format.

429

The frequency of requests was greater than allowed.

500

An unexpected condition occurred that prevented the server from fulfilling the request.

503

Temporary overloading or maintenance of the server.

xxxxxxxxxx
curl --request POST \
     --url https://sellingpartnerapi-na.amazon.com/inbound/fba/2024-03-20/inboundPlans \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "items": [
    {
      "labelOwner": "AMAZON",
      "prepOwner": "AMAZON"
    }
  ]
}
'

x-amzn-RequestId	Unique request reference identifier.
x-amzn-RateLimit-Limit	Your rate limit (requests per second) for this operation.

202CreateInboundPlan 202 response

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.