Modelo de FBA Small y Light API v1
Modelo Swagger para la FBA Small y Light API v1
{
"swagger": "2.0",
"info": {
"description": "The Selling Partner API for FBA Small and Light lets you help sellers manage their listings in the Small and Light program. The program reduces the cost of fulfilling orders for small and lightweight FBA inventory. You can enroll or remove items from the program and check item eligibility and enrollment status. You can also preview the estimated program fees charged to a seller for items sold while enrolled in the program.",
"version": "v1",
"title": "Selling Partner API for FBA Small And Light",
"contact": {
"name": "Selling Partner API Developer Support",
"url": "https://sellercentral.amazon.com/gp/mws/contactus.html"
},
"license": {
"name": "Apache License 2.0",
"url": "http://www.apache.org/licenses/LICENSE-2.0"
}
},
"host": "sellingpartnerapi-na.amazon.com",
"schemes": [
"https"
],
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"paths": {
"/fba/smallAndLight/v1/enrollments/{sellerSKU}": {
"get": {
"tags": [
"smallAndLight"
],
"description": "Returns the Small and Light enrollment status for the item indicated by the specified seller SKU in the specified marketplace.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 10 |\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, see [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": "getSmallAndLightEnrollmentBySellerSKU",
"parameters": [
{
"name": "sellerSKU",
"in": "path",
"description": "The seller SKU that identifies the item.",
"required": true,
"type": "string"
},
{
"name": "marketplaceIds",
"in": "query",
"description": "The marketplace for which the enrollment status is retrieved. Note: Accepts a single marketplace only.",
"required": true,
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/SmallAndLightEnrollment"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_ENROLLED_IN_SMALL_AND_LIGHT"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"marketplaceId": "ATVPDKIKX0DER",
"sellerSKU": "SKU_ENROLLED_IN_SMALL_AND_LIGHT",
"status": "ENROLLED"
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_400"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input."
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_403"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "Unauthorized",
"message": "Access to requested resource is denied."
}
]
}
}
]
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_404"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "NotFound",
"message": "Requested resource is not found"
}
]
}
}
]
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_413"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "PayloadTooLarge",
"message": "Payload of the request is too large."
}
]
}
}
]
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_415"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "UnsupportedType",
"message": "The entity of the request is of unsupported type."
}
]
}
}
]
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_429"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "TooManyRequests",
"message": "Total number of requests exceed your allowed limits."
}
]
}
}
]
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_500"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "InternalServerError",
"message": "Server encountered an unexpected condition while processing your request."
}
]
}
}
]
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_503"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Server is temporarily unavailable."
}
]
}
}
]
}
}
}
},
"put": {
"tags": [
"smallAndLight"
],
"description": "Enrolls the item indicated by the specified seller SKU in the Small and Light program in the specified marketplace. If the item is not eligible, the ineligibility reasons are returned.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 5 |\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, see [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": "putSmallAndLightEnrollmentBySellerSKU",
"parameters": [
{
"name": "sellerSKU",
"in": "path",
"description": "The seller SKU that identifies the item.",
"required": true,
"type": "string"
},
{
"name": "marketplaceIds",
"in": "query",
"description": "The marketplace in which to enroll the item. Note: Accepts a single marketplace only.",
"required": true,
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/SmallAndLightEnrollment"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_ELIGIBLE_FOR_SMALL_AND_LIGHT"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"marketplaceId": "ATVPDKIKX0DER",
"sellerSKU": "SKU_ELIGIBLE_FOR_SMALL_AND_LIGHT",
"status": "ENROLLED"
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_400"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input."
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_403"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "Unauthorized",
"message": "Access to requested resource is denied."
}
]
}
}
]
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_404"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "NotFound",
"message": "Requested resource is not found"
}
]
}
}
]
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_413"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "PayloadTooLarge",
"message": "Payload of the request is too large."
}
]
}
}
]
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_415"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "UnsupportedType",
"message": "The entity of the request is of unsupported type."
}
]
}
}
]
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_429"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "TooManyRequests",
"message": "Total number of requests exceed your allowed limits."
}
]
}
}
]
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_500"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "InternalServerError",
"message": "Server encountered an unexpected condition while processing your request."
}
]
}
}
]
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_503"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Server is temporarily unavailable."
}
]
}
}
]
}
}
}
},
"delete": {
"tags": [
"smallAndLight"
],
"description": "Removes the item indicated by the specified seller SKU from the Small and Light program in the specified marketplace. If the item is not eligible for disenrollment, the ineligibility reasons are returned.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 5 |\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, see [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": "deleteSmallAndLightEnrollmentBySellerSKU",
"parameters": [
{
"name": "sellerSKU",
"in": "path",
"description": "The seller SKU that identifies the item.",
"required": true,
"type": "string"
},
{
"name": "marketplaceIds",
"in": "query",
"description": "The marketplace in which to remove the item from the Small and Light program. Note: Accepts a single marketplace only.",
"required": true,
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
}
],
"responses": {
"204": {
"description": "Success.",
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_ENROLLED_FOR_SMALL_AND_LIGHT"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_400"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input."
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_403"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "Unauthorized",
"message": "Access to requested resource is denied."
}
]
}
}
]
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_404"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "NotFound",
"message": "Requested resource is not found"
}
]
}
}
]
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_413"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "PayloadTooLarge",
"message": "Payload of the request is too large."
}
]
}
}
]
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_415"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "UnsupportedType",
"message": "The entity of the request is of unsupported type."
}
]
}
}
]
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_429"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "TooManyRequests",
"message": "Total number of requests exceed your allowed limits."
}
]
}
}
]
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_500"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "InternalServerError",
"message": "Server encountered an unexpected condition while processing your request."
}
]
}
}
]
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_503"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Server is temporarily unavailable."
}
]
}
}
]
}
}
}
}
},
"/fba/smallAndLight/v1/eligibilities/{sellerSKU}": {
"get": {
"tags": [
"smallAndLight"
],
"description": "Returns the Small and Light program eligibility status of the item indicated by the specified seller SKU in the specified marketplace. If the item is not eligible, the ineligibility reasons are returned. **Note:** The parameters associated with this operation may contain special characters that must be encoded to successfully call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 2 | 10 |\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, see [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": "getSmallAndLightEligibilityBySellerSKU",
"parameters": [
{
"name": "sellerSKU",
"in": "path",
"description": "The seller SKU that identifies the item.",
"required": true,
"type": "string"
},
{
"name": "marketplaceIds",
"in": "query",
"description": "The marketplace for which the eligibility status is retrieved. NOTE: Accepts a single marketplace only.",
"required": true,
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/SmallAndLightEligibility"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_ELIGIBLE_FOR_SMALL_AND_LIGHT"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"marketplaceId": "ATVPDKIKX0DER",
"sellerSKU": "SKU_ELIGIBLE_FOR_SMALL_AND_LIGHT",
"status": "ELIGIBLE"
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_400"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input."
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_403"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "Unauthorized",
"message": "Access to requested resource is denied."
}
]
}
}
]
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_404"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "NotFound",
"message": "Requested resource is not found"
}
]
}
}
]
}
},
"413": {
"description": "The request size exceeded the maximum accepted size.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_413"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "PayloadTooLarge",
"message": "Payload of the request is too large."
}
]
}
}
]
}
},
"415": {
"description": "The request payload is in an unsupported format.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_415"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "UnsupportedType",
"message": "The entity of the request is of unsupported type."
}
]
}
}
]
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_429"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "TooManyRequests",
"message": "Total number of requests exceed your allowed limits."
}
]
}
}
]
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_500"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "InternalServerError",
"message": "Server encountered an unexpected condition while processing your request."
}
]
}
}
]
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"sellerSKU": {
"value": "SKU_503"
},
"marketplaceIds": {
"value": [
"ATVPDKIKX0DER"
]
}
}
},
"response": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Server is temporarily unavailable."
}
]
}
}
]
}
}
}
}
},
"/fba/smallAndLight/v1/feePreviews": {
"post": {
"tags": [
"smallAndLight"
],
"description": "Returns the Small and Light fee estimates for the specified items. You must include a marketplaceId parameter to retrieve the proper fee estimates for items to be sold in that marketplace. The ordering of items in the response will mirror the order of the items in the request. Duplicate ASIN/price combinations are removed.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 1 | 3 |\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, see [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": "getSmallAndLightFeePreview",
"parameters": [
{
"in": "body",
"name": "body",
"required": true,
"schema": {
"$ref": "#/definitions/SmallAndLightFeePreviewRequest"
}
}
],
"responses": {
"200": {
"description": "Success.",
"schema": {
"$ref": "#/definitions/SmallAndLightFeePreviews"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"marketplaceId": "ATVPDKIKX0DER",
"items": [
{
"asin": "B076ZL9PB5",
"price": {
"currencyCode": "USD",
"amount": 6.5
}
}
]
}
}
}
},
"response": {
"data": [
{
"asin": "B076ZL9PB5",
"price": {
"amount": 6.5,
"currencyCode": "USD"
},
"feeBreakdown": [
{
"feeType": "FBAPerUnitFulfillmentFee",
"feeCharge": {
"amount": 0.75,
"currencyCode": "USD"
}
},
{
"feeType": "FBAPerOrderFulfillmentFee",
"feeCharge": {
"amount": 1,
"currencyCode": "USD"
}
},
{
"feeType": "FBAWeightBasedFee",
"feeCharge": {
"amount": 1.1,
"currencyCode": "USD"
}
},
{
"feeType": "Commission",
"feeCharge": {
"amount": 0.98,
"currencyCode": "USD"
}
}
],
"totalFees": {
"amount": 3.83,
"currencyCode": "USD"
},
"errors": []
}
]
}
}
]
}
},
"400": {
"description": "Request has missing or invalid parameters and cannot be parsed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"marketplaceId": "TEST_CASE_400",
"items": []
}
}
}
},
"response": {
"errors": [
{
"code": "InvalidInput",
"message": "Invalid input."
}
]
}
}
]
}
},
"401": {
"description": "The request's Authorization header is not formatted correctly or does not contain a valid token.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"marketplaceId": "TEST_CASE_401",
"items": []
}
}
}
},
"response": {
"errors": [
{
"code": "Unauthorized",
"message": "Access to requested resource is denied."
}
]
}
}
]
}
},
"403": {
"description": "Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"marketplaceId": "TEST_CASE_403",
"items": []
}
}
}
},
"response": {
"errors": [
{
"code": "Unauthorized",
"message": "Access to requested resource is denied."
}
]
}
}
]
}
},
"404": {
"description": "The resource specified does not exist.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"marketplaceId": "TEST_CASE_404",
"items": []
}
}
}
},
"response": {
"errors": [
{
"code": "NotFound",
"message": "The requested resource doesn't exist."
}
]
}
}
]
}
},
"429": {
"description": "The frequency of requests was greater than allowed.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"marketplaceId": "TEST_CASE_429",
"items": []
}
}
}
},
"response": {
"errors": [
{
"code": "QuotaExceeded",
"message": "You exceeded your quota for the requested resource."
}
]
}
}
]
}
},
"500": {
"description": "An unexpected condition occurred that prevented the server from fulfilling the request.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"marketplaceId": "TEST_CASE_500",
"items": []
}
}
}
},
"response": {
"errors": [
{
"code": "InternalFailure",
"message": "We encountered an internal error. Please try again."
}
]
}
}
]
}
},
"503": {
"description": "Temporary overloading or maintenance of the server.",
"schema": {
"$ref": "#/definitions/ErrorList"
},
"headers": {
"x-amzn-RateLimit-Limit": {
"type": "string",
"description": "Your rate limit (requests per second) for this operation.\n_Note:_ For this status code, the rate limit header is deprecated and no longer returned."
},
"x-amzn-RequestId": {
"type": "string",
"description": "Unique request reference identifier."
}
},
"x-amzn-api-sandbox": {
"static": [
{
"request": {
"parameters": {
"body": {
"value": {
"marketplaceId": "TEST_CASE_503",
"items": []
}
}
}
},
"response": {
"errors": [
{
"code": "ServiceUnavailable",
"message": "Service is temporarily unavailable. Please try again."
}
]
}
}
]
}
}
}
}
}
},
"definitions": {
"MarketplaceId": {
"type": "string",
"description": "A marketplace identifier."
},
"SellerSKU": {
"type": "string",
"description": "Identifies an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit."
},
"Error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string",
"description": "An error code that identifies the type of error that occurred."
},
"message": {
"type": "string",
"description": "A message that describes the error condition in a human-readable form."
},
"details": {
"type": "string",
"description": "Additional information that can help the caller understand or fix the issue."
}
},
"description": "Error response returned when the request is unsuccessful."
},
"ErrorList": {
"type": "object",
"properties": {
"errors": {
"type": "array",
"items": {
"$ref": "#/definitions/Error"
}
}
},
"description": "A list of error responses returned when a request is unsuccessful."
},
"SmallAndLightEnrollmentStatus": {
"type": "string",
"description": "The Small and Light enrollment status of the item.",
"enum": [
"ENROLLED",
"NOT_ENROLLED"
],
"x-docgen-enum-table-extension": [
{
"value": "ENROLLED",
"description": "The Small and Light enrollment status is enrolled."
},
{
"value": "NOT_ENROLLED",
"description": "The Small and Light enrollment status is not enrolled."
}
]
},
"SmallAndLightEligibilityStatus": {
"type": "string",
"description": "The Small and Light eligibility status of the item.",
"enum": [
"ELIGIBLE",
"NOT_ELIGIBLE"
],
"x-docgen-enum-table-extension": [
{
"value": "ELIGIBLE",
"description": "The Small and Light eligibility status is eligible."
},
{
"value": "NOT_ELIGIBLE",
"description": "The Small and Light eligibility status is not eligible."
}
]
},
"SmallAndLightEnrollment": {
"type": "object",
"required": [
"marketplaceId",
"sellerSKU",
"status"
],
"properties": {
"marketplaceId": {
"$ref": "#/definitions/MarketplaceId"
},
"sellerSKU": {
"$ref": "#/definitions/SellerSKU"
},
"status": {
"$ref": "#/definitions/SmallAndLightEnrollmentStatus"
}
},
"description": "The Small and Light enrollment status of the item indicated by the specified seller SKU."
},
"SmallAndLightEligibility": {
"type": "object",
"required": [
"marketplaceId",
"sellerSKU",
"status"
],
"properties": {
"marketplaceId": {
"$ref": "#/definitions/MarketplaceId"
},
"sellerSKU": {
"$ref": "#/definitions/SellerSKU"
},
"status": {
"$ref": "#/definitions/SmallAndLightEligibilityStatus"
}
},
"description": "The Small and Light eligibility status of the item indicated by the specified seller SKU."
},
"SmallAndLightFeePreviewRequest": {
"type": "object",
"required": [
"items",
"marketplaceId"
],
"properties": {
"marketplaceId": {
"$ref": "#/definitions/MarketplaceId"
},
"items": {
"type": "array",
"description": "A list of items for which to retrieve fee estimates (limit: 25).",
"items": {
"$ref": "#/definitions/Item"
},
"maxItems": 25
}
},
"description": "Request schema for submitting items for which to retrieve fee estimates."
},
"SmallAndLightFeePreviews": {
"type": "object",
"properties": {
"data": {
"type": "array",
"description": "A list of fee estimates for the requested items. The order of the fee estimates will follow the same order as the items in the request, with duplicates removed.",
"items": {
"$ref": "#/definitions/FeePreview"
}
}
}
},
"Item": {
"type": "object",
"required": [
"asin",
"price"
],
"properties": {
"asin": {
"type": "string",
"description": "The Amazon Standard Identification Number (ASIN) value used to identify the item."
},
"price": {
"description": "The price that the seller plans to charge for the item.",
"$ref": "#/definitions/MoneyType"
}
},
"description": "An item to be sold."
},
"FeePreview": {
"type": "object",
"properties": {
"asin": {
"type": "string",
"description": "The Amazon Standard Identification Number (ASIN) value used to identify the item."
},
"price": {
"description": "The price that the seller plans to charge for the item.",
"$ref": "#/definitions/MoneyType"
},
"feeBreakdown": {
"type": "array",
"description": "A list of the Small and Light fees for the item.",
"items": {
"$ref": "#/definitions/FeeLineItem"
}
},
"totalFees": {
"description": "The total fees charged if the item participated in the Small and Light program.",
"$ref": "#/definitions/MoneyType"
},
"errors": {
"type": "array",
"description": "One or more unexpected errors occurred during the getSmallAndLightFeePreview operation.",
"items": {
"$ref": "#/definitions/Error"
}
}
},
"description": "The fee estimate for a specific item."
},
"FeeLineItem": {
"type": "object",
"required": [
"feeCharge",
"feeType"
],
"properties": {
"feeType": {
"type": "string",
"description": "The type of fee charged to the seller.",
"enum": [
"FBAWeightBasedFee",
"FBAPerOrderFulfillmentFee",
"FBAPerUnitFulfillmentFee",
"Commission"
],
"x-docgen-enum-table-extension": [
{
"value": "FBAWeightBasedFee",
"description": "The FBA weight-based fee (weight handling)."
},
{
"value": "FBAPerOrderFulfillmentFee",
"description": "The FBA per-order fulfillment fee (order handling)."
},
{
"value": "FBAPerUnitFulfillmentFee",
"description": "The FBA fulfillment fee (Pick & Pack)."
},
{
"value": "Commission",
"description": "The commission - referral fee."
}
]
},
"feeCharge": {
"description": "Amount charged to the seller for the specific fee type.",
"$ref": "#/definitions/MoneyType"
}
},
"description": "Fee details for a specific fee."
},
"MoneyType": {
"type": "object",
"properties": {
"currencyCode": {
"type": "string",
"description": "The currency code in ISO 4217 format."
},
"amount": {
"type": "number",
"description": "The monetary value."
}
}
}
}
}
Updated over 1 year ago