atalanda API

Unser Format basiert auf dem Google Shopping XML Product Feed, dieser ist beschrieben auf https://support.google.com/merchants/answer/188494?hl=de

Im folgenden finden Sie Beispiele, wie der Feed und seine Produkte aufgebaut sein müssen. Der Inhalt von Elementen, die Sonderzeichen enthalten können, sollte grundsätzlich in <![CDATA[]]> Blöcke eingefasst werden. Alternativ kann der Inhalt auch in HTML-Entities kodiert werden.

Als Zeichensatz muss konsistent UTF-8 verwendet werden! Dies sichert eine richtige Darstellung aller Umlaute (ö, ä, ü, ß).

Ein Produkt ohne Varianten

<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[Silber]]></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>

Ein Produkt mit Varianten

<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[Silber]]></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[Silber]]></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>

Zwei Produkte mit Varianten

<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 Silber</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[Silber]]></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 Silber</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[Silber]]></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>

Für Bekleidung sind weiterhin die Elemente <g:gender> und <g:age_group> vorgeschrieben. Die Größe von Bekleidungsstücken muss über das Element <atalanda:options> beschrieben werden. Elemente wie z.b. <g:color> finden bei uns keine Anwendung, da sie durch <atalanda:options> dargestellt werden und können weggelassen werden.

Produkte ab 18 Jahren (nicht jugendfrei) müssen das Element <g:adult>TRUE</g:adult> enthalten.
Produkte ab 16 Jahren müssen mit dem Element <g:adult>16</g:adult> (nicht Google-Standard), oder mit <g:adult>TRUE</g:adult> gekennzeichnet werden (In diesem Fall prüft der Kurier das Alter des Empfängers bzgl. des Mindestalters auf 18 Jahre).

Für Produkte mit Energieeffizienzklasse gibt es die Möglichkeit mit den Elementen <energy_efficiency_class>A+</energy_efficiency_class>, <max_energy_efficiency_class>A+++</max_energy_efficiency_class> und <min_energy_efficiency_class>A+++</min_energy_efficiency_class> ein Energieeffizienz-Label zu erstellen, z.B.: A+ (A+++ bis D).

Google Shopping XML Format

Produkt

Ein Produkt ohne Varianten

Ein Produkt mit Varianten

Zwei Produkte mit Varianten

Beachten Sie...