Setup guide for Qantas Marketplace

Please read this FAQ fully before you proceed.

Introduction and Overview

This article includes setup with configuration and technical instructions. The Qantas Marketplace is engineered by Marketplacer; some of the setup steps in Omnivore are customised and differ from other mainstream markets.

Before you begin please be aware of the following points:

To sell on the Qantas Marketplace using Marketplacer there must have an active and approved selling account. To confirm please check with the onboarding team at Qantas Marketplace
If this is already in place the setup in Omnivore can begin.
Retrieve the API Key from the Qantas Marketplacer team.
With these points in mind setup in Omnivore can continue.

Setup & Configuration

Before you proceed, steps 1-13 below include: Adding The Marketplace + Refreshing Brand & Categories + Completing fields on the 'Settings - General' page in Omnivore. These must be completed first and are best done in order.
Add the Qantas Marketplace into the Omnivore instance. To do this navigate to the Settings, Marketplaces page in Omnivore, select Create Link and Config.
When the market has been added you will see the Qantas Marketplace Tab in Omnivore, click Settings - Qantas Market - General to view the Connection and Advanced Settings section.
On this page add the API Key Credentials retrieved from the Qantas Marketplace Team.
Scroll down and click Update and Check Connection.
Brand & Category Retrieval and Update Steps. See the article above to 'Retrieve Brands allowed for the seller' (written by dev).
To begin this process in Omnivore navigate to Retailer Admin - New Dashboard - see Marketplacer rest api - click 'Download Brands create/update Marketplace Brands'.
This process can take a few seconds to complete so if nothing appears to change on the screen give it time.
When this job is complete it will display a screen like this - done, active brands = 992
This process can also be repeated when you just want to Update Brands for Qantas.
Navigate to Marketplace Admin - Marketplaces - on this page scroll down to find Qantas Marketplace and click 'View Brands' to check that the brands have been imported for that new marketplace you just added. For more required Brand Settings for Qantas , see 'Brand Options' below.
While on this same page in step 10 click the Refresh Categories button for that newly added market.
As you continue please refer to the two screen captures below.
Insert the 'Seller GraphQL Id' into the respectively named field. For Qantas this ID is the same for every seller:
Before proceeding click Update and Check Connection.
Omnivore can add dimensions for Shipping Setup if you do not have this information in your product data - please ask Qantas if you have to supply dimensions.
Tick the 'Validate Product Attributes' check box if it is not ticked as part of the config.
Insert N/A into the Not Available Value field.
Default Order Email, please read this FAQ to determine if you need this or not.
Shipping Profiles. If you are using shipping from the marketplace tick the 'Use Shipping Policies' box - follow this article for next steps.
Prefix Order Number, see full explanation below under the heading 'Órder Settings' below.
The Use Map Brands check box can be left unticked, please speak with your Integration Specialist.
If necessary, import your products from you eCommerce Store. The e.g. below shows the Import from Custom PullXml. If there are other marketplaces already active in Omnivore you don't need to do this step.
At this stage you are connected to the Qantas Marketplacer Operator but you are still in setup mode so product feeds, syncing and uploads have not started yet.

Summary of Seller Settings

Product Identifiers: if ticked we will not send UPC or Barcode data to the market.
Max Stock Quantity: used to define the max stock quantity we will push to the market.
Validate Product Attributes: must be ticked for Qantas Marketplace.
Use Map Brands: please see Brand Section below.
Use Shipping Profiles: More information on Shipping Setup below.
Prefix Order Number: this must be ticked by default. This will insert the word 'qantas' at the beginning of each order number.
Use GraphQL: obtain the seller GRAPHQL id from the Qantas Marketplacer Team.

Important: Any changes made to the Advanced Product Settings have to be saved by clicking 'Update' at the bottom of the page. During the setup phase a marketplace category refresh within Omnivore must also be completed (part of steps 10 and 11 above).

Required Check List

Decide Which Products to List

Omnivore has the function to Block and Exclude Products from listing, this means you can pick and choose what to list by blocking and unblocking products.
For more information on Blocking and Excluding click here.

Shipping Setup

There are two options for Shipping Setup:

Shipping Profiles from the Marketplace OR Shipping Policies setup with Omnivore.

Note: Qantas Market has very specific Shipping Requirements.

Follow this article for the setup options.

Brand Options

There are two brand options, Map Brand OR Brand Slug (default)

Map Brands: if the 'Send the value as Map Brands' field is ticked in Omnivore this means the retailer brand we send to the Marketplace has to be mapped on the Marketplace side, this is done by the Markeplacer Team or the retailer.

Brand Slug: this is the default brand setting, in this case we send a brand list to the Marketplace, once that brand list is in the Marketplace's Database we then reimport the brand list with any changes made by them. The reimported Brands in Omnivore now match what the Marketplace has. No further steps by the retailer or Omnivore are required.

Order Settings & Product Lead Time

Within the Omnivore go to Settings - Qantas - General, the field called called 'Prefix Order Number' must have a value entered. Whatever value is added into this field must also to have a - on the end.

Eg qantas- will prefix the order number with that value. So your order reference number will be formatted like this example: " qantas-240108 ".

If you want to adjust the default Product Lead Time you can do so in Omnivore, contact Support and we can adjust the Global Attribute Mapping for Product Lead Time. This information is sent to Qantas as an attribute, so the attribute value we set in Omnivore will become the default in Qantas.

Category Mapping

To successfully list a product it must be mapped to an Qantas Marketplace Category. The Category Mapping process in Omnivore is the same for all marketplaces.
For more information on Category Mapping in Omnivore click here.

Product Identifiers

This includes GTINs, UPC and EAN; the general rule on if product identifiers are required is defined by the marketplace. Omnivore imports product identifiers from the eCommerce Store, if the data is not required we do have functions to not send that type of data. For Marketplacer Markets this settings is on Settings - Qantas - General - Product Identifiers.

Start Selling

While setting up the Qantas Marketplace in Omnivore the integration is in Setup Mode, this means that feeds, syncs and uploads have NOT commenced yet. As you complete the many setup steps Omnivore will automatically reveal the Start Selling button on the Dashboard. In order for you to go live on the Marketplace you must hit Start Selling. There are checks and tests that we recommend before Start Selling is activated.