attribute | data type | mandatory | default value | description | example |
---|---|---|---|---|---|
additional_image_link | text | no | An additional picture can be added. | http://www.example.com/ring_silver1.jpg | |
adult | string (accepted values: "true", "false", "yes", "no", "ja", "wahr", "nein", "falsch", "oui", "vrai", "non", "faux") | no | Flags products which can only be delivered to people who are at least 18 years old. | true | |
age_group | string (accepted values: adult,kids,toddler,infant,newborn) | (yes) | false | Mandatory for products in the categories fashion and accessoires.. | newborn |
atalanda:additional_product_type_1 | string | no | Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. | Schmuck > Ringe | |
atalanda:additional_product_type_2 | string | no | Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. | Schmuck > Ringe | |
atalanda:additional_product_type_3 | string | no | Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. | Schmuck > Ringe | |
atalanda:boost_sort | float (accepted values: 0.0 - 10.0) | no | Determines the order of products on the shop detail page and in category searches. Products with high values (e.g. 10.0) are displayed first, products with lower values behind. Please balance values carefully (all products better than 7 is not allowed). | 5.0 | |
atalanda:delivery_method | string (accepted values: nationwide, package_delivery, self_collect) | no | package_delivery | Determines if a product is delivered nationwide, only within the city or if the customer can only collect the product in the store. |
nationwide nationwide,self_collect, |
atalanda:ingredients | text | no | Provide the ingredients of the product in this field. You can pass the description either in plain text format or include permitted HTML tags. | salt, orange, cranberries, sugar, lemon, juniper, fennel, ginger, chili, cumin | |
atalanda:nutrien_contents | text | no | Enter here, in the case of food, the nutritional information of the product. You can pass the description either in plain text format or include permitted HTML tags. | Nutritional information (per 100g) Energy: 516 kcal (2157 kJ) |
|
atalanda:preorder_days | Integer | no | 0 | Pre-order time of the item. | 42 |
atalanda:properties | String | no | Additional properties for a product or a variant. | Author=Dan Brown Author=Darwin,Release year=2015 |
|
atalanda:tax_rate | float (accepted values in Germany: 0, 7, 19, in Swiss: 0, 2.5, 3.8, 8.5, in Austria: 0, 10, 13, 20) | yes | VAT of article in percent. | 19 | |
availability | string (accepted values: in stock, auf Lager, out of stock, en stock and nicht auf Lager) | yes | Tells atalanda if product is available. Products marked with "out of stock" / "nicht auf Lager" will not be displayed for customers. | in stock | |
brand | string | no | brand of the product. | Swarovski | |
color | string | (yes) | If item_group_id is set, you also have to set color and / or size. | red | |
description | text | yes | Description of the product - provide as many details as possible. You can pass the description either as plain text format or with allowed HTML-Tags. | Wedding ring in silver, surface opal with 6 x 0.018 diamonds, width: 5.9 mm, height: 1.7 mm | |
energy_efficiency_class | string | (yes) | The energy efficiency class of a product. For usage in combination with min_energy_efficiency_class and max_energy_efficiency_class to create an energy efficiency label, e.g. A+ (A+++ to D). If energy_efficiency_class is set, you also need to providemin_energy_efficiency_class and max_energy_efficiency_class. |
permitted values:
|
|
gender | string (accepted values: female, male, unisex) | (yes) | Mandatory for products in the categories fashion and accessoires. | female | |
gtin | string | (yes) | Global Trade Item Number (GTIN) is an unique identifier for trade items. If not set, identifier_exists must contain the value false. For checking if a gtin is valid, you can use http://www.gtin.info/check-digit-calculator/ (in German). | 4012345678901 | |
id | integer | yes | Unique id within this data feed. | 1000 | |
identifier_exists | boolean | (yes) | true | If gtin is not set, this attributes needs to have false as value. | true |
image_link | text | yes | atalanda can basically deal with any kind of image size. Nevertheless, we recommend to provide images as large as possible (for zoom functionality). Benchmarks: 750x750 px for large images and 1500x1500 px for zoom-functionality. | http://www.example.com/ring_silver.jpg | |
item_group_id | string | no | You can set item_group_id in order to group different variants of a product to one product. If item_group_id is set, you also have to set color and / or size. | 109873423 | |
link | text | no | You can provide a link to the same product on your own online shop here. If you link back from your shop to atalanda, we can include this link on your atalanda product detail pages. Please contact us if you are interested. | http://www.example.com/product/123.html | |
max_energy_efficiency_class | String | (yes) | The maximum energy efficiency class of a product To be used in combination with min_energy_efficiency_class and energy_efficiency_class to create an energy efficiency label, for example, A+ (A+++ to D). If max_energy_efficiency_class is set, min_energy_efficiency_class and energy_efficiency_class have to be set as well. |
permitted values:
|
|
min_energy_efficiency_class | String | (yes) | The minimum energy efficiency class of a product. To be used in combination with max_energy_efficiency_class and energy_efficiency_class to create an energy efficiency label, for example, A+ (A+++ to D). If min_energy_efficiency_class is set, max_energy_efficiency_class and energy_efficiency_class have to be set as well. |
permitted values:
|
|
mpn | string | no | A part number (often abbreviated PN, P/N, part no., or part #) is an identifier of a particular part design used in a particular industry. Its purpose is to simplify reference to that part. A part number unambiguously identifies a part design within a single corporation, and sometimes across several corporations. | HSC0424PP | |
price | float | yes | Price in local currency. If you want to display a sales price, keep the normal price in this field and use the sale_price attribute for the lower price. | 99.00 | |
product_type | string | yes | Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. | Jewellery > Rings | |
google_product_category | string | yes | Provide your categories in this field. If they are not compliant with the atalanda categories, you can do the mapping in the atalanda backend. If you want to use atalanda categories right away, you can find the list of categories here. | Jewellery > Rings | |
quantity oder g:quantity oder atalanda:quantity | integer | (yes) | Number of products available in store. If the number is smaller than 5 an according message is shown to the customer. If the number is 0 or negative, the product cannot be seen by the customer anymore. If you provide an empty value, atalanda interprets this as "unlimited available". | 3 | |
sale_price | float | no | Sales price in local currency, has to be lower than price. Is displayed highlighted, the price will be shown crossed out. | 79.00 | |
size | string | (yes) | If item_group_id is set, you also have to set color and / or size. | M, 38kg, 24'', etc. | |
title | string | yes | Title of the product. Should not be longer than 140 characters because of SEO reasons. | Wedding ring silver model R305 | |
unit_pricing_base_measure | string (accepted values: mg, g, kg, ml, cl, l, cbm, cm, m, qm, sqm, items, stck, stück, rolle, packung, blatt, bogen, st, ro, pa, bl, bg, stk, pair, pairs, Paar, Paare, paire, paires) | no | Tells atalanda the value to which the basic price has to be calculated. Must be provided with the same unit as unit_pricing_measure. | 1kg, 1l | |
unit_pricing_measure | string (accepted values: mg, g, kg, ml, cl, l, cbm, cm, m, qm, sqm, items, stck, stück, rolle, packung, blatt, bogen, st, ro, pa, bl, bg, stk, pair, pairs, Paar, Paare, paire, paires) | no | Tells atalanda the measure or dimension of the given product. Must be provided with the same unit as unit_pricing_base_measure. | 0.5kg, 0.75l | |
atalanda:services | string (accepted values: depending on platform configuration) | no | Enter the unique identifier of the service here. Services and their identifiers are managed by us. Contact us if you would like to configure services (such as a gift wrapping service) for selected products. | free_gift_wrapping, free_weee_take_back |
google_product_category
, product_type
, atalanda:additional_product_type_1
, atalanda:additional_product_type_2
und atalanda:additional_product_type_3
contains one of your categories. For mapping these to the atalanda categories, please visit https://atalanda.com/admin and select Mappings under the menu-item "API". Alternatively you can directly provide atalanda categories.item_group_id
column (all variants of a product must have the same group ID). An example for such a product would be a ring made of silver or gold and offered in various sizes. Examples of a product with variants can be found here: XML-Format, CSV-Format.age_group
and gender
need to be set. A list of valid values can be found here: https://support.google.com/merchants/answer/188494?hl=en.description
Allowed HTML-Tags | usage | example | ||||||
---|---|---|---|---|---|---|---|---|
<a href=""> | <a href="https://example.com/wedding_rings/101>wedding ring 101</a> | wedding ring 101 | ||||||
<b>, <strong> | <b>wedding rings</b>, <strong>wedding rings</strong> | wedding rings | ||||||
<u> | <u>matt</u> | matt | ||||||
<br> | silver wedding rings, matt surface <br> with 6 x 0.018 diamonds. | silver wedding rings, matt surface with 6 x 0.018 diamonds. |
||||||
<em> | <em>Silver</em> | Silver | ||||||
<p> | <p>Lorem ipsum dolor sit amet, consetetur sadipscing elitr.</p> <p>At vero eos et accusam et justo duo dolores et ea rebum.</p> | Lorem ipsum dolor sit amet, consetetur sadipscing elitr. At vero eos et accusam et justo duo dolores et ea rebum. |
||||||
<ul>, <li> | <ul> <li>6 x 0.018 diamonds</li> <li>width: 5.9 mm</li> <li>height: 1.7 mm</li> </ul> |
|
||||||
<table>, <thead>, <tbody>, <tr>, <th>, <td> | <table> <thead> <tr> <th>Year of publication</th> <th>Color</th> </tr> </thead> <tbody> <tr> <td>1955</th> <td>blue</th> </tr> <tr> <td>1963</th> <td>green</th> </tr> </tbody> </table> |
|