Export Product Schemas from Amazon Seller Central
This task will provide both the product type schema and meta schema for a given product type on Amazon. These schemas are used in conjunction with the Import JSON Feed to Amazon Seller Central task and the 'JSON_LISTINGS_FEED' feed type. They provide details of the way Amazon expects listings data for a particular product type to be formatted, and which fields are required.
Settings
Amazon Seller Central Connection
Required
The Amazon Seller Central connection to use. See the Connecting to Amazon Seller Central article if you require more information on how to create/manage connections.
Marketplaces
Required
Choose a single marketplace to obtain schemas from.
Locale
Optional
The locale to retrieve presentation details (i.e. labels and descriptions) for. If not specified, will default to the primary locale of the marketplace.
Product Type
Required
The name of the product type to retrieve schemas for.
Requirements Set
Required
The name of the requirements set to retrieve a product type schema for. The following options are available:
- LISTING- Requirements inclusive of product facts and sales terms.
- LISTING_OFFER_ONLY - Requirements inclusive of sales terms only.
- LISTING_PRODUCT_ONLY - Requirements inclusive of product facts only.
Defaults to LISTING.
Meta Schema Output File
Required
The name of the JSON file to export the meta schema to.
Product Type Schema Output File
Required
The name of the JSON file to export the product type schema to.
Zynk Settings
See Common Task Settings.
Examples
Sample product type schema output file:
{
"$schema": "https://schemas.amazon.com/selling-partners/definitions/product-types/meta-schema/v1",
"$id": "https://schemas.amazon.com/selling-partners/definitions/product-types/schema/v1/PRODUCT",
"$comment": "Amazon product type definition for PRODUCT product type",
"$defs": {
"marketplace_id": {
"default": "A1F83G8C2ARO7P",
"editable": false,
"hidden": true,
"examples": [
"Amazon.co.uk"
],
"type": "string",
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"enum": [
"A1F83G8C2ARO7P"
],
"enumNames": [
"Amazon.co.uk"
]
}
]
},
"language_tag": {
"default": "en_GB",
"editable": false,
"hidden": true,
"examples": [
"English (United Kingdom)"
],
"type": "string",
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"enum": [
"en_GB"
],
"enumNames": [
"English (United Kingdom)"
]
}
]
}
},
"type": "object",
"required": [
"brand",
"bullet_point",
"color",
"country_of_origin",
"item_name",
"product_description",
"recommended_browse_nodes",
"supplier_declared_dg_hz_regulation"
],
"properties": {
"fulfillment_availability": {
"title": "Fulfillment Availability",
"description": "For those merchants using Amazon fulfillment services, please provide associated logistical information.",
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"maxUniqueItems": 1,
"selectors": [
"fulfillment_channel_code"
],
"items": {
"type": "object",
"required": [
"fulfillment_channel_code"
],
"properties": {
"fulfillment_channel_code": {
"title": "Fulfillment Channel Code",
"description": "For those merchants using Amazon fulfillment services, this designates which fulfillment network will be used. Specifying a value other than DEFAULT will cancel the Merchant-fulfilled offering.",
"editable": true,
"hidden": false,
"examples": [
"AMAZON_NA"
],
"type": "string",
"enum": [
"AMAZON_EU",
"DEFAULT"
],
"enumNames": [
"AMAZON_EU",
"DEFAULT"
]
},
"quantity": {
"title": "Quantity",
"description": "Enter the quantity of the item you are making available for sale. This is your current inventory commitment (as a whole number)",
"editable": true,
"hidden": false,
"examples": [
"152"
],
"type": "integer",
"minimum": 0
},
"is_inventory_available": {
"title": "Inventory Always Available",
"description": "Always available inventory is an alternative to quantity that allows inventory to never deplete. Enabling or disabling will toggle this feature on or off. Note that a quantity cannot be specified when provided.",
"editable": true,
"hidden": false,
"examples": [
"Enabled"
],
"type": "boolean",
"enum": [
false,
true
],
"enumNames": [
"Disabled",
"Enabled"
]
}
},
"additionalProperties": false
}
},
"purchasable_offer": {
"title": "Purchasable Offer",
"description": "The attribute indicates the Purchasable Offer of the product",
"examples": [
"EUR"
],
"type": "array",
"minItems": 1,
"minUniqueItems": 1,
"selectors": [
"marketplace_id",
"currency"
],
"items": {
"type": "object",
"required": [],
"properties": {
"currency": {
"title": "Currency",
"description": "Select the corresponding currency",
"default": "GBP",
"editable": true,
"hidden": false,
"examples": [
"GBP"
],
"type": "string",
"anyOf": [
{
"type": "string"
},
{
"type": "string",
"enum": [
"GBP"
],
"enumNames": [
"GBP"
]
}
]
},
"marketplace_id": {
"$ref": "#/$defs/marketplace_id"
},
"our_price": {
"title": "Purchasable Offer Our Price",
"description": "The attribute indicates the Purchasable Offer Our Price of the product",
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"schedule"
],
"properties": {
"schedule": {
"title": "Purchasable Offer Our Price Schedule",
"description": "The attribute indicates the Purchasable Offer Our Price Schedule of the product",
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"value_with_tax"
],
"properties": {
"value_with_tax": {
"title": "Your Price",
"description": "Provide the base price of an item",
"editable": true,
"hidden": false,
"examples": [
"249.99"
],
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
},
"additionalProperties": false,
}
Sample meta schema output file:
{
"$schema": "https://schemas.amazon.com/selling-partners/definitions/product-types/meta-schema/v1",
"$id": "https://schemas.amazon.com/selling-partners/definitions/product-types/meta-schema/v1",
"$vocabulary": {
"https://json-schema.org/draft/2019-09/vocab/core": true,
"https://json-schema.org/draft/2019-09/vocab/applicator": true,
"https://json-schema.org/draft/2019-09/vocab/validation": true,
"https://json-schema.org/draft/2019-09/vocab/meta-data": true,
"https://json-schema.org/draft/2019-09/vocab/format": true,
"https://json-schema.org/draft/2019-09/vocab/content": true,
"https://schemas.amazon.com/selling-partners/definitions/product-types/vocabulary/v1": true
},
"allOf": [
{
"$ref": "https://json-schema.org/draft/2019-09/schema"
}
],
"title": "Amazon Product Type Definition Meta-Schema v1",
"$comment": "Meta-schema for JSON Schema instances describing the properties and requirements for Amazon product types, such as LUGGAGE.",
"properties": {
"editable": {
"$comment": "Editable indicates whether or not an item property can be modified after the item has been created.",
"type": "boolean"
},
"enumNames": {
"$comment": "For objects with enum values defined, enum names provide display labels for the enum values in the same order as the enum values array.",
"items": {
"type": "string"
},
"type": "array"
},
"hidden": {
"$comment": "Suggests whether or not a property should be hidden in Amazon user interfaces. Hiding or displaying these properties is at the discretion of the application consuming the Amazon Product Type Definition Meta-Schema.",
"type": "boolean"
},
"maxUniqueItems": {
"$comment": "Maximum unique items indicates the maximum number of items with the same combination of selector properties.",
"type": "integer"
},
"minUniqueItems": {
"$comment": "Minimum unique items indicates the minimum number of items with the same combination of selector properties.",
"type": "integer"
},
"maxUtf8ByteLength": {
"$comment": "Maximum UTF-8 byte length indicates the maximum length of a string property in bytes.",
"type": "integer"
},
"minUtf8ByteLength": {
"$comment": "Minimum UTF-8 byte length indicates the minimum length of a string property in bytes.",
"type": "integer"
},
"selectors": {
"$comment": "Selectors indicate the properties of an object in an array that, in combination, make the object unique.",
"items": {
"type": "string"
},
"type": "array"
},
"$lifecycle": {
"$comment": "The $lifecycle element provides details for property and constraint changes, such as replacement properties and enumeration value deprecations.",
"type": "object",
"properties": {
"replacedBy": {
"$comment": "ReplacedBy indicates the properties replacing this property, in an array, using the Relative JSON Pointer specification: http://json-schema.org/draft/2019-09/relative-json-pointer.html.",
"items": {
"type": "string"
},
"type": "array"
},
"replaces": {
"$comment": "Replaces indicates the properties being replaced by this property, in an array, using the Relative JSON Pointer specification: http://json-schema.org/draft/2019-09/relative-json-pointer.html.",
"items": {
"type": "string"
},
"type": "array"
},
"enumDeprecated": {
"$comment": "EnumDeprecated provides an array of enum values that are deprecated and will be removed in the future. Existing usage of these deprecated enum values should be replaced with another value before they are removed.",
"items": {
"type": "string"
},
"type": "array"
},
"enumReplacement": {
"$comment": "EnumReplacement provides an array of deprecated enum values with their suggested replacement value(s) in an array.",
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"$comment": "Deprecated enum value.",
"type": "string"
},
"replacements": {
"$comment": "One or more suggested replacement values for the deprecated enum value in an array.",
"items": {
"type": "string"
},
"type": "array"
}
}
}
}
}
}
}
}