In this article, we’ve added a recommended setup for your integration, including disabling subtitles and auctions due to the extra fees it incurs. Familiarise yourself with Trade Me’s fees and charges before making any changes to the recommended settings.
-
In FILEHEADER, insert the following line into the text field:
sku,title,subtitle,description,categoryId,buyNowPrice,buyNowOnly,stockLevel,listingDuration,allowPickups,isNew,allowBankTransfer,allowCreditCard,allowSafeTrader,allowCash,sendPaymentInstructions,shippingPrice1,shippingDescription1,isGallery,imageFileName1,imageFileName2,attributeName1,attributeValue1,attributeName2,attributeValue2,attributeName3,attributeValue3
Warning: Ensure the cursor moves onto the next line after pasting the code. A line break is required for it to function correctly.
-
The fields we’ve just added are the names of the available product fields in Trade Me. In FILE BODY - header, we need to build out the values of these fields by linking (or mapping) them to available fields in Maropost Commerce.
To do this, we’re going to be using a combination of the Custom Product Fields tags we created earlier, along with product fields already in Maropost Commerce.
With every Custom Product Field you created, a field ID will also be created, eg. ‘misc5’. When using the FILE BODY - header section, we turn this into a tag which looks like this: [@misc5@]
You can also add values from the default fields in Maropost Commerce if you don’t wish to recreate data again in any of the Custom Product Fields. Eg. Using the title and description that already exist in Maropost Commerce without the need to use ‘Trade Me Title’ and ‘Trade Me Description’.
To do this, simply go into any product in Maropost Commerce and look for the associated tag icon besides any field as shown in this example.
-
Now it’s time to build out our FILE BODY - header. Similar to the FILEHEADER section, we just add the values of all fields, separating each value with a comma. Using the table below, we just add the the values listed under the Maropost Commerce Fields column.
-
Lets start on the first 4 fields (Sku, Title, Subtitle and Description) together. We’ve already added recommended values for each field however you will be required to change some of these fields as per the Description column.
The first 3 values will look like this:
"[@SKU@]","[%FORMAT type:'text' nohtml:'0' noeol:'0' %][@misc2@][%END FORMAT%]","","[%FORMAT type:'text' nohtml:'1' noeol:'0' %][@misc3@][%END FORMAT%]"
Now continue to build out the remainder of the fields using the table below.
| Trade Me Fields | Maropost Commerce Fields | Description |
|---|
| sku | "[@SKU@]" | This is the product SKU |
| title | "[%FORMAT type:'text' nohtml:'0' noeol:'0' %][@misc22@][%END FORMAT%]" | Replace [@misc22@] with Your Custom Field: Trade Me Title |
| subtitle | "" | Disabled by default |
| description | "[%FORMAT type:'text' rmhtml:'1' noeol:'0' %][@misc23@][%END FORMAT%]" | Replace [@misc23@] with Your Custom Field: Trade Me Description |
| categoryId | "[@misc21@]" | Replace [@misc21@] with Your Custom Field: Trade Me Category |
| buyNowPrice | "[@price_7@]" | Replace [@price_7@] with Your Custom Field: Trade Me Price |
| buyNowOnly | "1" | Buy now option only (0: Disable/1: Enabled) |
| stockLevel | [@store_quantity@] | Can be replaced with a specific warehouse or a static value for products always in stock. |
| listingDuration | "7" | Durations are 2, 3, 4, 5, 6, 7 and 10 days. 10 day listings incur a fee. |
| allowPickups | "0" | Can you pickup in NZ? 1 for enable, 0 for disable. |
| isNew | "1" | Is it a new item? 1 for enable, 0 for disable. |
| allowBankTransfer | "0" | 1 for enable, 0 for disable. Only use NZ banks. |
| allowCreditCard | "1" | 1 for enable, 0 for disable. |
| allowSafeTrader | "0" | Only applicable for NZ banks. See more here. |
| allowCash | "0" | 1 for enable, 0 for disable. This is for pickup only. |
| sendPaymentInstructions | "1" | 1 for enable, 0 for disable. |
| ShippingTemplateName | Name of shipping template created in TradeMe | Enter the name of your shipping template created in TradeMe. For more information on how to set this up, please refer to the guide: Trade Me |
| isGallery | "1" | 1 for enable, 0 for disable. Gallery attracts a fee. |
| imageFileName1 | [@image_full@] | Uses Main Image. See image guidelines. |
| imageFileName2 | [@thumb_full_1@] | Uses Alt Image 1. See image guidelines. |
| attributeName1 | [@misc24@] | Replace [@misc24@] with your custom field: 1. Trade Me Specific Type (eg: Colour) |
| attributeValue1 | [@misc25@] | Replace [@misc25@] with your custom field: 1. Trade me Specific Value (eg: Red) |
| attributeName2 | [@misc26@] | Replace [@misc26@] with your custom field: 2. Trade Me Specific Type (eg: Colour) |
| attributeValue2 | [@misc27@] | Replace [@misc27@] with your custom field: 2. Trade me Specific Value (eg: Red) |
| attributeName3 | [@misc28@] | Replace [@misc28@] with your custom field: 3. Trade Me Specific Type (eg: Colour) |
| attributeValue3 | [@misc29@] | Replace [@misc29@] with your custom field: 3. Trade me Specific Value (eg: Red) |
- If you get stuck, here is an example of a completed FILE BODY - header:
"[@SKU@]","[%FORMAT type:'text' rmhtml:'1' noeol:'1' %][@misc10@][%END FORMAT%]","","[%FORMAT type:'text' rmhtml:'1' noeol:'1' %][@misc11@][%END FORMAT%]","[@misc21@]","[@misc1@]","1",[@store_quantity@],"7","0","1","0","1","0","0","1","[@misc9@]","International Courier","1",[@image_full@],[@thumb_full_1@],[@misc12@],[@misc13@],[@misc14@],[@misc15@],[@misc16@],[@misc17@]
-
Click the Save Changes button to complete the file builder setup.