Formatbeschreibung für Deals (Bestellungen)

Last modified: 9. Oktober 2020

Die Daten für Deals (Bestellungen) stehen in den Ausgabeformaten XML und JSON zur Verfügung.

deal

Detailinformationen zu einem Auftrag, Bestellung

NamePflichtfeldDatentypBeschreibung
orderId JaString (250)Eindeutiger ITscope Key der Bestellung
ownOrderId String (250)Eigene Bestellnummer
customerOrderId String (250)Bestellnummer des Endkunden
cartIdJaString (250)Warenkorb-ID des Deals, in dem sich die Bestellung befindetnur in API 2.1 verfügbar
statusJaString (255)Auftragsstatus in dem sich die Bestellung befindet, siehe Punkt 8 Auftragsstatus Übersicht in diesem Beitrag weiter unten
statusMessageJa String (8192)zusätzliche textuelle Auftragsstatus Hinweise, teilweise direkt vom Verkäufer übermittelt.
statusDateJaDateLetztes Änderungsdatum der Bestellung
archivedJaBooleanGibt an, ob die Bestellung archiviert wurdenur in API 2.1 verfügbar
deeplinkJaString (2048)Deeplink auf die ITscope.com Plattformnur in API 2.1 verfügbar
vendor vendor (255)Referenz auf den Verkäufer (interner Key, n:1)
orders List<order>Details zur Liste der OpenTrans 2.1 ORDER Dokumente
orderresponses List<orderresponse>Details zur Liste der OpenTrans 2.1 ORDERRESPONSE Dokumente
dispatchnotifications List<dispatchnotification>Details zur Liste der OpenTrans 2.1 DISPATCHNOTIFICATION Dokumente
invoices List<invoice>Details zur Liste der OpenTrans 2.1 INVOICE Dokumente

vendor

Verkäuferdaten zu einem Auftrag, Bestellung

NamePflichtfeldDatentypBeschreibung
name JaString (255)Name der Firma
supplierJa supplierReferenz auf das Lieferanten-Objekt; nur vorhanden, wenn diese Firma ein Lieferant ist

supplier

Lieferant einer Bezugsquelle

NamePflichtfeldDatentypBeschreibung
idJaLongEindeutiger Key
nameJaString (255)Bezeichner des Lieferanten
deeplinkJaString (2048)URL, Link auf den Lieferanten innerhalb der ITscope Plattform
customerAccountNumber String (255)Kundennummer im Falle einer Partnerschaft. Kann als Filter verwendet werden, um zu ermitteln ob zu diesem Lieferanten eine Parnerschaft existiert

orders

Details zur Liste der OpenTrans 2.1 ORDER Dokumente:

NamePflichtfeldDatentypBeschreibung
transactionId String (36)ITscope TransaktionsId
lastUpdate DateDatum des letzten Updates des Dokuments
documentUrl String (255)API Business Dokumente URL für den Download des Dokuments. Ist keine URL vorhanden,  hat diese Transaktion kein ORDER Dokument.

orderresponses

Details zur Liste der OpenTrans 2.1 ORDERRESPONSE Dokumente.

NamePflichtfeldDatentypBeschreibung
transactionId String (36)ITscope TransaktionsId
lastUpdate DateDatum des letzten Updates des Dokuments
documentUrl String (255)API Business Dokumente URL für den Download des Dokuments. Ist keine URL vorhanden,  hat diese Transaktion kein ORDERRESPONSE Dokument, z.B. weil die Transaktion von Hand über das Verkaufsboard betätigt wurde.

dispatchnotifications

Details zur Liste der OpenTrans 2.1 DISPATCHNOTIFICATION Dokumente:

NamePflichtfeldDatentypBeschreibung
transactionId String (36)ITscope TransaktionsId
lastUpdate DateDatum des letzten Updates des Dokuments
documentUrl String (255)API Business Dokumente URL für den Download des Dokuments. Ist keine URL vorhanden hat diese Transaktion kein DISPATCHNOTIFICATION Dokument, z.B. weil die Transaktion von Hand über das Verkaufsboard betätigt wurde.

invoices

Details zur Liste der OpenTrans 2.1 INVOICE Dokumente

NamePflichtfeldDatentypBeschreibung
transactionId String (36)ITscope TransaktionsId
lastUpdate DateDatum des letzten Updates des Dokuments
documentUrl String (255)API Business Dokumente URL für den Download des Dokuments. Ist keine URL vorhanden,  hat diese Transaktion kein INVOICE Dokument, z.B. weil die Transaktion von Hand über das Verkaufsboard betätigt wurde.

Bestellstatus/Auftragsstatus Übersicht

API StatusPlattform StatusBeschreibung
PREPARINGVorschlagdie Bestellung liegt als Bestellvorschlag vor, nur der Besteller sieht diese Bestellung
TRANSMITTINGWird gerade versandtdie Bestellung wird gerade technisch an das System des Verkäufer übermittelt. Plattformstatus
SENTAbgeschicktdie Bestellung wurde zum Verkäufer gesendet
ARRIVEDAngekommendie Bestellung ist beim Verkäufer angekommen
ARRIVED_WARNINGAngekommen mit Warnungdie Bestellung ist beim Verkäufer angekommen, jedoch gab es bei der Bestätigung auf der Seite des Verkäufers einige Warnhinweise. Diese Hinweise stehen im Feld statusMessagez.B. einige Ihrer bestellten Positionen wurden storniert oder liegen auf Backorder.z.B. x Ihrer bestellten Positionen wurden storniert.oder ein konkreter Hinweis vom Verkäufer
PROCESSINGAuftrag bestätigtdie Bestellung wurde vom Verkäufer bestätigt
ADVISEDIm Versanddie Besellung wurde vom Verkäufer versendet
INVOICEDBerechnetdie Bestellung wurde vom Verkäufer berechnet
CANCELEDAbgelehntdie komplette Bestellung wurde vom Verkäufer abgelehnt oder alle Positionen in der Bestellung wurden auf Storno gesetzt
BLOCKED Gesperrtdie Bestellung wurde vom Verkäufer gesperrt, diese kann dann nur explizit vom Verkäufer wieder freigegeben werden
ERROR Fehlerdie Bestellung wurde technisch erfolgreich an das System des Verkäufers übermittelt, jedoch hat dessen System bei dem initialen Check der Bestellung einen Fehler gemeldet. Die dazugehörige Fehlermeldung steht dann dementsprechend im Feld statusMessage
Was this article helpful?
Dislike 0
Views: 75