IWS/API IWS3/getDistributors
Aus ITscope GmbH - Wissensbasis
Inhaltsverzeichnis |
1 Beschreibung
getDistributors liefert Distributoren und zugehörige Accounts im XML-Format. Verwendet wird die Methode, um Metadaten zu Lieferanten zu erhalten, die in der ITscope-Datenbank gelistet sind. Zu jedem Lieferanten werden alle Lieferantenkonten ausgegeben, die für den IWS-Key registriert sind.
Erklärung der Daten:
- its:supplierAccounts: Lieferantenkonten, die im MV für den Distributor angelegt wurden (Kundennummer, Login und Passwort sind verschlüsselt)
- its:supplierAccounts/its:localPricefileLstRead: Zeitpunkt, an dem die individuelle Preisliste zum letzten Mal eingelesen wurde - der Zeitpunkt kann über its:schedule eingesehen werden
- its3:pricelistx/@entryDate: Zeitpunkt, an dem die Standardliste zum letzten Mal eingelesen wurde (im Rahmen des ITscope-Durchlaufs)
2 Ähnliche Methoden
- keine
3 Parameter
3.1 Allgemeine Parameter
Die folgenden Parameter können für jede Methode verwendet werden.
| Name des Parameters | Beschreibung | Benötigt | Zulässige Werte |
|---|---|---|---|
| validate | Ist validate = true, wird die Anfrage nicht ausgeführt, sondern nur auf syntaktische und inhaltliche Korrektheit überprüft (z.B. ob Parameterwerte stimmen oder plausibel sind) | Optional |
|
| iwsKey | Der Webservice-Nutzungskey für ITscope-Kunden. Nur mit diesem Key können Web Service Requests ausgeführt werden. | Ja | Ihr IWS-Key, zum Beispiel: qnAGOar2dsAIo1EnThWsKA. Sie erhalten den Key bei der Registrierung als Enterprise-User bei ITscope. |
3.2 Spezielle Parameter
| Name des
Parameters | Beschreibung | Benötigt | Zulässige Werte |
|---|---|---|---|
| distributorId | Ruft die Daten des Distributor mit der distributorId ab. Wird die distributorId weggelassen, werden alle Distributoren zurückgeliefert. | Nein | Werte siehe Lieferanten |
4 Beispielaufrufe
- Beispiele für REST getDistributors REST