IWS/API IWS2/productListAction SOAP

Aus ITscope GmbH - Wissensbasis

Wechseln zu: Navigation, Suche
productListAction
aktuelle Version

Inhaltsverzeichnis

1 Beschreibung

productListAction verwaltet die im MarketViewer sichtbaren Produktlisten. Die Methode kann verwendet werden, um automatisiert Produktlisten zu erzeugen, zu löschen, Produkte hinzuzufügen oder wieder zu entfernen.

Beispielanwendungen: Angebote und Bestell-Listen aus der Warenwirtschaft übernehmen, dynamische Produktlisten aus Produktexporten erstellen etc.

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
method Name der IWS-Methode, bestimmt die Funktionalität der Anfrage Nein
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
  • true
  • false (default)
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
name Produklisten Name Nein /Ja - Operation abhängig Text
listid Produklisten ID Nein /Ja - Operation abhängig Numerisch
itsPid ITscope Produktnummer Nein /Ja - Operation abhängig

Separierte Liste von Produktnummern

  • bei REST Kommasepariert
  • bei SOAP Leerzeichensepariert
operation Die Operation für die Produktliste Ja
  • query - Alle Produktlisten anzeigen
  • create - Produktliste erstellen
  • addProducts - Produkte hinzufügen
  • removeProducts - Produkte entfernen
  • clear - Produktliste leeren
  • delete - Produktliste löschen

4 Beispielaufrufe

4.1 SOAP

4.1.1 Request

Setzen der Produkte 1079047000 117313000 auf die Produktliste 541032485 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.itscope.de/IWS/2006-04-20" xmlns:ns1="http://www.itscope.de/IWS3/2008-05-01">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:productListRequest>
          <ns:operation>addProducts</ns:operation>
         <ns:listId>541032485</ns:listId>
         <ns:itsPid>1079047000 117313000</ns:itsPid>
         <ns:requestHeader>
            <ns:customerAuthentication>
              <ns:iwsKey><IhrWebserviceKey></ns:iwsKey>
           </ns:customerAuthentication>
         </ns:requestHeader>
      </ns:productListRequest>
   </soapenv:Body>
</soapenv:Envelope>

4.1.2 Response

Erfolgreiches Setzen von Produkten auf eine Produktliste. 

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns3:productListResponse xmlns:ns2="http://www.itscope.de/IWS3/2008-05-01" xmlns:ns3="http://www.itscope.de/IWS/2006-04-20">
         <ns3:responseHeader>
            <ns3:requestId>1608810984</ns3:requestId>
            <ns3:customerId><IhreITscopeKundenummer></ns3:customerId>
            <ns3:processingTime>347</ns3:processingTime>
            <ns3:serverMasterdataTimestamp>0</ns3:serverMasterdataTimestamp>
            <ns3:messageDate>2010-03-21T12:50:13.999+01:00</ns3:messageDate>
         </ns3:responseHeader>
      </ns3:productListResponse>
   </soap:Body>
</soap:Envelope>


Fehlermeldung wenn Produktliste noch nicht vorhanden ist, dann sollte diese mit create zuvor angelegt werden. 

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns3:productListResponse xmlns:ns2="http://www.itscope.de/IWS3/2008-05-01" xmlns:ns3="http://www.itscope.de/IWS/2006-04-20">
         <ns3:responseHeader>
            <ns3:requestId>1608814704</ns3:requestId>
            <ns3:customerId><IhreITscopeKundenummer></ns3:customerId>
            <ns3:processingTime>365</ns3:processingTime>
            <ns3:errors>
               <ns3:exceptionMessage>Container muß spezifiziert werden bzw. konnte nicht geladen werden.</ns3:exceptionMessage>
               <ns3:exceptionCode>103</ns3:exceptionCode>
            </ns3:errors>
            <ns3:serverMasterdataTimestamp>0</ns3:serverMasterdataTimestamp>
            <ns3:messageDate>2010-03-21T12:53:02.669+01:00</ns3:messageDate>
         </ns3:responseHeader>
      </ns3:productListResponse>
   </soap:Body>
</soap:Envelope>
Von „http://www.itscope.de/wiki/IWS/API_IWS2/productListAction_SOAP“