WebService Calls > Options for Growth

Beschreibung

Über diese Funktion können Artikel-Attribute angelegt und bearbeitet werden.

Beispiel Request

Code

<mandator_id>1</mandator_id>

<attribute_id>561</attribute_id>

<attribute_identifier>Attribut_Bezeichnung</attribute_identifier>

<display_mode>1</display_mode>

<data_type>MULTILANGUAGE_STRING</data_type>

<value_type>PRE_DEFINED</value_type>

<unit_type_id>1</unit_type_id>

<unit_id>110</unit_id>

<language_code_iso>en</language_code_iso>

<text>Attribut_Bezeichnung_Englisch</text>

</translation>

</translations>

<attribute_values>

<attribute_value significant_key="attribute_value_id">

<attribute_value_id>674</attribute_value_id>

<attribute_value_identifier>Attributwert_Bezeichnung</attribute_value_identifier>

<unit_id>110</unit_id>

<language_code_iso>en</language_code_iso>

<text>Attributwert_Bezeichnung_Englisch</text>

</translation>

</translations>

<subchannel_map>

<subchannel_entry>

<subchannel_id>3100</subchannel_id>

<subchannel_text>Attributwertbezeichnung_fuer_amazon.de</subchannel_text>

</subchannel_entry>

</subchannel_map>

</attribute_value>

</attribute_values>

<subchannel_map>

<subchannel_entry>

<subchannel_id>1100</subchannel_id>

<subchannel_text>Attributbezeichnung_fuer_xt:Commerce</subchannel_text>

</subchannel_entry>

</subchannel_map>

<specific_attribute_data></specific_attribute_data>

</attribute>

</request>

Feldliste 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: „updateAttributes“
version	Attribut von request. Legt die Version der Anfrage fest.	1	integer	Fester Wert: „1.0.0“
attribute	Wrapper-Element, das Informationen zu einem Attribut zusammenfasst.	1	Element
significant_key	Gibt an welches Feld zur Identifikation des Attributs beim Update genutzt wird.	1	string	Feste Werte: "attribute_id" \| "attribute_identifier"
reference_id	Optionales Attribut des Elements "attribute". 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
mandator_id	Mandanten-ID	1	integer
attribute_id	ID des Attributes	0..1	integer
attribute_identifier	Bezeichnung des Attributes	0..1	string
display_mode	Anzeigemodus (1 = "Auswahlliste", 2 = "Auswahlschaltflächen")	0..1	integer	Feste Werte: "1" \| "2"
data_type	Datentyp des Attributes	0..1	string	Feste Werte: "STRING" \| "MULTILANGUAGE_STRING" \| "INTEGER" \| "DECIMAL" \| "BOOLEAN" \| "IMAGE_MODULE" \| "TEXT_MODULE" \| "MEDIUM" \| "FIELD_LINK"
value_type	Typ des Attributes	0..1	string	Feste Werte: "PRE_DEFINED" \| "FREE"
unit_type_id	ID des Masseinheitentyps.	0..1	integer	Feste Werte.
unit_id	Default ID der Attributeinheit.	0..1	integer	Feste Werte: Länge, Fläche, Volumen, Gewicht, Stück oder weitere.
translations	Wrapper-Element, das die verschiedenen Übersetzungen des Attributs zusammenfasst.	0..1	Element
translation	Wrapper-Element, das eine Übersetzung des Attributs beinhaltet.	1..N	Element
language_code_iso	ISO-Code der Sprache	1	string	Feste Werte
text	Übersetzte Bezeichnung des Attributs.	1	string	Max. Länge = 100 Zeichen
attribute_values	Wrapper-Element, das verschiedene Attributwerte zusammenfasst.	0..1	Element
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"
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 Attributeinheit.	0..1	integer	Feste Werte: Länge, Fläche, Volumen, Gewicht, Stück oder 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.	1	string	Max. Länge = 100 Zeichen
subchannel_map	Wrapper-Element, das die verschiedenen, subchannelspezifischen Bezeichnungen des Attributwertes zusammenfasst.	0..1	Element
subchannel_entry	Wrapper-Element, das eine subchannelspezifische Bezeichnung des Attributwertes enthält.	1..N	Element
subchannel_id	ID des Subchannels.	1	integer	Siehe Wertetabelle.
subchannel_text	Bezeichnung des Attributwertes für den Subchannel.	1	string	Max. Länge = 100 Zeichen
subchannel_map	Wrapper-Element, das die verschiedenen, subchannelspezifischen Bezeichnungen des Attributes zusammenfasst.	0..1	Element
subchannel_entry	Wrapper-Element, das eine subchannelspezifische Bezeichnung des Attributes enthält.	1..N	Element
subchannel_id	ID des Subchannels.	1	integer	Siehe Wertetabelle.
subchannel_text	Bezeichnung des Attributes für den Subchannel	1	string	Max. Länge = 100 Zeichen
specific_attribute_data	Wrapper-Element, das die verkaufskanalspezifischen Daten zum Attribut zusammenfasst.	0..1	Element
[entries]	Platzhalter für verkaufskanalspezifische Daten.	1..N	Element

Beispiel Response

Code

Feldliste 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: „“
version	Attribut von response. Legt die Version der Anfrage fest.	1	string	Fester Wert: „1.0.0“
report	Information über die ausgeführte Operation.	1	Element
return_code	Attribut von report. Gibt an ob in der durchgeführten Operation Fehler aufgetreten sind.	1	integer	0 = OK. < 0 = Fehler
error_description	Falls bei der Durchführung der Operation Fehler aufgetreten sind wird in error_description eine Fehlerbeschreibung zurück geliefert	1	string
attribute	Wrapper-Element, das die Daten des Attributes zusammenfasst	1	Element
variant_attribute_id	ID Attributes	1	integer
mandator_id	Mandant des Attributes	1	integer
identifier	Bezeichner des Attributes	1	string	Max. Länge: 100 Zeichen

Hinweise

•Die Priorität der Attributwerte wird anhand der Reihenfolge, in der sie übergeben werden, festgelegt.

•Um subchannelspezifische Attribut-Bezeichnungen zu vergeben oder ändern können Sie den Eintrag subchannel_map verwenden. Dieser ändert ausschließlich die Bezeichnung. Über den Bereich specific_attribute_data können Sie auch die Attribut-Bezeichnung je nach Subchannel bearbeiten. Darüber hinaus bietet der Bereich der specific_attribute_data mehr Möglichkeiten (z.b. aktiv setzen des Attributes). Soll nur die Bezeichnung des Attributes für den Subchannel gesetzt werden, entscheiden sie sich für eine der beiden Wege.

•Best Practice bei der Verwendung der Attributtypen:

oDer Typ des Attributs (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: data_type="STRING" und value_type="FREE".

Wertetabelle(n)

Value Table - for Field: language_code_iso.

Value	Description
de	German
en	English
fr	French
...

Value Table for Field: unit_type_id.

Value	Description
1	Length \| Länge
5	Area \| Fläche
10	Volume \| Volumen
15	Mass \| Masse
20	piece \| Stück
21	preasure\| Druck
22	temperature \| Temperatur
23	angle \| Winkel
24	electrical voltage \| Elektr. Spannung
25	electrical charge \| Elektr. Ladung
26	electrical resistance \| Elektr. Widerstand
27	electrical current \| Stromstärke
28	ohmic conductance \| Leitwert
29	power \| Kraft
30	time \| Zeit
31	frequency \| Frequenz
32	electrical power \| Leistung
33	luminous flux \| Lichtstrom
34	luminous intensity \| Lichtstärke
35	illuminance \| Beleuchtungsstärke
36	sound volume \| Lautstärke
37	velocity \| Geschwindigkeit
38	rotational speed \| Drehzahl
39	volume flow \| Volumenstrom
40	mass flow \| Massenstrom
41	energy \| Energie
42	Ratio \| Verhältnis
43	volume fraction \| Volumenanteil
44	weight per unit area \| Flächengewicht
45	Bytes / Bits
46	torque \| Drehmoment
47	resolution \| Auflösung
48	refractive power \| Brechkraft

Aufgeführte Werte gelten für das Feld: unit_id (Längen)

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: unit_id (Gewicht)

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	Onlineshops
1500	Shopgate	Onlineshops
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.

Änderungsübersicht

Version	Änderungsbeschreibung
3.5.37	Einführung des Calls.
3.6.3	Hinzufügen der neuen unit_type_id und der neuen unit_ids.
4.8.2	Wertetabelle für Subchannels eingefügt.
4.8.20	Best-Practice für Attribute ergänzt.

updateAttributes

updateAttributes