Fulfillment Inbound API v2024-03-20 Model
Swagger model for the Fulfillment Inbound API v2024-03-20.
{
"swagger": "2.0",
"info": {
"contact": {
"name": "Selling Partner API Developer Support",
"url": "https://sellercentral.amazon.com/gp/mws/contactus.html"
},
"description": "The Selling Partner API for Fulfillment By Amazon (FBA) Inbound. The FBA Inbound API enables building inbound workflows to create, manage, and send shipments into Amazon's fulfillment network. The API has interoperability with the Send-to-Amazon user interface.",
"license": {
"name": "Apache License 2.0",
"url": "http://www.apache.org/licenses/LICENSE-2.0"
},
"title": "The Selling Partner API for FBA inbound operations.",
"version": "2024-03-20"
},
"host": "sellingpartnerapi-na.amazon.com",
"schemes": [
"https"
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"paths": {
"/inbound/fba/2024-03-20/inboundPlans": {
"get": {
"produces": [
"application/json"
],
"parameters": [
{
"description": "The number of inbound plans to return in the response matching the given query.",
"in": "query",
"maximum": 30,
"minimum": 1,
"name": "pageSize",
"type": "integer",
"default": 10
},
{
"description": "A token to fetch a certain page when there are multiple pages worth of results. The value of this token is fetched from the `pagination` returned in the API response. In the absence of the token value from the query parameter the API returns the first page of the result.",
"in": "query",
"maxLength": 1024,
"minLength": 0,
"name": "paginationToken",
"type": "string"
},
{
"description": "The status of an inbound plan.",
"enum": [
"ACTIVE",
"VOIDED",
"SHIPPED"
],
"in": "query",
"name": "status",
"type": "string",
"x-docgen-enum-table-extension": [
{
"value": "ACTIVE",
"description": "An inbound plan that is being worked on."
},
{
"value": "VOIDED",
"description": "An inbound plan with all shipment cancelled and can no longer be modified."
},
{
"value": "SHIPPED",
"description": "A completed inbound plan. Only minor modifications can be made at this time."
}
]
},
{
"description": "Sort by field.",
"enum": [
"LAST_UPDATED_TIME",
"CREATION_TIME"
],
"in": "query",
"name": "sortBy",
"type": "string",
"x-docgen-enum-table-extension": [
{
"value": "LAST_UPDATED_TIME",
"description": "Last updated time of the inbound plan."
},
{
"value": "CREATION_TIME",
"description": "Inbound plan creation time."
}
]
},
{
"description": "The sort order.",
"enum": [
"ASC",
"DESC"
],
"in": "query",
"name": "sortOrder",
"type": "string",
"x-docgen-enum-table-extension": [
{
"value": "ASC",
"description": "Ascending order."
},
{
"value": "DESC",
"description": "Descending order."
}
]
}
],
"responses": {
"200": {
"description": "ListInboundPlans 200 response",
"schema": {
"$ref": "#/definitions/ListInboundPlansResponse"
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"status": {
"value": "ACTIVE"
},
"sortBy": {
"value": "LAST_UPDATED_TIME"
},
"sortOrder": {
"value": "ASC"
},
"pageSize": {
"value": 2
},
"paginationToken": {
"value": "paginationToken"
}
}
},
"response": {
"inboundPlans": [
{
"inboundPlanId": "wf1234abcd-1234-abcd-5678-1234abcd5678",
"name": "FBA (03/08/2023, 01:15 PM)",
"createdAt": "2023-03-08T13:15:30Z",
"lastUpdatedAt": "2023-03-08T13:15:30Z",
"status": "ACTIVE",
"marketplaceIds": [
"A2EUQ1WTGCTBG2"
],
"sourceAddress": {
"name": "name",
"companyName": "Acme",
"addressLine1": "123 example street",
"addressLine2": "Unit 102",
"city": "Toronto",
"countryCode": "CA",
"stateOrProvinceCode": "ON",
"postalCode": "M1M1M1",
"phoneNumber": "1234567890",
"email": "[email protected]"
}
},
{
"inboundPlanId": "wf2234abcd-1234-abcd-5678-1234abcd5678",
"name": "FBA (03/08/2023, 01:15 PM)",
"createdAt": "2023-03-08T13:15:30Z",
"lastUpdatedAt": "2023-03-08T13:15:30Z",
"status": "ACTIVE",
"marketplaceIds": [
"A2EUQ1WTGCTBG2"
],
"sourceAddress": {
"name": "name",
"companyName": "Acme",
"addressLine1": "123 example street",
"addressLine2": "Unit 102",
"city": "Toronto",
"countryCode": "CA",
"stateOrProvinceCode": "ON",
"postalCode": "M1M1M1",
"phoneNumber": "1234567890",
"email": "[email protected]"
}
}
],
"pagination": {
"nextToken": "nextPaginationToken"
}
}
}
]
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"type": "string"
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"status": {
"value": "badStatus"
},
"sortBy": {
"value": "LAST_UPDATED_TIME"
},
"sortOrder": {
"value": "ASC"
},
"pageSize": {
"value": 5
}
}
},
"response": {
"errors": [
{
"code": "BadRequest",
"message": "The status is invalid."
}
]
}
}
]
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"type": "string"
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"type": "string"
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
}
},
"tags": [
"fbaInbound"
],
"description": "Provides a list of inbound plans with minimal information.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 6 |\n\nThe `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](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"operationId": "listInboundPlans"
},
"post": {
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"$ref": "#/definitions/CreateInboundPlanRequest"
},
"description": "The body of the request to `createInboundPlan`."
}
],
"responses": {
"202": {
"description": "CreateInboundPlan 202 response",
"schema": {
"$ref": "#/definitions/CreateInboundPlanResponse"
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"name": "FBA (03/20/2024, 12:01 PM)",
"sourceAddress": {
"name": "name",
"companyName": "Acme",
"addressLine1": "123 example street",
"addressLine2": "Unit 102",
"city": "Toronto",
"countryCode": "CA",
"stateOrProvinceCode": "ON",
"postalCode": "M1M1M1",
"phoneNumber": "1234567890",
"email": "[email protected]"
},
"destinationMarketplaces": [
"A2EUQ1WTGCTBG2"
],
"items": [
{
"msku": "msku",
"prepOwner": "AMAZON",
"labelOwner": "AMAZON",
"quantity": 2,
"expiration": "2024-01-01",
"manufacturingLotCode": "lotCode"
}
]
}
}
}
},
"response": {
"inboundPlanId": "wf1234abcd-1234-abcd-5678-1234abcd5678",
"operationId": "1234abcd-1234-abcd-5678-1234abcd5678"
}
}
]
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"type": "string"
}
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"name": "FBA (03/20/2024, 12:01 PM)",
"sourceAddress": {
"name": "name",
"companyName": "Acme",
"addressLine1": "123 example street",
"addressLine2": "Unit 102",
"city": "Toronto",
"countryCode": "CA",
"stateOrProvinceCode": "ON",
"postalCode": "M1M1M1",
"phoneNumber": "1234567890",
"email": "[email protected]"
},
"destinationMarketplaces": [
"badMarketplace"
],
"items": [
{
"msku": "msku",
"prepOwner": "AMAZON",
"labelOwner": "AMAZON",
"quantity": 2,
"expiration": "2024-01-01",
"manufacturingLotCode": "lotCode"
}
]
}
}
}
},
"response": {
"errors": [
{
"code": "BadRequest",
"message": "Invalid destinationMarketplace provided."
}
]
}
}
]
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"type": "string"
}
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"type": "string"
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"type": "string"
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema":