Einstellungen
Utilizing this API, a variety of data, such as data on products, vendors, and shipments, can be retrieved. GraphQL is the query language, thus allowing clients to request exactly what they need and nothing else. You can also use our API to make changes, such as confirming orders or setting order tracking numbers. Our API can be explored using the interactive GraphQL Playground, which contains comprehensive and always up-to-date documentation.
The GraphQL API is available at http://www.sabu.de/graphql
You can use our GraphQL API in any application. For many programming languages, there are libraries designed to interact with a GraphQL API, but you can also send requests directly to our API.
For example, the following CURL request retrieves three products. Please replace YOUR_API_ACCESS_KEY
with your API access key, as outlined in the next section, or remove the header.
curl 'http://www.sabu.de/graphql' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer YOUR_API_ACCESS_KEY' \ --request POST \ --data-raw '{"query":"query { products(first: 3) { nodes { name { de } } } }"}'
Some data is publicly accessible, such as a vendor's description or a product's price. To access this data, you can use our GraphQL API without authentication. However, if you want to access or mutate data that is not publicly accessible, such as the orders of a vendor or information about vouchers, you need to authenticate yourself.
When using our GraphQL playground, the role and access rights of the user account you're logged in with on the platform are used for authentication.
If you're using the GraphQL API in your own application, you need to first request
your API access key by contacting us through your account manager or by sending an
email to support@sabu.de. You can then use this API access key by setting it as a header in each of your
GraphQL requests: Authorization: Bearer YOUR_API_ACCESS_KEY
The GraphQL API can be tested in the SABU.de GraphQL Playground. The available data and endpoints vary depending on whether and with which account you are logged in at https://www.sabu.de/.
In the playground, the documentation can be found in the top left corner. Also, you
can enable auto-complete by pressing CTRL + Space
when writing a query or mutation.
These fields are deprecated and will be removed in the near future:
Type | Field | Deprecation Reason |
---|---|---|
Event | latitude | Replaced by new field #lat |
Event | longitude | Replaced by new field #lng |
Greco | weight | This value is deprecated in favor of 'packages.weight' |
Product | ageRestriction | Use _age_restriction instead, which returns the age as an Integer instead of a String. |
Taxon | identifier | Will be removed in favor of field `slug`. |
User | billAddress | This field always retuns null and thus will be removed in the future. Use the field billAddress on orders instead. |
User | shipAddress | This field always retuns null and thus will be removed in the future. Use the field shipAddress on orders instead. |
Vendor | facebookLink | Will be removed in favor of field `social_media_links`. |
Vendor | instagramLink | Will be removed in favor of field `social_media_links`. |
Vendor | owner | This field always retuns null and thus will be removed in the future. Use the field representative instead. |
Vendor | permalink | Will be removed in favor of field `slug`. |
Vendor | twitterLink | Will be removed in favor of field `social_media_links`. |
Vendor | youtubeLink | Will be removed in favor of field `social_media_links`. |
Using our API, you can fetch unconfirmed orders, confirm or reject them, set a tracking number, handle returns, etc. Please use an API access key with at least shop manager rights. It is also possible to manage the orders of multiple vendor profiles if you have the necessary rights.
Please note that the following queries are only examples. It's inherent to GraphQL APIs that you can specify the exact data you want. Thus, feel free to add or remove fields in the requests. Please check our documentation in the GraphQL Playground for available fields.
Please make sure you are familiar with our order structure: A customer can place an order. An order can contain "shipments" from multiple vendors. For example, a customer might have had a book from a book store and a laptop from a tech store in their shopping cart during checkout at the same time. In this case, one order with two shipments is created. Each shipment must be confirmed/rejected separately by the respective vendor. A shipment can contain multiple products, named "inventoryUnits". A vendor can confirm some inventoryUnits and reject others in the same shipment. Of course, you only see the shipments of the vendors you manage, i.e., for which you have access rights.
There are four main queries and mutations for managing orders:
Retrieve shipments that still need to be confirmed or rejected.
query { shipments(state: unconfirmed) { nodes { id inventoryUnits { id state } } } }
{ "data": { "shipments": { "nodes": [ { "id": "YznzNJYRack", "inventoryUnits": [ { "id": "2VLvzrxn1VnrZKIo", "state": "unconfirmed" } ] } ] } } }
Use the IDs of the inventoryUnit
s from the previous query.isAvailable
should be set to true
, if the product is available and the vendor wants to confirm it.isAvailable
should be set to false
, if the product is sold out or if the vendor doesn't want to confirm it for another
reason.
If you have already set the state of an inventoryUnit
, for example by confirming it, you must not change it to another state, such as
"not available". If you do, the server returns a corresponding error message in the
errors field.
As soon as you have confirmed or rejected each inventoryUnit
of the shipment
, the shipment
's state changes from unconfirmed to either declined (if all products have been
rejected) or confirmed (if one or more products have been confirmed). This means, as
long as you don't confirm or reject each inventoryUnit
, the shipment
remains "unconfirmed" and is returned as part of the response in the previously shown unconfirmed shipments query.
mutation { confirmInventoryUnits( input: { inventoryUnits: [ { inventoryUnitId: "INVENTORY_UNIT_1_ID", isAvailable: true } { inventoryUnitId: "INVENTORY_UNIT_2_ID", isAvailable: false } { inventoryUnitId: "INVENTORY_UNIT_3_ID", isAvailable: false } ] } ) { inventoryUnits { id state } errors { id code message } } }
{ "data": { "confirmInventoryUnits": { "inventoryUnits": [ { "id": "INVENTORY_UNIT_1_ID", "state": "confirmed_available" }, { "id": "INVENTORY_UNIT_2_ID", "state": "confirmed_unavailable" } ], "errors": [ { "id": "INVENTORY_UNIT_3_ID", "code": "record_invalid", "message": "Status ungültiger Statuswechsel" } ] } } }
Use this mutation when a customer has returned an item. Using this mutation causes money to be refunded to the customer. Thus, you should only call this mutation when you received the returned item and not before.
Errors are returned, for example, when you try to return an item that was declined in the shipment confirmation step in the previous query, or when the conditions for a return are not or no longer given, such as when the return period has expired.
mutation { returnInventoryUnits( input: { inventoryUnits: [ { inventoryUnitId: "INVENTORY_UNIT_1_ID" }, { inventoryUnitId: "INVENTORY_UNIT_1_ID" } ] } ) { inventoryUnits { state id } errors { code id } } }
{ "data": { "returnInventoryUnits": { "inventoryUnits": [ { "id": "INVENTORY_UNIT_1_ID", "state": "returned" } ], "errors": [ { "id": "INVENTORY_UNIT_2_ID", "code": "record_invalid" } ] } } }
This mutation is used to add the tracking number to the shipment
. The required shipment ID can be queried via the shipments query.
Ideally, this is done before confirming the inventory units, so the tracking number can already be included in the confirmation mail to the customer. However, it's also possible to set a tracking number after the shipment has already been confirmed - in that case, the customer receives an additional email with the tracking information.
Please provide the service you're using for shipping the parcels for THE_SHIPPING_PROVIDER
. The currently supported providers (e.g., DHL, GLS, Fedex) are available under TrackingProviderEnum
.
mutation { setShipmentTracking( input: { code: "THE_SHIPMENT_TRACKING_CODE", provider: THE_SHIPPING_PROVIDER, shipmentId: "SHIPMENT_ID" } ) { shipment { tracking { code provider } } errors { code message } } }
{ "data": { "returnInventoryUnits": { "inventoryUnits": [ { "id": "INVENTORY_UNIT_1_ID", "state": "returned" } ], "errors": [ { "id": "INVENTORY_UNIT_2_ID", "code": "record_invalid" } ] } } }
To subscribe to our event system, please email us at support@sabu.de.
All events have the following structure:
{ "Type" : "Notification", "MessageId" : "XXX", "TopicArn" : "arn:aws:sns:eu-central-1:XXX:events", "Message" : "{\"id\":\"XXX\",\"type\":\"XXX\",\"payload\":{...}}", "Timestamp" : "2019-01-01T00:00:00.000Z", "SignatureVersion" : "1", "Signature" : "XXX", "SigningCertURL" : "https://sns.eu-central-1.amazonaws.com/xxx", "UnsubscribeURL" : "https://sns.eu-central-1.amazonaws.com/xxx" }
The "Message" attribute always contains the following attributes:
Hash ID of the event
Type of event. Possible values are:
Contains further information and references to the object that triggered the event. The structure of this attribute depends on the type. The following is a list of structures per type:
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of shipment | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of refund | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of user | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of user | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of user | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of user | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of variant | Yes |
productId | String | ID of variant's product | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of variant | Yes |
productId | String | ID of variant's product | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of vendor category | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of vendor category | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of vendor category | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of vendor | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of vendor | Yes |
Attribute | Type | Description | Mandatory |
---|---|---|---|
id | String | ID of vendor | Yes |
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 | |||||
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. Multiple properties can be separated by commas. You can also pass special control properties, which change how the product is displayed or processed. Following control properties are available for general use:
| Author=Dan Brown Author=Darwin,Release year=2015 _ai_description=true,Author=Darwin | |
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 | |
availability_date | |||||
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 | string | yes | Unique id within this data feed. May not be longer than 255 characters. | 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. | ||
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. | ||
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, gross, VAT included. 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, gross, VAT included. Has to be lower than price. Is displayed highlighted, the price will be shown crossed out. | 79.00 | |
size | |||||
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 | 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> |
|
It is not a problem if categories in your web shop deviate from ours. You can export your products with your category names. We can set up an assignment table in our system for this purpose. This assignment table defines for each of your category names, that does not match our category names 1:1, in which of our categories your product should be classified. Just contact us at service@atalanda.com
Data can also be provided in CSV format. Please refer to https://support.google.com/merchants/answer/188494?hl=en
Below are examples of how to structure a CSV file with products.
Please use UTF-8 encoding consistently for all fields.
The first line contains the column name. As delimiter either a tab (\t), a comma (,) or a semicolon (;) can be used. In the following examples commas were used as delimiters.All other lines represent a single product or a variant of a product.
id,title,price,description,product_type,availability,image_link,identifier_exists,atalanda:tax_rate,atalanda:quantity,sale_price,atalanda:preorder_days,google_product_category,atalanda:additional_product_type_1,brand,gtin,color,size,gender,age_group,atalanda:boost_sort,atalanda:delivery_method,link,additional_image_link 13056,'Ehering',119.99,'Beschreibung','Bekleidung & Accessoires > Schmuck > Ringe','in stock','http://ihre-domain.de/wedding_ring.jpg',false,19,10,99.99,1,'Bekleidung & Accessoires > Schmuck > Ringe','Gesundheit & Schönheit','atalanda',4012345678901,'Silver','52','female','adult',5.5,'nationwide','http://www.test-shop.de/product/13056','http://ihre-domain.de/wedding_ring_2.jpg'
id,title,price,description,product_type,availability,image_link,identifier_exists,atalanda:tax_rate,atalanda:quantity,sale_price,atalanda:preorder_days,google_product_category,atalanda:additional_product_type_1,brand,gtin,color,size,gender,age_group,atalanda:boost_sort,atalanda:delivery_method,item_group_id,link,additional_image_link 13057,'Ehering',119.99,'Beschreibung','Bekleidung & Accessoires > Schmuck > Ringe','in stock','http://ihre-domain.de/wedding_ring.jpg',false,19,10,99.99,1,'Bekleidung & Accessoires > Schmuck > Ringe','Gesundheit & Schönheit','atalanda',4012345678902,'Silver','50','female','adult',5.5,'nationwide',101,'http://www.test-shop.de/product/13057','http://ihre-domain.de/wedding_ring_2.jpg' 13058,'Ehering',119.99,'Beschreibung','Bekleidung & Accessoires > Schmuck > Ringe','in stock','http://ihre-domain.de/wedding_ring.jpg',false,19,10,99.99,1,'Bekleidung & Accessoires > Schmuck > Ringe','Gesundheit & Schönheit','atalanda',4012345678903,'Silver','52','female','adult',5.5,'nationwide',101,'http://www.test-shop.de/product/13058','http://ihre-domain.de/wedding_ring_2.jpg'
id,title,price,description,product_type,availability,image_link,identifier_exists,atalanda:tax_rate,atalanda:quantity,sale_price,atalanda:preorder_days,google_product_category,atalanda:additional_product_type_1,brand,gtin,color,size,gender,age_group,atalanda:boost_sort,atalanda:delivery_method,item_group_id,link,additional_image_link 13057,'Ehering Silver',119.99,'Beschreibung','Bekleidung & Accessoires > Schmuck > Ringe','in stock','http://ihre-domain.de/wedding_ring_silver.jpg',false,19,10,99.99,1,'Bekleidung & Accessoires > Schmuck > Ringe','Gesundheit & Schönheit','atalanda',4012345678904,'Silver','50','female','adult',5.5,'nationwide',101,'http://www.test-shop.de/product/13057','http://ihre-domain.de/wedding_ring_silver_2.jpg' 13058,'Ehering Silver',119.99,'Beschreibung','Bekleidung & Accessoires > Schmuck > Ringe','in stock','http://ihre-domain.de/wedding_ring_silver.jpg',false,19,10,99.99,1,'Bekleidung & Accessoires > Schmuck > Ringe','Gesundheit & Schönheit','atalanda',4012345678905,'Silver','52','female','adult',5.5,'nationwide',101,'http://www.test-shop.de/product/13058','http://ihre-domain.de/wedding_ring_silver_2.jpg' 13059,'Ehering Gold',219.99,'Beschreibung','Bekleidung & Accessoires > Schmuck > Ringe','in stock','http://ihre-domain.de/wedding_ring_gold.jpg',false,19,10,199.99,1,'Bekleidung & Accessoires > Schmuck > Ringe','Gesundheit & Schönheit','atalanda',4012345678906,'Gold','50','female','adult',5.5,'nationwide',102,'http://www.test-shop.de/product/13059','http://ihre-domain.de/wedding_ring_gold_2.jpg' 13060,'Ehering Gold',219.99,'Beschreibung','Bekleidung & Accessoires > Schmuck > Ringe','in stock','http://ihre-domain.de/wedding_ring_gold.jpg',false,19,10,199.99,1,'Bekleidung & Accessoires > Schmuck > Ringe','Gesundheit & Schönheit','atalanda',4012345678907,'Gold','52','female','adult',5.5,'nationwide',102,'http://www.test-shop.de/product/13060','http://ihre-domain.de/wedding_ring_gold_2.jpg'
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
blocks. Alternatively, the content can also be encoded in HTML entities.
The character set UTF-8 must be used constantly!
<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>
<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>
<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 products with an energy-efficiency classit is possible to create an energy-efficiency label with the elements <energy_efficiency_class>A+</energy_efficiency_class>
, <max_energy_efficiency_class>A+++</min_energy_efficiency_class>
and <min_energy_efficiency_class>A+++</min_energy_efficiency_class>
, e.g: A+ (A+++ to D).
Test your XML or CSV file to check for errors.
You can either provide an URL or copy the data into the text field below where our tool can reach the data.
Note: During the actual import, further error messages may appear (for example: non-specified mandatory fields in certain product categories).