Nachdem eine Bestellung von plentyONE importiert wurde, werden die Daten der Bestellung im XML-Format im Control Center > Import und Export angezeigt. Falls der Import fehlschlägt, können die Werte im XML durch pixi neu importiert werden.
XML-Struktur
<Order xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<OrderItems>
...
</OrderItems>
<Properties>
...
</Properties>
<AddressRelations>
...
</AddressRelations>
<Addresses>
...
</Addresses>
<Relations>
...
</Relations>
<Amounts>
...
</Amounts>
<EventDates>
...
</EventDates>
<TypeId>1</TypeId>
<PlentyId>26748</PlentyId>
<StatusId>5</StatusId>
<OwnerId>0</OwnerId>
<CreatedAt>2018-03-21T09:20:06+01:00</CreatedAt>
<UpdatedAt>2018-03-21T11:20:11+01:00</UpdatedAt>
<Id>6163</Id>
</Order>XML-Element |
Wert in pixi |
Beschreibung |
OrderItems | ||
Properties | ||
AddressRelations | ||
Addresses | ||
Relations | ||
Amounts | ||
EventDates | ||
TypeId |
- |
TypeId der Bestellung. Wenn die Einstellung Auftragssplittung unterstützen deaktiviert ist (0), importiert pixi Bestellungen mit allen Typen. Wenn die Einstellung aktiviert ist (1), importiert pixi Delivery Bestellungen (TypeId=2). Gewährleistungsbestellungen (TypeId=5) werden zusätzlich importiert, wenn die Channel-Einstellung Gewährleistungen (Warranty) importieren aktiviert ist. |
PlentyId |
Kundendetails > Kundennummer |
Enthält die PlentyID des Kunden zur Bestellung
Wenn die Channel-Einstellung PlentyCustomerNrExternal die PlentyID importiert, wird dieser Wert im Feld Kundennummer übernommen. Die Angabe oblgatorisch, wenn die Einstellung auf "PlentyID" gesetzt wurde. |
Id |
Bestellungen > Bestelldetails > Externe Bestellnr. |
Enthält die OrderID aus plentyONE (ext. Bestellnummer) Wenn ein Wert bei <Properties><OrderProperty><Value> (für TypeId = 7) vorhanden ist, werden beide Werte mit einem Unterstrich (_) verbunden. Beispiel:
Es sind maximal 50 Zeichen erlaubt. Bei einer geteilten Lieferbestellung (in plentyONE: Auftragstyp Lieferauftrag) oder Gewährleistungsbestellung (in plentyONE: Auftragstyp Gewährleistung) speichert pixi zusätzlich die ID der ursprünglichen Hauptbestellung (in plentyONE: Hauptauftrag). Sie wird mit dem Präfix P zwischen der plenty-Bestell-ID und der externen Bestellnummer eingefügt, zum Beispiel:
Ist der Wert länger als 50 Zeichen, wird das Ende gekürzt, die externe Bestellnummer also zuerst. pixi ergänzt die ID der Hauptbestellung beim Import der Bestellung. Um sie bei einer früher importierten Bestellung zu ergänzen, importieren Sie die Bestellung erneut. |
OrderItems
Diese Elemente enthalten Informationen zu bestellten Artikeln inklusive Versandkosten und Gutscheinen.
<OrderItems>
<OrderItem>
<Amounts>
<OrderItemAmount>
...
</OrderItemAmount>
</Amounts>
<Properties>
<OrderItemProperty>
...
</OrderItemProperty>
...
</Properties>
<OrderId>6163</OrderId>
<TypeId>Variation</TypeId>
<ReferrerId>4.01</ReferrerId>
<ItemVariationId>1134</ItemVariationId>
<Quantity>1</Quantity>
<OrderItemName>Profi Nagel-Fräser</OrderItemName>
<ShippingProfileId>0</ShippingProfileId>
<VatField>0</VatField>
<VatRate>19</VatRate>
<Id>10829</Id>
<CreatedAt>2018-03-21T10:32:22+01:00</CreatedAt>
<UpdatedAt>2018-03-21T11:20:10+01:00</UpdatedAt>
</OrderItem>
...
</OrderItem>XML-Element |
Wert in pixi |
Beschreibung |
Amounts | ||
Properties | ||
TypeId |
TypeId = 4 oder 5: Wert wird von <PriceGross> oder <PriceNet> genommen; TypeId = 6: Wert wird von <PriceGross> oder <PriceNet> genommen; |
IDs der verschiedenen Typen (types)
Andere TypeIds werden beim Import nicht berücksichtigt. Wenn ein Gutscheincode importiert wird, kürzt pixi den Gutscheincode auf 50 Zeichen und hängt die Bestell-ID am Ende an: „Summer sale - newsletter coupon for 10 EUR discount on all items“ wird zu „Summer sale - newsletter coupon for 10 E..._123456“. |
ReferrerId |
Kundendetails > Allgemein > Shop |
Basierend auf der Channel-Einstellung für Order Shop ID wird die ID von der Tabelle genommen, die mit dem Channel verknüpft ist. Beispiel:
|
ItemVariationId |
- |
ID der Item Variation Abhängig von der Channel-Einstellung InternalItemNumber |
Quantity |
Bestellungen > Details > Artikel > Menge |
Menge Abhängig von der Channel-Einstellung Bestellmenge mit VPE multiplizieren wird die Menge entweder mit der Verpackungseinheit in pixi multipliziert oder die Menge aus plentyONE wird verwendet. |
OrderItemName |
Orders > Details > Items > Item name
Bestellungen > Details > Artikel > Artikelname |
Artikelname aus plentyONE Wenn die Channel-Einstellung für Artikelname aus Plenty-Bestellung verwenden auf "0" gesetzt wurde, wird der Artikelname von pixi für die Bestellung verwendet. |
VatRate |
Bestellungen > Details > Artikel > MwSt. % |
Mehrwertsteuer z. B. 19.0 für 19 % MwSt. |
Id |
Externe Artikelnummer gespeichert in der Bestellzeile (nicht im UI sichtbar) |
<Order><Id> und dieser Wert werden durch einen Unterstrich (_) verbunden und als externe ARtikelnummer importiert.
|
CreatedAt |
Bestellungen > Bestellung > Bestelldatum
Bestelldatum gespeichert in der Bestellzeile (nicht im UI sichtbar) |
Das Datum, an dem die Bestellung erstellt wurde.
|
Amounts
In diesen Elementen sind Informationen zu verschiedenen Beträgen, Preisen, Währungen etc. enthalten.
<Amounts>
<OrderItemAmount>
<OrderItemId>10829</OrderItemId>
<Currency>EUR</Currency>
<ExchangeRate>1</ExchangeRate>
<IsSystemCurrency>true</IsSystemCurrency>
<PriceOriginalGross>69.99</PriceOriginalGross>
<PriceOriginalNet>58.8151</PriceOriginalNet>
<Surcharge>0</Surcharge>
<Discount>0</Discount>
<IsPercentage>true</IsPercentage>
<PurchasePrice>21.8</PurchasePrice>
<PriceGross>69.99</PriceGross>
<PriceNet>58.8151</PriceNet>
</OrderItemAmount>
</Amounts>Properties
Diese Werte werden beim Bestellimport nicht berücksichtigt.
<Properties>
<OrderItemProperty>
<TypeId>1</TypeId>
<Value>1</Value>
<OrderItemId>10829</OrderItemId>
</OrderItemProperty>
<OrderItemProperty>
<TypeId>11</TypeId>
<Value>1000</Value>
<OrderItemId>10829</OrderItemId>
</OrderItemProperty>
...
</Properties>Properties
In diesen Elementen befinden sich allgemeine Informationen (z. B. Versanddienstleister, Zahlungsart etc.).
<Properties>
<OrderProperty>
<TypeId>3</TypeId>
<Value>9</Value>
<OrderId>6163</OrderId>
</OrderProperty>
<OrderProperty>
<TypeId>4</TypeId>
<Value>fullyPaid</Value>
<OrderId>6163</OrderId>
</OrderProperty>
...
</Properties>XML-Element |
Wert in pixi |
Beschreibung |
TypeId |
- |
The ID of the property type. The following types are available:
Other TypIds are not considered on order import. ID des Property type. Folgende types können genutzt werden:
Andere TypeIds werden beim Bestellimport nicht berücksichtigt. |
Value |
TypeId = 1: Bestellungen > Bestellungen > Location
TypeId = 2: Orders > Details > General > Order Header > Shipping vendor
TypeId = 3: Orders > Details > General > Billing details > Payment
TypeId = 7: Orders > Orders > Order External Nr. TypeId = 62: Orders > Orders > Referrer |
Der Wert dieses Attributs anhängig vom Type. TypeId = 1: Wenn die Datenbankeinstellung openTRANS - Nutze Location des XMLs aktiviert ist, wird die Location aus der Zuordnungstabelle verwendet. TypeId = 2: Versanddiesntleister wird aus der Zuordnungs Zuordnungstabelle entnommen TypeId = 3: Die Zahlungsart wird von der Zuordnungstabelle entnommen. TypeId = 7: Enthält die OrderID aus plentyONE (ext. Bestellnummer) Wenn ein Wert bei <Order><Id> und dieser Wert mit einem Unterstrich (_) verbunden sind wird die externe Bestellnummer wie folgt importiert:
TypeId = 62: Enthält die External Source Order ID aus plentyONE, in der Regel die ursprüngliche Shopify-Bestell-ID. pixi übernimmt sie in das Feld Referrer der Bestellung. Werte mit mehr als 50 Zeichen werden gekürzt. |
AddressRelations
Diese Elemente enthalten die IDs der Kundenadressen für Rechnung und Versand.
<AddressRelations>
<OrderAddressRelation>
<OrderId>6163</OrderId>
<AddressId>67933</AddressId>
<TypeId>BillingAddress</TypeId>
</OrderAddressRelation>
<OrderAddressRelation>
<OrderId>6163</OrderId>
<AddressId>67933</AddressId>
<TypeId>DeliveryAddress</TypeId>
</OrderAddressRelation>
</AddressRelations>XML-Element |
Wert in pixi |
Beschreibung |
AddressId |
- |
Die ID der Adresse. Wird später für die Unterscheidung zwischen Rechnungs- und Versandadresse verwendet. |
TypeId |
- |
Art der Adresse: Rechnungs- oder LIeferadresse |
Addresses
Die Adressen befinden sich in diesen Elementen.
<Addresses>
<Address>
<Id>67933</Id>
<Name1/>
<Name2>John</Name2>
<Name3>Doe</Name3>
<Address1>Sunshine Avenue</Address1>
<Address2>1</Address2>
<Address3/>
<PostalCode>8523810025</PostalCode>
<Town>New York</Town>
<CountryId>1</CountryId>
<StateId xsi:type="xsd:long">2</StateId>
<ReadOnly>false</ReadOnly>
<CreatedAt>2018-03-21T11:20:09+01:00</CreatedAt>
<UpdatedAt>2018-03-21T11:20:09+01:00</UpdatedAt>
<Options>
...
</Options>
</Address>
</Addresses>XML-Element |
Wert in pixi |
Beschreibung |
Id |
- |
Die ID der Adresse. Wird später für die Unterscheidung zwischen Rechnungs- und Versandadresse benötigt. |
Name1 |
Bestellungen > Details > Allgemein > Zahlungsdaten/Versandadresse > Firma |
Feld Name 1 (standardmäßig: Firmenbezeichnung) |
Name2 |
Bestellungen > Details > Allgemein > Zahlungsdaten/Versandadresse > Anrede > 2. Feld (Vorname) |
The name 2 field (default: first name) Feld Name 2 (standardmäßig: Vorname) |
Name3 |
Bestellungen > Details > Allgemein > Zahlungsdaten/Versandadresse > Anrede > 3. Feld (Nachname) |
Feld Name 3 (standardmäßig: Nachname) |
Address1 |
Bestellungen > Details > Allgemein > Zahlungsdaten/Versandadresse > Straße / Nr. > 1. Feld (Straße) |
Feld Adresse 1 (Straße, Packstation, Postfiliale) |
Address2 |
Bestellungen > Details > Allgemein > Zahlungsdaten/Versandadresse > Straße / Nr. > 2. Feld (Hausnr.) |
Feld Adresse 2 (Hausnr., Packstation ID) |
Address3 |
Bestellungen > Details > Allgemein >Bestellung > Adresszusatz |
Feld Adresse 3 (zusätzliche Informationen) |
PostalCode |
Zahlungsdaten/Versandadresse > PLZ |
Postleitzahl |
Town |
Zahlungsdaten/Versandadresse > Stadt |
Ort |
CountryId |
Details > Billing / Shipping details > Country |
The ID of the country Länderkennung (ID) |
Options | ||
Options
In diesen Elementen werden zusätzliche Adressinformationen (z. B. E-Mail-Adresse und Telefon) übergeben.
<Options>
<AddressOption>
<Id>371780</Id>
<AddressId>67933</AddressId>
<TypeId>4</TypeId>
<Value>PhoneNumber</Value>
<Position>0</Position>
<CreatedAt>2018-03-21T11:20:09+01:00</CreatedAt>
<UpdatedAt>2018-03-21T11:20:09+01:00</UpdatedAt>
</AddressOption>
<AddressOption>
<Id>371781</Id>
<AddressId>67933</AddressId>
<TypeId>5</TypeId>
<Value>E-mailAddress</Value>
<Position>0</Position>
<CreatedAt>2018-03-21T11:20:09+01:00</CreatedAt>
<UpdatedAt>2018-03-21T11:20:09+01:00</UpdatedAt>
</AddressOption>
</Options>XML-Element |
Wert in pixi |
Beschreibung |
Id |
The ID of the address option |
|
AddressId |
- |
Die ID der Adresse. Je nachdem, welche ID übergeben wird, werden die Werte für die Rechnungs- und/oder Lieferadresse importiert. |
TypeId |
- |
Die ID des Adresstypes. Folgende Types sind verfügbar:
|
Value |
TypeId = 1: Bestellungen > Details > Allgemein > Rechnung/Lieferung > USt.ID TypeId = 5: Bestellungen > Details > Allgemein > Rechnung/Lieferung > Telefon TypeId = 4: Bestellungen > Details > Allgemein > Rechnung/Lieferung > E-Mail-Adresse |
Wenn die Channel-Einstellung PlentyCustomerNrExternal die "CustomerNrExternal" enthält, prüft das System nicht auf CustomerID. Somit können Kunden aus plentyONE auch ohne Customer ID importiert werden. E-Mail-Adresse darf maximal 60 Zeichen lang sein. |
Relations
Diese Angaben bestimmen, ob eine Bestellung vom Typ B2C oder B2B ist.
<Relations>
<OrderRelation>
<OrderId>6163</OrderId>
<ReferenceType>warehouse</ReferenceType>
<ReferenceId>1</ReferenceId>
<RelationName>sender</RelationName>
</OrderRelation>
<OrderRelation>
<OrderId>6163</OrderId>
<ReferenceType>contact</ReferenceType>
<ReferenceId>34742</ReferenceId>
<RelationName>receiver</RelationName>
</OrderRelation>
</Relations>XML-Element |
Wert in pixi |
Beschreibung |
ReferenceId |
Bestellungen > Details > Allgemein > Bestellung > Bestelltyp |
Reference ID Wenn der Wert identisch mit einem der Werte bei B2B Customer Classes IDs ist, wird die Bestellung als B2B-Bestellung zu pixi importiert. Andernfalls wird die Bestellung als B2C-Bestellung importiert. |
RelationName |
- |
Die Relation zwischen Reference und Bestellung. Folgende Typen stehen zur Auswahl:
Wenn der RelationName "receiver" ist, wird bei ReferenceId auf den Bestelltyp geprüft. |
Amounts
Diese Werte werden genutzt, um die Währung für die Bestellung und den Umrechnungssatz zu bestimmen.
<Amounts>
<OrderAmount>
<IsSystemCurrency>true</IsSystemCurrency>
<Currency>EUR</Currency>
<ExchangeRate>1</ExchangeRate>
<IsNet>false</IsNet>
<NetTotal>58.82</NetTotal>
<GrossTotal>69.99</GrossTotal>
<VatTotal>11.17</VatTotal>
<InvoiceTotal>69.99</InvoiceTotal>
<PaidAmount>69.99</PaidAmount>
<Vats>
<OrderVat>
...
</OrderVat>
</Vats>
</OrderAmount>
</Amounts>XML-Element |
Wert in pixi |
Beschreibung |
IsSystemCurrency |
- |
Kennzeichnet, ob die Währung die Gleiche wie die des Systems ist. |
Currency |
Bestellung > Details > Allgemein > Header > Währung |
Währung der Beträge |
ExchangeRate |
Bestellungen > Details > Allgemein > Header > Wechselkurs |
Umrechnungssatz für die Umrechnung der Währung in die Währung des Systems. |
Vats | ||
Vats
Diese Werte finden nach dem Import keinerlei Verwendung.
<Vats>
<OrderVat>
<VatField>0</VatField>
<VatRate>19</VatRate>
<Value>11.17</Value>
</OrderVat>
</Vats>EventDates
Diese Werte finden nach dem Import keinerlei Verwendung.
<EventDates>
<OrderDate>
<OrderId>6163</OrderId>
<TypeId>CreatedOn</TypeId>
<EventDate>2018-03-21T09:20:06+01:00</EventDate>
</OrderDate>
<OrderDate>
<OrderId>6163</OrderId>
<TypeId>PaidDate</TypeId>
<EventDate>2018-03-21T11:20:10+01:00</EventDate>
</OrderDate>
<OrderDate>
<OrderId>6163</OrderId>
<TypeId>LastUpdate</TypeId>
<EventDate>2018-03-21T11:20:11+01:00</EventDate>
</OrderDate>
</EventDatesDatentransfers mittels REST-Methoden
Neben den oben aufgeführten Informationen gibt es einige Daten, die nicht im XML-Format zu pixi importiert werden. Dazu gehören:
Bestellkommentare: Alle Kommentare, die zur Bestellung hinzugefügt wurden, können durch die GET-Methode bei plentyONE Endpunkt /rest/comments/order/{orderId} abgerufen werde.
Alle Kommentare werden in das Feld Kommentar aus Shop importiert.