Diese Dokumentation beschreibt den Aufbau der XML-Struktur für den Import von Artikeln von Ihrem Shop- oder PIM-System zu pixi.

Inhaltsstruktur der XML Datei

Jedes gültige Katalogdokument im BMEcat-Format wird mit dem Root-Element BMECAT eingeleitet und besteht aus einem Kopfteil (HEADER) und einem Transaktionsteil (pixi unterstützt nur T_NEW_CATALOG). Die BMEcat Version sowie Informationen zur XML version sind optional (nicht jedoch der umschließende Tag <BMECAT>…</BMECAT>).

<?xml version="1.0" encoding="UTF-8"?>
<BMECAT version="1.0">
   <HEADER>
      ...
   </HEADER>
   <T_NEW_CATALOG>
      ...
   </T_NEW_CATALOG>
</BMECAT>

Sollen komplexe Textblöcke mit Sonderzeichen wie &'<"®™>¿ importiert werden, empfehlen wir die Verwendung von CDATA-Abschnitten, nicht das Enkodieren über XML/HTML Entities.

Kopfbereich: HEADER

Der Kopfteil enthält grundlegende Informationen zum Absender (Autor) und Empfänger der XML-Datei, Katalog-Version und ID.

Achtung: pixi akzeptiert die XML-Datei auch bei fehlendem Header-Abschnitt, nur die Artikelinformationen im Transaktionsteil sind von Bedeutung.

<HEADER>
   <GENERATOR_INFO>Name Ihres Shop-Systems - BMEcat Export</GENERATOR_INFO>
   <CATALOG>
      <LANGUAGE>deu</LANGUAGE>
      <CATALOG_ID>catalog1</CATALOG_ID>
      <CATALOG_VERSION>1.0</CATALOG_VERSION>
      <CATALOG_NAME> 13.10.2011 BMECat Export</CATALOG_NAME>
      <CURRENCY>EUR</CURRENCY>
      <DATABASE>Name der pixi Datenbank</DATABASE>
      <SHOPID>Mandanten ID</SHOPID>
      <DATEEXPORT>UNIX-Zeitstempel</DATEEXPORT>
      <EXPORT_DATE>Datums-Zeitstempel</EXPORT_DATE>
   </CATALOG>
   <BUYER>
      ...
   </BUYER>
   <SUPPLIER>
      ...
   </SUPPLIER>
</HEADER>

<BUYER>
   <BUYER_ID>1234</BUYER_ID>
   <BUYER_NAME>Fraunhofer IAO</BUYER_NAME>
   <ADDRESS type="buyer">
      <NAME>Fraunhofer IAO</NAME>
      <NAME2>Marktstrategieteam Electronic Business Systems</NAME2>
      <STREET>Holzgartenstrasse 17</STREET>
      <ZIP>70174</ZIP>
      <CITY>Stuttgart</CITY>
      <COUNTRY>Germany</COUNTRY>
   </ADDRESS>
</BUYER> 

<SUPPLIER>
   <SUPPLIER_ID type="supplier_specific">DEM</SUPPLIER_ID>
   <SUPPLIER_NAME>DEMO-Shop</SUPPLIER_NAME>
   <ADDRESS type="supplier">
      <NAME>ShopBetreiber</NAME>
      <CONTACT>Max Mustermann</CONTACT>
      <STREET>Universitaetsstr. 9</STREET>
      <ZIP>45117</ZIP>
      <CITY>Essen</CITY>
      <COUNTRY>Germany</COUNTRY>
   </ADDRESS>
</SUPPLIER>

Zum Seitenanfang

Transaktionsteil: T_NEW_CATALOG

Der Transaktionsteil stellt nun die Artikel-Daten in sich wiederholenden ARTICLE-Elementen bereit. Das Element ARTICLE enthält die eindeutige Artikelnummer des Shops (SUPPLIER_AID), sowie weitere Unterelemente, die Angaben zu Beschreibung, Preis, Verpackung und multimedialen Zusatzinformationen des Artikels enthalten. Die Transaktion T_NEW_CATALOG kann beliebig viele Artikel enthalten.

Hinweis: Bitte beachten Sie, dass pixi hier der BMEcat Originalspezifikation nicht ganz folgt. Es werden nur Inhalte der ARTICLE Elemente importiert, alle anderen möglichen Elemente werden nicht verarbeitet.

<T_NEW_CATALOG> 
   <ARTICLE>
      …
   </ARTICLE>
   <ARTICLE>
      …
   </ARTICLE>
   …
</T_NEW_CATALOG>

ARTICLE

Jede ARTICLE Ebene beinhaltet jeweils einen Artikel bzw. Varianten-Artikel mit dem Primärschlüssel und den jeweiligen Artikeldetails wie Verkaufs- und Einkaufspreis, Lieferant, Artikelname usw., wobei auch mehr als nur ein Lieferant hinterlegt werden kann. Außerdem können auch die Bilder zu den jeweiligen Artikeln übermittelt werden.

<ARTICLE>
   <SUPPLIER_AID>Primärschlüssel des Artikels, Shop-Artikelnummer</SUPPLIER_AID>
   <ARTICLE_DETAILS>...</ARTICLE_DETAILS>
   <ARTICLE_FEATURES>...</ARTICLE_FEATURES>
   <ARTICLE_ORDER_DETAILS>...</ARTICLE_ORDER_DETAILS>
   <ARTICLE_PRICE_DETAILS>...</ARTICLE_PRICE_DETAILS>
   <MIME_INFO>...</MIME_INFO>
   <ITEMTAGS>...</ITEMTAGS>
   <ITEM_BUNDLE>...</ITEM_BUNDLE>
</ARTICLE> 

Zum Seitenanfang

ARTICLE_DETAILS

Das Element ARTICLE_DETAILS beinhaltet Datenfelder, die einen Artikel identifizieren und verbal beschreiben.

<ARTICLE_DETAILS>
   <DESCRIPTION_SHORT>Artikelname (inkl. Variante)</DESCRIPTION_SHORT>
   <DESCRIPTION_LONG>Artikelbeschreibung</DESCRIPTION_LONG>
   <EAN>EAN/Barcode des Artikels</EAN>
   <MANUFACTURER_NAME>Herstellername</MANUFACTURER_NAME>
   <MANUFACTURER_TYPE_DESCR>Alternative für den Artikelnamen</MANUFACTURER_TYPE_DESCR>
   <SEGMENT>Kategorie im Shop</SEGMENT>
   <WEIGHT>Gewicht in kg</WEIGHT>
   <INTERNAL_ITEM_NUMBER>interne Artikelnummer</INTERNAL_ITEM_NUMBER>
</ARTICLE_DETAILS>
 

Zum Seitenanfang

ARTICLE_FEATURES

Mit Hilfe der FEATURE Elemente in ARTICLE_FEATURES kann ein Artikel klassifiziert werden. Die Merkmale müssen eindeutig benannt werden, d.h. der Merkmalsname FNAME muss bei allen Elementen innerhalb des selben Elements ARTICLE_FEATURES verschieden sein. Ein Element FEATURE beschreibt ein messbares Merkmal eines Artikels, d.h. den Merkmalsnamen und die Merkmalsausprägung (den Merkmalswert).

<ARTICLE_FEATURES>
   <FEATURE>
      <FNAME>Europe1PriceFactory.PTG</FNAME>
      <FVALUE>Mehrwertsteuer-Satz</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>WEIGHT</FNAME>
      <FVALUE>Gewicht des Artikels</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>ID OXID</FNAME>
      <FVALUE>interne (eigene) Artikelnummer</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>ID Lieferanten-ID</FNAME>
      <FVALUE>Artikelnummer des Lieferanten</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>EK LieferantenID</FNAME>
      <FVALUE>3.55</FVALUE>
   </FEATURE>
   <FEATURE> 
      <FNAME>MIN_STOCK_QTY</FNAME> 
      <FVALUE>Mindestlagermenge</FVALUE> 
   </FEATURE> 
   <FEATURE>
      <FNAME>Anzeigetitel</FNAME>
      <FVALUE>Name des Artikels</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>WIDTH</FNAME>
      <FVALUE>12</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>HEIGHT</FNAME>
      <FVALUE>2</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>LENGTH</FNAME>
      <FVALUE>3</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>TARGET_STOCK</FNAME>
      <FVALUE>6</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>STATUS</FNAME>
      <FVALUE>ACTIVE</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>BookAccountEu</FNAME>
      <FVALUE>XXX</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>BookAccountNonEu</FNAME>
      <FVALUE>XXX</FVALUE>
   </FEATURE>
   <FEATURE>
      <FNAME>BookAccountEuCompanies</FNAME>
      <FVALUE>XXX</FVALUE>
   </FEATURE>
 
   <SerialNumberRequired>0</SerialNumberRequired> 
   <CustomsTariffNumber>12456</CustomsTariffNumber>
   <CustomsCountryOfOrigin>DE</CustomsCountryOfOrigin>
   <CustomsTariffText>Plastics</CustomsTariffText>
 
</ARTICLE_FEATURES>

Einige Informationen können im Bereich ARTICLE_FEATURES ohne die Struktur FNAME und FVALUE dargestellt werden:

Zum Seitenanfang

ARTICLE_ORDER_DETAILS

Das Element ARTICLE_ORDER_DETAILS enthält Elemente, die Angaben zu Bestellkonditionen und Verpackungsmodalitäten des Artikels machen. pixi verwendet hier nur das Element ORDER_UNIT zum Import der Verpackungseinheit des Artikels:

<ARTICLE_ORDER_DETAILS>
   <ORDER_UNIT>Verpackungseinheit</ORDER_UNIT>
</ARTICLE_ORDER_DETAILS>

Hinweise:
- Fehlt der Tag in der Import-XML oder enthält keinen Wert oder "0", so wird die Verpackungseinheit des Artikels auf 1 gesetzt.
- Eine Systembedingung verhindert den Import einer Verpackungseinheit als Dezimalzahl mit Punkt als Trennzeichen, z.B. "2.3", oder falls der Wert nicht numerisch oder negativ ist.
- Wird eine Dezimalzahl mit Komma als Trennzeichen übergeben, z.B. "2,3", so werden die Nachkommastellen abgeschnitten und nur der Wert vor dem Komma importiert, im Beispiel also "2".

ARTICLE_PRICE_DETAILS

Mit dem Element ARTICLE_PRICE_DETAILS werden die Preisdaten eines Artikels spezifiziert. Es ist möglich, verschiedene Preise für einen Artikel anzugeben. So können zum Beispiel Netto- und Bruttopreise eines Artikels angegeben werden (mit Hilfe des Attributs "price_type" des Elements ARTICLE_PRICE).

<ARTICLE_PRICE_DETAILS>
   <ARTICLE_PRICE price_type="gros_list">
      <PRICE_AMOUNT>BRUTTO-Verkaufspreis</PRICE_AMOUNT>
      <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
      <SUPPLPRICE_AMOUNT>NETTO-Einkaufspreis</SUPPLPRICE_AMOUNT>
   </ARTICLE_PRICE>
</ARTICLE_PRICE_DETAILS>
 
<ARTICLE_PRICE_DETAILS>
   <ARTICLE_PRICE price_type="net_list">
      <PRICE_AMOUNT>NETTO-Verkaufspreis</PRICE_AMOUNT>
      <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
      <SUPPLPRICE_AMOUNT>NETTO-Einkaufspreis</SUPPLPRICE_AMOUNT>
   </ARTICLE_PRICE>
</ARTICLE_PRICE_DETAILS>

Hinweis: Es werden Artikelpreis-Beträge bis zu 999.999,99 unterstützt. Werden Preise importiert, die größer sind, wird der Preis automatisch auf 999.999,00 gesetzt und der Artikel wird nicht importiert, wenn die Bedingung "Differenz zwischen Netto- und Bruttopreis muss dem MwSt.-Satz entsprechen" aktiviert ist.

Zum Seitenanfang

MIME_INFO

Mit dem Element MIME_INFO können Referenzen auf multimediale Zusatzdokumente eines Artikels spezifiziert werden. Hierdurch ist es zum Beispiel möglich, Abbildungen und Produktdatenblätter eines Artikels bei einem Katalogdatenaustausch mit zu referenzieren. Das Element MIME_INFO kann zwei Elemente MIME beinhalten. Jedes dieser Elemente repräsentiert genau eine Referenz auf ein Zusatzdokument. Die Definition des Elements MIME ist an das MIME-Format (Multipurpose Internet Mail Extensions) angelehnt. Das MIME-Format dient zur standardisierten Übertragung von Daten im Internet.

Tipp: Wenn die Berechtigung “Artikelbild anzeigen” für den aktuell angemeldeten Benutzer aktiviert ist, dann wird das Artikelbild von der importierten URL beim Erstellen von Umtäuschen oder Retouren im pixi Kundenservice angezeigt (verfügbar ab pixi LOU Update 7).

<MIME_INFO>
   <MIME>
      <MIME_TYPE>image/jpeg</MIME_TYPE>
      <MIME_SOURCE>Url zur Grafik</MIME_SOURCE>
      <MIME_PURPOSE>normal</MIME_PURPOSE>
   </MIME>
</MIME_INFO>

ITEMTAGS

Mit dem ITEMTAGS Element können für einen Artikel neue Tags in pixi gesetzt werden. Es ist nicht möglich, bestehende Tags zu entfernen.

<ITEMTAGS>
   <ITEMTAG>Geschenke</ITEMTAG>
   <ITEMTAG>Wohnen</ITEMTAG>
   <ITEMTAG>Bar-Equippment</ITEMTAG>
   <ITEMTAG>Fantasy</ITEMTAG>
   <ITEMTAG>Uhren</ITEMTAG>
</ITEMTAGS>

Die Datenbankeinstellung Allgemein – Überschreiben der System-TAGs im pixi Control Center > Reiter Datenbank-Einstellungen > Imports 2.0 ist wesentlich für die Tagverwaltung.

Wenn aktiviert, werden sämtliche System-Tags zur A/B/C Klassifizierung, Personalisierung, Chargennummer, MHD oder Atlas beim erneuten Import des Artikels entfernt, und allein die mit dem Artikel-XML übergeben Tags gesetzt.

Wenn deaktiviert, werden Tags über den Artikel-Import nicht mehr entfernt und müssen vielmehr manuell oder mit Hilfe der SOAP API von Artikeln entfernt werden.

Zum Seitenanfang

Übergabe von Set-Artikeln (Bundles) per BMECAT

Definition eines Bundles

Sie können bei der Übergabe eines Artikels per BMEcat diesen Artikel als Bundle in pixi definieren. D.h. für den Artikel, in dem dieser Tag erscheint, werden die aufgelisteten Artikel in pixi als Einzelartikel definiert.

<ARTICLE>
...
<ITEM_BUNDLE>
   <BUNDLE_ITEM>
      <BUNDLE_ITEMNRINT>SUPPLIER_AID</BUNDLE_ITEMNRINT>
      <BUNDLE_ITEMQTY>Anzahl</BUNDLE_ITEMQTY>
   </BUNDLE_ITEM>
   <BUNDLE_ITEM>
      <BUNDLE_ITEMNRINT>SUPPLIER_AID</BUNDLE_ITEMNRINT>
      <BUNDLE_ITEMQTY>Anzahl</BUNDLE_ITEMQTY>
   </BUNDLE_ITEM>
</ITEM_BUNDLE>
...
</ARTICLE>

Hinweise:
Das Element ITEM_BUNDLE kann innerhalb von ARTICLE wiederholt werden. Alle Artikel innerhalb der Tags BUNDLE_ITEM werden dem Bundle als Artikel hinzugefügt.
Ab pixi LOU Update 10: Beim Artikel-Import können Bundles auch importiert werden, wenn die Einzelartikel des Bundles in der gleichen XML-Datei sind wie der zu erstellende Bundle-Artikel. Falls eine XML-Datei beim Artikel-Import einen Artikel enthält, der als Einzelartikel importiert werden soll, in pixi aber als Bundle angelegt ist, dann erfolgt eine automatische Konvertierung des Artikels in einen Einzelartikel sofern keine Bestellungen für diesen Artikel vorliegen und umgekehrt.

Löschen eines Bundles

Ein Artikel, der bereits als Bundle definiert wurde, kann mit folgendem XML das Bundle in pixi wieder gelöscht werden:

<ITEM_BUNDLE> 
   <BUNDLE_ITEM>
      <BUNDLE_ITEMNRINT>NO_BUNDLE</BUNDLE_ITEMNRINT>
      <BUNDLE_ITEMQTY>1</BUNDLE_ITEMQTY>
   </BUNDLE_ITEM>         
</ITEM_BUNDLE>

Zum Seitenanfang

Import von Zolltarif und Warenherkunftsland

Werden für Sendungen in das Ausland für die Ausfuhranmeldung spezifische Parameter wie die Zolltarifnummer und das Herkunftsland eines Artikels benötigt, so können folgende 3 Parameter mit dem Import von Artikeldaten (BMECat) an pixi übergeben werden. Diese 3 Parameter können dann auf der Rechnung mit ausgewiesen werden. Eine Übergabe der Daten an den Versand-Dienstleister (DHL, GLS, DPD, UPS o.a.) ist nicht vorgesehen. Für den Ausweis der Parameter muss u.U. das sog. "Rechnungs-Template" angepasst werden, hier wenden Sie sich bei Bedarf an den pixi Support.

Berücksichtigen Sie bitte auch, dass u.U. die Shop-Schnittstelle ebenfalls angepasst werden muss, um die drei erforderlichen Parameter aus der Shop-Datenbank zu beziehen, auch hier hilft Ihnen der pixi Support gerne weiter.

Verfügbare Parameter

Folgende Parameter können per BMECat-Verfahren an pixi übergeben werden:

 <CustomsTariffNumber>123456</CustomsTariffNumber>
 <CustomsCountryOfOrigin>DE</CustomsCountryOfOrigin>
 <CustomsTariffText>Plastics</CustomsTariffText>

Der Parameter <CustomsTariffNumber> beschreibt die Zolltarifnummer, der Parameter <CustomsCountryOfOrigin> das Ursprungsland des Artikels und <CustomsTariffText> beschreibt die Warengruppe.

Beispiel

Beispiel für die korrekte Syntax und Positionierung dieser XML-Inhalte innerhalb der BMECat-Struktur:

 (...)
<FEATURE>
   <FNAME>Europe1PriceFactory.PTG</FNAME>
   <FVALUE>MwSt_High</FVALUE>
</FEATURE>
<FEATURE>
   <FNAME>ID MGS</FNAME>
   <FVALUE>123456</FVALUE>
</FEATURE>
<CustomsTariffNumber>123456</CustomsTariffNumber>
<CustomsCountryOfOrigin>DEU</CustomsCountryOfOrigin>
<CustomsTariffText>Plastics</CustomsTariffText>
</ARTICLE_FEATURES>
<ARTICLE_PRICE_DETAILS>
   <ARTICLE_PRICE price_type="gros_list">
   <PRICE_AMOUNT>9.99</PRICE_AMOUNT>
   <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
 (...)

Beispiele für Zolltarifnummern und aktuelle Informationen zu Ausfuhrbestimmungen erhalten Sie u.a. auf dieser externen Webseite: www.zolltarifnummern.de

Weitere, allgemeine Informationen zur Zolltarifnummer finden Sie unter: Zolltarifnummer

Zum Seitenanfang

Verwendung der Mehrwährungsfunktionalität

Wenn die Mehrwährungsfähigkeit in pixi aktiviert ist, müssen einige Besonderheiten beim Import von Artikeln beachtet werden. Der wesentliche Vorteil ist die Möglichkeit zum Import von Verkaufspreisen in verschiedenen Währungen für einen einzigen Artikel - damit ist es möglich, manuelle Bestellungen im pixi Kundenservice mit spezifischen Preisen in der Landeswährung des Kunden zu erstellen.

Ein XML-Beispiel zur Verdeutlichung der erforderlichen Struktur finden Sie weiter unten unter: Verwendung der Mehrwaehrungsfaehigkeit.

Pflichtelemente

Ist die Mehrwährungsfähigkeit in pixi aktiviert, so müssen folgende Tags zwingend beim Artikelimport übergeben werden:

• SHOPID: Basierend auf dem übergebenen Shop sowie der gesetzten Shopwährung validiert pixi, ob die Preise mindestens in der erforderlichen Währung übergeben wurden. Siehe KOPFBEREICH

• PRICE_CURRENCY: Da das Element ARTICLE_PRICE mehr als einmal pro Artikel auftreten kann, muss jeweils zwingend die Währung angegeben werden, in welcher die Preise des Elements zu pixi importiert werden sollen. Siehe auch unter: ARTICLE_PRICE_DETAILS

Import des Artikelpreises in verschiedenen Währungen

Der Verkaufspreis eines Artikels muss zwingend entweder in der Shop- oder der Heimatwährung importiert werden. Wird der Preis eines neuen Artikels nicht in der Heimatwährung bereitgestellt, so wird dieser basierend auf dem Preis in Shopwährung sowie dem Wechselkurs der EZB zum Zeitpunkt des Imports berechnet. Wird der Preis eines neuen Artikels weder in Heimat- noch in Shopwährung bereitgestellt, wird der Artikel nicht importiert.

Hinweis: Wird ein Artikel erneut importiert, so wird der Preis in Heimatwährung nur aktualisiert, wenn dieser auch explizit übermittelt wurde, d. h. dieser wird nicht bei jedem Import basierend auf dem Preis in Shopwährung erneut berechnet.

Import von Einkaufspreisen

Der Einkauf in pixi unterstützt derzeit keine Mehrwährungsfunktionalität, daher können Einkaufspreise nur in der Heimatwährung importiert werden.

Import des Einkaufspreises pro Lieferant

Wird der Einkaufspreis pro Lieferant mit Hilfe der FEATURE Elemente zu pixi importiert, so wird dieser als Preis in Heimatwährung interpretiert (da es mit der aktuellen XML-Struktur nicht möglich ist, die Währung zusätzlich anzugeben).

Beispiel:

<FEATURE>
  <FNAME>EK XYZ</FNAME>
  <FVALUE>6.35</FVALUE>
</FEATURE>

Der Einkaufspreis des Lieferanten mit der ID "XYZ" ist 6,35 - die Währung entspricht der gesetzten Heimatwährung.

Import des Einkaufspreises pro Artikel (für alle Lieferanten gleich)

Soll für alle Lieferanten eines Artikels der gleiche Einkaufspreis verwendet werden (oder ist dem Artikel nur ein Lieferant zugewiesen), so kann der Einkaufspreis im Element ARTICLE_PRICE übergeben werden. Es wird nur der Einkaufspreis berücksichtigt, welcher sich im ARTICLE_PRICE Block befindet, der als PRICE_CURRENCY die Heimatwährung gesetzt hat.

Beispiel - die Heimatwährung ist auf EUR gesetzt:

<ARTICLE_PRICE_DETAILS>
<ARTICLE_PRICE price_type="gros_list">
     <PRICE_AMOUNT>11.00</PRICE_AMOUNT>
     <SUPPLPRICE_AMOUNT>6.19</SUPPLPRICE_AMOUNT>
     <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
</ARTICLE_PRICE>
<ARTICLE_PRICE price_type="gros_list">
     <PRICE_AMOUNT>13.00</PRICE_AMOUNT>
     <SUPPLPRICE_AMOUNT>7.33</SUPPLPRICE_AMOUNT>
     <PRICE_CURRENCY>USD</PRICE_CURRENCY>
</ARTICLE_PRICE>

Der Einkaufspreis von 6,19 EUR aus dem Tag <SUPPLPRICE_AMOUNT> wird für alle Lieferanten hinterlegt, welche nicht in den FEATURE-Elementen aufgeführt wurden. Der in weiteren ARTICLE_PRICE Elementen angegebene Einkaufspreis, bei welchen die PRICE_CURRENCY nicht der Heimatwährung entspricht, wird ignoriert.

Wird der Einkaufspreis gar nicht oder nicht in Heimatwährung angegeben, so wird dieser für neue Artikel auf 0 gesetzt. Wurde bereits ein Einkaufspreis importiert, so wird er in diesem Fall nicht aktualisiert.

Siehe auch: Mehrwährung in pixi

Zum Seitenanfang

Vollständiges BMEcat XML Beispiel

<?xml version="1.0" encoding="UTF-8"?>
<BMECAT version="1.2">
 
<HEADER>
 
   <GENERATOR_INFO>Name Ihres Shop-Systems - BMEcat Export</GENERATOR_INFO>
 
   <CATALOG>
      <LANGUAGE>deu</LANGUAGE>
      <CATALOG_ID>catalog1</CATALOG_ID>
      <CATALOG_VERSION>1.0</CATALOG_VERSION>
      <CATALOG_NAME> 13.10.2011 BMECat Export</CATALOG_NAME>
      <CURRENCY>EUR</CURRENCY>
      <DATABASE>Name der pixi Datenbank</DATABASE>
      <SHOPID>Mandanten ID</SHOPID>
      <DATEEXPORT>UNIX-Zeitstempel</DATEEXPORT>
      <EXPORT_DATE>Datums-Zeitstempel</EXPORT_DATE>
   </CATALOG>
 
   <BUYER>
      <BUYER_ID>1234</BUYER_ID>
      <BUYER_NAME>Fraunhofer IAO</BUYER_NAME>
      <ADDRESS type="buyer">
         <NAME>Fraunhofer IAO</NAME>
         <NAME2>Marktstrategieteam Electronic Business Systems</NAME2>
         <STREET>Holzgartenstrasse 17</STREET>
         <ZIP>70174</ZIP>
         <CITY>Stuttgart</CITY>
         <COUNTRY>Germany</COUNTRY>
      </ADDRESS>
   </BUYER>
 
   <SUPPLIER>
      <SUPPLIER_NAME/>
      <ADDRESS type="supplier">
         <NAME>OXID eShop 4</NAME>
         <STREET>Musterstr.10</STREET>
         <ZIP>79098</ZIP>
         <CITY>Musterstadt</CITY>
         <COUNTRY>Deutschland</COUNTRY>
      </ADDRESS>
   </SUPPLIER>
 
</HEADER>
 
<!--Transaction section - mandatory-->
<T_NEW_CATALOG>
 
   <ARTICLE>
 
      <SUPPLIER_AID>18201-180160-bl</SUPPLIER_AID>
 
      <ARTICLE_DETAILS>
           <DESCRIPTION_SHORT><![CDATA[Matratze Comfort Plus, Größe: 180 x 160 cm, Farbe: blau]]></DESCRIPTION_SHORT>
           <DESCRIPTION_LONG><![CDATA[7-Zonen Komfortschaummatratze für einen guten Schlaf, <br/> Komfort- und 
            Entlastungszone im Schulter-, Lenden- und Beckenbereich, <br/> Atmungsaktiver Doppeltuchbezug, <br/>
            Bezug geprüft nach Öko-Tex Standard 100, <br/> Für Allergiker geeignet]]></DESCRIPTION_LONG>                   
           <EAN>4000053269821</EAN>
           <MANUFACTURER_NAME>Comfort</MANUFACTURER_NAME>
           <SEGMENT>Matratzen</SEGMENT>
           <WEIGHT>10</WEIGHT>
	   <INTERNAL_ITEM_NUMBER>UnsereArtikelnummer</INTERNAL_ITEM_NUMBER>
      </ARTICLE_DETAILS>
 
      <ARTICLE_FEATURES>
         <FEATURE>
            <FNAME>ID Comfort</FNAME>
            <FVALUE>12345</FVALUE>
         </FEATURE>
	 <FEATURE>
            <FNAME>EK Comfort</FNAME>
            <FVALUE>99.00</FVALUE>
         </FEATURE>
	 <FEATURE>
            <FNAME>Europe1PriceFactory.PTG</FNAME>
            <FVALUE>MWST_HIGH</FVALUE>
         </FEATURE>
         <FEATURE>
            <FNAME>MIN_STOCK_QTY</FNAME>
            <FVALUE>5</FVALUE>
         </FEATURE>
         <FEATURE>
            <FNAME>TARGET_STOCK</FNAME>
            <FVALUE>6</FVALUE>
         </FEATURE>
         <FEATURE>
            <FNAME>STATUS</FNAME>
            <FVALUE>ACTIVE</FVALUE>
         </FEATURE>
 
	 <SerialNumberRequired>0</SerialNumberRequired> 
         <CustomsTariffNumber>12456</CustomsTariffNumber>
         <CustomsCountryOfOrigin>DE</CustomsCountryOfOrigin>
         <CustomsTariffText>Betten</CustomsTariffText>
 
      </ARTICLE_FEATURES>
 
      <ARTICLE_PRICE_DETAILS>
         <ARTICLE_PRICE price_type="gros_list">
            <PRICE_AMOUNT>119</PRICE_AMOUNT>
            <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
            <SUPPLPRICE_AMOUNT>95</SUPPLPRICE_AMOUNT>
         </ARTICLE_PRICE>
	 <ARTICLE_PRICE price_type="net_list">
            <PRICE_AMOUNT>100</PRICE_AMOUNT>
            <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
            <SUPPLPRICE_AMOUNT>95</SUPPLPRICE_AMOUNT>
         </ARTICLE_PRICE>
      </ARTICLE_PRICE_DETAILS>
 
      <!--optional-->
      <ITEMTAGS>
         <ITEMTAG>Wohnen</ITEMTAG>
         <ITEMTAG>Geschenke</ITEMTAG>
      </ITEMTAGS>
 
      <!--optional-->
      <MIME_INFO>
         <MIME>
            <MIME_TYPE>image/jpeg</MIME_TYPE>
            <MIME_SOURCE>http://www.madgeniuses.net/images/Bild.jpg</MIME_SOURCE>
            <MIME_PURPOSE>normal</MIME_PURPOSE>
         </MIME>
      </MIME_INFO>
 
      <!--optional-->
      <ARTICLE_ORDER_DETAILS>
         <ORDER_UNIT>10</ORDER_UNIT>
      </ARTICLE_ORDER_DETAILS>
 
   </ARTICLE>
</T_NEW_CATALOG>
</BMECAT>

Zum Seitenanfang

Beispiel bei Verwendung der Mehrwährungsfähigkeit

Im folgenden Beispiel finden Sie eine Artikelimport-XML für den Shop ABC, für welchen die Währung GBP als Shopwährung hinterlegt ist. Die Heimatwährung ist EUR.

<BMECAT version="1.2">
   <HEADER>
      <GENERATOR_INFO>OXID eShop Professional Edition BMECat Export</GENERATOR_INFO>
   <CATALOG>
      <LANGUAGE>1</LANGUAGE>
      <CATALOG_ID>4e96c808be6bf</CATALOG_ID>
      <CATALOG_VERSION/>
      <CATALOG_NAME> 13.05.2015 BMECat Export</CATALOG_NAME>
      <DATABASE>pixi_TEST</DATABASE>
      <SHOPID>ABC</SHOPID>
      <DATEEXPORT>2015-05-13 13:14:15</DATEEXPORT>
   </CATALOG>
    ...
   </HEADER>
   <T_NEW_CATALOG>
      <ARTICLE>
      ...  
         <ARTICLE_FEATURES>
            <FEATURE>
               <FNAME>ID XYZ</FNAME>
               <FVALUE>9842912363377</FVALUE>
            </FEATURE>
            <FEATURE>
               <FNAME>ID PIXI</FNAME>
               <FVALUE>9842912363377</FVALUE>
            </FEATURE>
            <FEATURE>
               <FNAME>EK XYZ</FNAME>
               <FVALUE>6.35</FVALUE> 
               <!-- Als Einkaufspreis für den Lieferanten XYZ wird 6,35 EUR importiert -->
            </FEATURE>
            …
         </ARTICLE_FEATURES>
         …
         <ARTICLE_PRICE_DETAILS>
            <ARTICLE_PRICE price_type="gros_list">
               <PRICE_AMOUNT>11.00</PRICE_AMOUNT>
               <SUPPLPRICE_AMOUNT>6.19</SUPPLPRICE_AMOUNT> 
               <!-- Als Einkaufspreis für den Lieferanten PIXI wird 6,19 EUR importiert -->
               <PRICE_CURRENCY>EUR</PRICE_CURRENCY>
            </ARTICLE_PRICE>
            <ARTICLE_PRICE price_type="gros_list">
               <PRICE_AMOUNT>13.00</PRICE_AMOUNT>
               <SUPPLPRICE_AMOUNT>7.33</SUPPLPRICE_AMOUNT>
               <!-- Einkaufspreis wird ignoriert -->
               <PRICE_CURRENCY>USD</PRICE_CURRENCY>
            </ARTICLE_PRICE>
            <ARTICLE_PRICE price_type="gros_list">
               <PRICE_AMOUNT>10.00</PRICE_AMOUNT>
               <SUPPLPRICE_AMOUNT>5.05</SUPPLPRICE_AMOUNT>
               <!-- Einkaufspreis wird ignoriert -->
               <PRICE_CURRENCY>GBP</PRICE_CURRENCY>
            </ARTICLE_PRICE>
         </ARTICLE_PRICE_DETAILS>
      </ARTICLE>
   </T_NEW_CATALOG>
</BMECAT>

Einstellungen im Control Center

Im Control Center gibt es verschiedene Einstellungen, die das Verhalten von Artikelnummern beeinflussen. In der folgenden Übersicht sind die wichtigsten Einstellungen aufgeführt.

Zum Seitenanfang