business/deals/purchase Methoden

Last modified: 14. Mai 2024

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*
  • customerNumber: Kundennummer des Einkäufers beim Verkäufers

* 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

https://api.itscope.com/2.1/business/deals/search/purchase/cartId%3D611-ac7b-42c2-a3b6-2434812ede75/deal.xml

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.
Was this article helpful?
Dislike 0
Views: 108