Bedienungsanleitung Produkt-Export

Produkt-Export

Da Magento das produktführende System ist, werden Produkt-Daten und Attribute von Magento für Pixi* verwendet. Der Abgleich findet in einem definierten Turnus statt. Dies kann im Pixi* Control Center konfiguriert werden.

Bitte wenden Sie sich dazu an Descartes/Pixi* oder prüfen Sie die Dokumentation

Filterung der Produkte für den Export

Es werden alle Produkte des Magento-Shops für den Export in Betracht gezogen. Da wie erwähnt Magento das produktführende System ist und die Produktdaten auf globaler Ebene gehalten werden, werden alle Produkt-Informationen exportiert.

Es findet keine Filterung der Produkte aufgrund ihrer Website-Zuordnung statt.

Für die Filterung der Produkte für Export werden die Attribute pixi_export_status, pixi_export_date und pixi_export_price genutzt, um die Produkte für den Export zu identifizieren.

Mit der optionalen Übergabe von StoreID- oder StoreCode-Parametern im Request können nun gezielt Produkte welchem dem angefragten Store zugewiesen sind exportiert werden. Der Funktionsablauf ist gleich dem Standard-Produkt-Export. Es wird jedoch anhand des Parameters zusätzliche gefiltert, welche Produkte exportiert werden sollen.

Anwendungsfall: Standard-Produkt-Export

In dieser kurzen Beschreibung wird erklärt, wie ein Standard-Produkt-Export von Magento ausgeführt wird.

Bitte prüfen Sie zunächst, ob die Konfiguration des Produkt-Exports gesetzt ist.
Es werden nur Produkte an Pixi* übermittelt, welche noch nicht exportiert oder die seit dem letzten Export aktualisiert wurden.

Für den Export von Magento zu Pixi* werden maximal 250 Produkte ermittelt und übersendet.
Lösen Sie den Produkt-Export aus.
- Dies passiert wie beschrieben durch den konfigurierten Turnus in pixi*.
- Alternativ können Sie den Request testen.
  - dazu das Attribute Environment auf Development stellen.
  - und folgenden Request-Text in eine Browser-Adresszeile eingeben:
    
    https://magento242commerce.test/pixi/api/exportCatalog?sid=test

Nach dem Export werden die Produkte als exportiert markiert

Der Pixi-Export-Status wird auf 1 gesetzt.
Es wird das Pixi-Export-Datum gemäß dem Zeitpunkt des Exports gesetzt.
Folgende Daten sind in der XML-Antwort zu finden (BMEcat)
- Im Header-Bereich sind alle Store- bzw. Shop-Informationen enthalten, wenn diese gepflegt wurden.
- Die SUPPLIER_AID in den Artikeldaten entspricht dem konfigurierten Produkt-Identifikator.
- Die Artikeldetails werden aus den Standard-Daten versorgt. Wenn ein EAN-Attribut konfiguriert ist, so wird dieses ebenfalls exportiert.
- In den Artikelfeatures sind folgende Daten standardmäßig enthalten:
  - Der Status des Produkts (aktiv/deaktiviert)
  - Name des Herstellers, wenn beim Produkt gepflegt. Standard-Konfiguration ist hier das Magento-Attribut manufacturer
  - Die Steuerklasse des Produkts
    
    Ist keine Steuerklasse für die Pixi-Steuerklassen hinterlegt, so wird MwSt_High übermittelt.
- Unter der Mime-Information werden die Bilder des Produkts übergeben
  
  Dies kann per Konfiguration deaktiviert werden.

<?xml version="1.0"?>
<BMECAT version="1.2">
  <HEADER>
    <GENERATOR_INFO> BMECat Export</GENERATOR_INFO>
    <SUPPLIER>
      <SUPPLIER_NAME/>
      <ADDRESS type="supplier"/>
    </SUPPLIER>
    <CATALOG>
      <CURRENCY>USD</CURRENCY>
      <SHOPID>1</SHOPID>
      <DATEEXPORT>1623325325</DATEEXPORT>
      <EXPORT_DATE>2021-06-10 11:42:05</EXPORT_DATE>
    </CATALOG>
  </HEADER>
  <T_NEW_CATALOG>
    <ARTICLE>
      <SUPPLIER_AID>24-MB01</SUPPLIER_AID>
      <ARTICLE_DETAILS>
        <DESCRIPTION_SHORT>Joust Duffle Bag(s)</DESCRIPTION_SHORT>
        <DESCRIPTION_LONG>description</DESCRIPTION_LONG>
        <EAN>Test-EAN-2</EAN>
        <MANUFACTURER_NAME>Hersteller2</MANUFACTURER_NAME>
        <SEGMENT>Bags</SEGMENT>
      </ARTICLE_DETAILS>
      <ARTICLE_FEATURES>
        <FEATURE>
          <FNAME>Europe1PriceFactory.PTG</FNAME>
          <FVALUE>MwSt_High</FVALUE>
        </FEATURE>
        <FEATURE>
          <FNAME>ID Hersteller2</FNAME>
          <FVALUE>24-MB01</FVALUE>
        </FEATURE>
        <FEATURE>
          <FNAME>STATUS</FNAME>
          <FVALUE>ACTIVE</FVALUE>
        </FEATURE>
        <SerialNumberRequired>0</SerialNumberRequired>
      </ARTICLE_FEATURES>
      <MIME_INFO>
        <MIME>
          <MIME_TYPE>image/jpeg</MIME_TYPE>
          <MIME_SOURCE>https://magento242commerce.test/media/catalog/product/cache/d0b08d5ed0ccc03dcf25f1ae26210948/1/4/1479914220-3162776734_1.jpg</MIME_SOURCE>
          <MIME_PURPOSE>normal</MIME_PURPOSE>
        </MIME>
      </MIME_INFO>
      <MIME_INFO>
        <MIME>
          <MIME_TYPE>image/jpeg</MIME_TYPE>
          <MIME_SOURCE>https://magento242commerce.test/media/catalog/product/cache/142114b9961d7c84b84533a07e95bb2d/1/4/1479914220-3162776734_1.jpg</MIME_SOURCE>
          <MIME_PURPOSE>thumbnail</MIME_PURPOSE>
        </MIME>
      </MIME_INFO>
      <ARTICLE_PRICE_DETAILS>
        <ARTICLE_PRICE price_type="net_list">
          <PRICE_CURRENCY>USD</PRICE_CURRENCY>
          <PRICE_AMOUNT>36.0000</PRICE_AMOUNT>
          <SUPPLPRICE_AMOUNT>0</SUPPLPRICE_AMOUNT>
        </ARTICLE_PRICE>
      </ARTICLE_PRICE_DETAILS>
    </ARTICLE>
  </T_NEW_CATALOG>
</BMECAT>

Beim nächsten Export werden bereits exportierte Produkte nicht mehr übergeben. Erst, wenn sich die Daten des Produkts wieder ändern, ermittelt das Pixi* Connector Modul die Änderung und exportiert das Produkt erneut zu pixi.

Anwendungsfall: Korrekter Export von Steuerklassen

Um Steuerberechnungen in Pixi* korrekt zu verarbeiten, müssen die Steuerklassen für Produkte korrekt übergeben werden. Dabei wird nach drei Klassen unterschieden:

MwS_High – normaler Steuersatz
MwSt_Low – verringerter Steuersatz
MwSt-None – keine Steuerklasse

Dazu müssen in der Konfiguration alle verwendeten Magento-Steuerklassen den Pixi-Steuerklassen zugewiesen werden.

<ARTICLE_FEATURES>
  <FEATURE>
    <FNAME>Europe1PriceFactory.PTG</FNAME>
    <FVALUE>MwSt_High</FVALUE>
  </FEATURE>
  ...
</ARTICLE_FEATURES>

Anwendungsfall: Korrekter Export von Lieferantenzuweisungen

Es ist möglich je Hersteller, sogar wenn das Produkt von mehreren Herstellern geliefert wird, eine Identifikation zu konfigurieren um Produkte zu Herstellern/Lieferanten zuweisen zu können.

Dazu können in der Konfiguration Identifikations-Attribute jedem Hersteller-Namen zugweisen werden.

<ARTICLE_FEATURES>
  <FEATURE>
    <FNAME>ID Hersteller2</FNAME>
    <FVALUE>Test-EAN-2</FVALUE>
  </FEATURE>
  <FEATURE>
    <FNAME>ID Hersteller3</FNAME>
    <FVALUE>24-MB01</FVALUE>
  </FEATURE>
  ...
</ARTICLE_FEATURES>

Werden Leerwerte bei Hersteller-Identifikatoren (FVALUE) übertragen, so werden die Produkte im Pixi* Control Center mit Fehlermeldungen importiert Pixi* Fehlerbeschreibungen und deren Behebung

Um Leerwerte für Hersteller-Identifikatoren zuzulassen, falls diese in Magento nicht gepflegt sind, können Sie im Pixi* Control Center die Option Die Lieferantenartikelnummer wurde nicht gefunden oder ist in der XML leer in den Pixi* Import-Bedingungen für Artikel deaktivieren.

Anwendungsfall: Export von Sonderpreisen

Es ist möglich Sonderpreise anstatt der Normalpreise an Pixi beim Produktexport zu übermitteln. Dazu muss in der Konfiguration der Export von Sonderpreisen erlaubt werden. Da Sonderpreise (Special-Prices) in Magento für gewisse Zeitspannen (in der Zukunft) definiert werden können, wurde speziell hierfür eine Ermittlungsfunktion via CronJob implementiert. Der Zeitpunkt der Ermittlung des Preises ist konfigurierbar. Wir empfehlen aber eine tägliche Ermittlung um 01:00 Uhr nachts.

Bitte stellen Sie sicher, dass der Cronjob bzw. die Crongroup auf dem System aktiviert und lauffähig sind.

Bei jedem Export wird der Produktpreis zwischengespeichert.
Am konfigurierten Zeitpunkt die wird Preisdifferenz ermittelt (aktueller Preis – letzter Exportpreis).
Wird eine Differenz festgestellt, so wird das Produkt für den nächsten Export markiert.
Beim Export des Produkts wird der aktuelle Preis (Final-Price/Special-Price) anstelle des Normalpreises übergeben.

Anwendungsfall: Zuweisung der Produktkategorie für den Export

In Magento können Sie ein Produkt mehreren Kategorien zuweisen. Pixi* nimmt als Zuweisung nur eine Kategorie entgegen. Hierfür wird die zuletzt (zeitlich) zugewiesene Kategorie des Produkts verwendet.

Ein Produkt eine nur eine Kategorie ("Tanks")
Dem Produkt wird eine weitere Kategorie hinzugefügt ("Hoodies & Sweatshirts")
Da die Kategorie "Hoodies & Sweatshirts" als letzte hinzugefügt wird, wird diese auch als Kategorie für den Export verwendet.

Leider ist Export-Kategorie auf der Produktdetailseite im Backend nicht ersichtlich, da die Kategorien ihrer nach geordnet sind.