PRODUCT_SKU (required)
Description: Unique field identifying the product. This should not be changed once assigned to a product
Type: String
Validation:
- No more than 45 characters consisting of letters, numbers, underscores, periods or hyphens
PRODUCT_TITLE (required)
Description: Name of the product
Type: String
Validation:
- No more than 230 characters
- Unicode symbols are not accepted
Product titles must contain sufficient information to identify the product, and must not contain any additional or duplicate swords that are not relevant to the specific product, such as the name of a seller.
"Keyword stuffing", or loading the Title with keywords is not permitted.
PRODUCT_DESCRIPTION (required)
Description: HTML description of the product
Type: String
Validation:
- Only safe HTML tags are allowed. See here for a full list of safe HTML tags
- Unicode symbols / hyperlinks will be stripped
Must be clear and concise, and detail all the relevant features of the product to enable a consumer to make an informed decision, as well as any information required by any applicable laws and regulations.
The description must not include information specific to the Seller (such as pricing or special terms). Please review the Duplicate Listing Policy for more information.
BRAND (optional)
Description: Brand name of the product
Type: String
Validation: No more than 230 characters
Only a legitimate brand that applies to the specific product can be used, and may not include the sellers name unless approved.
Examples:
|
BRAND |
Valid (Y/N) |
Reason if invalid |
|
Maxwell & Williams |
Y |
|
|
Maxwell & Sons |
N |
A non-existent brand |
CATEGORY (required)
Description: Kogan Category. Refer here for the full list of Kogan Categories
Type: String
Validation: Must be a choice in the list
STOCK (required)
Description: Number of products available for purchase
Type: Integer
Validation: Non-negative integer. 0 stock will be marked as sold out
Sellers should ensure the stock number provided is a number the sellers is confident it is able to accept orders, until the next time the stock data point is updated.
PRICE (required)
Description: Sell price of product excluding shipping cost
Type: Integer or Decimal
Validation: Positive integer OR decimals (2 decimal places)
Price representations should be compliant with the law and be competitive pricing in keeping with Kogan.com being a discount and price competitive destination.
Examples:
|
PRICE |
Valid (Y/N) |
Reason if invalid |
|
89 |
Y |
|
|
89.95 |
Y |
|
|
0 |
N |
Sell price cannot be zero |
|
1,000 |
N |
Thousand separators must be omitted |
|
$10.00 |
N |
This field cannot contain any symbols |
PRICE_NZD (required if selling in NZ)
Description: Sell price of product excluding shipping cost
Type: Integer or Decimal
Validation: Positive integer OR decimals (2 decimal places)
SHIPPING (required)
Description: Shipping cost in addition to Sell Price.
- 0 for FREE SHIPPING, OR
- A positive number for fixed shipping cost per item, OR
- “VARIABLE” for variable shipping rate (Please see here on how to set this up)
Type: Integer or Decimal or String
Validation: If a number, no more than 5 digits including 2 decimal places
Shipping prices should not be disproportionally high compared to the price of the product. To discuss please contact your account manager.
Examples:
|
SHIPPING |
Valid (Y/N) |
Reason if invalid |
|
0 |
Y |
|
|
9.99 |
Y |
|
|
-1.00 |
N |
Shipping cost cannot be negative |
|
1000.01 |
N |
More than 5 digits including 2 decimal places |
|
$10.00 |
N |
This field cannot contain any symbols |
SHIPPING_NZD (required if selling in NZ)
Description: Shipping cost in addition to Sell Price.
- 0 for FREE SHIPPING, OR
- A positive number for fixed shipping cost per item, OR
- “VARIABLE” for variable shipping rate (Please see here on how to set this up)
Type: Integer or Decimal or String
Validation: If a number, no more than 5 digits including 2 decimal places
IMAGES (required)
Description: List of publicly-readable image URLs separated by a pipe character, i.e. "|" (without quotes). We only download the first 8 images from this list. The first URL - the main image - is required. The next 7 are optional.
Recommended dimensions: 1000 x 1000px
Maximum Width: 1320px
Maximum Height:1080px
Resolution: 720dpi
Type: String
Validation: Each URL must start with http:// (or https://) followed by a fully qualified domain name.
The first image requires a white background with a clear representation of the product, centred in the image. Marketing messages or added text is not permitted on images.
Examples:
|
IMAGES |
Valid (Y/N) |
Reason if invalid |
|
https://images.example-domain.com.au/750px/product-image-1.jpg |
Y |
|
|
https://images.example-domain.com.au/750px/product-image-1.jpg|https://images.example-domain.com.au/750px/product-image-2.jpg |
Y |
|
|
/home/johndoe/Photos/img1.jpg |
N |
Not a valid URL that we can download |
|
ftps://example-domain.com.au/images/img1.jpg |
N |
Must be HTTP |
PRODUCT_SUBTITLE (currently not in use)
Description: Additional “byline” you want to place below product title
Type: String
Validation: Plain text. No more than 200 characters. If validation fails a blank string will be used
Must be clear and concise, and relevant to the specific product.
PRODUCT_INBOX (optional)
Description: What’s in the box?
Type: String
Validation: Only safe HTML tags are allowed, a full list can be found here. If validation fails a blank string will be used
PRODUCT_GTIN (required)
Description: Global Trade Item Number
Type: String
Validation: 8, 12, 13 or 14 digits long.
This is typically the product barcode.
The following are exempt from providing UPC's:
- Multi-packs or bundled products
- Refurbished goods
- Non-branded generic goods
Please see here if you are not able to provide GTIN's for your products
RRP (optional)
Description: The "Don't Pay" Price that would be shown as “Don't Pay $XXX” below Sell Price on Product page
Type: Integer or Decimal
Validation: Positive integer or positive decimals (2 decimal places). If validation fails NULL will be used
Price representations should be compliant with the law.
RRP_NZD (optional)
As per RRP, for use if selling into NZ
HANDLING_DAYS (optional)
Description: Number of days before an in-stock item ships. Default to 0 if not specified
Type: Integer
Validation: Non-negative integer
Must represent an amount of time the seller is confident it can achieve on over 95% of orders.
If the handling_days field is not provided, it is expected that the orders are dispatched within one business day. Please provide the appropriate handling_days if your handling time is longer than one business day.
How does handling delay affect product listings
Examples:
|
handling_days |
Valid (Y/N) |
Reason if invalid |
|
1 |
Y |
|
|
3/2 |
N |
Must be an integer >= 0 |
|
1.5 |
N |
Must be an integer >= 0 |
HANDLING_DAYS_NZD (optional)
As per RRP, for use if selling into NZ
PRODUCT_LOCATION (optional)
Description: The location from where the product is sold, for GST collection purposes.
Type: String
Validation:
- 2 characters long
- Matches a code from the list of valid countries found here
KOGAN_FIRST_PRICE (optional)
Description: Sell price of product excluding shipping cost
Type: Integer or Decimal
Validation: Positive integer OR decimals (2 decimal places)