orders
Mit dem Datenformat-Creator orders kannst du Aufträge exportieren und in der Cloud speichern. Die Rohdaten-Datei ist maximal 6 Monate auf dem Cloud-Speicher verfügbar. Eine Weiterverarbeitung muss somit vorher erfolgen. Weitere Informationen zu den Eigenschaften des Formats findest du in den nachfolgenden Tabellen.
1. Technische Spezifikationen
In Tabelle 1 werden die verfügbaren Eigenschaften und die dazugehörigen Werte erläutert.
Eigenschaft | Bedeutung | Wert | Erläuterung |
---|---|---|---|
dataName |
Name |
orders |
Name des Creator-Prozesses und Präfix der erstellten Datei. |
fileFormat |
Dateiformat |
CSV, GZIP |
Die Daten werden als per GZIP (RFC 1952) komprimierte CSV-Datei bereitgestellt. |
limitPage |
Zeilen pro Anfrage |
bis zu 5.000 |
Die maximale Anzahl der Datenzeilen, die in eine einzelne Datei geschrieben wird. |
limitDay |
Zeilen pro Tag |
bis zu 500.000 |
Die maximale Anzahl der Datenzeilen, die insgesamt an einem Tag geschrieben wird. |
earliestPossibleDataDate |
Frühester Zeitpunkt |
2020-01-01 |
Zeitpunkt, ab dem die Rohdaten erhoben werden können. Die Daten werden nach dem Datum gefiltert, das in der Spalte dataUpdatedAtColumnName enthalten ist. |
filterType |
Filtertyp |
lastUpdate |
Daten werden basierend auf der letzten Aktualisierung gefiltert. |
dataUpdatedAtColumnName |
Spaltenbezeichnung |
o_updated_at |
Name der Spalte, die den Zeitstempel der letzten Aktualisierung der Daten enthält. |
defaultActive |
Standardmäßig aktiv |
ja |
Der Export läuft standardmäßig automatisch im Hintergrund. |
interval |
Intervall |
täglich |
Mit dieser Einstellung werden 1 x pro Tag, gewöhnlich über Nacht, alle seit dem letzten Durchlauf geänderten Daten exportiert. |
storableFromPlan |
Speicherung ab Tarif |
plentyBI XS |
Tarif, ab dem die Daten im Cloud Storage gespeichert werden und via REST abgerufen werden können. |
processableFromPlan |
Nutzung ab Tarif |
plentyBI L |
Tarif, ab dem die Daten an plentyBI Data Warehouse überführt werden, also zur Nutzung, Filterung und Berechnung von Kennzahlen zur Verfügung stehen. |
2. Datenspalten
In Tabelle 2 werden die Datenspalten des Formats orders erläutert, die beim Export der Rohdaten in der CSV-Datei gespeichert werden.
Spaltenname | Datentyp | Vollständige Bezeichnung | Erläuterung |
---|---|---|---|
plenty_id |
INTEGER NOT NULL |
plenty ID |
ID des plentymarkets Systems |
o_id (Primary key) |
VARCHAR NOT NULL |
order ID |
ID des Auftrags |
o_plenty_id |
INTEGER NOT NULL |
order plenty ID |
ID des plentymarkets Systems oder Mandanten, über die der Auftrag angelegt wurde |
o_origin_order_ID |
VARCHAR |
order origin order ID |
ID des übergeordneten Hauptauftrags. Diese ID wird nur bei Auftragstypen ausgegeben, die einem sogenannten Hauptauftrag untergeordnet ist (beispielsweise Gutschriften, Retouren und Lieferaufträge). |
os_id |
NUMERIC(6,4) NOT NULL |
order status |
Status des Auftrags im Dezimalformat. Je nach den im System eingerichteten Status werden Zahlen mit bis zu 4 Nachkommastellen ausgegeben. Die IDs der Standardstatus finden Sie auf der Handbuchseite Interne IDs in plentymarkets. |
o_referrer |
NUMERIC(5,2) |
order referrer |
Herkunft des Auftrags. |
o_global_referrer |
NUMERIC(5,2) |
order global referrer |
Globale Herkunft des Auftrags |
o_type |
VARCHAR NOT NULL |
order type |
Auftragstyp |
o_is_main_order |
SMALLINT NOT NULL |
order is main order |
Gibt an, ob der Auftrag ein Hauptauftrag ist. |
o_is_net |
SMALLINT NOT NULL |
order is net |
Gibt an, ob der Auftrag netto oder brutto abgerechnet wurde. |
o_is_b2b |
SMALLINT NOT NULL |
order is b2b |
Gibt an, ob es sich um einen B2B-Auftrag handelt. |
ac_id |
VARCHAR NOT NULL |
account contact id |
ID des Kontakts, der dem Auftrag zugeordnet ist |
o_payment_status |
SMALLINT NOT NULL |
order payment status |
Zahlungsstatus des Auftrags |
o_invoice_postal_code |
VARCHAR |
order invoice postal code |
Postleitzahl der Rechnungsanschrift |
o_invoice_town |
VARCHAR |
order invoice town |
Stadt der Rechnungsanschrift |
o_invoice_country |
VARCHAR |
order invoice country |
Land der Rechnungsanschrift (ISO2 Code) |
o_delivery_postal_code |
VARCHAR |
order delivery postal code |
Postleitzahl der Lieferanschrift |
o_delivery_town |
VARCHAR |
order delivery town |
Stadt der Lieferanschrift |
o_delivery_country |
VARCHAR |
order delivery country |
Land der Lieferanschrift (ISO2 Code) |
o_shipping_profile |
INTEGER NOT NULL |
order shipping profile |
ID des Versandprofil des Auftrags |
o_parcel_service |
INTEGER NOT NULL |
order parcel service |
Versanddienstleister des Auftrags |
smw_id |
VARCHAR |
stock management warehouse id |
ID des Lagers, das dem Auftrag zugeordnet ist |
smw_country |
VARCHAR |
stock management warehouse country |
Land des Lagers, das dem Auftrag zugeordnet ist |
smw_postal_code |
VARCHAR |
stock management warehouse postal code |
Postleitzahl des Lagers, das dem Auftrag zugeordnet ist |
o_entry_at |
TIMESTAMPTZ NOT NULL |
order entry at |
Zeitstempel des Auftragseingangs. Dieses Datum ist über die Benutzeroberfläche im Backend editierbar. Sofern keine Änderung vorgenommen wurde, ist dieses Feld mit dem bereits bestehenden Feld o_created_at identisch (Zeitpunkt der Speicherung des Auftrags in der Datenbank). |
o_created_at |
TIMESTAMPTZ NOT NULL |
order created at |
Zeitstempel der Auftragsanlage |
o_goods_issue_at |
TIMESTAMPTZ |
order goods issue at |
Zeitstempel der Buchung des Warenausgangs |
o_paid_at |
TIMESTAMPTZ |
order paid at |
Zeitstempel der Buchung des Zahlungseingangs |
o_updated_at |
TIMESTAMPTZ NOT NULL |
order updated at |
Zeitstempel der letzten Aktualisierung des Auftrags |