THE ICONIC: marketplace guide

About this guide

This is a ChannelEngine guide on the Sydney, Australia-based marketplace THE ICONIC, part of Global Fashion Group. Here you can find information on how to request a THE ICONIC account, how to configure this marketplace on ChannelEngine, and what the specific requirements are.

Table of contents

Commercial information

How to request an account

Associated costs

Marketplace features

Settings and configuration

Marketplace-specific requirements and exceptions

• Setup
• Categorization
• Mappings
• Pricing
• Listed products

Additional information

FAQs

About this channel

THE ICONIC is part of the Global Fashion Group (comprising THE ICONIC, Dafiti, and ZALORA), and it is the leading online retailer for fashion, sports, and kids in Australia and New Zealand.

Commercial information

How to request an account

Contact ChannelEngine’s Channel Partner team to request an introduction to THE ICONIC.

Associated costs

THE ICONIC does not charge any setup or monthly fees. Commission rates vary and are based on the level of support you require from THE ICONIC, e.g.: support required for producing content.

Marketplace features

1. To enable managing returns via ChannelEngine, first check with your THE ICONIC contact person if you participate in the THE ICONIC Direct Returns program. If you participate, then Returns from warehouse is enabled on the THE ICONIC backend, and you can proceed to process returns via ChannelEngine.
2. Grandparents are not allowed, and product families are only used for size variations. Therefore, a parent product is a product of a specific color whose child products are of various sizes.
3. Bullet points are not visible on the frontend of the website. If using bullet points to describe your product features, list them with hyphens.

Settings and configuration

Setting up each channel on ChannelEngine follows the same flow, though not every channel includes the steps listed below.

1. Go through the Setup.
2. Create a Product selection.
3. Complete the Categorization.
4. Set up the Mappings: content, offers, and carriers.
5. Configure the Pricing: rules and currency conversion.
6. Fill in the Stock settings.
7. Finish the Activation.
8. Check the Listed products overview.

Marketplace-specific requirements and exceptions

Setup

On THE ICONIC

Connect your THE ICONIC seller account with ChannelEngine.

1. Add ChannelEngine to your applications on the THE ICONIC platform:
   • Go to Integration management.
   • Select Add application.
   • Enter the URL of your ChannelEngine tenant.
2. Then, retrieve the following information: 
   • Seller ID - navigate to Settings, Your profile. Your Seller ID is located under the General tab. It is the first field in the Seller account information section. 
   • API key - now go to Settings, Integration management. Your API key can be found in the section API explorer. 

Agree on your fulfillment model with THE ICONIC.

1. Decide if you will use your own carriers or if you will use THE ICONIC’s carriers and shipping labels for last-mile delivery.
2. Configure your carriers on THE ICONIC’s platform.

On ChannelEngine

Log in to ChannelEngine, and go to the Setup step of your THE ICONIC plugin.

1. In Connection, enter the credentials that you obtained from THE ICONIC into the following fields:
   • Client ID - enter your Seller ID.
   • Client secret - enter your API Key.
2. Then, in Plugin specific settings, specify whether you will ship directly to buyers or if THE ICONIC ships: 
   • Fulfillment type - if you assume all shipping costs, choose Delivery by Seller. If you make use of THE ICONIC’s carrier account and shipping labels for last-mile delivery, then choose Delivery by The Iconic.

Categorization

Categorization is mandatory if you want to create or update existing product information on THE ICONIC.

The choice of categories that you are able to select is specific to your seller account on THE ICONIC. Therefore, the choice of mappable categories will not necessarily match the full suite of categories that are visible on THE ICONIC.

Mappings

Content

All products (required)

• Brand - the name of the brand of the product. 
• Description - a text or HTML-enriched description of the product, including three to five unique selling points for potential buyers.
  • If using bullet points, use a hyphen (-) and a space to begin bullet points because the bullet point character is not visible on the website. Capitalize the first letter of each bullet point.
  • The product name must be in bold.
  • The description can contain between 6 and 25,000 characters.
• Image 1 - the URL of the main product image. Below are the general guidelines:
  • Orientation - portrait.
  • Background - white (product) or light grey (apparel).
  • Format - JPEG.
  • Resolution - at least 762x1,100 px, and 300 dpi.
    File size - at most 2 MB.
  • Free from blur, image distortion, cluttered backgrounds, and watermarks/brand logos of any kind.
  • Products must be presented as the main focus of the image, and in a neat manner.
  • Only one model may appear per image for apparel.
  • The suggested image file structure is [SKU]_[ImagePosition].jpg. E.g.: 
    • BlueDressAIX_1.jpg for the main image.
    • BlueDressAIX_2.jpg for the secondary image.
    • BlueDressAIX_3/4/5.jpg for the tertiary image.
    • etc.

• Name - the name of the product, e.g.: Jewel Sweetheart Maxi Dress. Avoid using abbreviations, colors, symbols, or product codes in the name. Maximum 100 characters.
• Colour - the overall color family of the product, for internal use, e.g.: ‘blue'. Note: if there are three colors or more, use the value 'multi'. 
• Colour name - the color of the product, for display on the website. This value is typically a vanity color, e.g.: ‘Indigo’.
• SKU supplier config - the ChannelEngine Merchant product number or style code. Take a look at the Product variations section below for more information on style codes and mapping the SKU for parent products.
• Weight (kg) - the weight of the product in kg. 

All products (optional)

• Browse nodes - add the most relevant browse nodes for the product, so prospective buyers can find your products easily, other than the categories that you specify in Sub categories.
• Image 2-9 - additional product image URLs.
  • THE ICONIC recommends that you provide at least five additional images.
  • These images should show the product or clothing item from additional angles.
  • If the product is clothing, then an image that shows the suggested styling of the apparel is also recommended.
  • Upload product images in the order of front - side - back - close-up (swatch).
• Product identifier - the product’s GTIN.
• Sub categories - suggest categories where the product is listed on the website.
• Associated SKUs - the SKUs of products to link under the “Wear it with” heading on the listing, separated by a space.
• Care label - special care instructions. Separate bullet points with a comma ( , ), and capitalize the first letter of each bullet point. Avoid using special characters to denote temperature. E.g.: 'Machine wash up to 30 degrees Celsius'. Maximum characters: 255.
• Colour hex - the hexadecimal code of the product’s color, to generate a color swatch on the listing.
• Flammable liquid/gas - ml of product - if the product contains a flammable gas or liquid, indicate the volume in milliliters, e.g.: ‘50’.
• IsHybridDepth - gives an indication of whether the product is hybrid depth.
• Model's body measurements - the model’s height or other measurement that is specific to the product they wear.
• Omit from new arrivals - indicate if the product is not listed in the “New arrivals” section of the website.
• ParentSku - to group variations (different sizes) of a product together, this attribute must be mapped. The mapped value can be the style code for the parent product with no sizing attached. E.g.: 'THJ01-WHITE'.
• ProductId - the barcode.
• Size of model’s garment - the size of the product that the model is wearing, e.g. ‘Model wears size 10/S’.
• Vimeo video ID - if using a video, indicate the unique videoID from the end of the Vimeo URL.

Offer

All products (required)

• Status - choose active or inactive. If you choose inactive, the product is unlisted from the marketplace.

All products (optional)

• Sale price end date - the date until which the product's sale price is valid, if applicable. The expected format is yyyy-MM-dd hh:mm. e.g.: 2025-02-15 15:30.
• Sale price start date - the date from which the product's sale price is valid, if applicable. The expected format is yyyy-MM-dd hh:mm. e.g.: 2025-02-15 15:30.

Carrier

Carrier mapping is required for THE ICONIC. For more details on supported carriers, check out the Shipments section below. 

Pricing

In Mappings, Offer mappings, the following offer attribute may appear on this channel, if this channel uses pricing v2:

• Allow promotion below min price - set it to ‘true’ to allow the promotion price to drop below your product's minimum price. 

In Mappings, Fee group mappings, map the marketplace fee group ID of the product.

Set up your product’s prices in Pricing, Price rules.

The default currency for THE ICONIC is AUD. However, orders can originate from both Australia and New Zealand.

Listed products

If you have problems with products not appearing on THE ICONIC (especially when trying to create products), check the Listed products page for more information.

Additional information

Product variations

• THE ICONIC uses the product identifier Parent SKU to recognize product families. All child products of the same family must have the same Parent SKU.

• Via the API, THE ICONIC recognizes size as a product variation. Therefore, products of various sizes are grouped under a parent of a single color. For parent products, THE ICONIC recommends using a style code with no size attached. THE ICONIC does not support grandparent products.

• The style code structure is: [Model]-[Color]-[Size]. E.g.: the style code WK001-BLK-S translates to:

  • Model - WK001

  • Color - Black

  • Size - S

• The style code of a parent product omits the size, e.g.: WK001-BLK

Order extra data items

When an order is imported to ChannelEngine, ChannelEngine also retrieves extra data items related to the order itself – or to order lines. This extra data is specific to this marketplace. An explanation of each can be found below: 

Order extra data

Order line extra data

Canceling orders

Only paid orders are imported into ChannelEngine, and these orders are imported with the status New. If a THE ICONIC order is imported into ChannelEngine with the status New, and it is then canceled on THE ICONIC, it is also canceled on ChannelEngine. Orders that are canceled on THE ICONIC but are not yet imported into ChannelEngine are not imported during the next order import task. Note that orders cannot be canceled by the buyer when the order has the status Ready to ship.

Shipments

You must configure your selection of carriers on THE ICONIC’s back-end platform.   

THE ICONIC specifies in the order which carrier to use to ship the given order. The predefined carrier is indicated in the ShipmentProvider field in the order extra data. Always specify a carrier when creating the shipment on ChannelEngine. 

Shipping labels

If you use last-mile delivery for fulfillment, once you create your shipment with the specified carrier, ChannelEngine will request the shipping label for you from the marketplace. For guidance, check out ChannelEngine: shipping labels (last-mile delivery).

FAQs

How often does each task run on THE ICONIC?

How long does it take for THE ICONIC to approve my product content and offers?
It usually takes THE ICONIC two to five business days to approve product data. Pricing updates can take a minimum of one hour before appearing on the live marketplace.

All new product content is reviewed by the THE ICONIC Quality Control (QC) team before it can go live on the marketplace. The review process takes two to five business days to either: 

1. Approve products to go live on the THE ICONIC website  
2. Disapprove/reject products that do not fulfill their requirements.