atalanda API

Our format is based on the Google Shopping XML Product Feed, which is described here https://support.google.com/merchants/answer/188494?hl=en

Below are examples of how the feed and its products must be constructed. The content of elements that may contain special characters should always be enclosed in <![CDATA[]]> blocks. Alternatively, the content can also be encoded in HTML entities.

The character set UTF-8 must be used constantly!

A Product without Variants

<rss xmlns:atalanda='http://api.atalanda.com/ns/gfeed' xmlns:g='http://base.google.com/ns/1.0' xmlns:atom='http://www.w3.org/2005/Atom' version='2.0'>
    <channel>
      <atom:link href='http://www.schuh-auftritt.de/atalanda/atalanda.xml' rel='self' type='application/rss+xml'/>
      <title><![CDATA[juwelier-xy.de - Schmuck für jeden Anlass. Ihr Fachgeschäft in XY]]></title>
      <item>
        <g:id>13056</g:id>
        <title>Ehering</title>
        <g:price>119.99</g:price>
        <description>Beschreibung</description>
        <g:product_type><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:product_type>
        <g:google_product_category><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:google_product_category>
        <atalanda:additional_product_type_1><![CDATA[Gesundheit & Schönheit]]></atalanda:additional_product_type_1>
        <g:availability>in stock</g:availability>
        <g:image_link><![CDATA[http://ihre-domain.de/wedding_ring.jpg]]></g:image_link>
        <g:identifier_exists>FALSE</g:identifier_exists>
        <atalanda:tax_rate>19</atalanda:tax_rate>
        <atalanda:quantity>10</atalanda:quantity>
        <g:sale_price>99.99</g:sale_price>
        <atalanda:preorder_days>1</atalanda:preorder_days>
        <g:brand>atalanda</g:brand>
        <g:gtin>4012345678901</g:gtin>
        <atalanda:options>
          <atalanda:option>
            <atalanda:key><![CDATA[Farbe]]></atalanda:key>
            <atalanda:value><![CDATA[Silver]]></atalanda:value>
          </atalanda:option>
          <atalanda:option>
            <atalanda:key><![CDATA[Größe]]></atalanda:key>
            <atalanda:value>52</atalanda:value>
          </atalanda:option>
        </atalanda:options>
        <g:gender>female</g:gender>
        <g:age_group>adult</g:age_group>
        <atalanda:boost_sort>5.5</atalanda:boost_sort>
        <atalanda:delivery_method>nationwide</atalanda:delivery_method>
        <link><![CDATA[http://www.test-shop.de/product/13056]]></link>
        <g:additional_image_link><![CDATA[http://ihre-domain.de/wedding_ring_2.jpg]]></g:additional_image_link>
      </item>
    </channel>
  </rss>

A Product with Variants

<rss xmlns:atalanda='http://api.atalanda.com/ns/gfeed' xmlns:g='http://base.google.com/ns/1.0' xmlns:atom='http://www.w3.org/2005/Atom' version='2.0'>
  <channel>
    <atom:link href='http://www.schuh-auftritt.de/atalanda/atalanda.xml' rel='self' type='application/rss+xml'/>
    <title><![CDATA[juwelier-xy.de - Schmuck für jeden Anlass. Ihr Fachgeschäft in XY]]></title>
    <item>
      <g:id>13057</g:id>
      <title>Ehering</title>
      <g:price>119.99</g:price>
      <description>Beschreibung</description>
      <g:product_type><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:product_type>
      <g:google_product_category><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:google_product_category>
      <atalanda:additional_product_type_1><![CDATA[Gesundheit & Schönheit]]></atalanda:additional_product_type_1>
      <g:availability>in stock</g:availability>
      <g:image_link><![CDATA[http://ihre-domain.de/wedding_ring.jpg]]></g:image_link>
      <g:identifier_exists>FALSE</g:identifier_exists>
      <atalanda:tax_rate>19</atalanda:tax_rate>
      <atalanda:quantity>10</atalanda:quantity>
      <g:sale_price>99.99</g:sale_price>
      <atalanda:preorder_days>1</atalanda:preorder_days>
      <g:brand>atalanda</g:brand>
      <g:gtin>4012345678902</g:gtin>
      <atalanda:options>
        <atalanda:option>
          <atalanda:key><![CDATA[Farbe]]></atalanda:key>
          <atalanda:value><![CDATA[Silver]]></atalanda:value>
        </atalanda:option>
        <atalanda:option>
          <atalanda:key><![CDATA[Größe]]></atalanda:key>
          <atalanda:value>52</atalanda:value>
        </atalanda:option>
      </atalanda:options>
      <g:gender>female</g:gender>
      <g:age_group>adult</g:age_group>
      <atalanda:boost_sort>5.5</atalanda:boost_sort>
      <atalanda:delivery_method>nationwide</atalanda:delivery_method>
      <g:item_group_id>101</g:item_group_id>
      <link><![CDATA[http://www.test-shop.de/product/13057]]></link>
      <g:additional_image_link><![CDATA[http://ihre-domain.de/wedding_ring_2.jpg]]></g:additional_image_link>
    </item>
    <item>
      <g:id>13058</g:id>
      <title>Ehering</title>
      <g:price>119.99</g:price>
      <description>Beschreibung</description>
      <g:product_type><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:product_type>
      <g:google_product_category><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:google_product_category>
      <atalanda:additional_product_type_1><![CDATA[Gesundheit & Schönheit]]></atalanda:additional_product_type_1>
      <g:availability>in stock</g:availability>
      <g:image_link><![CDATA[http://ihre-domain.de/wedding_ring.jpg]]></g:image_link>
      <g:identifier_exists>FALSE</g:identifier_exists>
      <atalanda:tax_rate>19</atalanda:tax_rate>
      <atalanda:quantity>10</atalanda:quantity>
      <g:sale_price>99.99</g:sale_price>
      <atalanda:preorder_days>1</atalanda:preorder_days>
      <g:brand>atalanda</g:brand>
      <g:gtin>4012345678903</g:gtin>
      <atalanda:options>
        <atalanda:option>
          <atalanda:key><![CDATA[Farbe]]></atalanda:key>
          <atalanda:value><![CDATA[Silver]]></atalanda:value>
        </atalanda:option>
        <atalanda:option>
          <atalanda:key><![CDATA[Größe]]></atalanda:key>
          <atalanda:value>52</atalanda:value>
        </atalanda:option>
      </atalanda:options>
      <g:gender>female</g:gender>
      <g:age_group>adult</g:age_group>
      <atalanda:boost_sort>5.5</atalanda:boost_sort>
      <atalanda:delivery_method>nationwide</atalanda:delivery_method>
      <g:item_group_id>101</g:item_group_id>
      <link><![CDATA[http://www.test-shop.de/product/13058]]></link>
      <g:additional_image_link><![CDATA[http://ihre-domain.de/wedding_ring_2.jpg]]></g:additional_image_link>
    </item>
  </channel>
</rss>

Two Products with Variants

<rss xmlns:atalanda='http://api.atalanda.com/ns/gfeed' xmlns:g='http://base.google.com/ns/1.0' xmlns:atom='http://www.w3.org/2005/Atom' version='2.0'>
  <channel>
    <atom:link href='http://www.schuh-auftritt.de/atalanda/atalanda.xml' rel='self' type='application/rss+xml'/>
    <title><![CDATA[juwelier-xy.de - Schmuck für jeden Anlass. Ihr Fachgeschäft in XY]]></title>
    <item>
      <g:id>13057</g:id>
      <title>Ehering Silver</title>
      <g:price>119.99</g:price>
      <description>Beschreibung</description>
      <g:product_type><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:product_type>
      <g:google_product_category><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:google_product_category>
      <atalanda:additional_product_type_1><![CDATA[Gesundheit & Schönheit]]></atalanda:additional_product_type_1>
      <g:availability>in stock</g:availability>
      <g:image_link><![CDATA[http://ihre-domain.de/wedding_ring.jpg]]></g:image_link>
      <g:identifier_exists>FALSE</g:identifier_exists>
      <atalanda:tax_rate>19</atalanda:tax_rate>
      <atalanda:quantity>10</atalanda:quantity>
      <g:sale_price>99.99</g:sale_price>
      <atalanda:preorder_days>1</atalanda:preorder_days>
      <g:brand>atalanda</g:brand>
      <g:gtin>4012345678904</g:gtin>
      <atalanda:options>
        <atalanda:option>
          <atalanda:key><![CDATA[Farbe]]></atalanda:key>
          <atalanda:value><![CDATA[Silver]]></atalanda:value>
        </atalanda:option>
        <atalanda:option>
          <atalanda:key><![CDATA[Größe]]></atalanda:key>
          <atalanda:value>52</atalanda:value>
        </atalanda:option>
      </atalanda:options>
      <g:gender>female</g:gender>
      <g:age_group>adult</g:age_group>
      <atalanda:boost_sort>5.5</atalanda:boost_sort>
      <atalanda:delivery_method>nationwide</atalanda:delivery_method>
      <g:item_group_id>101</g:item_group_id>
      <link><![CDATA[http://www.test-shop.de/product/13057]]></link>
      <g:additional_image_link><![CDATA[http://ihre-domain.de/wedding_ring_silver_2.jpg]]></g:additional_image_link>
    </item>
    <item>
      <g:id>13058</g:id>
      <title>Ehering Silver</title>
      <g:price>119.99</g:price>
      <description>Beschreibung</description>
      <g:product_type><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:product_type>
      <g:google_product_category><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:google_product_category>
      <atalanda:additional_product_type_1><![CDATA[Gesundheit & Schönheit]]></atalanda:additional_product_type_1>
      <g:availability>in stock</g:availability>
      <g:image_link><![CDATA[http://ihre-domain.de/wedding_ring.jpg]]></g:image_link>
      <g:identifier_exists>FALSE</g:identifier_exists>
      <atalanda:tax_rate>19</atalanda:tax_rate>
      <atalanda:quantity>10</atalanda:quantity>
      <g:sale_price>99.99</g:sale_price>
      <atalanda:preorder_days>1</atalanda:preorder_days>
      <g:brand>atalanda</g:brand>
      <g:gtin>4012345678905</g:gtin>
      <atalanda:options>
        <atalanda:option>
          <atalanda:key><![CDATA[Farbe]]></atalanda:key>
          <atalanda:value><![CDATA[Silver]]></atalanda:value>
        </atalanda:option>
        <atalanda:option>
          <atalanda:key><![CDATA[Größe]]></atalanda:key>
          <atalanda:value>52</atalanda:value>
        </atalanda:option>
      </atalanda:options>
      <g:gender>female</g:gender>
      <g:age_group>adult</g:age_group>
      <atalanda:boost_sort>5.5</atalanda:boost_sort>
      <atalanda:delivery_method>nationwide</atalanda:delivery_method>
      <g:item_group_id>101</g:item_group_id>
      <link><![CDATA[http://www.test-shop.de/product/13058]]></link>
      <g:additional_image_link><![CDATA[http://ihre-domain.de/wedding_ring_silver_2.jpg]]></g:additional_image_link>
    </item>
    <item>
      <g:id>13059</g:id>
      <title>Ehering Gold</title>
      <g:price>219.99</g:price>
      <description>Beschreibung</description>
      <g:product_type><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:product_type>
      <g:google_product_category><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:google_product_category>
      <atalanda:additional_product_type_1><![CDATA[Gesundheit & Schönheit]]></atalanda:additional_product_type_1>
      <g:availability>in stock</g:availability>
      <g:image_link><![CDATA[http://ihre-domain.de/wedding_ring.jpg]]></g:image_link>
      <g:identifier_exists>FALSE</g:identifier_exists>
      <atalanda:tax_rate>19</atalanda:tax_rate>
      <atalanda:quantity>10</atalanda:quantity>
      <g:sale_price>199.99</g:sale_price>
      <atalanda:preorder_days>1</atalanda:preorder_days>
      <g:brand>atalanda</g:brand>
      <g:gtin>4012345678906</g:gtin>
      <atalanda:options>
        <atalanda:option>
          <atalanda:key><![CDATA[Farbe]]></atalanda:key>
          <atalanda:value><![CDATA[Gold]]></atalanda:value>
        </atalanda:option>
        <atalanda:option>
          <atalanda:key><![CDATA[Größe]]></atalanda:key>
          <atalanda:value>52</atalanda:value>
        </atalanda:option>
      </atalanda:options>
      <g:gender>female</g:gender>
      <g:age_group>adult</g:age_group>
      <atalanda:boost_sort>5.5</atalanda:boost_sort>
      <atalanda:delivery_method>nationwide</atalanda:delivery_method>
      <g:item_group_id>102</g:item_group_id>
      <link><![CDATA[http://www.test-shop.de/product/13059]]></link>
      <g:additional_image_link><![CDATA[http://ihre-domain.de/wedding_ring_gold_2.jpg]]></g:additional_image_link>
    </item>
    <item>
      <g:id>13060</g:id>
      <title>Ehering Gold</title>
      <g:price>219.99</g:price>
      <description>Beschreibung</description>
      <g:product_type><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:product_type>
      <g:google_product_category><![CDATA[Bekleidung & Accessoires > Schmuck > Ringe]]></g:google_product_category>
      <atalanda:additional_product_type_1><![CDATA[Gesundheit & Schönheit]]></atalanda:additional_product_type_1>
      <g:availability>in stock</g:availability>
      <g:image_link><![CDATA[http://ihre-domain.de/wedding_ring.jpg]]></g:image_link>
      <g:identifier_exists>FALSE</g:identifier_exists>
      <atalanda:tax_rate>19</atalanda:tax_rate>
      <atalanda:quantity>10</atalanda:quantity>
      <g:sale_price>199.99</g:sale_price>
      <atalanda:preorder_days>1</atalanda:preorder_days>
      <g:brand>atalanda</g:brand>
      <g:gtin>4012345678907</g:gtin>
      <atalanda:options>
        <atalanda:option>
          <atalanda:key><![CDATA[Farbe]]></atalanda:key>
          <atalanda:value><![CDATA[Gold]]></atalanda:value>
        </atalanda:option>
        <atalanda:option>
          <atalanda:key><![CDATA[Größe]]></atalanda:key>
          <atalanda:value>52</atalanda:value>
        </atalanda:option>
      </atalanda:options>
      <g:gender>female</g:gender>
      <g:age_group>adult</g:age_group>
      <atalanda:boost_sort>5.5</atalanda:boost_sort>
      <atalanda:delivery_method>nationwide</atalanda:delivery_method>
      <g:item_group_id>102</g:item_group_id>
      <link><![CDATA[http://www.test-shop.de/product/13060]]></link>
      <g:additional_image_link><![CDATA[http://ihre-domain.de/wedding_ring_gold_2.jpg]]></g:additional_image_link>
    </item>
  </channel>
</rss>

Clothing still requires the elements <g:gender> and <g:age_group>. The size of garments must be described using the element <atalanda:options>. Elements such as <g:color> will not apply to us as they are represented by <atalanda:options> and can therefore be omitted.

Products from 18 years (U-certificate) must contain the element <g:adult>TRUE</g:adult>.
Products from 16 years need to use the <g:adult>16</g:adult> (not Google-Standard), or <g:adult>TRUE</g:adult> (In this case, the courier checks the age of the recipient for the minimum age of 18 years).

For producst with an energy-efficiency class it is possible to create an energy-efficiency label with the elements <energy_efficiency_class>A+</energy_efficiency_class>, <max_energy_efficiency_class>A+++</max_energy_efficiency_class> and <min_energy_efficiency_class>A+++</min_energy_efficiency_class>, e.g: A+ (A+++ to D).

Google Shopping XML Format

Product

A Product without Variants

A Product with Variants

Two Products with Variants

Please notice...