MagentoAddOrders - Magento

← Magento Add-On Übersicht

Mit dem Step MagentoAddOrders können Sie neue Aufträge in Magento anlegen.

Achtung

Dieser Step unterscheidet sich von anderen Steps. Aufträge die zu Magento übertragen werden sollen, müssen zuerst in zwei Datastores (Auftragskopfdaten und Auftragspositionen) gespeichert werden. Der MagentoAddOrders - Step kann nur gespeicherte Aufträge zu Magento übertragen. 

Für diesen Step benötigen Sie daher zwei Datastores in einer Master-Child Beziehung (siehe Datastores).

• Im Master Datastore sind dabei die Kopfdaten der Bestellung gespeichert.
• Im Child Datastore sind die jeweiligen Artikelpositionen gespeichert und müssen per master_identifier dem jeweiligen Masterdatastore-Item (Bestellkopf) zugewiesen sein.

Voraussetzungen

 

Wenn Sie das Magento Addon gebucht haben, erstellen Sie zwei Datastores in einer Master-Child Beziehung zueinander. 

Vorgehensweise

• Für die Datastores sind zunächst zwei Schemas zu erstellen. 
  • MagentoOrderHead (als Master für die Auftragskopfdaten): wählen Sie Vordefiniertes Schema MagentoOrderPayloadProvider
  • MagentoOrderItem (als Child für die Auftragspositionen) : wählen Sie Vordefiniertes Schema MagentoOrderItemPayloadProvider

 

Hinweis

Diese beiden vordefinierten sind im Magento Plugin enthalten und können beim Erstellen von Schemas genutzt werden.

Entsprechend sind nun 2 Datastores mit den jeweiligen Schemas anzulegen. Nennen Sie die Datastores am besten analog zu den Schemas:

• OrderHead (als Master für die Auftragskopfdaten)
• OrderItem (als Child für die Auftragspositionen)

In die Datastores müssen nun mit Daten aus dem jeweiligen System befüllt werden (z.Bsp. aus Plentymarkets, etc.)

Der Step erwartet nun als Input den Master Datastore für die Order (mit dem Schema MagentoOrderPayloadProvider). 

• datastore=MagentoOrderHead

Input	Beschreibung
account	Wählen sie hier Ihren Magento-Account aus, um auf die Schnittstelle Ihres Shops zuzugreifen zu können (weitere Informationen)
storeViewId	Geben Sie hier die Id des gewünschten Stores an.
datastore	Wählen Sie hier den Datastore für die Kopfdaten der Aufträge
folder	Wählen Sie hier den Ordner des Datastores aus.

 

• Felder des Datastores

Die Kopfdaten werden durch das Datastore-Schema MagentoOrderPayloadProvider beschrieben

Felder	Anmerkungen	Pflichtfeld
Bestellungsdetails
name	Name der Bestellung
paymentMethod	ID der Zahlungsart	ja
shippingMethod	ID der Versandart	ja
Kundendaten
Lieferadresse
shipping_addressId	ID der Adresse
shipping_firstname	Vorname	ja
shipping_lastname	Nachname	ja
shipping_company	Unternehmen
shipping_street	Straße & Hausnummer	ja
shipping_city	Stadt	ja
shipping_region	Region (z.B. Thüringen)
shipping_regionId	ID der Region	ja
shipping_postcode	Postleitzahl	ja
shipping_countryId	ID des Landes (z.B. DE für Deutschland)	ja
shipping_telephone	Telefon	ja
shipping_fax	Fax
shipping_isDefaultBilling	Adresse als Standard Rechnungsadresse des Kunden setzen
shipping_isDefaultShipping	Adresse als Standard Versandadresse des Kunden setzen
Rechnungsadresse
billing_addressId	ID der Adresse
billing_firstname	Vorname	ja
billing_lastname	Nachname	ja
billing_company	Unternehmen
billing_street	Straße & Hausnummer	ja
billing_city	Stadt	ja
billing_region	Region (z.B. Thüringen)
billing_regionId	ID der Region
billing_postcode	Postleitzahl	ja
billing_countryId	ID des Landes (z.B. DE für Deutschland)	ja
billing_telephone	Telefon	ja
billing_fax	Fax
billing_isDefaultBilling	Adresse als Standard Rechnungsadresse des Kunden setzen
billing_isDefaultShipping	Adresse als Standard Versandadresse des Kunden setzen

Die Auftragspositionen sind durch das Schema MagentoOrderItemPayloadProvider beschrieben.

Pflichtfelder	Anmerkungen	Pflichtfeld
name	Artikelname
productId	ID des Artikels	(Entweder ProduktID oder SKU müssen befüllt sein.)
sku	SKU des Artikels	(Entweder ProduktID oder SKU müssen befüllt sein.)
quantity	Anzahl	Ja

Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name	Datentyp	Beschreibung	Pflichtfeld	Werte
account	ACCOUNT	Ihr Konto	Ja
datastore	DATASTORE	Der Datastore enthält die Bestellungen für Magento. Der Datastore muss mit dem Magento Bestellschema kompatibel sein.	Ja
	Folgende Felder sind zu konfigurieren: Feld Datentyp Beschreibung Pflichtfeld Standardwert name SINGLE Nein orderId SINGLE Nein status SINGLE Nein shipping_addressId SINGLE Nein shipping_firstname SINGLE Ja shipping_lastname SINGLE Ja shipping_company SINGLE Nein shipping_street SINGLE Ja shipping_city SINGLE Ja shipping_region SINGLE Nein shipping_regionId SINGLE Ja shipping_postcode SINGLE Ja shipping_countryId SINGLE Ja shipping_telephone SINGLE Ja shipping_fax SINGLE Nein shipping_isDefaultBilling SINGLE Nein shipping_isDefaultShipping SINGLE Nein billing_addressId SINGLE Nein billing_firstname SINGLE Ja billing_lastname SINGLE Ja billing_company SINGLE Nein billing_street SINGLE Ja billing_city SINGLE Ja billing_region SINGLE Nein billing_regionId SINGLE Ja billing_postcode SINGLE Ja billing_countryId SINGLE Ja billing_telephone SINGLE Ja billing_fax SINGLE Nein billing_isDefaultBilling SINGLE Nein billing_isDefaultShipping SINGLE Nein shippingMethod SINGLE Ja paymentMethod SINGLE Ja productId SINGLE Nein sku SINGLE Nein quantity SINGLE Ja link SINGLE Nein
folder	STRING	Der Datastore Folder	Nein
limit	STRING	Begrenzt die Anzahl der pro Ausführung bearbeiteten Aufträge	Nein
sortByField	STRING	Optionales Feld zum Sortieren der Datensätze nach einem der indizierten Datastore Felder.	Nein	Keine (Standard) Identifier Identifier2 Identifier3 Tags Erstellungsdatum Aktualisierungsdatum Datum der letzten Inhaltsänderung Datum der Verarbeitung Folder
sortDir	STRING	Die Sortierreihenfolge (Aufsteigend oder Absteigend).	Nein	Aufsteigend Absteigend
storeViewId	STRING	Der Code der Magento Store View (z.B. Standard, Französisch, Deutsch etc.). Standard: leer.	Nein

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name	Datentyp	Beschreibung	Werte
result	SPREADSHEET	Ein SPREADSHEET mit den Ergebnissen des Auftragsimports
	Folgende Felder sind im Output enthalten: Feld Datentyp Beschreibung Standardwert identifier SINGLE The identifier column to import Spreadsheet into a Datastore. orderID SINGLE status SINGLE statusMessage SINGLE