Diese Methoden sind für Einkaufsbestellungen
Abrufen einer Liste von gesendeten Plattform Bestellungen
Folgende Query Parameter sind möglich
- archiv
- ARCHIVED: archivierte Bestellungen
- NOTARCHIVED: nicht archivierte Bestellungen
- sort – Sortierungskriterien
- LAST_MODIFIED : Änderungsdatum absteigend
- SENT_DESC: Versanddatum absteigend
- SEND_ASC: Versanddatum aufsteigend
- SUPPLIER: nach Lieferant absteigend
- ID: nach eindeutiger ITscope Bestellungsnummer (Feld orderId) absteigend
- page
- 1..n, die Abfragen sind immer auf 50 Bestellungen pro Seite begrenzt
- lastUpdateDateFrom (nur API 2.1)
- Datumszeitraum von, im Format yyyy-MM-dd oder yyyy-MM-ddThh:mm:ss oder mit Zeitzonen yyyy-MM-ddThh:mm:ss±hh:mm
- siehe Einschränkung der Suche nach letztem Änderungsdatum einer Bestellung weiter unten in diesem Beitrag
- lastUpdateDateTo (nur API 2.1)
- Datumszeitraum bis, im Format yyyy-MM-dd oder yyyy-MM-ddThh:mm:ss oder mit Zeitzonen yyyy-MM-ddThh:mm:ss±hh:mm
- siehe Einschränkung der Suche nach letztem Änderungsdatum einer Bestellung weiter unten in diesem Beitrag
Bsp: https://api.itscope.com/2.1/business/deals/purchase/deal.xml
Eine Beschreibung der Response wird im Formatbeschreibung für Deals beschrieben.
Suche nach gesendete Plattform Bestellungen
Folgende Filter sind möglich
- keywords: Teilsuchen in orderId , ownOrderId und customerOrderId, z.B. keywords=11SRRK
- orderId (oder legacy per dealId): ITscope eindeutige Dealnummer z.B. orderId=11SRRK-150126-1136
- ownOrderId (oder legacy per ownDealId): Vom Einkäufer selbst vergebene eigene Bestellnummer, z.B. ownOrderId=54321
- customerOrderId (oder legacy per customerDealId): Die Bestellnummer des Endkunden, z.B. customerOrderId=12345
- status: Filtern nach Bestellsstatus, z.B. status=ADVISED
- cartId: Suche anhand der Warenkorb-IDs, in dem sich die Bestellungen befinden*
* nur API 2.1, siehe hier.
Folgende Query Parameter sind möglich
- archiv
- ARCHIVED: archivierte Bestellungen
- NOTARCHIVED: nicht archivierte Bestellungen
- sort – Sortierungskriterien
- LAST_MODIFIED : Änderungsdatum absteigend
- SENT_DESC: Versanddatum absteigend
- SEND_ASC: Versanddatum aufsteigend
- SUPPLIER: nach Lieferant absteigend
- ID: nach ITscope Bestellungsnummer (Feld orderId) absteigend
- page
- 1..n, die Abfragen sind immer auf 50 Bestellungen pro Seite begrenzt
- lastUpdateDateFrom (nur API 2.1)
- Datumszeitraum von, im Format yyyy-MM-dd oder yyyy-MM-ddThh:mm:ss oder mit Zeitzonen yyyy-MM-ddThh:mm:ss±hh:mm
- siehe Einschränkung der Suche nach letztem Änderungsdatum einer Bestellung weiter unten in diesem Beitrag
- lastUpdateDateTo (nur API 2.1)
- Datumszeitraum bis, im Format yyyy-MM-dd oder yyyy-MM-ddThh:mm:ss oder mit Zeitzonen yyyy-MM-ddThh:mm:ss±hh:mm
- siehe Einschränkung der Suche nach letztem Änderungsdatum einer Bestellung weiter unten in diesem Beitrag
Beispielsuche nach einer vom Einkäufer vergebenen eigenen Bestellnummer 54231
https://api.itscope.com/2.1/business/deals/search/purchase/ownOrderID%3D54231/deal.xml
Beispielsuche nach einer Endkunden Bestellnummer 12345
https://api.itscope.com/2.1/business/deals/search/purchase/customerOrderID%3D12345/deal.xml
Beispiel suche nach allen Bestellungen zu einem Warenkorb mit der Id 611e-ac7b-42c2-a3b6-2434812ede75
Eine Beschreibung der Response wird im Formatbeschreibung für Deals beschrieben.
Einschränkung der Suche nach letztem Änderungsdatum (nur API 2.1)
Die entsprechenden Requestparameter stehen erst ab der API 2.1 zur Verfügung. Die Parameter filtern auf dem Feld statusDate bei den Bestellungen, siehe Formatbeschreibung für Deals. Das Änderungsdatum gibt an, wann bei einer Bestellungen das letzte Mal eine neues Bestellantwortdokument (Transaktionsdokument) hinzugefügt wurde wie zum Beispiel eine geänderte Auftragsbestätigung oder ein Lieferschein oder Rechnung. Auch neue Bestellungen, die in dem Zeitraum angelegt wurden, werden damit gefunden
- lastUpdateDateFrom: Der Startzeitpunkt für die Einschränkung des Bestell Änderungsdatum Zeitraums im Format yyyy-MM-dd oder yyyy-MM-ddThh:mm:ss oder mit Zeitzonen yyyy-MM-ddThh:mm:ss±hh:mm. Nur wenn dieser Parameter gesetzt ist, werden die Bestellungen nach dem Änderungsdatum Zeitraum gefiltert.
- lastUpdateDateTo: Der Endzeitpunkt für die Einschränkung Bestell Änderungsdatum Zeitraums im Format yyyy-MM-dd oder yyyy-MM-ddThh:mm:ss oder mit Zeitzonen yyyy-MM-ddThh:mm:ss±hh:mm. Wird kein Wert übermittelt ist der Defaultwert das aktuelle Datum. Der Wert darf nicht weniger als lastUpdateDateFrom sein.