{
"openapi": "3.0.1",
"info": {
"title": "The Selling Partner API for Amazon Warehousing and Distribution",
"description": "The Selling Partner API for Amazon Warehousing and Distribution (AWD) provides programmatic access to information about AWD shipments and inventory. ",
"contact": {
"name": "Selling Partner API Developer Support",
"url": "https://sellercentral.amazon.com/gp/mws/contactus.html"
},
"license": {
"name": "Apache License 2.0",
"url": "https://www.apache.org/licenses/LICENSE-2.0"
},
"version": "2024-05-09"
},
"servers": [
{
"url": "https://sellingpartnerapi-na.amazon.com/"
}
],
"paths": {
"/awd/2024-05-09/inboundOrders": {
"post": {
"tags": [
"awd"
],
"description": "Creates a draft AWD inbound order with a list of packages for inbound shipment. The operation creates one shipment per order. \n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\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 indicates 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": "createInbound",
"requestBody": {
"description": "Payload for creating an inbound order.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InboundOrderCreationData"
}
}
},
"required": true
},
"responses": {
"201": {
"description": "`createInbound` 201 response.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"Location": {
"description": "Location header with the order ID for the newly created inbound order.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InboundOrderReference"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"externalReferenceId": "string",
"originAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "City1",
"countryCode": "CC",
"district": "District1",
"name": "address_name",
"postalCode": "123456",
"stateOrRegion": "State1"
},
"packagesToInbound": [
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen",
"expiration": "2025-06-07T12:12:09.061Z",
"prepDetails": {
"prepCategory": "PERFORATED",
"prepOwner": "AMAZON",
"labelOwner": "SELF"
}
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
]
}
}
}
},
"response": {
"orderId": "TestOrderId"
},
"responseHeaders": {
"Location": {
"value": "TestOrderId"
}
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"externalReferenceId": "string",
"originAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "City1",
"countryCode": "CC",
"district": "District1",
"name": "address_name",
"postalCode": "123456",
"stateOrRegion": "State1"
},
"packagesToInbound": [
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen",
"expiration": "2025-06-07T12:12:09.061Z",
"prepDetails": {
"prepCategory": "PERFORATED",
"prepOwner": "AMAZON",
"labelOwner": "SELF"
}
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "TEST"
}
}
]
}
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"message": "Invalid value (`TEST`) passed for `DistributionPackageType`. Valid values are: `CASE`, `PALLET`",
"details": "This exception is thrown when client inputs are invalid."
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
},
"x-codegen-request-body-name": "body"
}
},
"/awd/2024-05-09/inboundOrders/{orderId}": {
"get": {
"tags": [
"awd"
],
"description": "Retrieves an AWD inbound order.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 2 |\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 indicates 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": "getInbound",
"parameters": [
{
"name": "orderId",
"in": "path",
"description": "The ID of the inbound order that you want to retrieve.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "The 200 response for `getInbound`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InboundOrder"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": "TestOrderId"
}
}
},
"response": {
"destinationDetails": {
"destinationAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "Seattle",
"countryCode": "US",
"county": "Washington",
"district": "District1",
"name": "address_name",
"phoneNumber": "+14155552671",
"postalCode": "123456",
"stateOrRegion": "Washington"
},
"destinationRegion": "us-east"
},
"createdAt": "2023-06-07T12:12:09.061Z",
"externalReferenceId": "TestReferenceId",
"orderId": "TestOrderId",
"orderStatus": "DRAFT",
"originAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "Seattle",
"countryCode": "US",
"county": "Washington",
"district": "District1",
"name": "address_name",
"phoneNumber": "+14155552671",
"postalCode": "123456",
"stateOrRegion": "Washington"
},
"packagesToInbound": [
{
"count": 1,
"distributionPackage": {
"contents": {
"packages": [],
"products": [
{
"quantity": 1,
"sku": "testPen",
"expiration": "2025-06-07T12:12:09.061Z",
"prepDetails": {
"prepCategory": "PERFORATED",
"prepOwner": "AMAZON",
"labelOwner": "SELF",
"prepInstructions": [
{
"prepType": "ITEM_POLYBAGGING",
"prepOwner": "AMAZON"
}
]
}
}
]
},
"measurements": {
"dimensions": {
"height": 2.54,
"length": 2.54,
"unitOfMeasurement": "CENTIMETERS",
"width": 2.54
},
"weight": {
"unitOfMeasurement": "KILOGRAMS",
"weight": 0.453592
}
},
"type": "CASE"
}
}
],
"updatedAt": "2023-06-07T12:12:09.061Z"
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": " "
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "OrderId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
},
"put": {
"tags": [
"awd"
],
"description": "Updates an AWD inbound order that is in `DRAFT` status and not yet confirmed. Use this operation to update the `packagesToInbound`, `originAddress` and `preferences` attributes.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\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 indicates 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": "updateInbound",
"parameters": [
{
"name": "orderId",
"in": "path",
"description": "The ID of the inbound order that you want to update.",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"description": "Represents an AWD inbound order.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InboundOrder"
}
}
},
"required": true
},
"responses": {
"204": {
"description": "The 204 response for `updateInbound`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": "TestOrderId1"
},
"body": {
"value": {
"createdAt": "2023-06-07T12:12:09.061Z",
"destinationDetails": {
"destinationAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "Seattle",
"countryCode": "US",
"county": "Washington",
"district": "District1",
"name": "address_name",
"phoneNumber": "+14155552671",
"postalCode": "123456",
"stateOrRegion": "Washington"
},
"destinationRegion": "us-east"
},
"orderId": "TestOrderId1",
"orderStatus": "DRAFT",
"originAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "City1",
"countryCode": "CC",
"district": "District1",
"name": "DestinationName",
"postalCode": "123456",
"stateOrRegion": "State1"
},
"packagesToInbound": [
{
"count": 2,
"distributionPackage": {
"contents": {
"packages": [],
"products": [
{
"quantity": 10,
"sku": "testPen",
"expiration": "2025-06-07T12:12:09.061Z",
"prepDetails": {
"prepCategory": "PERFORATED",
"prepOwner": "AMAZON",
"labelOwner": "SELF",
"prepInstructions": [
{
"prepType": "ITEM_POLYBAGGING",
"prepOwner": "AMAZON"
}
]
}
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "CENTIMETERS",
"width": 1
},
"weight": {
"unitOfMeasurement": "KILOGRAMS",
"weight": 1
}
},
"type": "CASE"
}
}
],
"updatedAt": "2023-06-07T12:12:09.061Z"
}
}
}
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": "TestOrderId1"
},
"body": {
"value": {
"destinationDetails": {
"destinationAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "Seattle",
"countryCode": "US",
"county": "Washington",
"district": "District1",
"name": "address_name",
"phoneNumber": "+14155552671",
"postalCode": "123456",
"stateOrRegion": "Washington"
},
"destinationRegion": "us-east"
},
"createdAt": "2023-06-07T12:12:09.061Z",
"orderId": "TestOrderId1",
"orderStatus": "DRAFT",
"originAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "City1",
"countryCode": "CC",
"district": "District1",
"name": "DestinationName",
"postalCode": "123456",
"stateOrRegion": "State1"
},
"packagesToInbound": [
{
"count": 2,
"distributionPackage": {
"contents": {
"packages": [],
"products": [
{
"quantity": 10,
"sku": "testPen",
"expiration": "2025-06-07T12:12:09.061Z",
"prepDetails": {
"prepCategory": "PERFORATED",
"prepOwner": "AMAZON",
"labelOwner": "SELF",
"prepInstructions": [
{
"prepType": "ITEM_POLYBAGGING",
"prepOwner": "AMAZON"
}
]
}
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "CENTIMETERS",
"width": 1
},
"weight": {
"unitOfMeasurement": "KILOGRAMS",
"weight": 1
}
},
"type": "TEST"
}
}
],
"updatedAt": "2023-06-07T12:12:09.061Z"
}
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"message": "Invalid value (`TEST`) passed for `DistributionPackageType`. Valid values are: `CASE`, `PALLET`",
"details": "This exception is thrown when client inputs are invalid."
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"409": {
"description": "`ConflictException` 409 response.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
},
"x-codegen-request-body-name": "body"
}
},
"/awd/2024-05-09/inboundOrders/{orderId}/cancellation": {
"post": {
"tags": [
"awd"
],
"description": "Cancels an AWD Inbound order and its associated shipment.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\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 indicates 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": "cancelInbound",
"parameters": [
{
"name": "orderId",
"in": "path",
"description": "The ID of the inbound order you want to cancel.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "The 204 response for `cancelInbound`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"example": [
{}
]
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": "TestOrderId1"
}
}
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": " "
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "OrderId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"409": {
"description": "`ConflictException` 409 response.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
}
},
"/awd/2024-05-09/inboundOrders/{orderId}/confirmation": {
"post": {
"tags": [
"awd"
],
"description": "Confirms an AWD inbound order in `DRAFT` status.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see 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": "confirmInbound",
"parameters": [
{
"name": "orderId",
"in": "path",
"description": "The ID of the inbound order that you want to confirm.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "The 204 response for `confirmInbound`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"example": [
{}
]
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": "TestOrderId1"
}
}
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": " "
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "OrderId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"409": {
"description": "`ConflictException` 409 response.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
}
},
"/awd/2024-05-09/inboundShipments/{shipmentId}": {
"get": {
"tags": [
"awd"
],
"description": "Retrieves an AWD inbound shipment.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see 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": "getInboundShipment",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"description": "ID for the shipment. A shipment contains the cases being inbounded.",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "skuQuantities",
"in": "query",
"description": "If equal to `SHOW`, the response includes the shipment SKU quantity details.\n\nDefaults to `HIDE`, in which case the response does not contain SKU quantities",
"schema": {
"type": "string",
"enum": [
"SHOW",
"HIDE"
],
"x-docgen-enum-table-extension": [
{
"description": "Show the additional SKU quantity details.",
"value": "SHOW"
},
{
"description": "Hide the additional SKU quantity details.",
"value": "HIDE"
}
]
},
"example": "SHOW",
"x-docgen-enum-table-extension": [
{
"description": "Show the additional SKU quantity details.",
"value": "SHOW"
},
{
"description": "Hide the additional SKU quantity details.",
"value": "HIDE"
}
]
}
],
"responses": {
"200": {
"description": "The 200 response for `getInboundShipment`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InboundShipment"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "TestShipmentId"
}
}
},
"response": {
"createdAt": "2023-06-07T12:12:09.061Z",
"destinationAddress": {
"addressLine1": "address_line_1",
"addressLine2": "address_line_2",
"addressLine3": "address_line_3",
"city": "City1",
"countryCode": "CC",
"district": "District1",
"name": "DestinationName",
"postalCode": "123456",
"stateOrRegion": "State1"
},
"orderId": "TestOrderId",
"originAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "City1",
"countryCode": "CC",
"district": "District1",
"name": "address_name",
"postalCode": "123456",
"stateOrRegion": "State1"
},
"receivedQuantity": [
{
"quantity": 0,
"unitOfMeasurement": "CASES"
}
],
"shipmentContainerQuantities": [
{
"count": 2,
"distributionPackage": {
"contents": {
"packages": [],
"products": [
{
"quantity": 20,
"sku": "testPen"
}
]
},
"measurements": {
"dimensions": {
"height": 33.02,
"length": 45.72,
"unitOfMeasurement": "CENTIMETERS",
"width": 15.24
},
"weight": {
"unitOfMeasurement": "KILOGRAMS",
"weight": 5.443104
}
},
"type": "CASE"
}
}
],
"shipmentId": "TestShipmentId",
"shipmentStatus": "CREATED",
"shipmentSkuQuantities": [
{
"sku": "testPen",
"expectedQuantity": {
"quantity": 2,
"unitOfMeasurement": "CASE"
},
"receivedQuantity": {
"quantity": 0,
"unitOfMeasurement": "CASE"
}
}
],
"updatedAt": "2023-06-07T12:12:09.061Z"
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"shipmentId": {
"value": " "
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "ShipmentId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
}
},
"/awd/2024-05-09/inboundShipments/{shipmentId}/labels": {
"get": {
"tags": [
"awd"
],
"description": "Retrieves the box labels for a shipment ID that you specify. This is an asynchronous operation. If the label status is `GENERATED`, then the label URL is available.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 2 |\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 indicates 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": "getInboundShipmentLabels",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"description": "ID for the shipment.",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
},
{
"name": "pageType",
"in": "query",
"description": "Page type for the generated labels. The default is `PLAIN_PAPER`.",
"schema": {
"type": "string",
"enum": [
"THERMAL_NONPCP",
"PLAIN_PAPER",
"LETTER_6"
],
"x-docgen-enum-table-extension": [
{
"description": "Use `THERMAL_NONPC` for a thermal printer. Supports non-Amazon-partnered shipments.",
"value": "THERMAL_NONPCP"
},
{
"description": "One label per sheet of US Letter paper. Only for non-Amazon-partnered shipments.",
"value": "PLAIN_PAPER"
},
{
"description": "Six labels per US Letter label sheet.",
"value": "LETTER_6"
}
]
},
"example": "PLAIN_PAPER",
"x-docgen-enum-table-extension": [
{
"description": "Use `THERMAL_NONPC` for a thermal printer. Supports non-Amazon-partnered shipments.",
"value": "THERMAL_NONPCP"
},
{
"description": "One label per sheet of US Letter paper. Only for non-Amazon-partnered shipments.",
"value": "PLAIN_PAPER"
},
{
"description": "Six labels per US Letter label sheet.",
"value": "LETTER_6"
}
]
},
{
"name": "formatType",
"in": "query",
"description": "The format type of the output file that contains your labels. The default format type is `PDF`.",
"schema": {
"type": "string",
"enum": [
"PDF"
],
"x-docgen-enum-table-extension": [
{
"description": "PDF format.",
"value": "PDF"
}
]
},
"example": "PDF",
"x-docgen-enum-table-extension": [
{
"description": "PDF format.",
"value": "PDF"
}
]
}
],
"responses": {
"200": {
"description": "The 200 response for `getInboundShipmentLabels`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ShipmentLabels"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "TestShipmentId"
}
}
},
"response": {
"labelDownloadURL": "TEST_URL",
"labelStatus": "GENERATED"
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"shipmentId": {
"value": " "
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "ShipmentId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
}
},
"/awd/2024-05-09/inboundShipments/{shipmentId}/transport": {
"put": {
"tags": [
"awd"
],
"description": "Updates transport details for an AWD shipment.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see 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": "updateInboundShipmentTransportDetails",
"parameters": [
{
"name": "shipmentId",
"in": "path",
"description": "The shipment ID.",
"required": true,
"schema": {
"minLength": 1,
"type": "string"
}
}
],
"requestBody": {
"description": "Transportation details for the shipment.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TransportationDetails"
}
}
},
"required": true
},
"responses": {
"204": {
"description": "The 204 response for `updateInboundShipmentTransportDetails`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"shipmentId": {
"value": "TestShipmentId"
},
"body": {
"value": {
"trackingDetails": [
{
"carrierCode": {
"carrierCodeType": "SCAC"
},
"bookingId": "TRACKING_ID"
}
]
}
}
}
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"shipmentId": {
"value": " "
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "ShipmentId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
},
"x-codegen-request-body-name": "body"
}
},
"/awd/2024-05-09/inboundEligibility": {
"post": {
"tags": [
"awd"
],
"description": "Determines if the packages you specify are eligible for an AWD inbound order and contains error details for ineligible packages.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\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 indicates 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": "checkInboundEligibility",
"requestBody": {
"description": "Represents the packages you want to inbound.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InboundPackages"
}
}
},
"required": true
},
"responses": {
"200": {
"description": "The 200 response for `checkInboundEligibility`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InboundEligibility"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"packagesToInbound": [
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "TestDVDSku"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
},
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
]
}
}
}
},
"response": {
"ineligibilityReasons": [],
"status": "INELIGIBLE",
"packagesToInbound": [
{
"ineligibilityReasons": [
{
"description": "You can't use the gating service to buy this item.",
"code": "GATING_BLOCK_ON_GL"
}
],
"status": "INELIGIBLE",
"packageQuantity": {
"count": 1,
"distributionPackage": {
"contents": {
"packages": [],
"products": [
{
"quantity": 1,
"sku": "TestDVDSku"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
},
{
"ineligibilityReasons": [],
"status": "ELIGIBLE",
"packageQuantity": {
"count": 1,
"distributionPackage": {
"contents": {
"packages": [],
"products": [
{
"quantity": 1,
"sku": "testPen"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
}
],
"previewedAt": "2025-06-20T19:30:58.466Z"
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"packagesToInbound": [
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "TestDVDSku"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
},
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "TEST"
}
}
]
}
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "OrderId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
},
"x-codegen-request-body-name": "body"
}
},
"/awd/2024-05-09/inboundShipments": {
"get": {
"tags": [
"awd"
],
"description": "Retrieves a summary of all the inbound AWD shipments associated with a merchant, with the ability to apply optional filters.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 1 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see 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": "listInboundShipments",
"parameters": [
{
"name": "sortBy",
"in": "query",
"description": "Field to sort results by. By default, the response will be sorted by UPDATED_AT.",
"schema": {
"type": "string",
"enum": [
"UPDATED_AT",
"CREATED_AT"
],
"x-docgen-enum-table-extension": [
{
"description": "Sort by the time of update.",
"value": "UPDATED_AT"
},
{
"description": "Sort by the time of creation.",
"value": "CREATED_AT"
}
]
},
"x-docgen-enum-table-extension": [
{
"description": "Sort by the time of update.",
"value": "UPDATED_AT"
},
{
"description": "Sort by the time of creation.",
"value": "CREATED_AT"
}
]
},
{
"name": "sortOrder",
"in": "query",
"description": "Sort the response in ASCENDING or DESCENDING order. By default, the response will be sorted in DESCENDING order.",
"schema": {
"type": "string",
"enum": [
"ASCENDING",
"DESCENDING"
],
"x-docgen-enum-table-extension": [
{
"description": "Sorts the collection in ascending order.",
"value": "ASCENDING"
},
{
"description": "Sorts the collection in descending order.",
"value": "DESCENDING"
}
]
},
"example": "ASCENDING",
"x-docgen-enum-table-extension": [
{
"description": "Sorts the collection in ascending order.",
"value": "ASCENDING"
},
{
"description": "Sorts the collection in descending order.",
"value": "DESCENDING"
}
]
},
{
"name": "shipmentStatus",
"in": "query",
"description": "Filter by inbound shipment status.",
"schema": {
"type": "string",
"enum": [
"CREATED",
"SHIPPED",
"IN_TRANSIT",
"RECEIVING",
"DELIVERED",
"CLOSED",
"CANCELLED"
],
"x-docgen-enum-table-extension": [
{
"description": "Shipment is created, but hasn't shipped.",
"value": "CREATED"
},
{
"description": "Shipment was picked up by the carrier or was dropped off with the carrier.",
"value": "SHIPPED"
},
{
"description": "The carrier has notified AWD that the shipment is in transit between the origin and destination nodes.",
"value": "IN_TRANSIT"
},
{
"description": "The shipment has been partially received.",
"value": "RECEIVING"
},
{
"description": "The shipment has reached the destination node and has been delivered to the facility yard. The shipment `receive` process at the warehouse will start soon.",
"value": "DELIVERED"
},
{
"description": "No more actions are required for the shipment. This is a final state.",
"value": "CLOSED"
},
{
"description": "The shipment is cancelled. This is a final state.",
"value": "CANCELLED"
}
]
},
"example": "CREATED",
"x-docgen-enum-table-extension": [
{
"description": "Shipment is created, but hasn't shipped.",
"value": "CREATED"
},
{
"description": "Shipment was picked up by the carrier or was dropped off with the carrier.",
"value": "SHIPPED"
},
{
"description": "The carrier has notified AWD that the shipment is in transit between the origin and destination nodes.",
"value": "IN_TRANSIT"
},
{
"description": "The shipment has been partially received.",
"value": "RECEIVING"
},
{
"description": "The shipment has reached the destination node and has been delivered to the facility yard. The shipment `receive` process at the warehouse will start soon.",
"value": "DELIVERED"
},
{
"description": "No more actions are required for the shipment. This is a final state.",
"value": "CLOSED"
},
{
"description": "The shipment is cancelled. This is a final state.",
"value": "CANCELLED"
}
]
},
{
"name": "updatedAfter",
"in": "query",
"description": "List the inbound shipments that were updated after a certain time (inclusive). The date must be in ISO 8601 format.",
"schema": {
"type": "string",
"format": "date-time"
},
"example": "2023-01-12T10:00:00.000Z"
},
{
"name": "updatedBefore",
"in": "query",
"description": "List the inbound shipments that were updated before a certain time (inclusive). The date must be in ISO 8601 format.",
"schema": {
"type": "string",
"format": "date-time"
},
"example": "2023-01-12T10:00:00.000Z"
},
{
"name": "maxResults",
"in": "query",
"description": "Maximum number of results to return.",
"schema": {
"maximum": 200,
"minimum": 1,
"type": "integer",
"format": "int32",
"default": 25
},
"example": "10"
},
{
"name": "nextToken",
"in": "query",
"description": "A token that is used to retrieve the next page of results. The response includes `nextToken` when the number of results exceeds the specified `maxResults` value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.",
"schema": {
"type": "string"
},
"example": "SampleToken"
}
],
"responses": {
"200": {
"description": "The 200 response for `listInboundShipments`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ShipmentListing"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {}
},
"response": {
"shipments": [
{
"createdAt": "2023-06-07T12:12:09.061Z",
"orderId": "TestOrderId",
"shipmentId": "TestShipmentId",
"shipmentStatus": "CREATED",
"updatedAt": "2023-06-07T12:12:09.061Z"
}
]
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sortBy": {
"value": "TEST"
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "Invalid shipment sortable field received: TEST"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
}
},
"/awd/2024-05-09/inventory": {
"get": {
"tags": [
"awd"
],
"description": "Lists AWD inventory associated with a merchant with the ability to apply optional filters.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 2 |\n\nThe `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see 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": "listInventory",
"parameters": [
{
"name": "sku",
"in": "query",
"description": "Filter by seller or merchant SKU for the item.",
"schema": {
"type": "string"
},
"example": "TestSKU"
},
{
"name": "sortOrder",
"in": "query",
"description": "Sort the response in `ASCENDING` or `DESCENDING` order.",
"schema": {
"type": "string",
"enum": [
"ASCENDING",
"DESCENDING"
],
"x-docgen-enum-table-extension": [
{
"description": "Sorts the collection in ascending order.",
"value": "ASCENDING"
},
{
"description": "Sorts the collection in descending order.",
"value": "DESCENDING"
}
]
},
"x-docgen-enum-table-extension": [
{
"description": "Sorts the collection in ascending order.",
"value": "ASCENDING"
},
{
"description": "Sorts the collection in descending order.",
"value": "DESCENDING"
}
]
},
{
"name": "details",
"in": "query",
"description": "Set to `SHOW` to return summaries with additional inventory details. Defaults to `HIDE,` which returns only inventory summary totals.",
"schema": {
"type": "string",
"enum": [
"SHOW",
"HIDE"
],
"x-docgen-enum-table-extension": [
{
"description": "Show the additional summarized inventory details.",
"value": "SHOW"
},
{
"description": "Hide the additional summarized inventory details.",
"value": "HIDE"
}
]
},
"example": "SHOW",
"x-docgen-enum-table-extension": [
{
"description": "Show the additional summarized inventory details.",
"value": "SHOW"
},
{
"description": "Hide the additional summarized inventory details.",
"value": "HIDE"
}
]
},
{
"name": "nextToken",
"in": "query",
"description": "A token that is used to retrieve the next page of results. The response includes `nextToken` when the number of results exceeds the specified `maxResults` value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.",
"schema": {
"type": "string"
},
"example": "SampleToken"
},
{
"name": "maxResults",
"in": "query",
"description": "Maximum number of results to return.",
"schema": {
"maximum": 200,
"minimum": 1,
"type": "integer",
"format": "int32",
"default": 25
},
"example": "10"
}
],
"responses": {
"200": {
"description": "The 200 response for `listInventory`.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InventoryListing"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {},
"response": {
"inventory": [
{
"totalOnhandQuantity": 20,
"totalInboundQuantity": 10,
"sku": "100TestSKU1Pen",
"inventoryDetails": {
"availableDistributableQuantity": 10,
"reservedDistributableQuantity": 10,
"replenishmentQuantity": 10
},
"expirationDetails": [
{
"onhandQuantity": 10,
"expiration": "2027-01-12T10:00:00.000Z"
},
{
"onhandQuantity": 10,
"expiration": "2028-01-12T10:00:00.000Z"
}
]
},
{
"totalOnhandQuantity": 20,
"totalInboundQuantity": 5,
"sku": "2U-BKEX-VW4D",
"inventoryDetails": {
"availableDistributableQuantity": 10,
"reservedDistributableQuantity": 10,
"replenishmentQuantity": 10
},
"expirationDetails": [
{
"onhandQuantity": 20,
"expiration": "2027-01-12T10:00:00.000Z"
}
]
}
]
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sortOrder": {
"value": "UNKNOWN"
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "Invalid value: UNKNOWN passed for sort order. Possible values are: [ASCENDING, DESCENDING]"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
}
},
"/awd/2024-05-09/replenishmentOrders": {
"get": {
"tags": [
"awd"
],
"description": "Retrieves all the AWD replenishment orders pertaining to a merchant with optional filters.\nAPI by default will sort orders by updatedAt attribute in descending order.",
"operationId": "listReplenishmentOrders",
"parameters": [
{
"name": "updatedAfter",
"in": "query",
"description": "Get the replenishment orders updated after certain time (Inclusive)\nDate should be in ISO 8601 format as defined by date-time in - https://www.rfc-editor.org/rfc/rfc3339.",
"schema": {
"type": "string",
"format": "date-time"
},
"example": "2023-01-12T10:00:00.000Z"
},
{
"name": "updatedBefore",
"in": "query",
"description": "Get the replenishment orders updated before certain time (Inclusive)\nDate should be in ISO 8601 format as defined by date-time in - https://www.rfc-editor.org/rfc/rfc3339.",
"schema": {
"type": "string",
"format": "date-time"
},
"example": "2023-01-12T10:00:00.000Z"
},
{
"name": "sortOrder",
"in": "query",
"description": "Sort the response in ASCENDING or DESCENDING order. The default sort order is DESCENDING.",
"schema": {
"type": "string",
"enum": [
"ASCENDING",
"DESCENDING"
],
"x-docgen-enum-table-extension": [
{
"description": "Sorts the collection in ascending order.",
"value": "ASCENDING"
},
{
"description": "Sorts the collection in descending order",
"value": "DESCENDING"
}
]
},
"example": "ASCENDING",
"x-docgen-enum-table-extension": [
{
"description": "Sorts the collection in ascending order.",
"value": "ASCENDING"
},
{
"description": "Sorts the collection in descending order",
"value": "DESCENDING"
}
]
},
{
"name": "maxResults",
"in": "query",
"description": "Maximum results to be returned in a single response.",
"schema": {
"maximum": 100,
"minimum": 1,
"type": "integer",
"format": "int32",
"default": 25
},
"example": "10"
},
{
"name": "nextToken",
"in": "query",
"description": "A token that is used to retrieve the next page of results. The response includes `nextToken` when the number of results exceeds the specified `maxResults` value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.",
"schema": {
"type": "string"
},
"example": "SampleToken"
}
],
"responses": {
"200": {
"description": "ListReplenishmentOrders 200 response",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ReplenishmentOrderListing"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {}
},
"response": {
"orders": [
{
"confirmedOn": "2024-08-11T23:20:50.520Z",
"createdAt": "2024-08-10T23:20:50.520Z",
"eligibleProducts": [],
"distributionIneligibleReasons": [],
"orderId": "TEST_ORDER_ID",
"status": "SUCCESS",
"outboundShipments": [],
"products": [],
"shippedProducts": []
}
]
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sortOrder": {
"value": "TEST"
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "Invalid sort order field: TEST"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
},
"post": {
"tags": [
"awd"
],
"description": "Creates an AWD replenishment order with given products to replenish.\nThe API will return the order ID of the newly created order and also start an async validation check on the products to e.\nThe order status will transition to ELIGIBLE/INELIGIBLE status from VALIDATING post validation check",
"operationId": "createReplenishmentOrder",
"requestBody": {
"description": "Payload for creating a replenishment order.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ReplenishmentOrderCreationData"
}
}
},
"required": true
},
"responses": {
"201": {
"description": "CreateReplenishmentOrder 201 response.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ReplenishmentOrderReference"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"products": [
{
"quantity": 20,
"sku": "TEST_SKU"
}
],
"preferences": {
"confirmation": "AUTO"
}
}
}
}
},
"response": {
"orderId": "TEST_ORDER_ID"
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"products": [
{
"quantity": 1,
"sku": "TEST_SKU"
}
]
}
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "Invalid package type: TEST"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
},
"x-codegen-request-body-name": "body"
}
},
"/awd/2024-05-09/replenishmentOrders/{orderId}": {
"get": {
"tags": [
"awd"
],
"description": "Retrieves an AWD Replenishment order with a set of shipments containing items that is/was planned to be replenished into an FBA node.",
"operationId": "getReplenishmentOrder",
"parameters": [
{
"name": "orderId",
"in": "path",
"description": "ID of the replenishment order to be retrieved.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "GetReplenishmentOrder 200 response.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ReplenishmentOrder"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": "TEST_ORDER_ID"
}
}
},
"response": {
"confirmedOn": "2024-08-11T23:20:50.520Z",
"createdAt": "2024-08-10T23:20:50.520Z",
"eligibleProducts": [],
"distributionIneligibleReasons": [],
"orderId": "TEST_ORDER_ID",
"status": "SUCCESS",
"outboundShipments": [],
"products": [],
"shippedProducts": []
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": " "
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "OrderId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
}
},
"/awd/2024-05-09/replenishmentOrders/{orderId}/confirmation": {
"post": {
"tags": [
"awd"
],
"description": "Confirms an AWD replenishment order in ELIGIBLE state with a set of shipments containing items that are needed to be replenished to an FBA node.\nOrder can only be confirmed in ELIGIBLE state.",
"operationId": "confirmReplenishmentOrder",
"parameters": [
{
"name": "orderId",
"in": "path",
"description": "ID of the replenishment order to be confirmed.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "ConfirmReplenishmentOrder 204 response",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"orderId": {
"value": " "
}
}
},
"response": {
"errors": [
{
"code": "BAD_REQUEST",
"details": "This exception is thrown when client inputs are invalid",
"message": "OrderId should be present for this request"
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"404": {
"description": "The resource specified does not exist.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
},
"x-amzn-RateLimit-Limit": {
"description": "Your rate limit (requests per second) for this operation.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"headers": {
"x-amzn-RequestId": {
"description": "Unique request reference identifier.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorList"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"Address": {
"required": [
"addressLine1",
"countryCode",
"name",
"stateOrRegion"
],
"type": "object",
"properties": {
"addressLine1": {
"type": "string",
"description": "First line of the address text."
},
"addressLine2": {
"type": "string",
"description": "Optional second line of the address text."
},
"addressLine3": {
"type": "string",
"description": "Optional third line of the address text."
},
"city": {
"type": "string",
"description": "Optional city where this address is located."
},
"countryCode": {
"type": "string",
"description": "Two-digit, ISO 3166-1 alpha-2 formatted country code where this address is located."
},
"county": {
"type": "string",
"description": "Optional county where this address is located.",
"example": "Washington"
},
"district": {
"type": "string",
"description": "Optional district where this address is located."
},
"name": {
"type": "string",
"description": "Name of the person, business, or institution at this address."
},
"phoneNumber": {
"type": "string",
"description": "Optional E.164-formatted phone number for an available contact at this address.",
"example": "+14155552671"
},
"postalCode": {
"type": "string",
"description": "Optional postal code where this address is located."
},
"stateOrRegion": {
"type": "string",
"description": "State or region where this address is located. Note that this is contextual to the specified country code."
}
},
"description": "Shipping address that represents the origin or destination location.",
"example": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "Seattle",
"countryCode": "US",
"county": "Washington",
"district": "District1",
"name": "address_name",
"phoneNumber": "+14155552671",
"postalCode": "123456",
"stateOrRegion": "Washington"
}
},
"CarrierCode": {
"type": "object",
"properties": {
"carrierCodeType": {
"$ref": "#/components/schemas/CarrierCodeType"
},
"carrierCodeValue": {
"type": "string",
"description": "Value of the carrier code.",
"example": "TestCarrierCode"
}
},
"description": "Identifies the carrier that will deliver the shipment.",
"example": {
"carrierCodeType": "SCAC",
"carrierCodeValue": "TestCarrierCode"
}
},
"CarrierCodeType": {
"type": "string",
"description": "Denotes the type for the carrier.",
"example": "SCAC",
"enum": [
"SCAC"
],
"x-docgen-enum-table-extension": [
{
"description": "Standard Carrier Alpha Code. Refer to [What is a Standard Carrier Alpha Code](https://www.help.cbp.gov/s/article/Article-1420?language=en_US) for more information.",
"value": "SCAC"
}
]
},
"ConfirmationMode": {
"type": "string",
"description": "Confirmation Modes supported for Replenishment order creation. By default, the confirmation mode will be set to MANUAL.",
"example": "MANUAL",
"enum": [
"AUTO",
"MANUAL"
],
"x-docgen-enum-table-extension": [
{
"description": "When set to AUTO, the order will be confirmed once the status is ELIGIBLE.",
"value": "AUTO"
},
{
"description": "When set to MANUAL, the order needs to be confirmed manually after the status is ELIGIBLE.",
"value": "AUTO"
}
]
},
"DestinationDetails": {
"type": "object",
"properties": {
"destinationAddress": {
"$ref": "#/components/schemas/Address"
},
"destinationRegion": {
"type": "string",
"description": "Assigned region where the order will be shipped. This can differ from what was passed as preference. AWD currently supports following region IDs: [us-west, us-east, us-southcentral, us-southeast]",
"example": "us-west"
},
"shipmentId": {
"minLength": 1,
"type": "string",
"description": "Unique ID of the confirmed shipment being shipped to the assigned destination. This will be available only after an inbound order is confirmed and can be used to track the shipment."
}
},
"description": "Destination details of an inbound order based on the assigned region and DC for the order.",
"example": {
"destinationAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "Seattle",
"countryCode": "US",
"county": "Washington",
"district": "District1",
"name": "address_name",
"phoneNumber": "+14155552671",
"postalCode": "123456",
"stateOrRegion": "Washington"
},
"destinationRegion": "us-east"
}
},
"DimensionUnitOfMeasurement": {
"type": "string",
"description": "Unit of measurement for package dimensions.",
"example": "INCHES",
"enum": [
"INCHES",
"CENTIMETERS"
],
"x-docgen-enum-table-extension": [
{
"description": "Denotes package dimensions in inches.",
"value": "INCHES"
},
{
"description": "Denotes package dimensions in centimeters.",
"value": "CENTIMETERS"
}
]
},
"DistributionIneligibleReason": {
"required": [
"failureCode",
"failureReasons"
],
"type": "object",
"properties": {
"failureCode": {
"type": "string",
"description": "Failure code details of the error.",
"example": "TestErrorCode"
},
"failureReasons": {
"type": "array",
"description": "Failure reasons of the error.",
"example": [
"Test failure reason"
],
"items": {
"type": "string"
}
},
"sku": {
"type": "string",
"description": "SKU associated with the error.",
"example": "SampleSKU"
}
},
"description": "Execution errors associated with the replenishment order. This field will be populated if the order failed validation.",
"example": {
"failureCode": "TestErrorCode",
"failureReasons": [
"Test failure reason"
],
"sku": "SampleSKU"
}
},
"DistributionPackage": {
"required": [
"contents",
"measurements",
"type"
],
"type": "object",
"properties": {
"contents": {
"$ref": "#/components/schemas/DistributionPackageContents"
},
"measurements": {
"$ref": "#/components/schemas/MeasurementData"
},
"type": {
"$ref": "#/components/schemas/DistributionPackageType"
}
},
"description": "Represents an AWD distribution package.",
"example": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen",
"expiration": "2025-06-07T12:12:09.061Z",
"prepDetails": {
"prepCategory": "PERFORATED",
"prepOwner": "AMAZON",
"labelOwner": "SELF",
"prepInstructions": [
{
"prepType": "ITEM_POLYBAGGING",
"prepOwner": "AMAZON"
}
]
}
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
},
"DistributionPackageContents": {
"type": "object",
"properties": {
"packages": {
"type": "array",
"description": "This is required only when `DistributionPackageType=PALLET`.",
"items": {
"$ref": "#/components/schemas/DistributionPackageQuantity"
}
},
"products": {
"type": "array",
"description": "This is required only when `DistributionPackageType=CASE`.",
"items": {
"$ref": "#/components/schemas/ProductQuantity"
}
}
},
"description": "Represents the contents inside a package, which can be products or a nested package."
},
"DistributionPackageQuantity": {
"required": [
"count",
"distributionPackage"
],
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "Number of cases or pallets with the same package configuration.",
"format": "int32"
},
"distributionPackage": {
"$ref": "#/components/schemas/DistributionPackage"
}
},
"description": "Represents a distribution package with its respective quantity.",
"example": {
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen",
"expiration": "2025-06-07T12:12:09.061Z",
"prepDetails": {
"prepCategory": "PERFORATED",
"prepOwner": "AMAZON",
"labelOwner": "SELF",
"prepInstructions": [
{
"prepType": "ITEM_POLYBAGGING",
"prepOwner": "AMAZON"
}
]
}
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
},
"DistributionPackageType": {
"type": "string",
"description": "Type of distribution packages.",
"example": "CASE",
"enum": [
"CASE",
"PALLET"
],
"x-docgen-enum-table-extension": [
{
"description": "Package type `CASE`.",
"value": "CASE"
},
{
"description": "Package type `PALLET`. Currently, the `PALLET` package type is not supported.",
"value": "PALLET"
}
]
},
"DistributionProduct": {
"required": [
"quantity",
"sku"
],
"type": "object",
"properties": {
"attributes": {
"type": "array",
"description": "Attributes for this instance of the product, i.e. already-prepped, or other\nattributes that distinguish the product beyond the SKU.",
"example": {
"name": "TestAttribute",
"value": "TestAttributeValue"
},
"items": {
"$ref": "#/components/schemas/ProductAttribute"
}
},
"quantity": {
"type": "integer",
"description": "Quantity of the product",
"format": "int32"
},
"sku": {
"type": "string",
"description": "The seller/merchant stock keeping unit (SKU)."
}
},
"description": "Represents a product with sku details and corresponding quantity"
},
"Error": {
"required": [
"code",
"message"
],
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "An error code that identifies the type of error that occurred."
},
"details": {
"type": "string",
"description": "Additional details that can help the caller understand or fix the issue."
},
"message": {
"type": "string",
"description": "A message that describes the error condition."
}
},
"description": "Error response returned when the request is unsuccessful."
},
"ErrorList": {
"required": [
"errors"
],
"type": "object",
"properties": {
"errors": {
"type": "array",
"description": "A list of errors describing the failures.",
"items": {
"$ref": "#/components/schemas/Error"
}
}
},
"description": "This exception is thrown when client inputs are invalid."
},
"InboundEligibility": {
"required": [
"packagesToInbound",
"previewedAt",
"status"
],
"type": "object",
"properties": {
"ineligibilityReasons": {
"type": "array",
"description": "If there are order level eligibility issues, then this list will contain those error codes and descriptions.",
"items": {
"$ref": "#/components/schemas/OrderIneligibilityReason"
}
},
"packagesToInbound": {
"type": "array",
"description": "Details on SKU eligibility for each inbound package.",
"items": {
"$ref": "#/components/schemas/SkuEligibility"
}
},
"previewedAt": {
"type": "string",
"description": "Timestamp when the eligibility check is performed.",
"format": "date-time"
},
"status": {
"$ref": "#/components/schemas/InboundEligibilityStatus"
}
},
"description": "Represents the eligibility status of the inbound packages."
},
"InboundEligibilityStatus": {
"type": "string",
"description": "Enum denoting the package inbound eligibility.",
"enum": [
"ELIGIBLE",
"INELIGIBLE"
],
"x-docgen-enum-table-extension": [
{
"description": "Eligible to inbound.",
"value": "ELIGIBLE"
},
{
"description": "Ineligible to inbound.",
"value": "INELIGIBLE"
}
]
},
"InboundOrder": {
"required": [
"createdAt",
"orderId",
"orderStatus",
"originAddress",
"packagesToInbound"
],
"type": "object",
"properties": {
"createdAt": {
"type": "string",
"description": "Date when this order was created.",
"format": "date-time"
},
"destinationDetails": {
"$ref": "#/components/schemas/DestinationDetails"
},
"externalReferenceId": {
"type": "string",
"description": "Reference ID that can be used to correlate the order with partner resources.",
"example": "TestReferenceId"
},
"orderId": {
"type": "string",
"description": "Inbound order ID."
},
"orderStatus": {
"$ref": "#/components/schemas/InboundStatus"
},
"originAddress": {
"$ref": "#/components/schemas/Address"
},
"packagesToInbound": {
"minItems": 1,
"type": "array",
"description": "List of packages to be inbounded.",
"items": {
"$ref": "#/components/schemas/DistributionPackageQuantity"
}
},
"preferences": {
"$ref": "#/components/schemas/InboundPreferences"
},
"updatedAt": {
"type": "string",
"description": "Date when this order was last updated.",
"format": "date-time"
}
},
"description": "Represents an AWD inbound order.",
"example": {
"destinationDetails": {
"destinationAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "Seattle",
"countryCode": "US",
"county": "Washington",
"district": "District1",
"name": "address_name",
"phoneNumber": "+14155552671",
"postalCode": "123456",
"stateOrRegion": "Washington"
},
"destinationRegion": "us-east",
"shipmentId": "TestShipmentId"
},
"createdAt": "2023-06-07T12:12:09.061Z",
"externalReferenceId": "TestReferenceId",
"orderId": "TestOrderId",
"orderStatus": "DRAFT",
"originAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "Seattle",
"countryCode": "US",
"county": "Washington",
"district": "District1",
"name": "address_name",
"phoneNumber": "+14155552671",
"postalCode": "123456",
"stateOrRegion": "Washington"
},
"packagesToInbound": [
{
"count": 1,
"distributionPackage": {
"contents": {
"packages": [],
"products": [
{
"quantity": 1,
"sku": "testPen",
"expiration": "2025-06-07T12:12:09.061Z",
"prepDetails": {
"prepCategory": "PERFORATED",
"prepOwner": "AMAZON",
"labelOwner": "SELF",
"prepInstructions": [
{
"prepType": "ITEM_POLYBAGGING",
"prepOwner": "AMAZON"
}
]
}
}
]
},
"measurements": {
"dimensions": {
"height": 2.54,
"length": 2.54,
"unitOfMeasurement": "CENTIMETERS",
"width": 2.54
},
"weight": {
"unitOfMeasurement": "KILOGRAMS",
"weight": 0.453592
}
},
"type": "CASE"
}
}
],
"updatedAt": "2023-06-07T12:12:09.061Z",
"preferences": {
"destinationRegion": "us-west"
}
}
},
"InboundOrderCreationData": {
"required": [
"originAddress",
"packagesToInbound"
],
"type": "object",
"properties": {
"externalReferenceId": {
"type": "string",
"description": "Reference ID that can be used to correlate the order with partner resources.",
"example": "TestReferenceId"
},
"originAddress": {
"$ref": "#/components/schemas/Address"
},
"packagesToInbound": {
"minItems": 1,
"type": "array",
"description": "List of packages to be inbounded.",
"example": [
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
],
"items": {
"$ref": "#/components/schemas/DistributionPackageQuantity"
}
},
"preferences": {
"$ref": "#/components/schemas/InboundPreferences"
}
},
"description": "Payload for creating an inbound order.",
"example": {
"externalReferenceId": "TestReferenceId",
"originAddress": {
"addressLine1": "address_1",
"addressLine2": "address_2",
"addressLine3": "address_3",
"city": "City1",
"countryCode": "CC",
"district": "District1",
"name": "address_name",
"postalCode": "123456",
"stateOrRegion": "State1"
},
"packagesToInbound": [
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
],
"preferences": {
"destinationRegion": "us-west"
}
}
},
"InboundOrderReference": {
"required": [
"orderId"
],
"type": "object",
"properties": {
"orderId": {
"type": "string",
"description": "Order ID of the inbound order."
}
},
"description": "A response that contains the reference identifiers for the newly created or updated inbound order. Consists of an order ID and version."
},
"InboundPackages": {
"required": [
"packagesToInbound"
],
"type": "object",
"properties": {
"packagesToInbound": {
"minItems": 1,
"type": "array",
"description": "List of packages to be inbounded.",
"example": [
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
],
"items": {
"$ref": "#/components/schemas/DistributionPackageQuantity"
}
}
},
"description": "Represents the packages to inbound.",
"example": {
"packagesToInbound": [
{
"count": 1,
"distributionPackage": {
"contents": {
"products": [
{
"quantity": 1,
"sku": "testPen"
}
]
},
"measurements": {
"dimensions": {
"height": 1,
"length": 1,
"unitOfMeasurement": "INCHES",
"width": 1
},
"volume": {
"unitOfMeasurement": "CUIN",
"volume": 1
},
"weight": {
"unitOfMeasurement": "POUNDS",
"weight": 1
}
},
"type": "CASE"
}
}
]
}
},
"InboundPreferences": {
"type": "object",
"properties": {
"destinationRegion": {
"type": "string",
"description": "Pass a preferred region so that the inbound order can be shipped to an AWD warehouse located in that region. This doesn't guarantee the order to be assigned in the specified destination region as it depends on warehouse capacity availability. AWD currently supports following region IDs: [us-west, us-east, us-southcentral, us-southeast]"
}
},
"description": "Preferences that can be passed in context of an inbound order"
},
"InboundShipment": {
"required": [
"destinationAddress",
"orderId",
"originAddress",
"shipmentContainerQuantities",
"shipmentId",
"shipmentStatus"
],
"type": "object",
"properties": {
"carrierCode": {
"$ref": "#/components/schemas/CarrierCode"
},
"createdAt": {
"type": "string",
"description": "Timestamp when the shipment was created. The date is returned in ISO 8601 format.",
"format": "date-time"
},
"destinationAddress": {
"$ref": "#/components/schemas/Address"
},
"externalReferenceId": {
"type": "string",
"description": "Client-provided reference ID that can correlate this shipment to client resources. For example, to map this shipment to an internal bookkeeping order record.",
"example": "TestReferenceId"
},
"orderId": {
"minLength": 1,
"type": "string",
"description": "The AWD inbound order ID that this inbound shipment belongs to."
},
"originAddress": {
"$ref": "#/components/schemas/Address"
},
"receivedQuantity": {
"type": "array",
"description": "Quantity received (at the receiving end) as part of this shipment.",
"items": {
"$ref": "#/components/schemas/InventoryQuantity"
}
},
"shipBy": {
"type": "string",
"description": "Timestamp when the shipment will be shipped.",
"format": "date-time"
},
"shipmentContainerQuantities": {
"type": "array",
"description": "Packages that are part of this shipment.",
"items": {
"$ref": "#/components/schemas/DistributionPackageQuantity"
}
},
"shipmentId": {
"minLength": 1,
"type": "string",
"description": "Unique shipment ID."
},
"shipmentSkuQuantities": {
"type": "array",
"description": "Quantity details at SKU level for the shipment. This attribute will only appear if the skuQuantities parameter in the request is set to SHOW.",
"items": {
"$ref": "#/components/schemas/SkuQuantity"
}
},
"destinationRegion": {
"type": "string",
"description": "Assigned region where the order will be shipped. This can differ from what was passed as preference. AWD currently supports following region IDs: [us-west, us-east, us-southcentral, us-southeast]",
"example": "us-west"
},
"shipmentStatus": {
"$ref": "#/components/schemas/InboundShipmentStatus"
},
"trackingId": {
"minLength": 1,
"type": "string",
"description": "Carrier-unique tracking ID for this shipment."
},
"updatedAt": {
"type": "string",
"description": "Timestamp when the shipment was updated. The date is returned in ISO 8601 format.",
"format": "date-time"
},
"warehouseReferenceId": {
"type": "string",
"description": "An AWD-provided reference ID that you can use to interact with the warehouse. For example, a carrier appointment booking.",
"example": "TestWarehouseReferenceId"
}
},
"description": "Represents an AWD inbound shipment."
},
"InboundShipmentStatus": {
"type": "string",
"description": "Possible shipment statuses used by shipments.",
"enum": [
"CREATED",
"SHIPPED",
"IN_TRANSIT",
"RECEIVING",
"DELIVERED",
"CLOSED",
"CANCELLED"
],
"x-docgen-enum-table-extension": [
{
"description": "Shipment is created but has not yet shipped.",
"value": "CREATED"
},
{
"description": "Shipment was picked up by the carrier or was dropped off with the carrier.",
"value": "SHIPPED"
},
{
"description": "The carrier has notified AWD that the shipment is in transit between origin and destination node.",
"value": "IN_TRANSIT"
},
{
"description": "The shipment has been partially received.",
"value": "RECEIVING"
},
{
"description": "The shipment has reached the destination node and has been delivered to the facility yard. The shipment receive process at the warehouse will start soon.",
"value": "DELIVERED"
},
{
"description": "No more actions required on the shipment. This is a final state.",
"value": "CLOSED"
},
{
"description": "Shipment has been cancelled. This is a final state.",
"value": "CANCELLED"
}
]
},
"InboundShipmentSummary": {
"required": [
"orderId",
"shipmentId",
"shipmentStatus"
],
"type": "object",
"properties": {
"createdAt": {
"type": "string",
"description": "Timestamp when the shipment was created.",
"format": "date-time"
},
"externalReferenceId": {
"type": "string",
"description": "Optional client-provided reference ID that can be used to correlate this shipment with client resources. For example, to map this shipment to an internal bookkeeping order record.",
"example": "TestReferenceId"
},
"orderId": {
"minLength": 1,
"type": "string",
"description": "The AWD inbound order ID that this inbound shipment belongs to."
},
"shipmentId": {
"minLength": 1,
"type": "string",
"description": "A unique shipment ID."
},
"shipmentStatus": {
"$ref": "#/components/schemas/InboundShipmentStatus"
},
"updatedAt": {
"type": "string",
"description": "Timestamp when the shipment was updated.",
"format": "date-time"
}
},
"description": "Summary for an AWD inbound shipment containing the shipment ID, which can be used to retrieve the actual shipment."
},
"InboundStatus": {
"type": "string",
"description": "The supported statuses for an inbound order.",
"enum": [
"DRAFT",
"VALIDATING",
"CONFIRMED",
"CLOSED",
"EXPIRED",
"CANCELLED"
],
"x-docgen-enum-table-extension": [
{
"description": "A newly created inbound order will start in this state.",
"value": "DRAFT"
},
{
"description": "The order is in this state while being updated. Once updated, the order will enter the updated state.",
"value": "VALIDATING"
},
{
"description": "The order enters this state as soon as the order is confirmed.",
"value": "CONFIRMED"
},
{
"description": "The order enters this state when all associated shipments are closed.",
"value": "CLOSED"
},
{
"description": "The order enters this state if it is not confirmed within a time limit.",
"value": "EXPIRED"
},
{
"description": "The order enters this state when it is cancelled.",
"value": "CANCELLED"
}
]
},
"ExpirationDetails": {
"type": "object",
"properties": {
"expiration": {
"type": "string",
"description": "The expiration date of the SKU.",
"format": "date-time"
},
"onhandQuantity": {
"type": "integer",
"description": "The quantity that is present in AWD.",
"format": "int64"
}
},
"description": "The expiration details of the inventory. This object will only appear if the details parameter in the request is set to `SHOW`."
},
"InventoryDetails": {
"type": "object",
"properties": {
"availableDistributableQuantity": {
"type": "integer",
"description": "Quantity that is available for downstream channel replenishment.",
"format": "int64"
},
"replenishmentQuantity": {
"type": "integer",
"description": "Quantity that is in transit from AWD and has not yet been received at FBA.",
"format": "int64"
},
"reservedDistributableQuantity": {
"type": "integer",
"description": "Quantity that is reserved for a downstream channel replenishment order that is being prepared for shipment.",
"format": "int64"
}
},
"description": "Additional inventory details. This object is only displayed if the details parameter in the request is set to `SHOW`."
},
"InventoryListing": {
"required": [
"inventory"
],
"type": "object",
"properties": {
"inventory": {
"type": "array",
"description": "List of inventory summaries.",
"items": {
"$ref": "#/components/schemas/InventorySummary"
}
},
"nextToken": {
"type": "string",
"description": "A token that is used to retrieve the next page of results. The response includes `nextToken` when the number of results exceeds the specified `maxResults` value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.",
"example": "SampleToken"
}
},
"description": "AWD inventory payload."
},
"InventoryQuantity": {
"required": [
"quantity",
"unitOfMeasurement"
],
"type": "object",
"properties": {
"quantity": {
"type": "number",
"description": "Quantity of the respective inventory."
},
"unitOfMeasurement": {
"$ref": "#/components/schemas/InventoryUnitOfMeasurement"
}
},
"description": "Quantity of inventory with an associated measurement unit context."
},
"InventorySummary": {
"required": [
"sku"
],
"type": "object",
"properties": {
"expirationDetails": {
"type": "array",
"description": "The expiration details of the inventory. This object will only appear if the `details` parameter in the request is set to `SHOW`.",
"items": {
"$ref": "#/components/schemas/ExpirationDetails"
}
},
"inventoryDetails": {
"$ref": "#/components/schemas/InventoryDetails"
},
"sku": {
"type": "string",
"description": "The seller or merchant SKU."
},
"totalInboundQuantity": {
"type": "integer",
"description": "Total quantity that is in-transit from the seller and has not yet been received at an AWD Distribution Center",
"format": "int64"
},
"totalOnhandQuantity": {
"type": "integer",
"description": "Total quantity that is present in AWD distribution centers.",
"format": "int64"
}
},
"description": "Summary of inventory per SKU."
},
"InventoryUnitOfMeasurement": {
"type": "string",
"description": "Unit of measurement for the inventory.",
"enum": [
"PRODUCT_UNITS",
"CASES",
"PALLETS"
],
"x-docgen-enum-table-extension": [
{
"description": "Measures a discrete amount of product units.",
"value": "PRODUCT_UNITS"
},
{
"description": "Measures a discrete amount of cases.",
"value": "CASES"
},
{
"description": "Measures a discrete amount of pallets.",
"value": "PALLETS"
}
]
},
"LabelOwner": {
"type": "string",
"description": "The entity that labels the products.",
"enum": [
"AMAZON",
"SELF"
],
"x-docgen-enum-table-extension": [
{
"description": "Amazon labels the products.",
"value": "AMAZON"
},
{
"description": "The seller labels the products.",
"value": "SELF"
}
]
},
"LabelStatus": {
"type": "string",
"description": "The status of your label.",
"enum": [
"GENERATING",
"GENERATED",
"GENERATION_FAILED",
"NOT_READY"
],
"x-docgen-enum-table-extension": [
{
"description": "Labels are being generated.",
"value": "GENERATING"
},
{
"description": "Labels are generated.",
"value": "GENERATED"
},
{
"description": "Label generation failed.",
"value": "GENERATION_FAILED"
},
{
"description": "Not yet ready to start label generation.",
"value": "NOT_READY"
}
]
},
"MeasurementData": {
"required": [
"weight"
],
"type": "object",
"properties": {
"dimensions": {
"$ref": "#/components/schemas/PackageDimensions"
},
"volume": {
"$ref": "#/components/schemas/PackageVolume"
},
"weight": {
"$ref": "#/components/schemas/PackageWeight"
}
},
"description": "Package weight and dimension."
},
"OrderIneligibilityReason": {
"required": [
"code",
"description"
],
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Code for the order ineligibility.",
"example": "INVALID_MSKU"
},
"description": {
"type": "string",
"description": "Description detailing the ineligibility reason of the order.",
"example": "The MSKU passed as part of order is invalid"
}
},
"description": "Represents one ineligibility reason for the order (there can be multiple reasons).",
"example": {
"code": "INVALID_MSKU",
"description": "The MSKU of an invalid order."
}
},
"OutboundShipmentStatus": {
"type": "string",
"description": "Possible shipment statuses for outbound shipments.",
"example": "CREATED",
"enum": [
"CREATED",
"IN_TRANSIT",
"DELIVERED",
"RECEIVING",
"RECEIVED",
"CLOSED",
"CANCELLED",
"FAILED"
],
"x-docgen-enum-table-extension": [
{
"description": "Shipment is created. No inventory has been picked up at the source node.",
"value": "CREATED"
},
{
"description": "Carrier acknowledged that the shipment is in transit between the origin node and destination node.",
"value": "IN_TRANSIT"
},
{
"description": "Carrier indicated that the shipment has arrived at the destination node, but the destination node has not acknowledged the delivery.",
"value": "DELIVERED"
},
{
"description": "Destination node acknowledged the arrival of the shipment.",
"value": "RECEIVING"
},
{
"description": "Destination node has received the items.",
"value": "RECEIVED"
},
{
"description": "No more actions are required for the shipment. This is a final state.",
"value": "CLOSED"
},
{
"description": "Shipment has been cancelled by order owner. This is a final state.",
"value": "CANCELLED"
},
{
"description": "Shipment delivery has failed. This is a final state.",
"value": "FAILED"
}
]
},
"OutboundShipmentSummary": {
"required": [
"orderId",
"shipmentId",
"shipmentStatus"
],
"type": "object",
"properties": {
"createdAt": {
"type": "string",
"description": "Timestamp denoting when the shipment was created",
"format": "date-time",
"example": "2023-01-12T10:00:00Z"
},
"orderId": {
"minLength": 1,
"type": "string",
"description": "Order ID of AWD inbound order this inbound shipment belongs to",
"example": "TestOrderId"
},
"shipmentId": {
"minLength": 1,
"type": "string",
"description": "Unique shipment ID",
"example": "TestShipmentId"
},
"shipmentStatus": {
"$ref": "#/components/schemas/OutboundShipmentStatus"
},
"updatedAt": {
"type": "string",
"description": "Timestamp denoting when the shipment was updated",
"format": "date-time",
"example": "2023-01-12T10:00:00Z"
}
},
"description": "Summary of an AWD inbound shipment containing the shipment ID which can be used to\nfetch the actual shipment",
"example": {
"createdAt": "2023-01-12T10:00:00.000Z",
"orderId": "TestOrderId",
"shipmentId": "TestShipmentId",
"shipmentStatus": "CREATED",
"updatedAt": "2023-01-12T10:00:00.000Z"
}
},
"PackageDimensions": {
"required": [
"height",
"length",
"unitOfMeasurement",
"width"
],
"type": "object",
"properties": {
"height": {
"type": "number",
"description": "Height of the package.",
"format": "double"
},
"length": {
"type": "number",
"description": "Length of the package.",
"format": "double"
},
"unitOfMeasurement": {
"$ref": "#/components/schemas/DimensionUnitOfMeasurement"
},
"width": {
"type": "number",
"description": "Width of the package.",
"format": "double"
}
},
"description": "Dimensions of the package."
},
"PackageVolume": {
"required": [
"unitOfMeasurement",
"volume"
],
"type": "object",
"properties": {
"unitOfMeasurement": {
"$ref": "#/components/schemas/VolumeUnitOfMeasurement"
},
"volume": {
"type": "number",
"description": "The package volume value.",
"format": "double"
}
},
"description": "Represents the volume of the package with a unit of measurement."
},
"PackageWeight": {
"required": [
"unitOfMeasurement",
"weight"
],
"type": "object",
"properties": {
"unitOfMeasurement": {
"$ref": "#/components/schemas/WeightUnitOfMeasurement"
},
"weight": {
"type": "number",
"description": "The package weight value.",
"format": "double"
}
},
"description": "Represents the weight of the package with a unit of measurement."
},
"PrepDetails": {
"type": "object",
"properties": {
"labelOwner": {
"$ref": "#/components/schemas/LabelOwner"
},
"prepCategory": {
"$ref": "#/components/schemas/PrepCategory"
},
"prepInstructions": {
"type": "array",
"description": "Contains information about the preparation of the inbound products. The system auto-generates this field with the use of the `prepCategory`, and if you attempt to pass a value for this field, the system will ignore it.",
"items": {
"$ref": "#/components/schemas/PrepInstruction"
}
},
"prepOwner": {
"$ref": "#/components/schemas/PrepOwner"
}
},
"description": "The preparation details for a product. This contains the prep category, prep owner, and label owner.\nPrep instructions are generated based on the specified category."
},
"PrepCategory": {
"type": "string",
"description": "The preparation category for shipping an item to Amazon's fulfillment network.",
"enum": [
"ADULT",
"BABY",
"FC_PROVIDED",
"FRAGILE",
"GRANULAR",
"HANGER",
"LIQUID",
"PERFORATED",
"SET",
"SHARP",
"SMALL",
"TEXTILE",
"NO_PREP",
"UNKNOWN"
],
"x-docgen-enum-table-extension": [
{
"value": "ADULT",
"description": "Displays potentially offensive material such as profanity or nudity."
},
{
"value": "BABY",
"description": "Made for a child aged three years or younger, packaging with cutouts greater than one square inch."
},
{
"value": "FC_PROVIDED",
"description": "A prep type has been defined by the Fulfillment Center. This value is provided by Amazon and cannot be used as an input."
},
{
"value": "FRAGILE",
"description": "Glass or otherwise fragile, or a liquid in a glass container."
},
{
"value": "GRANULAR",
"description": "Made of powder, pellets, or granular material."
},
{
"value": "HANGER",
"description": "Made of cloth or fabric and intended to be put on a hanger."
},
{
"value": "LIQUID",
"description": "Liquid or viscous without a double seal."
},
{
"value": "PERFORATED",
"description": "In packaging that has a perforated opening."
},
{
"value": "SET",
"description": "Multiple items that are sold as one unit."
},
{
"value": "SHARP",
"description": "Sharp and easily exposed, not already contained in protective packaging."
},
{
"value": "SMALL",
"description": "Longest side less than 2 1/8 inches (width of a credit card)."
},
{
"value": "TEXTILE",
"description": "Made of cloth or fabric that could be damaged by dirt, dust, moisture, or liquid."
},
{
"value": "NO_PREP",
"description": "Does not require prep."
},
{
"value": "UNKNOWN",
"description": "An unknown prep category was found. This value is provided by Amazon and cannot be used as an input."
}
]
},
"PrepInstruction": {
"type": "object",
"properties": {
"prepOwner": {
"$ref": "#/components/schemas/PrepOwner"
},
"prepType": {
"type": "string",
"description": "The type of preparation to be done. For more information about preparing items, refer to [Prep guidance](https://sellercentral.amazon.com/help/hub/reference/external/GF4G7547KSLDX2KC) on Seller Central."
}
},
"description": "Information pertaining to the preparation of inbound products."
},
"PrepOwner": {
"type": "string",
"description": "The owner of the preparations, if special preparations are required.",
"enum": [
"AMAZON",
"SELF"
],
"x-docgen-enum-table-extension": [
{
"description": "Amazon owns the preparation.",
"value": "AMAZON"
},
{
"description": "The seller owns the preparation",
"value": "SELF"
}
]
},
"ProductAttribute": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Product attribute name.",
"example": "TestAttribute"
},
"value": {
"type": "string",
"description": "Product attribute value.",
"example": "TestAttributeValue"
}
},
"description": "Product instance attribute that is not described at the SKU level in the catalog.",
"example": {
"name": "TestAttribute",
"value": "TestAttributeValue"
}
},
"ProductQuantity": {
"required": [
"quantity",
"sku"
],
"type": "object",
"properties": {
"attributes": {
"type": "array",
"description": "Contains attributes for this instance of the product. For example, item color, or other attributes that distinguish the product beyond the SKU. This is metadata for the product and Amazon does not process this data.",
"example": {
"name": "TestAttribute",
"value": "TestAttributeValue"
},
"items": {
"$ref": "#/components/schemas/ProductAttribute"
}
},
"quantity": {
"type": "integer",
"description": "Product quantity.",
"format": "int32"
},
"sku": {
"type": "string",
"description": "The seller or merchant SKU."
},
"expiration": {
"type": "string",
"description": "The expiration date for the SKU. Values are in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) date-time format.",
"format": "date-time"
},
"prepDetails": {
"$ref": "#/components/schemas/PrepDetails"
}
},
"description": "Represents a product with the SKU details and the corresponding quantity."
},
"ReplenishmentOrder": {
"required": [
"orderId",
"outboundShipments",
"status"
],
"type": "object",
"properties": {
"confirmedOn": {
"type": "string",
"description": "Date on which this replenishment order was confirmed.",
"format": "date-time"
},
"createdAt": {
"type": "string",
"description": "Date on which this replenishment order was created.",
"format": "date-time"
},
"distributionIneligibleReasons": {
"type": "array",
"description": "Distribution errors associated with the order related to the products or packages to replenish.\nThis field will be populated if the order has products or packages which failed validation.",
"items": {
"$ref": "#/components/schemas/DistributionIneligibleReason"
}
},
"eligibleProducts": {
"type": "array",
"description": "List of product units that are eligible for replenishment.",
"items": {
"$ref": "#/components/schemas/DistributionProduct"
}
},
"orderId": {
"type": "string",
"description": "Order Id of the replenishment order."
},
"status": {
"$ref": "#/components/schemas/ReplenishmentOrderStatus"
},
"outboundShipments": {
"type": "array",
"description": "List of outbound shipments that are part of this order.",
"items": {
"$ref": "#/components/schemas/OutboundShipmentSummary"
}
},
"products": {
"type": "array",
"description": "Requested amount of single product units to be replenished.",
"items": {
"$ref": "#/components/schemas/DistributionProduct"
}
},
"shippedProducts": {
"type": "array",
"description": "Outbound product units that are shipped after the execution has completed post confirmation.",
"items": {
"$ref": "#/components/schemas/DistributionProduct"
}
},
"updatedAt": {
"type": "string",
"description": "Date on which this replenishment order was last updated.",
"format": "date-time",
"example": "2023-01-12T10:00:00Z"
}
},
"description": "Represents an AWD replenishment order."
},
"ReplenishmentOrderCreationData": {
"type": "object",
"properties": {
"preferences": {
"$ref": "#/components/schemas/ReplenishmentPreferences"
},
"products": {
"type": "array",
"description": "Requested amount of single product units to be replenished.",
"example": [
{
"sku": "TestSKU",
"quantity": 1
}
],
"items": {
"$ref": "#/components/schemas/DistributionProduct"
}
}
},
"description": "This structure represents the payload for creating an AFN Replenishment Order.\nBy default, all replenishment orders created support Partial order preferences.",
"example": {
"products": [
{
"quantity": 1,
"sku": "testPen"
}
],
"preferences": {
"confirmation": "AUTO"
}
}
},
"ReplenishmentOrderListing": {
"type": "object",
"properties": {
"nextToken": {
"type": "string",
"description": "A token that is used to retrieve the next page of results. The response includes `nextToken` when the number of results exceeds the specified `maxResults` value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.",
"example": "SampleToken"
},
"orders": {
"type": "array",
"description": "List of replenishment orders.",
"items": {
"$ref": "#/components/schemas/ReplenishmentOrder"
}
}
},
"description": "A list of paginated replenishment orders filtered by the attributes passed in the request."
},
"ReplenishmentOrderReference": {
"required": [
"orderId"
],
"type": "object",
"properties": {
"orderId": {
"type": "string",
"description": "Order ID of the Replenishment order."
}
},
"description": "Response containing the reference identifier for the newly created/updated replenishment order consisting of the order ID."
},
"ReplenishmentOrderStatus": {
"type": "string",
"description": "Statuses supported for an replenishment order.",
"enum": [
"CONFIRMED",
"CREATED",
"ELIGIBLE",
"EXECUTING",
"FAILURE",
"INELIGIBLE",
"INVENTORY_OUTBOUND",
"SUCCESS",
"VALIDATING"
],
"x-docgen-enum-table-extension": [
{
"description": "The order enters this state as soon as the order is confirmed.",
"value": "CONFIRMED"
},
{
"description": "A newly created replenishment order will always start in this state. On UI, this status is called DRAFT",
"value": "CREATED"
},
{
"description": "This is the only state when an order can be confirmed.",
"value": "ELIGIBLE"
},
{
"description": "The order is being executed in the system.",
"value": "EXECUTING"
},
{
"description": "If any of the shipment reports failure or does not reach the destination,\nthe order status is marked as failed",
"value": "FAILURE"
},
{
"description": "If the validation results in a failure, the order will be in this state.\nIn this state, a validation errors field will be provided to show the\nerrors with the order and potential guidance on fixing them.",
"value": "INELIGIBLE"
},
{
"description": "The order executing is complete and the order is awaiting the moving of inventory.\nIn this status, the shipments for an order will be visible.",
"value": "INVENTORY_OUTBOUND"
},
{
"description": "If all the shipments are successfully received at the destination channel, the order is marked successful.",
"value": "SUCCESS"
},
{
"description": "The order is being validated asynchronously.\nThe order will be in this state after every item update.",
"value": "VALIDATING"
}
]
},
"ReplenishmentPreferences": {
"type": "object",
"properties": {
"confirmation": {
"$ref": "#/components/schemas/ConfirmationMode"
}
},
"description": "Preferences that can be passed in context of a replenishment order"
},
"ShipmentLabels": {
"required": [
"labelStatus"
],
"type": "object",
"properties": {
"labelDownloadURL": {
"type": "string",
"description": "The URL to download shipment labels. The URL is active for 600 seconds from generation."
},
"labelStatus": {
"$ref": "#/components/schemas/LabelStatus"
}
},
"description": "Shipment labels."
},
"ShipmentListing": {
"type": "object",
"properties": {
"nextToken": {
"type": "string",
"description": "A token that is used to retrieve the next page of results. The response includes `nextToken` when the number of results exceeds the specified `maxResults` value. To get the next page of results, call the operation with this token and include the same arguments as the call that produced the token. To get a complete list, call this operation until `nextToken` is null. Note that this operation can return empty pages.",
"example": "SampleToken"
},
"shipments": {
"type": "array",
"description": "List of inbound shipment summaries.",
"items": {
"$ref": "#/components/schemas/InboundShipmentSummary"
}
}
},
"description": "A list of inbound shipment summaries filtered by the attributes specified in the request."
},
"SkuEligibility": {
"required": [
"packageQuantity",
"status"
],
"type": "object",
"properties": {
"ineligibilityReasons": {
"type": "array",
"description": "If not eligible, these are list of error codes and descriptions.",
"items": {
"$ref": "#/components/schemas/SkuIneligibilityReason"
}
},
"packageQuantity": {
"$ref": "#/components/schemas/DistributionPackageQuantity"
},
"status": {
"$ref": "#/components/schemas/InboundEligibilityStatus"
}
},
"description": "Represents eligibility of one SKU."
},
"SkuIneligibilityReason": {
"required": [
"code",
"description"
],
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Code for the SKU ineligibility."
},
"description": {
"type": "string",
"description": "Detailed description of the SKU ineligibility."
}
},
"description": "Represents the ineligibility reason for one SKU."
},
"SkuQuantity": {
"required": [
"expectedQuantity",
"sku"
],
"type": "object",
"properties": {
"expectedQuantity": {
"$ref": "#/components/schemas/InventoryQuantity"
},
"receivedQuantity": {
"$ref": "#/components/schemas/InventoryQuantity"
},
"sku": {
"type": "string",
"description": "The merchant stock keeping unit"
}
},
"description": "Quantity details for a SKU as part of a shipment"
},
"TrackingDetails": {
"required": [
"bookingId"
],
"type": "object",
"properties": {
"carrierCode": {
"$ref": "#/components/schemas/CarrierCode"
},
"bookingId": {
"minLength": 1,
"type": "string",
"description": "The identifier that is received from transportation to uniquely identify a booking."
}
},
"description": "Tracking details for the shipment. If using SPD transportation, this can be for each case. If not using SPD transportation, this is a single tracking entry for the entire shipment."
},
"TransportationDetails": {
"required": [
"trackingDetails"
],
"type": "object",
"properties": {
"trackingDetails": {
"type": "array",
"description": "Tracking details for the shipment. If using SPD transportation, this can be for each case. If not using SPD transportation, this is a single tracking entry for the entire shipment.",
"items": {
"$ref": "#/components/schemas/TrackingDetails"
}
}
},
"description": "Transportation details for the shipment.",
"example": {
"trackingDetails": [
{
"carrierCode": {
"carrierCodeType": "SCAC"
},
"bookingId": "TRACKING_ID"
}
]
}
},
"VolumeUnitOfMeasurement": {
"type": "string",
"description": "Unit of measurement for the package volume.",
"enum": [
"CU_IN",
"CBM",
"CC"
],
"x-docgen-enum-table-extension": [
{
"description": "Denotes volume measurement in cubic inches.",
"value": "CU_IN"
},
{
"description": "Denotes volume measurement in cubic meters.",
"value": "CBM"
},
{
"description": "Denotes volume measurement in cubic centimeters.",
"value": "CC"
}
]
},
"WeightUnitOfMeasurement": {
"type": "string",
"description": "Unit of measurement for the package weight.",
"enum": [
"POUNDS",
"KILOGRAMS"
],
"x-docgen-enum-table-extension": [
{
"description": "Denotes weight measurement in pounds.",
"value": "POUNDS"
},
{
"description": "Denotes weight measurement in kilograms.",
"value": "KILOGRAMS"
}
]
}
}
},
"x-original-swagger-version": "2.0"
}