Spezifische Artikeldaten für Magento

Navigation:  WebService Calls > Options for Growth > updateItems > Plattformspezifische Daten >

Spezifische Artikeldaten für Magento

 Previous pageReturn to chapter overviewNext page

Texte ein-/ausblenden

Beschreibung

Die XML-Struktur welche die spezifischen Artikeldaten für die Verkaufsplattform Magento enthält muss als Kindelement in das Element specific_item_data in den Request-Daten von updateItems eingebettet sein.

Beispiel Request

Code

<magento_commerce_item_data>

   <account_specific_data>

      <account_specific>

         <account_id>1874697</account_id>

         <mandator_id>1</mandator_id>

         <!--<account_identifier>Magento Account 1</account_identifier> --><!--Alternative 2 -->

         <inactive>true</inactive>

         <magento_commerce_set delete_set_mapping="false">

            <magento_commerce_set_id>3290363</magento_commerce_set_id>

            <attribute_mappings>

               <attribute_mapping>

                  <variant_attribute_id>3290358</variant_attribute_id>

                  <variant_attribute_value_id>3290359</variant_attribute_value_id><!--Alternative 1 -->

               </attribute_mapping>

               <attribute_mapping>

                  <variant_attribute_id>3290357</variant_attribute_id>

                  <manual_values><!--Alternative 2 -->

                     <manual_value>

                        <language_code_iso>de</language_code_iso>

                        <translation>blue</translation>

                     </manual_value>

                     <manual_value>

                        <language_code_iso>en</language_code_iso>

                        <translation>X en</translation>

                     </manual_value>

                  </manual_values>

               </attribute_mapping>

            </attribute_mappings>

         </magento_commerce_set>

         <meta_title_text_module_type_id>1680273</meta_title_text_module_type_id>

         <meta_description_text_module_type_id>1680274</meta_description_text_module_type_id>

         <meta_keywords_text_module_type_id>1680275</meta_keywords_text_module_type_id>

         <price>5.00</price>

         <use_special_price>true</use_special_price>

         <special_price>4.50</special_price>

         <special_price_valid_from>2012-10-01T15:05:10.857+02:00</special_price_valid_from>

         <special_price_valid_to>2012-10-01T15:05:10.857+02:00</special_price_valid_to>

         <clear_groups_tierprices>false</clear_groups_tierprices>

         <multilingual_data>

            <translation>

               <language_code_iso>de</language_code_iso>

               <item_name>Magento Commerce Testartikel</item_name>

               <short_template_id>1563859</short_template_id>

               <long_template_id>1563861</long_template_id>

            </translation>

         </multilingual_data>

         <tier_prices>

            <tier_price>

               <customer_group_id>0</customer_group_id>

               <tier_price_mappings>

                  <tier_price_mapping>

                     <amount>1</amount>

                     <identifier>not logged in 20,00</identifier>

                     <price>20.00</price>

                  </tier_price_mapping>

               </tier_price_mappings>

            </tier_price>

         </tier_prices>

         <variant_prices>

            <variant_price>

               <attribute_value_id>3290359</attribute_value_id>

               <price_type>1</price_type>

               <price>8.00</price>

            </variant_price>

         </variant_prices>

         <listing_settings>

            <primary>1</primary>

            <placing_count>10</placing_count>

            <refill_count>5</refill_count>

            <transfer_to_offer>false</transfer_to_offer>

         </listing_settings>

         <magento_commerce_categories>

            <magento_commerce_category_id>10389593</magento_commerce_category_id>

         </magento_commerce_categories>

         <website_specific_data>

            <website_specific>

               <website_id>2</website_id>

               <website_identifier>Magento_Website</website_identifier>

               <inactive>false</inactive>

               <price>10.50</price>

               <use_special_price>true</use_special_price>

               <special_price>9.50</special_price>

               <special_price_valid_from>2020-06-01T09:30:47Z</special_price_valid_from>

               <special_price_valid_to>2020-09-01T20:30:47Z</special_price_valid_to>

               <tier_prices>

                  <tier_price>

                     <customer_group_id>1</customer_group_id>

                     <customer_group_identifier>Mitarbeiter</customer_group_identifier>

                     <tier_price_mappings>

                        <tier_price_mapping>

                           <amount>5</amount>

                           <price>9.10</price>

                        </tier_price_mapping>

                     </tier_price_mappings>

                  </tier_price>

               </tier_prices>

            </website_specific>

         </website_specific_data>

      </account_specific>

   </account_specific_data>

</magento_commerce_item_data>

Feldliste Request

Name

Beschreibung

Anz.

Typ

sonstiges

magento_commerce_item_data

Wrapper-Element, das die Spezifischen Artikeldaten für die Verkaufsplattform Magento enthält.

0..N

Element

account_specific_data

Wrapper-Element, das die accountspezifischen Artikeldaten zusammenfasst.

1

Element

account_specific

Wrapper-Element, das die Accountdaten zusammenfasst

1

Element

mandator_id

ID des Mandanten

1

integer

account_id

ID des Accounts

1

integer

account_identifier

Bezeichnung des Accounts

1

string

inactive

Gibt an, ob der Artikel aktiv geschaltet ist.

0..1

boolean

magento_commerce_set

Wrapper-Element, das die Attribut-Set-Daten zusammenfasst

0..1

Element

delete_set_mapping

Gibt an, ob die Attributdaten gelöscht werden sollen oder nicht. Wird diese Option gesetzt, werden alle Daten gelöscht.

0..1

boolean

Standard: false

magento_commerce_set_id

ID des Attribut-Sets.

1

integer

attribute_mappings

Wrapper-Element, das die Attributzuweisungen beinhaltet.

1

Element

attribute_mapping

Wrapper-Element, das die Attributzuweisung beinhaltet.

1..N

Element

variant_attribute_id

Varianten-Attribut-ID, die dem Attribut-Set zugewiesen ist.

1

integer

variant_attribute_value_id

Varianten-Attributswert-ID, die dem Varianten-Attribut zugewiesen ist.

1

integer

Alternative 1

manual_values

Wrapper-Element, das die Varianten-Attributswert-ID ersetzt.

Element

Alternative 2

manual_value

Wrapper-Element, das den manuellen Wert des Attributs zusammenfasst.

1

Element

language_code_iso

Gibt die Sprache der Daten in diesem translation-Element an.

string

Sprachcode ISO 639-1 ALPHA-2 (z.B. „de“)

translation

Übersetzung des Attributwerts.

1

string

meta_title_text_module_type_id

Legt den Textbausteintyp fest der den Metatitel enthält

0..1

integer

meta_description_text_module_type_id

Legt den Textbausteintyp fest, der die Metabeschreibung des Artikels enthält.

0..1

integer

meta_keywords_text_module_type_id

Legt die Meta-Schlüsselwörter für den Artikel fest.

0..1

integer

price

Preis

0..1

decimal

use_special_price

Flag das festlegt ob der Sonderpreis aktiv geschalten werden soll.

0..1

boolean

special_price

Sonderpreis

0..1

decimal

special_price_valid_from

Legt fest, ab wann der Sonderpreis gültig ist.

0..1

dateTime

special_price_valid_to

Legt fest, bis wann der Sonderpreis gültig ist.

1

dateTime

clear_groups_tierprices

Ermöglicht das Löschen von hinterlegten Staffelpreisen. Wird das Feld mit True übergeben und es sind zusätzlich Staffelpreise im Aufruf enthalten, dann sind im Artikel nur noch die Staffelpreise enthalten die in diesem Aufruf mitgegeben worden sind. Alle vorher gesetzten Staffelpreise werden gelöscht.

0..1

boolean

base_price

Legt fest, ob der Grundpreis angezeigt wird.

0..1

boolean

multilingual_data

Wrapper-Element, das mehrsprachig vorhandene Artikel-Daten für die Verkaufsplattform Magento zusammenfasst.

0..1

Element

translation

Wrapper-Element, das die Informationen einer Sprache zusammenfasst.

0..N

Element

language_code_iso

Gibt die Sprache der Daten in diesem translation-Element an.

1

string

Sprachcode ISO 639-1 ALPHA-2 (z.B. „de“)

item_name

Verkaufskanalspezifische Artikelbezeichnung

0..1

string

short_template_id

ID des Templates für die Kurzbeschreibung des Artikels.

0..1

integer

long_template_id

ID des Templates für die Detailbeschreibung des Artikels.

0..1

integer

tier_prices

Wrapper-Element, das die Staffelpreise zusammenfasst.

0..1

Element

tier_price

Wrapper-Element, das einen Staffelpreis zusammenfasst.

0..N

Element

customer_group_id

ID der Kundengruppe

1

integer

tier_price_mappings

Wrapper-Element, das die Staffelpreis-Mappings zusammenfasst.

0..1

Element

tier_price_mapping

Wrapper-Element, das das Staffelpreis-Mapping zusammenfasst.

0..N

Element

amount

Betrag

1

decimal

identifier

Bezeichnung

1

string

price

Preis

1

decimal

variant_prices

Wrapper-Element, das die Variantenpreise zusammenfasst.

0..1

Element

variant_price

Wrapper-Element, das den Variantenpreis zusammenfasst.

1..N

Element

attribute_value_id

Variantenattribut-ID, für die der Preiszuschlag/Preisabschlag gelten soll.

1

integer

price_type

Gibt den Typ des Variantenpreises an.

1

integer

Feste Werte:

0 = absolut

1 = prozentual

price

Preiszuschlag/Preisabschlag

1

decimal

listing_settings

Wrapper-Element welches die Einstellmengen für diesen Artikel, die Plattform und den Account festlegt.

0..1

Element

primary

Legt den primären Verkaufskanal fest

1

integer

Feste Werte:

1 = primär. |

0 = nicht primär

placing_count

Legt die initiale Einstellmenge für den Artikel fest

1

integer

Hinweise

refill_count

Legt die Menge fest, ab der wieder aufgefüllt wird.

1

integer

transfer_to_offer

Ist die Option aktiv, so wird die angegebene Einstellmenge an laufende Angebote übertragen.

0..1

boolean

magento_commerce_categories

Wrapper-Element, das die Magento-Kategorien zusammenfasst.

0..1

Element

magento_commerce_category_id

ID der Magento-Kategorie

0..1

integer

website_specific_data

Wrapper-Element, das die Website-spezifischen Daten des Magento-Artikels zusammenfasst.

0..1

Element

website_specific

Wrapper-Element, das die Website-spezifischen Daten einer Website zusammenfasst.

0..N

Element

website_id

ID der Magento-Shopwebsite.

1

integer

Hinweis

website_identifier

Bezeichnung der Magento-Shopwebsite.

1

string

Hinweis

inactive

Definiert ob das Angebot im Shop für diese Website aktiv ist.

0..1

boolean

price

Artikelpreis

0..1

decimal

use_special_price

Aktiviert den Sonderpreis.

0..1

boolean

special_price

Sonderpreis.

0..1

decimal

special_price_valid_from

Sonderpreis gültig ab Datum.

0..1

datetime

special_price_valid_to

Sonderpreis gültig bis Datum.

0..1

datetime

tier_prices

Wrapper-Element, das die website-spezifischen Preisstaffelungen des Magento-Artikels zusammenfasst.

0..1

Element

tier_price

Wrapper-Element, das die website-spezifischen Preisstaffelungen des Magento-Artikels für eine Kundengruppe zusammenfasst.

0..N

Element

customer_group_id

ID der Kundengruppe.

1

integer

Hinweis

customer_group_identifier

Bezeichnung der Kundengruppe.

1

string

Hinweis

tier_price_mappings

Wrapper-Element, das die Preisstaffelungen zusammenfasst.

0..1

Element

tier_price_mapping

Wrapper-Element, das eine Preisstaffel enthält.

0..N

Element

amount

Menge

1

integer

price

Preis

1

decimal

Hinweise

•Die Elemente account_id und account_identifier dürfen nicht gemeinsam genutzt werden.

•Eine Einstellmenge (placing_count) von -1 deaktiviert den interaktiven Angebotsbestandsabgleich für diesen Artikel und die daraus resultierenden Angebote.

•Die Felder website_id und website_identifier dürfen nicht gleichzeitig genutzt werden.

•Die Felder customer_group_id und customer_group_identifier dürfen nicht gleichzeitig genutzt werden.

Änderungsübersicht

Version

Änderungsbeschreibung

3.2.9.100

Erweiterung des Calls updateItems um Magento.

3.3.2.181

Erweiterung des Calls updateItems um Magento-Attribut-Sets.

3.3.6.64

Erweiterung des Calls updateItems um Magento-Variantenpreise.

3.4.35.1

Erweiterung der Magento spezifischen Daten des Calls updateItems um die Anzeige des Grundpreises und um die Zuordnung der Magento-Kategorien.

4.10.26

Erweiterung um webseitenspezifische Preisangaben.

4.12.4

Erweiterung um clear_groups_tierprices.