Trade Me New Goods Feed

The New Goods Feed (NGF) allows you to import and update your Trade Me products via a csv type file using an FTP connection. You will first need to set up your account and access with our support staff and then set up your shipping templates before import. Please see the section “How to add shipping templates for New Goods Feed”.

You will need to contact support@tradevine.com to get this set up.

Steps for setting up your listings

  1. Get your new account setup via Support or Account Manager 
  2. Set up your new shipping templates to use with your products (see the section “How to add shipping templates for New Goods Feed”).
  3. Create your import file via CSV or XML. 
  4. Load the file via ftp with images
  • Once uploaded, your listings import will be validated and report any errors (if any)
  • Once validated, listings are then created on www.trademe.co.nz
  • You can edit your listings at any time by making changes to your CSV file and re-uploading via ftp server.

Table of Contents

  1. How to add shipping templates for New Goods Feed
  2. Criteria for the full benefits of shipping templates:
  3. Creating and updating shipping templates
  4. How to set up a new shipping template – Free shipping
  5. How to set up a new shipping template – Shipping costs by destination
  6. Quick Guide to the Templates
  7. Applying Shipping Templates
  8. How to make changes to my existing Shipping Templates
  9. How will the shipping templates display on your listings?
  10. How to set up your import file

How to add shipping templates for New Goods Feed

We know that buyers want transparency across shipping time and costs. Our buyers have told us that surfacing this info offers a better experience and we are confident that this should lead to a higher conversion rate for you.

By adding your shipping templates, you’ll be able to provide buyers with clarity about the delivery time and total cost of purchase, throughout the buying journey.

Examples of listings with shipping details

You can use a shipping template on multiple listings, which will make it easier to manage your shipping options if you have lots of products.

All listings will need to provide shipping templates. However your listings need to meet the following criteria in order to see the full benefits of delivery timeframes:

Criteria for the full benefits of shipping templates:

  • It must be a Buy now only listings (i.e. no auctions)
  • Marketplace or Auto Parts categories 
  • Not Pick Up Only

Listings that don’t meet the criteria will still set up shipping templates as expected and will still see shipping options on their listings, however will not show expected delivery timeframe like those that meet the criteria (see designs under ‘How will the shipping templates display on your listings?’). 

Pick Up Only Items

If the ‘pickup’ element is set to ‘demand’, the shipping template does not need to be provided and will just show “Buyer must pick-up…”

Creating and updating shipping templates

  1. Go to https://nz.tradevine.com/
  2. Login using your TradeMe credentials by clicking on the ‘Sign in with TradeMe button’
  3. Navigate to Products > Shipping templates
  4. Click on ‘Add Shipping Template’

How to set up a new shipping template – Free shipping

A Free shipping template is used when you offer nationwide free shipping on your item.

  1. Give your template a name (e.g. ‘Free Shipping’) and then select ‘Free shipping’
  2. Provide the carrier product and handling times so that we can display time estimates for buyers.
  3. Select your handling time in business days. This is the amount of time it takes from the customer order to you giving the package to your carrier, in business days. Note that your handling time is added to the shipping option days to give the customer an estimate of the total number of days the item will take to arrive after purchase.
  4. Select your order cut off time
  5. Select  ‘Save & apply template’

How to set up a new shipping template – Shipping costs by destination

A template to specify shipping costs by destination is used when you offer paid shipping either nationwide or by destination. You will need to provide the carrier products, costs and handling times for your shipping options so that we can display time estimates for buyers.
We recommend you specify a nationwide option in addition to any specific location options.

  1. Give your template a name (e.g. ‘Small Items Courier’) and then select ‘Shipping costs by destination’.
  2. Create at least one option.
  1. Enter the cost (e.g. 6.99)
  2. Select the carrier you’re using. Note that the carrier name doesn’t currently display to buyers. If the carrier you prefer isn’t listed, or you use multiple carriers, you can use the Generic option and select the product that best matches your delivery times.
  3. Select the shipping destination. Destinations are based on a location tree/hierarchy. Buyers will see the shipping rates relevant to their location when they search – it is a good idea to have one nationwide option so that as many buyers as possible can see your shipping estimates in search.
  4. Choose the carrier product (e.g. Standard (1-2 days))
  5. For rural shipping options these are available as products (e.g. Rural Standard)
  6. Repeat steps above if you want to add more than one option.
  1. If you would like to offer combined shipping (free or cheaper shipping for a second or subsequent item) then select the combined shipping option
    1. Similar to shipping options, set the price (enter $0 if you want it to be free)
    2. The combined shipping option will display on your listing page as “Combine with another item you’ve paid shipping on.”
  2. Select your handling time in business days. This is the amount of time it takes from the customer order to you giving the package to your carrier, in business days. Note that your handling time is added to the shipping option days to give the customer an estimate of the total number of days the item will take to arrive after purchase.
  3. Select your order cut off time
  4. Select  ‘Save & apply template’

Quick Guide to the Templates

Template Name:

Give the template an easily identifiable name. Can be alphabetical or numbers, no special characters. This will be what you provide in your CSV/XML file.

For each shipping option (one or more)

Cost:

Enter the cost for that particular shipping option.

Carrier:

Most NZ courier companies will be shown here. If you can’t find the courier you use, select ‘Generic’. Carrier is not shown on the listing page currently.

Destination:

You can specify that this option is only for a specific region. If the buyer is outside the specified region, then they will be shown Nationwide cost. Make sure you have at least one option with Nationwide cost.

Product:

Choose the carrier product, e.g. Standard (1-3 days). We will add the handling time to the days when displaying delivery times to buyers.

Signature:

If you select the With the Signature option, the customer will see two shipping options on the listing – the price without signature and the price with signature, and they will be able to choose between the two. 

For this template:

Combined Shipping:

If you would like to offer free or reduced shipping for additional items, select ‘Add combined shipping option’.

Similar to shipping options, set the price (enter $0 if you want it to be free)

This will display to buyers as “Combine with another item you’ve paid shipping on.”

Shopping-cart combined shipping rules will not be affected by this template.

Handling Time:

Handling time is the time between when the buyer places the order until you hand the order over to your carrier. This is added when showing estimated delivery time to buyers.

Total Delivery Time = Handling Time + Courier Transit Time

If you go on a holiday or if there’s a delay in courier picking up the items, simply change this, and it will be reflected in estimated delivery times as soon as your products are relisted.

Order cut-off:

Let customers know when an order needs to be placed for processing to begin on the same day.

Applying Shipping Templates

Now that you have your new templates set up you will now need to provide the Shipping Template Name in the CSV/XML file you upload to the FTP Server under the column ‘shippingTemplateName’. 

You will no longer need to provide the shipping options in the CSV/XML file. Simply adding the Shipping Template Name will attach the shipping options set up in the template to the listing. 

Please note: Listings that meet the criteria will show the delivery estimates with Structured Shipping Templates. For listings that do not match the criteria, you will still see the shipping options on your listings without estimated delivery timeframes. See screenshots below.

To view how to properly set up your CSV/XML file for uploading listings, please see section “How to set up your import file”

How to make changes to my existing Shipping Templates

Updating templates is as easy as following the steps from above. And new listings or relists will automatically get the updated options. For existing listings, you’ll need to manually edit listings and reupload your csv file or contact support to do a bulk update of active listings. Please note: we recommend you make a small edit to description (adding a space at the end) to ensure proper updating to the existing listings.

How will the shipping templates display on your listings?

We’ll use the info from your new shipping template to calculate and display the most appropriate shipping info to the buyer, alongside the full cost of purchase. This can be seen throughout the full buying process.

Once you’ve set up your new templates and updated your products, your listings will be updated with the new shipping information as soon as they are edited or relisted.

Here are some examples of how your listing page will look with the new shipping options:

Listings that meet the criteria
Listings that don’t meet the criteria will not display delivery estimates

How to set up your import file

For more information on how the retail feed works please download either the CSV or the XML specification.

Download CSV Specification

Download XML Retail Feed Specification 02

Once you are ready to go you can add your products to the csv import template file ready for uploading.

Download Import Template

This is a simple template file. If you need more fields than the basic template provides then please refer to the specification for any additional fields.

You can also download the categories file so that you can find and add the category IDs (codes).

Download Category IDs