createMarketplaceItemLabels

For a given marketplace - creates labels for a list of MSKUs.

Usage Plan:

Rate (requests per second)	Burst
2	30

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

Request

Body Params application/json

The `createMarketplaceItemLabels` request.

height

number

optional

The height of the item label.

>= 25<= 100

labelType

enum<string>

required

Indicates the type of print type for a given label.

Allowed values:

STANDARD_FORMATTHERMAL_PRINTING

Example:

STANDARD_FORMAT

localeCode

string

optional

The locale code constructed from ISO 639 language code and ISO 3166-1 alpha-2 standard of country codes separated by an underscore character.

Default:

en_US

Match pattern:

^[a-z]{2}_[A-Z]{2}$

marketplaceId

string

required

The Marketplace ID. For a list of possible values, refer to Marketplace IDs.

>= 1 characters<= 20 characters

mskuQuantities

array[object (MskuQuantity) {2}]

required

Represents the quantity of an MSKU to print item labels for.

>= 1 items<= 100 items

msku

string

required

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

>= 1 characters<= 40 characters

quantity

integer

required

A positive integer.

>= 1<= 10000

pageType

enum<string>

optional

The page type to use to print the labels. Possible values: 'A4_21', 'A4_24', 'A4_24_64x33', 'A4_24_66x35', 'A4_24_70x36', 'A4_24_70x37', 'A4_24i', 'A4_27', 'A4_40_52x29', 'A4_44_48x25', 'Letter_30'.

Allowed values:

A4_21A4_24A4_24_64x33A4_24_66x35A4_24_70x36A4_24_70x37A4_24iA4_27A4_40_52x29A4_44_48x25Letter_30

Example:

A4_21

width

number

optional

The width of the item label.

>= 25<= 100

Example

{
    "height": 25,
    "labelType": "STANDARD_FORMAT",
    "localeCode": "en_US",
    "marketplaceId": "A2EUQ1WTGCTBG2",
    "mskuQuantities": [
        {
            "msku": "msku",
            "quantity": 5
        }
    ],
    "pageType": "A4_21",
    "width": 100
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

CreateMarketplaceItemLabels 200 response

Headers

x-amzn-RequestId

string

optional

Unique request reference identifier.

x-amzn-RateLimit-Limit

string

optional

Your rate limit (requests per second) for this operation.

Body

The `createMarketplaceItemLabels` response.

documentDownloads

array[object (DocumentDownload) {3}]

required

Resources to download the requested document.

downloadType

string

required

The type of download. Possible values: URL.

expiration

string <date-time>

optional

The URI's expiration time. In ISO 8601 datetime format with pattern yyyy-MM-ddTHH:mm:ss.sssZ.

uri

string

required

Uniform resource identifier to identify where the document is located.

Example

{
    "documentDownloads": [
        {
            "downloadType": "string",
            "expiration": "2019-08-24T14:15:22Z",
            "uri": "string"
        }
    ]
}

🟠400Bad Request

🟠403Forbidden

🟠404Record Not Found

🟠413413

🟠415415

🟠429429

🔴500Server Error

🔴503Service Unavailable