API - Endpunkte - Items

2021-02-18 @Unknown user Diese Doku ist jetzt nicht mehr öffentlich einsehbar! Die Api Beschreibung ist nicht mehr aktuell!

Hier werden alle API-Calls rund um die Artikel beschrieben.

Die WSDL kann direkt über den TRADEMAN aufgerufen werden: https://<trademanURL>/api/soap/item/wsdl

Inhaltsverzeichnis

getItems

Abfragen von Artikeln mit möglichen Filtern

itemId: Artikelnummer 1 des Artikels

Aufruf:

Hier ein Beispiel für eine SOAP-Anfrage mit Artikelnummer 1000

XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:item="http://item.soap.poe.de/">
   <soapenv:Header/>
   <soapenv:Body>
      <item:GetItem>
         <item:itemId>1000</item:itemId>
         <!--Optional:-->
         <item:officialSeal>?</item:officialSeal>
      </item:GetItem>
   </soapenv:Body>
</soapenv:Envelope>

Antwort:

Bei einer erfolgreichen Anfrage könnte dieses Ergebnis wieder gegeben werden

XML

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://item.soap.poe.de/">
   <SOAP-ENV:Body>
      <ns1:GetItemResponse>
         <itemid>1000</itemid>
         <itemid2>810812001000</itemid2>
         <itemid3>810812001000</itemid3>
         <itemid4/>
         <itemid5/>
         <itemname>Tisch Palor</itemname>
         <itemname2>Text</itemname2>
         <discountable>true</discountable>
         <productgroup>8</productgroup>
         <supplier>70002</supplier>
         <manufacturer>70002</manufacturer>
         <invisible>false</invisible>
         <nostock>false</nostock>
         <creation_date>00000000000000</creation_date>
         <youth_protection>false</youth_protection>
         <minimum_age>18</minimum_age>
         <rrp>14900</rrp>
         <notorderable>false</notorderable>
         <discontinued>true</discontinued>
         <negative>true</negative>
         <toweight>true</toweight>
         <onlyreturn>false</onlyreturn>
         <notsellable>false</notsellable>
         <price_net/>
         <price_gross/>
         <purchaseprice/>
         <purchaseitem/>
         <receiptinfo/>
         <additionalprinttexts/>
         <shippinglock/>
         <pricerequest/>
         <extraexport1/>
         <noinvoicerelevance/>
         <fixamount/>
         <foceadditionaltext/>
      </ns1:GetItemResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Wenn z.B. der Artikel nicht zugeordnet werden konnte, kommt dieser Fehler:

XML

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://item.soap.poe.de/">
   <SOAP-ENV:Body>
      <ns1:GetItemResponse/>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

getSearchItem

Abfragen von Artikeln mit möglichen Filtern.

Hier eine Vorlage mit allen möglichen Filtern für die Suche nach Artikeln

XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:item="http://item.soap.poe.de/">
   <soapenv:Header/>
   <soapenv:Body>
      <item:SearchItem>
         <!--Optional:-->
         <item:itemid>?</item:itemid>
         <!--Optional:-->
         <item:itemid2>?</item:itemid2>
         <!--Optional:-->
         <item:itemid3>?</item:itemid3>
         <!--Optional:-->
         <item:itemid4>?</item:itemid4>
         <!--Optional:-->
         <item:itemid5>?</item:itemid5>
         <!--Optional:-->
         <item:itemname>?</item:itemname>
         <!--Optional:-->
         <item:itemname2>?</item:itemname2>
         <!--Optional:-->
         <item:productgroup>?</item:productgroup>
         <!--Optional:-->
         <item:supplier>?</item:supplier>
         <!--Optional:-->
         <item:manufacturer>?</item:manufacturer>
         <!--Optional:-->
         <item:notorderable>?</item:notorderable>
         <!--Optional:-->
         <item:discontinued>?</item:discontinued>
         <!--Optional:-->
         <item:negative>?</item:negative>
         <!--Optional:-->
         <item:toweight>?</item:toweight>
         <!--Optional:-->
         <item:onlyreturn>?</item:onlyreturn>
         <!--Optional:-->
         <item:notsellable>?</item:notsellable>
         <!--Optional:-->
         <item:purchaseitem>?</item:purchaseitem>
         <!--Optional:-->
         <item:receiptinfo>?</item:receiptinfo>
         <!--Optional:-->
         <item:shippinglock>?</item:shippinglock>
         <!--Optional:-->
         <item:pricerequest>?</item:pricerequest>
         <!--Optional:-->
         <item:identconstraint>?</item:identconstraint>
         <!--Optional:-->
         <item:noinvoicerelevance>?</item:noinvoicerelevance>
         <!--Optional:-->
         <item:extraexport1>?</item:extraexport1>
         <!--Optional:-->
         <item:fixamount>?</item:fixamount>
         <!--Optional:-->
         <item:foceadditionaltext>?</item:foceadditionaltext>
         <!--Optional:-->
         <item:officialSeal>?</item:officialSeal>
      </item:SearchItem>
   </soapenv:Body>
</soapenv:Envelope>

getProductGroupItems

Abfragen von Artikeln an einer Warengruppe mit möglichen Filtern:

productGroupId: Warengruppe eines Artikels

Aufruf:

Hier ein Beispiel für eine SOAP-Anfrage zum Abfragen der Artikel mit einer bestimmten Warengruppe:

XML

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:item="http://item.soap.poe.de/">
   <soapenv:Header/>
   <soapenv:Body>
      <item:GetProductGroupItems>
         <item:productGroupId>?</item:productGroupId>
         <!--Optional:-->
         <item:officialSeal>?</item:officialSeal>
      </item:GetProductGroupItems>
   </soapenv:Body>
</soapenv:Envelope>

Anmerkungen

Mit dem "officialSeal" können die Anfragen weiter eingegrenzt werden. So ist dies mindestens 4 Stellig (mit führenden Nullen) anzugeben, 2 stellen für den TRADMEMAN (bei Kaskadierten Systemen) gefolgt von 2 Stellen für die Filiale
- Z.B. wenn die "0302" dort angegeben wird, so ist die Anfrage im TRADEMAN mit der ID 3 mit der Filiale 2 betrachten