updateItems |
  
|
updateItems |
|
Anlegen und Aktualisieren von Artikeln. |
<request method="updateItems" version="1.0.0"> <item significant_key="item_id" reference_id="ref-123"> <!-- <item_id>[ID]</item_id> Keine ID => Neu anlegen --> <mandator_id>1</mandator_id> <identifier>Poloshirt/ L / Weiß</identifier> <internal_item_number>s4t_05-001</internal_item_number> <vendor_item_number>HANR-s4t_05-001</vendor_item_number> <match_code>PS-L-W</match_code> <ean_code>5901234123457</ean_code> <variable_field></variable_field> <stock_count>200</stock_count> <safety_stock_count>0</safety_stock_count> <minimal_stock_count>10</minimal_stock_count> <list_price>14.95</list_price> <tax_type_id>3</tax_type_id> <length>600.00</length> <width>500.00</width> <height>3.00</height> <distance_unit_id>105</distance_unit_id> <weight>250.00</weight> <weight_unit_id>400</weight_unit_id> <piece>1</piece> <piece_unit_id>500</piece_unit_id> <base_price_type_id>5</base_price_type_id> <package_length>300.00</package_length> <package_width>150.00</package_width> <package_height>50.00</package_height> <package_distance_unit_id>105</package_distance_unit_id> <package_weight>500.00</package_weight> <package_weight_unit_id>400</package_weight_unit_id> <packaging_unit>1</packaging_unit> <package_count>1</package_count> <category_id>93</category_id><!-- Alternative 1 --> <!-- <external_category_id>[EXTERNE_ID]</external_category_id>--><!-- Alternative 2 --> <active>true</active> <delivery_charge_category_id>147</delivery_charge_category_id><!-- Alternative 1 --> <!--<external_delivery_charge_category_id>[EXTERNE_ID]</external_delivery_charge_category_id>--> <!-- Alternative 2 --> <delivery_time_id>3029</delivery_time_id><!-- Alternative 1 --> <!--<delivery_time_identifier>1-2 Tage</delivery_time_identifier>--> <!-- Alternative 2 --> <vendor_id>38</vendor_id><!-- Alternative 1 --> <!-- <external_vendor_id>[EXTERNE_ID]</external_vendor_id> --><!-- Alternative 2 --> <is_coupon>false</is_coupon> <is_adult_product>false</is_adult_product> <isbn></isbn> <upc_code>036000291452</upc_code> <variant> <variant_parent_id>60</variant_parent_id><!-- Alternative 1 --> <!-- <external_variant_parent_id>xyz12345</external_variant_parent_id> --><!-- Alternative 2 --> <variant_standard>false</variant_standard> <attributes> <attribute> <property> <identifier>Farbe</identifier> <translation> <language_code_iso>de</language_code_iso> <text>Farbe</text> </translation> </property> <value> <identifier>Weiß</identifier> <translation> <language_code_iso>de</language_code_iso> <text>Weiß</text> </translation> </value> </attribute> </attributes> </variant> <text_modules delete="true"> <text_module> <text_module_type>15</text_module_type> <translation> <language_code_iso>de</language_code_iso> <text>Jederzeit passend gekleidet! ... </text> </translation> </text_module> </text_modules> <image_modules> <image_module> <image_module_type_id>2627</image_module_type_id> <image_url>https://www.speed4trade.com/image.png</image_url> <!-- Alternative 1 --> <!-- <local_image_path>\\Server\Imagepool\productimage.png</local_image_path> --><!-- Alternative 2 UNC --> <!-- <local_image_path>C:\User\Admin\Desktop\PIC\PDC11027.png</local_image_path> --><!-- Alternative 3 lokales Laufwerk --> <image_type>png</image_type> <is_local>true</is_local> </image_module> </image_modules> <cross_selling_items clear="false"> <cross_selling_item delete="false"> <cross_selling_item_id>57</cross_selling_item_id> <position>0</position> <cross_selling_type>CROSS_SELLING</cross_selling_type> </cross_selling_item> </cross_selling_items> <item_set> <set_item> <set_item_id>57</set_item_id><!-- Alternative 1 --> <position>0</position> <amount>1</amount> <!-- <internal_set_item_number>AS-8461</internal_set_item_number> --> <!-- Alternative 2 --> </set_item> </item_set> <specific_item_data><!-- Platzhalter für plattformspezifische Daten --></specific_item_data> <item_suppliers delete="false"> <item_supplier> <supplier_id>3069</supplier_id> <purchase_price>12.00</purchase_price> <additional_charge_percentage>1.00</additional_charge_percentage> <priority>1</priority> </item_supplier> </item_suppliers> <default_shipping_carrier_id>143</default_shipping_carrier_id ><!-- Alternative 1 --> <!-- <default_shipping_carrier_identifier>DHL</default_shipping_carrier_ identifier>--> <!-- Alternative 2 --> <!-- <default_shipping_carrier_external_id>DHL</ default_shipping_carrier_external_id >--> <!-- Alternative 3 --> <media_modules> <media_module> <media_module_type_id>1630250</media_module_type_id> <language_code_iso>de</language_code_iso> <media_id>1269508</media_id> <url>speed4trade.com/beispielmedium.pdf</url> </media_module> </media_modules> <item_attributes clear="false"> <item_attribute significant_key="attribute_id" delete="false"> <attribute_id>1323</attribute_id> <attribute_identifier>Farbe</attribute_identifier> <attribute_data_type>MULTILANGUAGE_STRING</attribute_data_type> <attribute_value_type>PRE_DEFINED</attribute_value_type> <display_mode>1</display_mode> <unit_type_id>1</unit_type_id> <unit_id>110</unit_id> <translations> <translation> <language_code_iso>de</language_code_iso> <text>Attributbezeichnung_de</text> </translation> <translation> <language_code_iso>en</language_code_iso> <text>Attributbezeichnung_en</text> </translation> </translations> <subchannel_map> <subchannel_entry> <subchannel_id>2100</subchannel_id> <subchannel_text>Attributbezeichnung_fuer_ebay_de</subchannel_text> </subchannel_entry> </subchannel_map> <item_attribute_values> <item_attribute_value significant_key="attribute_value_id" delete="false"> <attribute_value_id>2341</attribute_value_id> <attribute_value_identifier>Attributwertbezeichnung</attribute_value_identifier> <unit_id>110</unit_id> <translations> <translation> <language_code_iso>de</language_code_iso> <text>Attributwertbezeichnung_de</text> </translation> </translations> <subchannel_map> <subchannel_entry> <subchannel_id>2100</subchannel_id> <subchannel_text>Attributwertbezeichnung_fuer_ebay_de</subchannel_text> </subchannel_entry> </subchannel_map> </item_attribute_value> </item_attribute_values> </item_attribute> </item_attributes> </item> </request> |
Name |
Beschreibung |
Anz. |
Typ |
Sonstiges |
|---|---|---|---|---|
request |
Root-Element der Anfrage |
1 |
Element |
|
method |
Attribut von request. Name der Webservice-Methode. |
1 |
string |
Fester Wert: „updateItems“ |
version |
Attribut von request. Legt die Version der Anfrage fest. |
1 |
integer |
Fester Wert: „1.0.0“ |
item |
Wrapper-Element, das die Daten des Artikels zusammenfasst |
0..N |
Element |
|
significant_key |
Gibt an welches Feld zur Identifikation des Artikels beim Update genutzt wird. |
1 |
string |
Feste Werte: „item_id“ | „internal_item_ number“ | „ean_code“ |
reference_id |
Optionales Attribut des Elements "item". In diesem Feld kann eine beliebige ID angegeben werden die später im zugehörigen Report-Block der Response-Daten wieder erscheint. |
0..1 |
string |
|
item_id |
Artikel-ID |
1 |
integer |
|
mandator_id |
Mandanten-ID |
1 |
integer |
|
identifier |
Artikelbezeichnung |
1 |
string |
Länge: 0-255 Zeichen |
internal_item_number |
interne Artikelnummer |
1 |
string |
Länge: 0-50 Zeichen |
vendor_item_number |
Artikelnummer des Herstellers |
0..1 |
string |
Länge: 0-100 Zeichen |
match_code |
Matchcode |
0..1 |
string |
Länge: 0-100 Zeichen |
ean_code |
EAN-Code des Artikels |
0..1 |
string |
Länge: 0-30 Zeichen |
variable_field |
Freifeld |
0..1 |
string |
Länge: 0-100 Zeichen |
stock_count |
Artikelbestand, der auf das Standard-Lager gebucht wird. |
0..1 |
integer |
|
stock_items |
Wrapper-Element, das die Daten der Lagerbestände zusammenfasst. |
0..1 |
Element |
|
stock_item |
Wrapper-Element, das die Daten des Lagerbestands zusammenfasst. |
1..N |
Element |
|
warehouse_id |
Identifiziert das Lager anhand der ID. |
1 |
integer |
Lager kann durch„warehouse_id“ oder „warehouse_code“ angegeben werden |
warehouse_code |
Identifiziert das Lager anhand des Lagercodes. |
1 |
string |
Lager kann durch„warehouse_id“ oder „warehouse_code“ angegeben werden |
stock_count |
Lagerbestand |
1 |
integer |
|
absolute |
Gibt an ob der Lagerbestand absolut oder relativ verbucht wird. |
1 |
boolean |
|
safety_stock_count |
Sicherheitsbestand |
0..1 |
integer |
|
minimal_stock_count |
Mindestbestand |
0..1 |
integer |
|
list_price |
Listenpreis |
0..1 |
decimal |
|
tax_type_id |
ID des Mehrwertsteuertypen |
1 |
integer |
Feste Werte: 1 = Frei 2 = Reduziert 3 = Normal |
length |
Länge des Artikels - Artikelmaß; Für Grundpreisangabe verwendbar |
0..1 |
decimal |
|
width |
Breite des Artikels - Artikelmaß; Für Grundpreisangabe verwendbar |
0..1 |
decimal |
|
height |
Höhe des Artikels - Artikelmaß; Für Grundpreisangabe verwendbar |
0..1 |
decimal |
|
distance_unit_id |
Maßeinheit für Abmessungen - Default: Millimeter |
0..1 |
integer |
Feste Werte |
weight |
Gewicht des Artikels - Artikelmaß; Für Grundpreisangabe verwendbar |
0..1 |
decimal |
|
weight_unit_id |
Maßeinheit für das Gewicht des Artikels - Default: Gramm |
0..1 |
integer |
Feste Werte |
area |
Fläche des Artikels - Artikelmaß; Für Grundpreisangabe verwendbar |
0..1 |
decimal |
|
area_unit_id |
Maßeinheit für die Fläche |
0..1 |
integer |
Feste Werte
|
volume |
Volumen des Artikels - Artikelmaß; Für Grundpreisangabe verwendbar |
0..1 |
decimal |
|
volume_unit_id |
Maßeinheit für das Volumen |
0..1 |
integer |
Feste Werte
|
piece |
Artikelanzahl - Artikelmaß; Für Grundpreisangabe verwendbar |
0..1 |
decimal |
|
piece_unit_id |
Maßeinheit für die Anzahl |
0..1 |
integer |
Feste Werte: ID = 500 |
base_price_type_id |
Grundpreistyp des Artikels. Bei Angabe des Grundpreistyps muss das dazugehörige Artikelmaß und die Einheit dazu gesetzt sein. |
0..1 |
integer |
Feste Werte
|
package_length |
Länge der Artikelverpackung |
0..1 |
decimal |
|
package_width |
Breite der Artikelverpackung |
0..1 |
decimal |
|
package_height |
Höhe der Artikelverpackung |
0..1 |
decimal |
|
package_distance_unit_id |
Legt die Maßeinheit für Strecken fest. Default: Millimeter |
0..1 |
integer |
Feste Werte
|
package_weight |
Gewicht des Artikels inkl. Verpackung |
0..1 |
decimal |
|
package_weight_unit_id |
Legt die Maßeinheit für das Gewicht fest. Default: Gramm |
0..1 |
integer |
Feste Werte
|
packaging_unit |
Verpackungseinheit in Stück |
0..1 |
integer |
|
package_count |
Anzahl Packstücke |
0..1 |
integer |
|
category_id |
Warengruppen-ID |
0..1 |
integer |
|
external_category_id |
Externe ID der Warengruppe |
0..1 |
string |
Länge: 0-50 Zeichen |
active |
Aktiv/Inaktiv |
0..1 |
boolean |
|
delivery_charge_category_id |
Versandkostenkategorie |
0..1 |
integer |
|
external_delivery_charge_category_id |
Setzt die Versandkostenkategorie über die externe ID. |
0..1 |
String |
Länge: 0-100 Zeichen |
delivery_time_id |
ID der voraussichtlichen Lieferzeit |
0..1 |
integer |
|
delivery_time_identifier |
Bezeichner der voraussichtlichen Lieferzeit |
0..1 |
string |
Länge: 0-255 Zeichen |
vendor_id |
Hersteller-ID |
0..1 |
integer |
|
external_vendor_id |
Externe Hersteller-ID |
0..1 |
string |
|
is_coupon |
Legt fest ob es sich bei dem Artikel um einen Gutschein handelt. |
0..1 |
boolean |
Default: false |
is_adult_product |
Legt fest ob der Artikel ausschließlich für Erwachsene bestimmt ist. |
0..1 |
boolean |
Default: false |
isbn |
ISBN-Nummer des Artikels |
0..1 |
string |
Länge: 0 – 13 Zeichen |
upc_code |
UPC-Code des Artikels |
0..1 |
string |
Länge: 0 – 12 Zeichen |
variant |
Wrapper-Element, das die Variantenoptionen dieses Artikels zusammenfasst. |
0..1 |
Element |
|
variant_parent_id |
Übergeordnete Artikel-ID |
1 |
integer |
|
external_variant_parent_id |
Übergeordnete interne Artikelnummer |
1 |
string |
|
variant_standard |
Gibt an ob dieser Artikel die Standardausführung der Artikelvarianten ist. |
0..1 |
boolean |
|
attributes |
Wrapper-Element, das die Attibute der Variante zusammenfasst. |
1 |
Element |
|
attribute |
Wrapper-Element, das ein Attribut der Variante zusammenfasst. |
1..N |
Element |
|
property |
Wrapper-Element, das die Attribute-Eigenschaften der Variante zusammenfasst. |
1 |
Element |
|
identifier |
Gibt an, um welche Eigenschaft es sich handelt |
1 |
string |
|
translation |
Wrapper-Element, das eine Übersetzung der Attribut-Eigenschaft enthält. |
1..N |
Element |
|
language_code_iso |
Sprache dieser Übersetzung |
1 |
string |
Sprachcode ISO 639-1 ALPHA-2 (z.B. „de“) |
text |
Text in der Sprache die im Element language_code_iso angegeben wurde |
1 |
string |
|
value |
Wrapper-Element, das die Attribute-Werte der Variante zusammenfasst. |
1 |
Element |
|
identifier |
Gibt an, um welche Eigenschaft es sich handelt |
1 |
string |
|
translation |
Wrapper-Element, das eine Übersetzung des Attribut-Wertes enthält. |
1..N |
Element |
|
language_code_iso |
Sprache dieser Übersetzung |
1 |
string |
Sprachcode ISO 639-1 ALPHA-2 (z.B. „de“) |
text |
Text in der Sprache die im Element language_code_iso angegeben wurde |
1 |
string |
|
text_modules |
Wrapper-Element, das die Textbausteine dieses Artikels zusammenfasst. |
0..1 |
Element |
|
delete |
Attribut von text_modules, mit dem festgelegt werden kann, ob alle anderen Textbausteine, die nicht im Request enthalten sind, aus dem Artikel gelöscht werden. |
0..1 |
boolean |
Default: false |
text_module |
Wrapper-Element, das die Daten des Textbausteins zusammenfasst |
0..N |
Element |
|
text_module_type |
ID des Textbausteintyps |
1 |
integer |
|
translation |
Wrapper-Element, das eine Übersetzung des Textbausteins enthält. |
0..N |
Element |
|
language_code_iso |
Sprache dieser Übersetzung |
1 |
string |
Sprachcode ISO 639-1 ALPHA-2 (z.B. „de“) |
text |
Text in der Sprache die im Element language_code_iso angegeben wurde |
1 |
string |
|
image_modules |
Wrapper-Element, das die Bildbausteine dieses Artikels zusammenfasst. |
0..1 |
Element |
|
image_module |
Wrapper-Element, das die Daten eines Bildbausteins zusammenfasst. |
0..N |
Element |
|
image_module_type_id |
ID des Bildbausteintyps |
1 |
integer |
|
image_url |
URL zu dem Bild |
0..1 |
string |
Länge: 0–200 Zeichen |
local_image_path |
UNC Pfad zu einer Bild-Datei. |
0..1 |
string |
|
base64_image_data |
Base64-Codierte Daten des Bildes |
0..1 |
string |
|
image_type |
Dateiendung des Bildes (z.B. png, jpg) |
0..1 |
string |
|
is_local |
Legt fest ob das lokale Bild oder eine URL genutzt wird. Bei Base64 muss dieses Element den Wert "true" haben. |
1 |
boolean |
|
cross_selling_items |
Wrapper-Element, das die Zusatzartikel dieses Artikels zusammenfasst. |
0..1 |
Element |
|
clear |
Attribut von cross_selling_items. •Wert true oWerden keine weiteren Zusatzartikel übergeben, dann werden alle bisher zugewiesenen Zusatzartikel aus dem Artikel entfernt. oWerden zusätzlich weitere Zusatzartikel angegeben, dann werden die bisherigen Zusatzartikel mit diesen überschrieben. •Wert false oDie bisherigen Zusatzartikel im Artikel bleiben erhalten. oNeue Zusatzartikel werden hinzugefügt. oBestehende Zusatzartikel können aktualisiert werden (Position, Typ,...). |
0..1 |
boolean |
Default: false |
cross_selling_item |
Wrapper-Element, das die Daten des Zusatzartikels zusammenfasst |
0..N |
Element |
|
delete |
Attribut von cross_selling_item, mit dem gezielt einzelne Cross-Selling-Artikel entfernt werden können. Um einen zugewiesenen Cross-Selling-Artikel zu entfernen muss mindestens das Delete-Flag mit dem Wert "true" und der zu entfernenden cross_selling_item_id übergeben werden. |
0..1 |
boolean |
Default: false |
cross_selling_item_id |
ID des Zusatzartikels |
1 |
integer |
|
position |
Position innerhalb der Zusatzartikel. Wird zur Sortierung verwendet. |
0..1 |
integer |
|
cross_selling_type |
Typ des Zusatzartikels |
0..1 |
string |
Feste Werte: CROSS_ SELLING | UP_SELLING | ALTERNATIVE |
item_set |
Wrapper-Element, das die Artikelsets dieses Artikels zusammenfasst. |
0..1 |
Element |
|
set_item |
Wrapper-Element, das die Daten des Artikelsets zusammenfasst. |
0..N |
Element |
|
set_item_id |
ID des Setartikels |
0..1 |
integer |
Entweder set_item_id oder internal_set_item_number. Eines der beiden Felder muss immer angegeben sein. |
position |
Position innerhalb des Sets. Wird zur Sortierung verwendet. |
0..1 |
integer |
|
amount |
Menge des Setartikels im Set |
1 |
integer |
Die Menge des Setartikels im Set ist zwingend nötig um den Gesamtsetbestand berechnen zu können. |
internal_set_item_number |
Interne Artikelnummer des Setartikels im Set |
0..1 |
string |
Entweder set_item_id oder internal_set_item_number. Eines der beiden Felder muss immer angegeben sein. |
specific_item_data |
Wrapper-Element, das Verkaufskanalspezifische Daten zum Artikel zusammenfasst. |
1 |
Element |
|
[entries] |
Platzhalter für Verkaufskanalspezifische Daten. Die möglichen Daten sind in den platformspezifischen Daten zum call updateItems beschrieben. |
0..N |
Element |
|
item_suppliers |
Wrapper-Element, das die Daten der zugeordneten Lieferantenbeziehungen enthält |
0..1 |
Element |
|
delete |
Attribut von item_suppliers, mit dem festgelegt werden kann ob die übergebenen Lieferanten additiv (delete="false") oder überschreibend (delete="true") zugewiesen werden. Wird das Flag delete="true" übergeben und kein Lieferant, werden alle bisher zugewiesenen Lieferanten entfernt. |
0..1 |
boolean |
Default:false |
item_supplier |
Wrapper-Element, das die Daten einer zugeordneten Lieferantenbeziehung enthält. |
0..N |
Element |
|
supplier_id |
Legt die ID des Lieferanten für diese Artikel-Lieferanten-Beziehung fest. |
1 |
integer |
|
purchase_price |
Legt den Preis des Artikels für den Lieferanten fest. |
0..1 |
decimal |
|
additional_charge_percentage |
Legt den prozentualen Aufschlag für diesen Lieferanten fest. |
0..1 |
decimal |
|
priority |
Legt die Priorität des Lieferanten fest. |
0..1 |
integer |
|
default_shipping_carrier_id |
ID des Versanddienstleisters der standardmäßig für diesen Artikel verwendet werden soll. |
0..1 |
integer |
|
default_shipping_carrier_identifier |
Bezeichner des Versanddienstleisters der standardmäßig für diesen Artikel verwendet werden soll. |
0..1 |
string |
Länge: 0-100 Zeichen |
default_shipping_carrier_external_id |
Externe ID des Versanddienstleisters der standardmäßig für diesen Artikel verwendet werden soll. |
0..1 |
string |
|
media_modules |
Wrapper-Element, das die Daten der Medienbausteine zusammenfasst. |
0..1 |
Element |
|
media_module |
Wrapper-Element, das die Daten eines Medienbausteins beinhaltet. |
1..N |
Element |
|
media_module_type_id |
Gibt an welchem Medienbaustein das Medium zugewiesen wird. |
1 |
integer |
|
language_code_iso |
Medienbausteininhalte können je Sprache gepflegt werden. Übergeben Sie hier für welche Übersetzungssprache das Medium verwendet werden soll. |
1 |
string |
Feste Werte. |
media_id |
Medien die bereits im System vorhanden sind können via ID zugewiesen werden. |
0..1 |
integer |
|
url |
Hinterlegen des Mediums über eine URL. |
0..1 |
string |
|
item_attributes |
Wrapper-Element, das die Daten der Attribute zusammenfasst. |
0..1 |
Element |
|
clear |
Attribut von item_attributes, mit dem festgelegt werden kann, ob die bereits gepflegten Attribute vor dem Import der übergebenen Attribute allesamt gelöscht werden sollen. Wird das Flag clear="true" und kein Artikelattribut übergeben, dann werden alle bisher zugewiesenen Artikelattribute entfernt. |
0..1 |
boolean |
Default: false |
item_attribute |
Wrapper-Element, das die Daten der Attribute zusammenfasst. |
0..1 |
Element |
|
significant_key |
Gibt an welches Feld zur Identifikation des Attributes beim Update genutzt wird. |
1 |
string |
Feste Werte: "attribute_id" | "attribute_identifier" |
delete |
Gibt an ob die Zuweisung des Attributes zum Artikel entfernt werden soll (true), oder ob das Attribut dem Artikel zugewiesen werden soll (false). |
0..1 |
boolean |
Standard: false |
attribute_id |
ID des Attributes |
0..1 |
integer |
|
attribute_identifier |
Bezeichner des Attributes |
0..1 |
string |
Max. Länge: 100 Zeichen |
attribute_data_type |
Datentyp des Attributes |
0..1 |
string |
Feste Werte: "STRING" | "MULTILANGUAGE_STRING" | "INTEGER" | "DECIMAL" | "BOOLEAN" | "IMAGE_MODULE" | "TEXT_MODULE" | "MEDIUM" | "FIELD_LINK" |
attribute_value_type |
Typ der Attributwerte FREE = Freitext Werte PRE_DEFINED = Vordefinierte Werte |
0..1 |
string |
Feste Werte: "FREE" | "PRE_DEFINED" |
display_mode |
Anzeigemodus (1 = "Auswahlliste", 2 = "Auswahlschaltflächen") |
0..1 |
integer |
Feste Werte: "1" | "2" |
unit_type_id |
ID des Maßeinheitentyps. |
0..1 |
integer |
Feste Werte |
unit_id |
ID der zu verwendenden Einheit für das Attribut. |
0..1 |
integer |
Feste Werte: Länge, Fläche, Volumen, Gewicht, Stück und weitere. |
translations |
Wrapper-Element, das mehrsprachig vorhandene Daten zusammenfasst. |
0..1 |
Element |
|
translation |
Wrapper-Element, das die Informationen einer Sprache zusammenfasst. |
1..N |
Element |
|
language_code_iso |
ISO-Code der Sprache. |
1 |
string |
Feste Werte |
text |
Übersetzer Attributbezeichner passend zur Sprache des vorher gewählten language_code_iso Wertes. |
1 |
string |
Max. Länge = 100 Zeichen |
subchannel_map |
Wrapper-Element, das verschiedene, subchannel-spezifische Attributbezeichner zusammenfasst. |
0..1 |
Element |
|
subchannel_entry |
Wrapper-Element, das ein subchannel-spezfischen Attributbezeichner enthält. |
1..N |
Element |
|
subchannel_id |
ID des Subchannels |
1 |
integer |
Siehe Wertetabelle. |
subchannel_text |
Gibt den Attributbezeichner spezifisch für den gewählten Subchannel an. |
1 |
string |
Max. Länge = 100 Zeichen |
item_attribute_values |
Wrapper-Element, das verschiedene Attributwerte zusammenfasst. |
0..1 |
Element |
|
item_attribute_value |
Wrapper-Element, das einen Attributwert enthält. |
1..N |
Element |
|
significant_key |
Gibt an welches Feld zur Identifikation des Attributwertes beim Update genutzt wird. |
1 |
string |
Feste Werte: "attribute_value_id" | "attribute_value_identifier" |
delete |
Gibt an ob der übergebene Attributwert dem Artikelattribute zugewiesen (false) oder entfernt werden soll (true). |
0..1 |
boolean |
Standard: false |
attribute_value_id |
Identifizierung des Attributwertes via dessen ID. |
0..1 |
integer |
|
attribute_value_identifier |
Bezeichnung des Attributwertes. |
0..1 |
string |
Max. Länge in Abhängigkeit des gewählten Datentyps. Texte = 100 Zeichen; Ganzzahl = 10 Stellen; Dezimalzahl = 7 Vorkomma- und 2 Nachkommastellen. |
unit_id |
ID der zu verwendenden Einheit für den Attributwert. |
0..1 |
integer |
Feste Werte: Länge, Fläche, Volumen, Gewicht, Stück und weitere. |
translations |
Wrapper-Element, das die verschiedenen Übersetzungen des Attributwertes zusammenfasst. |
0..1 |
Element |
|
translation |
Wrapper-Element, das eine Übersetzung des Attributwertes beinhaltet. |
1..N |
Element |
|
language_code_iso |
ISO-Code der Sprache. |
1 |
string |
Feste Werte |
text |
Übersetzte Bezeichnung des Attributwertes, passend zur Sprache des vorher gewählten language_code_iso Wertes. |
1 |
string |
Max. Länge = 100 Zeichen |
subchannel_map |
Wrapper-Element, das die verschiedenen subchannel-spezifischen Bezeichnungen des Attributwertes zusammenfasst. |
0..1 |
Element |
|
subchannel_entry |
Wrapper-Element, das eine subchannel-spezifische Bezeichnung des Attributwertes beinhaltet. |
1..N |
Element |
|
subchannel_id |
ID des Subchannels. |
1 |
integer |
Siehe Wertetabelle. |
subchannel_text |
Gibt die Bezeichnung des Attributwertes zu dem gewählten Subchannel an. |
1 |
string |
Max. Länge = 100 Zeichen |
<response method="updateItems" version="1.0.0"> <report action="insert" return_code="0" reference_id="ref-123"> <item> <item_id>887021</item_id> <mandator_id>1</mandator_id> <internal_item_number>s4t_05-001</internal_item_number> <ean_code>5901234123457</ean_code> <stock_count>200</stock_count> </item> </report> </response> |
Name |
Beschreibung |
Anz. |
Typ |
sonstiges |
|---|---|---|---|---|
response |
Root-Element der Antwort |
1 |
Element |
|
method |
Attribut von response. Name der Webservice-Methode. |
1 |
string |
Fester Wert: „updateItems“ |
version |
Attribut von response. Legt die Version der Anfrage fest. |
1 |
integer |
Fester Wert: „1.0.0“ |
report |
Information über die ausgeführte Operation. Für jedes Item-Element aus dem Request wird ein Report zurückgegeben. |
0..N |
Element |
|
action |
Attribut von report. Gibt an welche Operation mit dem Datensatz durchgeführt wurde. |
1 |
string |
Feste Werte: insert | update |
return_code |
Attribut von report. Gibt an ob in der durchgeführten Operation Fehler aufgetreten sind. |
1 |
integer |
0 = OK. < 0 = Fehler. Feste Werte |
reference_id |
Optionales Attribut von report. Enthält die im zugehörigen item-Block des Requests angegebene reference_id falls diese angegeben wurde. |
0..1 |
string |
|
error_description |
Falls bei der Durchführung der Operation Fehler aufgetreten sind wird in error_description eine Fehlerbeschreibung zurück geliefert |
0..1 |
string |
|
item |
Wrapper-Element, das die Daten der Artikel zusammenfasst |
1 |
Element |
|
item_id |
Artikel-ID |
1 |
integer |
|
mandator_id |
Mandanten-ID |
1 |
integer |
|
internal_item_number |
Interne Artikelnummer |
1 |
string |
Länge: 0 – 50 Zeichen |
ean_code |
EAN-Code des Artikels |
1 |
string |
|
stock_count |
Artikelbestand |
0..1 |
integer |
Aufgeführte Werte gelten für das Feld return_code
Wert |
Beschreibung |
|---|---|
-1 |
Error |
-4 |
Validation failed |
-5 |
Access denied |
Value Table - for Field: base_price_type_id |
Value |
Description |
|---|---|
1 |
per 1 m |
2 |
per 1 m² |
3 |
per 100 cm³ |
4 |
per 1 dm³ |
5 |
per 100 g |
6 |
per 1 kg |
7 |
per 100 ml |
8 |
per 1 l |
9 |
per 1 piece | Stück |
10 |
per 1 m³ |
Value Table - for Field: language_code_iso. |
Value |
Description |
|---|---|
de |
German |
en |
English |
fr |
French |
... |
|
Aufgeführte Werte gelten für das Feld: distance_unit_id
Wert |
Beschreibung |
|---|---|
105 |
mm |
110 |
cm |
115 |
dm |
120 |
m |
125 |
in. |
130 |
ft. |
135 |
yd |
Aufgeführte Werte gelten für das Feld area_unit_id |
Wert |
Beschreibung |
|---|---|
200 |
mm² |
205 |
cm² |
210 |
dm² |
215 |
m² |
220 |
sq. in. |
225 |
sq. ft. |
230 |
sq. yd. |
235 |
sq. |
Value Table - for Field: volume_unit_id |
Value |
Description |
|---|---|
300 |
mm³ |
305 |
cm³ |
310 |
dm³ |
315 |
m³ |
320 |
cu. in. |
325 |
cu. ft. |
330 |
cu. yd. |
355 |
ml |
357 |
cl |
360 |
l |
365 |
fl. oz. |
370 |
pt. |
375 |
qt. |
380 |
gal. |
Aufgeführte Werte gelten für das Feld: weight_unit_id
Value |
Description |
|---|---|
400 |
g |
405 |
kg |
407 |
t |
409 |
oz.tr. |
410 |
oz. |
415 |
pd. |
Value Table - for Field: piece_unit_id |
Value |
Description |
|---|---|
500 |
piece | Stück |
Aufgeführte Werte gelten für das Feld pressure_unit_id (Druck). |
Wert |
Beschreibung |
|---|---|
600 |
µPa |
601 |
mPa |
602 |
Pa |
603 |
hPa |
604 |
kPa |
610 |
bar |
615 |
psi |
620 |
mmHg |
Aufgeführte Werte gelten für das Feld temperature_unit_id (Temperatur). |
Wert |
Beschreibung |
|---|---|
640 |
K |
641 |
°C |
642 |
°F |
643 |
°Ra |
Aufgeführte Werte gelten für das Feld degree_unit_id (Grad). |
Wert |
Beschreibung |
|---|---|
650 |
° |
Aufgeführte Werte gelten für das Feld voltage_unit_id (Elektr. Spannung). |
Wert |
Beschreibung |
|---|---|
660 |
µV |
661 |
mV |
662 |
V |
663 |
kV |
Aufgeführte Werte gelten für das Feld electric_charge_unit_id (Elektr. Ladung). |
Wert |
Beschreibung |
|---|---|
670 |
mAh |
671 |
Ah |
672 |
As |
Aufgeführte Werte gelten für das Feld electric_resistance_unit_id (Elektr. Widerstand). |
Wert |
Beschreibung |
|---|---|
680 |
µΩ |
681 |
mΩ |
682 |
Ω |
683 |
kΩ |
684 |
MΩ |
Aufgeführte Werte gelten für das Feld electric_current_unit_id (Elektr. Stromstärke). |
Wert |
Beschreibung |
|---|---|
690 |
µA |
691 |
mA |
692 |
A |
693 |
kA |
694 |
MA |
Aufgeführte Werte gelten für das Feld electric_conductance_unit_id (Elektr. Leitwert). |
Wert |
Beschreibung |
|---|---|
700 |
µS |
701 |
mS |
702 |
S |
703 |
kS |
Aufgeführte Werte gelten für das Feld force_unit_id (Kraft). |
Wert |
Beschreibung |
|---|---|
710 |
mN |
711 |
cN |
712 |
N |
713 |
kN |
Aufgeführte Werte gelten für das Feld time_unit_id (Zeit). |
Wert |
Beschreibung |
|---|---|
720 |
ms |
721 |
s |
722 |
min |
723 |
h |
724 |
d |
725 |
w |
726 |
m |
727 |
y |
Aufgeführte Werte gelten für das Feld frequency_unit_id (Frequenz). |
Wert |
Beschreibung |
|---|---|
730 |
mHz |
731 |
Hz |
732 |
kHz |
733 |
MHz |
734 |
GHz |
Aufgeführte Werte gelten für das Feld power_rating_unit_id (Leistung). |
Wert |
Beschreibung |
|---|---|
740 |
µW |
741 |
mW |
742 |
W |
743 |
kW |
744 |
MW |
745 |
PS |
Aufgeführte Werte gelten für das Feld lighting_current_unit_id (Lichtstrom). |
Wert |
Beschreibung |
|---|---|
750 |
mlm |
751 |
lm |
752 |
klm |
Aufgeführte Werte gelten für das Feld luminous_intensity_unit_id (Lichtstärke). |
Wert |
Beschreibung |
|---|---|
760 |
mcd |
761 |
cd |
762 |
kcd |
Aufgeführte Werte gelten für das Feld illumination_unit_id (Beleuchtungsstärke). |
Wert |
Beschreibung |
|---|---|
770 |
µlx |
771 |
mlx |
772 |
lx |
773 |
klx |
Aufgeführte Werte gelten für das Feld loudness_unit_id (Lautstärke). |
Wert |
Beschreibung |
|---|---|
780 |
B |
781 |
dB |
782 |
dB(A) |
Aufgeführte Werte gelten für das Feld velocity_unit_id (Geschwindigkeit). |
Wert |
Beschreibung |
|---|---|
790 |
m/s |
791 |
m/min |
792 |
m/h |
793 |
km/s |
794 |
km/min |
795 |
km/h |
796 |
mps |
797 |
mpm |
798 |
mph |
799 |
kn |
Aufgeführte Werte gelten für das Feld revolution_speed_unit_id (Drehzahl). |
Wert |
Beschreibung |
|---|---|
810 |
U/s |
811 |
U/min |
812 |
U/h |
Aufgeführte Werte gelten für das Feld flow_rate_unit_id (Volumenstrom). |
Wert |
Beschreibung |
|---|---|
820 |
cm³/s |
821 |
cm³/min |
822 |
cm³/h |
823 |
m³/s |
824 |
m³/min |
825 |
m³/h |
826 |
l/s |
827 |
l/min |
828 |
l/h |
829 |
in³/s |
830 |
in³/m |
831 |
in³/h |
832 |
gps |
833 |
gpm |
834 |
gph |
Aufgeführte Werte gelten für das Feld mass_throughput_unit_id (Massenstrom). |
Wert |
Beschreibung |
|---|---|
840 |
g/s |
841 |
g/min |
842 |
g/h |
843 |
kg/s |
844 |
kg/min |
845 |
kg/h |
846 |
oz./s |
847 |
oz./min |
848 |
oz./h |
849 |
lb/s |
850 |
lb/min |
851 |
lb/h |
Aufgeführte Werte gelten für das Feld energy_unit_id (Energie). |
Wert |
Beschreibung |
|---|---|
860 |
J |
861 |
kJ |
862 |
MJ |
863 |
cal |
864 |
kcal |
865 |
Wh |
866 |
kWh |
867 |
MWh |
Aufgeführte Werte gelten für das Feld proportion_unit_id (Volumenanteil). |
Wert |
Beschreibung |
|---|---|
870 |
‰ |
871 |
% |
Aufgeführte Werte gelten für das Feld volume_share_unit_id (Volumenanteil). |
Wert |
Beschreibung |
|---|---|
880 |
% vol. |
Aufgeführte Werte gelten für das Feld surface_weight_unit_id (Flächengewicht). |
Wert |
Beschreibung |
|---|---|
890 |
mg/m² |
891 |
g/m² |
892 |
kg/m² |
Aufgeführte Werte gelten für das Feld memory_capacity_unit_id (Speicherplatz). |
Wert |
Beschreibung |
|---|---|
900 |
B |
901 |
kB |
902 |
MB |
903 |
GB |
904 |
b |
905 |
kb |
906 |
Mb |
907 |
Gb |
Aufgeführte Werte gelten für das Feld torque_unit_id (Drehmoment). |
Wert |
Beschreibung |
|---|---|
915 |
mNm |
916 |
Nm |
917 |
kNm |
Aufgeführte Werte gelten für das Feld resolution_unit_id (Auflösung). |
Wert |
Beschreibung |
|---|---|
920 |
dpi |
921 |
px |
922 |
Mpx |
Aufgeführte Werte gelten für das Feld refraction_unit_id (Brechkraft). |
Wert |
Beschreibung |
|---|---|
930 |
dpt |
Value Table - for Field sub_channel_id |
sub_channel_id |
sub_channel_identifier |
channel_identifier |
|---|---|---|
1001 |
Speed4Trade COMMERCE |
Onlineshops |
1100 |
modified Shop |
Onlineshops |
1400 |
Gambio (Deprecated) |
Onlineshops (Deprecated) |
1500 |
Shopgate (Deprecated) |
Onlineshops (Deprecated) |
1600 |
MagentoCommerce |
Onlineshops |
1700 |
OXID |
Onlineshops |
1900 |
Shopware |
Onlineshops |
2100 |
eBay.de |
eBay |
2200 |
eBay.co.uk |
eBay |
2250 |
eBay.ie |
eBay |
2300 |
eBay.com |
eBay |
2310 |
eBay Motors |
eBay |
2350 |
eBay.ca |
eBay |
2400 |
eBay.fr |
eBay |
2500 |
eBay.it |
eBay |
2600 |
eBay.at |
eBay |
2650 |
eBay.ch |
eBay |
2700 |
eBay.es |
eBay |
2750 |
eBay.com.au |
eBay |
2800 |
eBay.nl |
eBay |
2850 |
eBay.be |
eBay |
2900 |
eBay.pl |
eBay |
3100 |
amazon.de |
Amazon |
3200 |
amazon.co.uk |
Amazon |
3300 |
amazon.fr |
Amazon |
3350 |
amazon.nl |
Amazon |
3400 |
amazon.com |
Amazon |
3500 |
amazon.it |
Amazon |
3550 |
amazon.ae |
Amazon |
3600 |
amazon.es |
Amazon |
3700 |
amazon.ca |
Amazon |
3750 |
amazon.com.au |
Amazon |
3800 |
amazon.com.mx |
Amazon |
3820 |
amazon.eg |
Amazon |
3830 |
amazon.sa |
Amazon |
3840 |
amazon.tr |
Amazon |
3850 |
amazon.se |
Amazon |
3860 |
amazon.pl |
Amazon |
4100 |
Telefonverkauf |
manual sales / telesales |
5100 |
Allyouneed.de (Deprecated) |
Allyouneed (Deprecated) |
6100 |
Yatego |
Yatego |
7100 |
Rakuten.de (Deprecated) |
Rakuten (Deprecated) |
9100 |
DAPARTO.de |
DAPARTO |
10100 |
otto.de |
OTTO |
10200 |
otto.at |
OTTO |
10300 |
otto.ch |
OTTO |
10400 |
otto.nl |
OTTO |
10500 |
otto.ru |
OTTO |
11100 |
Locafox.de (Deprecated) |
Locafox (Deprecated) |
12100 |
WEBSALE (Deprecated) |
WEBSALE (Deprecated) |
13100 |
Kaufland.de |
Kaufland.de |
14001-14999 |
individual channel name (see notes below) |
Multi-Channel-Plugin (MCP) |
15100 |
OTTO Market DE |
OTTO Market |
Note for value table and field : sub_channel_id: The sub channels for the Multi-Channel-Plugin (MCP) can be configured via the Speed4Trade CONNECT UI. This doesn't allow for a standardized definition across all customer systems. The required subchannel_ids can be retrieved by using the call fetchSubChannels which could be executed after the initial configuration of a new subchannel using a tool like SoapUI. Setup of this tool is described in the Partnerportal. |
Allgemeine Hinweise zu einzelnen Feldern
•Bei jeder Operation wird zunächst geprüft ob bereits ein passender Datensatz mit dem durch significant_key angegebenen Schlüssel zum Aktualisieren vorhanden ist. Wenn dies nicht der Fall ist, wird ein neuer Datensatz angelegt. •Die Elemente category_id und external_category_id dürfen nicht gemeinsam genutzt werden. •Die Elemente delivery_time_id und delivery_time_identifier dürfen nicht gemeinsam genutzt werden. •Die Elemente default_shipping_carrier_id und default_shipping_carrier_identifier dürfen nicht gemeinsam genutzt werden. •Die reference_id wird nicht in Speed4Trade CONNECT gespeichert und ist damit auch nicht fest an den betroffenen Artikel gebunden. Die selbe ID kann daher in unterschiedlichen Calls problemlos wiederverwendet werden. Sie dient lediglich zur schnellen Zuordnung eines Reports in den Response-Daten zu einem order-Block aus den Request-Daten. Dies ist insbesondere dann nützlich wenn es bei der Verarbeitung eines oder mehrerer der übergebenen Artikel zu Fehlern kommt und noch keine Artikel-IDs für eine Zuordnung vorhanden sind. So kann dennoch die Fehlermeldung zu einem Request-Bestandteil zugeordnet werden. |
Hinweise zu Varianten und Sets
•Die Elemente variant_parent_id und external_variant_parent_id dürfen nicht gemeinsam genutzt werden. •Bei Angabe der external_variant_parent_id muss in einem vorausgehenden Aufruf von updateItems bereits der Varianten-Hauptartikel angelegt worden sein, da sonst eine Zuweisung nicht funktioniert. Es kann also nicht im gleichen Aufruf der Hauptartikel und der Unterartikel angelegt werden, wenn beide über dieses Feld verknüpft werden sollen. •Bei den Artikelvarianten darf nur bei einer die Eigenschaft der Standard-Variante "variant_standard" gesetzt werden. Ob diese Eigenschaft wirklich nur bei einer Artikelvariante gesetzt ist, wird seitens Speed4Trade CONNECT nicht geprüft, sondern muss von außen korrekt übergeben werden. Für die Marktplätze und Shops ist wichtig, dass dieses Flag eindeutig einer Artikelvariante zuordenbar ist. •Definieren von Artikelsets setzt voraus, dass die enthaltenen Artikel (Setbestandteile und Sethauptartikel) bereits in Speed4Trade CONNECT angelegt sind.
|
•Wird ein Bild über die Elemente base64_image_data oder local_image_path übergeben, muss auch das Element image_type angegeben werden. Image_type muss nach den beiden Elementen aufgeführt sein. •Aus Performance-Gründen sollten Bilder möglichst per UNC-Pfad oder URL angegeben werden. Falls dennoch eine Base64-codierte Übergabe notwendig ist, sollte die Datenmenge der übergebenen Bilder pro Request nicht mehr als 2 MB, wie in den technischen Hinweisen angegeben, betragen. •Für das Feld local_image_path dürfen Netzlaufwerke nicht über einen verknüpften Laufwerksbuchstaben angegeben werden. Stattdessen muss die UNC-Notation benutzt werden, da für Dienste keine Logon-Skripte ausgeführt werden, welche die Laufwerksverknüpfung machen und somit der Laufwerksbuchstabe für Speed4Trade CONNECT nicht existent ist. |
•Werden in einem Request zentrale Attribute und marktplatzspezifische Attribute übergeben, so werden nur die zentralen Attribute gesetzt. •Wird über das delete Flag ein zugewiesenes Attribut vom Artikel entfernt, dann werden auch die dazugehörigen Attributwerte des Artikels entfernt. •Soll ein mehrsprachiger Freitextattributwert einzeln entfernt werden, so muss die Bezeichnung des Attributwertes in der Hauptsystemsprache übergeben werden. •Beim Anlegen eines neuen Attributes müssen zwingend Daten für attribute_identifier, attribute_data_type und attribute_value_type übergeben werden. Um bestehende Attribute dem Artikel zuzuweisen, reicht die Angabe der attribute_id. •Attributwerte werden für Artikel überschreibend gesetzt. D.h. um einen bestehende Attributwertzuweisung im Artikel zu behalten und gleichzeitig einen weiteren Attributwert für das gleiche Attribut hinzuzufügen muss im Request sowohl der bestehende als auch der neue Wert übergeben werden. •Best Practice bei der Verwendung der Attributtypen: oDer Typ des Attributs (attribute_value_type) sollte nur in den Fällen auf der Standardeinstellung "PRE_DEFINED" belassen werden, wenn für das Attribut nur wenige, bestimmte Werte gepflegt sind und wenn diese auf den Verkaufskanälen als Filterwerte benutzt werden. In allen anderen Fällen ist der Typ des Attributs zu wechseln auf "FREE", da damit immer nur ein Wert je Attribut direkt beim Artikel gespeichert wird (Performance) und keine Werteliste beim Attribut hinterlegt und aktualisiert werden muss. oDer Datentyp des Attributs (attribute_data_type) ist immer entsprechend der Attributverwendung zu wählen. Wird der Datentyp nicht gesetzt, wird die Standardeinstellung "MULTILANGUAGE_STRING" verwendet. Dies erfordert dann zwingend die Übergabe Elements "translations" mit mindestens einer Sprache. Bei anderen Datentypen werden die Werte im Feld "attribute_value_identifier" übergeben. Die Standardeinstellung sollte also nur in den Fällen verwendet werden, bei denen wirklich mehrsprachige Texte als Attribut gespeichert werden sollen. oDie am häufigsten benutzte Kombination ist: attribute_data_type="STRING" und attribute_value_type="FREE". •Wichtig: Bei Attributen die Variantenbildend verwendet werden bitte immer den Typ attribute_value_type="PRE_DEFINED" übergeben. Über den Webservice kann der Attributtyp von bestehenden Attributen geändert werden, die Attribute können dann nicht mehr für die Variantenbildung verwendet werden. |
Version |
Änderungsbeschreibung |
3.2.9.75 |
Redaktionelle Überarbeitung |
3.2.11.46 |
Ergänzung des Attributs reference_id in den Request- und Response-Daten. |
3.3.2.90 |
Erweiterung der listing_settings um Option zum Abgleich der Daten mit Angeboten |
3.4.31.1 |
Hinweis zur Positionierung des Elements image_type ergänzt. |
3.4.42.1 |
Ergänzung des Elements internal_set_item_number als zusätzliche Identifizierung des Setartikeln im Set. |
3.5.7 |
Hinweis zur Verwendung der Eigenschaft external_variant_parent_id. |
3.5.17 |
Hinweis zur Verwendung der Eigenschaft variant_standard ergänzt. |
3.5.27 |
Neuen Cross-Selling Typ "ALTERNATIVE" hinzugefügt. |
3.5.37 |
Ergänzung des Elements item_attributes um Attribute und Attributwerte pflegen zu können. |
3.5.37 |
Hinzufügen der externe ID des Versanddienstleisters der standardmäßig für diesen Artikel verwendet werden soll. |
3.5.47 |
Neues Attribut "delete" bei den Textbausteinen. |
3.6.3 |
Hinzufügen der neuen unit_type_id und der neuen unit_ids. |
3.6.17 |
Erweiterung der Übergabe von Attributen und Attributwerten um je ein Delete-Flag. |
3.6.23 |
Erweiterung der Übergabe von Zusatzartikeln um ein Delete-Flag. |
3.6.23 |
Erweiterung der Übergabe von Lieferanten um ein Delete-Flag. |
4.7.5 |
Hinzufügen der Verpackungseinheit |
4.7.51 |
Neues Attribut "clear" bei item_attributes, um bestehende Artikelattributzuweisungen vorab zu löschen. |
4.8.2 |
Wertetabelle für Subchannels eingefügt. |
4.8.20 |
Hinweise neu strukturiert und Best-Practice für Attribute ergänzt. |
4.13.35 |
Erweiterung der Übergabe von Zusatzartikels um ein Clear-Flag. |