Items sources

Load the list of the items you would like to sell on a marketplace in trimpo

Trimpo can get items info either from yml or excel files, or you can add items manually.

Read more about YML
Read more about Excel
Read more about manual adding


YML file.

This is a format created by Yandex for transferring your items info in XML. You can read more about it on yandex.market.

What is YML file?

How to get YML file?

How to check YML file?

Which columns in YML file needs to be filled?

What additional tags trimpo supports?

How to transfer full item description with formatting?

How to paste YouTube video in description?

How to transfer item with goods of different properties?

How to transfer trade rule and eBay category?

YML(Yandex Market Language) — is a format created by Yandex for transferring info about your items in XML. Read more about it on yandex.market.

How to get YML file?

If you use one of the popular CMS-systems (such as In_sales, Bitrix, Shop-Script, WordPress etc), then you most probably already have the modules or sections in the system that allow you to customize parameters needed to create YML file with your items in it.

If not – try to contact your CMS support or find more info in Google: how to create yml file in your CMS system.

How to check YML file?

You can use a special service for this: https://webmaster.yandex.ru/xsdtest.xml

Which columns need to be filled in a YML file?

Item example, simplified description:

<offer available="true" id="32865619">
<currencyId>RUR</currencyId>
<categoryId>3166042</categoryId>
<price>7160</price>
<picture>http://site.ru/images/products/32865619_1.jpg</picture>
<picture>http://site.ru/images/products/32865619_2.jpg</picture>
<picture>http://site.ru/images/products/32865619_3.jpg</picture>
<picture>http://site.ru/images/products/32865619_4.jpg</picture>
<name>Name</name>
<description>Full item description</description>
<param name="Brand">Diesel</param>
<param name="Collection">Digital</param>
<param name="Mechanism type">quartz</param>
<param name="Energy source">batteries</param>
<param name="Waterproof">WR 50</param>
<param name="Display">numbers</param>
<param name="Serial number">yes</param>
</offer>

You can also send item name as a vendor.model
For example:

<offer id="12341"type="vendor.model"available="true">
........
<typePrefix>Hand watches</typePrefix>
<vendor>Diesel</vendor>
<model>DZ1090</model>
........
</offer>

In this case name of item will be formed as typePrefix + vendor + model.

As a result, we get a name: «Hand watches Diesel DZ1090».

Which additional tags are supported by trimpo?

Item balance — Use a <stock> tag, where you put the number of items available, to show the current item balance

<offer id=
............
<stock>3</stock>
............
</offer>

If a <stock> tag is not determined and the item status is set as available = true, then the system will automatically determine it as “1”. If status is set as available = false, trimpo will set stock = 0.

Item condition— if you want to specify item condition please use a <condition> tag.

Example:

<offer id=
............
<condition>New</condition>
............
</offer>

If <condition> tag is not determined, system will automatically set it as “New”.

List of possible condition tag values by eBay categories: http://pages.ebay.com/help/sell/item-condition.html

Full list of possible condition tag values: http://developer.ebay.com/devzone/finding/callref/Enums/conditionIdList.html
We recommend to use either New or Used condition tag value.

How to transfer full item description with formatting?

Use CDATA tag for transferring full item description with unique format.

Example:

<offer id=
............
<description> <![CDATA[...]]> </description>
............
</offer>

You can transfer html-tags inside […] for description formatting, although JS and iframe usage is restricted. Learn more here: http://pages.ebay.com/help/policies/listing-javascript.html

How to paste YouTube video in description?

YouTube generaly uses iframe tag for sharing videos to outside resources. But this tag is not used on eBay, so if you want to add a YouTube video in your item description, just use this simple code:

<p align="center">
<object height="385" width="640"><param name="movie"
value="//www.youtube.com/v/XXXXXXXXXXX?fs=1&amp;hl=en_US"><param 
name="allowFullScreen" value="true"><param 
name="allowscriptaccess" value="always">
<embed src="//www.youtube.com/v/XXXXXXXXXXX?fs=1&amp;hl=en_US"
type="application/x-shockwave-flash" allowscriptaccess="always"
allowfullscreen="true" height="385" width="640"></object></span></strong></p>

*Just change XXXXXXXXXXX to a 11-symbol code from your YouTube video, and you’re good to go. You can find code in the link to the video. It’s bold in our example: http://www.youtube.com/watch?v=2aaaE5EtcLc

How to transfer an item with goods of different properties?

Example: You want to place a T-shirt, which is available in 2 colors and 3 sizes on a marketplace. It’s 5 goods.

  1. White — М
  2. White — S
  3. Black — М
  4. Black — S
  5. Black — L

In order to set different goods, which are related to one item use group_id tag. Read more about it: yandex.market.

Here is an example of a yml-file for this 5 t-shirts.

First product: T-shirt, White, size — М

<offer available="true" id="10001" group_id="123">
............
<picture>http://site.ru/images/products/10001_белая.jpg</picture>
<name>T-shirt</name>
............
<param name="Color">White</param>
<param name="Size">M</param>
</offer>

Second product: T-shirt, White, size — S

<offer available="true" id="10002" group_id="123">
............
<picture>http://site.ru/images/products/10002_белая.jpg</picture>
<name>T-shirt</name>
............
<param name="Color">White</param>
<param name="Size">S</param>
</offer>

Third product: T-shirt, Black, size — М

<offer available="true" id="10003" group_id="123">
............
<picture>http://site.ru/images/products/10003_черная.jpg</picture>
<name>T-shirt</name>
............
<param name="Color">Black</param>
<param name="Size">M</param>
</offer>

Fourth product: T-shirt, Black, size — S

<offer available="true" id="10004" group_id="123">
............
<picture>http://site.ru/images/products/10004_черная.jpg</picture>
<name>T-shirt</name>
............
<param name="Color">Black</param>
<param name="Size">S</param>
</offer>

Fifth product: T-shirt, Black, size — L

<offer available="true" id="10005" group_id="123">
............
<picture>http://site.ru/images/products/10005_черная.jpg</picture>
<name>T-shirt</name>
............
<param name="Color">Black</param>
<param name="Size">L</param>
</offer> 

How to transfer a trade rule and eBay category?

If you want to send goods to eBay automatically then set Id’s of trade rules and eBay category for each product.
You can find Id of trade rules in the “Trade rules” section in “Group Id”.
eBay category.
You can find Id of an eBay category in special service where Id will be set in URL, for example category=725. Or you can open http://ebay.com/ and find the same product, then chose category of this product and copy id from URL, for example http://www.ebay.com/sch/-/9355/i.html

Here is the format of transferring ID of trade rules and Id of eBay category

<offer id=
............
<ebayCategory ruleId="43" account="alexterentyev">9355</ebayCategory>
............
</offer>

Where:
43 — Id of trade rules
9355 — Id of eBay category
alexterentyev — eBay account name


Excel

Excel is a very simple format as a source of item data. It fits perfectly if you have 100 or less items and you change price and balance often. This source type allows you to update all your items at the same time.

You can find template here: https://app.trimpo.org/download/excel-import.xls

Columns in Excel sheet

  • Id — id of your product. Product loaded into trimpo can’t change its id. In this case trimpo will create a new product, and the old one will be withdrawn from sale;
  • Available — status of item availability. If you want to remove all items from sale quickly just set “false”. Then trimpo will remove all the models from sale after loading this file;
  • Price;
  • Stock — quantity of items available;
  • Category — item category. We recommend to use this column, because it will help you to filter items inside trimpo;
  • Picture — links (URL) to your images. If you want to add several pics to the item use «;» symbol between links to images (you can find an example in the template above);
  • Brand — brand of your item. Please set this info if you have it;
  • Name — name of the item;
  • Description — description of the item. Try to create the most detailed description to all of your items. Notice: you can send description with html tags by creating descriptin in Word and saving as html;
  • Specifics — item properties. You have to use this format: property_1: value ; property_2 : value. Find an example in the template above;
  • Сondition (New/Used) — item condition. You can use two values — New or Used. If you set Used, then describe condition in details and tell about defects;

group_id — item id. You can use it when creating items with options. For example – goods of one item with differencies in color or size. Item id have to be unique and can’t be changed.


Items manual adding

It fits best for shops with few items.

It allows you to add info about each item manually. If you click on the «Add item» button, trimpo will open standard form with fields to fill.

You have to fill all fields and add at least one picture.

Set «Item name», condition (new or second hand). Then you can choose category.

After this trimpo will offer you to create a list the item’s properties (which can change depending on category).

For example, books category:

  • «Binding»;
  • «Subject»;
  • «Theme»;
  • «Printed in»;
  • «Origin».

You can also add any unique properties by clicking the “Add properties” button.

Once you’re done with it, please add at least one image and description.

Now you can set the price and balance. Item is successfully created!