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, werden nur Delivery Bestellungen (TypeId=2) importiert.
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: 6163 6163_487-4507687431-848 Es sind maximal 50 Zeichen erlaubt.

Zum Seitenanfang

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; Bestellung > Details > Allgemein > Header > Gutschein TypeId = 6: Wert wird von <PriceGross> oder <PriceNet> genommen; Orders > Details > Allgemein > Header > Versandkosten	IDs der verschiedenen Typen (types) VARIATION = 1 ITEM_BUNDLE = 2 PROMOTIONAL_COUPON = 4 GIFT_CARD = 5 SHIPPING_COSTS = 6 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: Channel-Einstellung "Order Shop ID" hat die Einstellung "0"; Dann ist die ShopID der Referrer Matching table for ShopID contains: Original Value (plenty) = "4.01" Match Value (pixi) = "MAD" Die verknüpfte Tabelle zur ShopID enthält: Original Wert (plentyONE) = "4.01" Verknpüpfter Wert (pixi) = "MAD" Value "MAD" is used as shop ID for the order Der Wert "MAD" wird dementsprechend als Shop ID bei der Bestellung verwendet
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. Wenn die Einstellung auf "1" gesetzt wurde, wird der Artikelname aus dem Bestellimport der XML genommen.
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. 6163_10829
CreatedAt	Bestellungen > Bestellung > Bestelldatum Bestelldatum gespeichert in der Bestellzeile (nicht im UI sichtbar)	Das Datum, an dem die Bestellung erstellt wurde.

Zum Seitenanfang

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>

Zum Seitenanfang

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>

Zum Seitenanfang

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:

WAREHOUSE = 1
SHIPPING_PROFILE = 2
PAYMENT_METHOD = 3
XTERNAL_ORDER_ID = 7

Other TypIds are not considered on order import.

ID des Property type. Folgende types können genutzt werden:

WAREHOUSE = 1
SHIPPING_PROFILE = 2
PAYMENT_METHOD = 3
XTERNAL_ORDER_ID = 7

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.

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.
Wenn deaktiviert, wird die LocationID verwendet, die mit dem Land der Versandadresse verknüpft ist.

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:

6163
6163_487-4507687431-848

Zum Seitenanfang

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

Zum Seitenanfang

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) max. 12 Zeichen
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

Zum Seitenanfang

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: USt. ID = 1 Telefon = 4 E-Mail-Adresse = 5
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.

Zum Seitenanfang

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:

sender
receiver

Wenn der RelationName "receiver" ist, wird bei ReferenceId auf den Bestelltyp geprüft.

Zum Seitenanfang

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

Zum Seitenanfang

Vats

Diese Werte finden nach dem Import keinerlei Verwendung.

<Vats>
    <OrderVat>
        <VatField>0</VatField>
        <VatRate>19</VatRate>
        <Value>11.17</Value>
    </OrderVat>
</Vats>

Zum Seitenanfang

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>
</EventDates

Zum Seitenanfang

Datentransfers 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.

Zum Seitenanfang