Schukat API – Detaillierte Schnittstellenbeschreibung & technische Referenz
Die Preis- und Verfügbarkeits-API von Schukat ist eine auf SOAP basierende Webservice-Schnittstelle. Über diesen Service können externe Anwendungen Informationen zu Preis- und Bestandsdaten bei Schukat in Echtzeit abrufen. Alle Anfragen müssen über die individuellen Zugangsdaten authentifiziert werden.
Anfragen
Die URL des Webservice lautet:https://api.schukat.com/schukat/schukat_ws.nsf/schukat-ws?
OpenWebService
Der HTTP-POST-Request der SOAP-Anfrage/Nachricht enthält den Autorisierungsanforderungs-Header mit Benutzername und Kennwort, während sich die eigentlichen Nutzdaten der Anfrage im Body des sogenannten Envelope-Elements befinden müssen. Nachfolgend aufgelistet finden Sie die notwendigen Bestandteile des Body-Elementes einer SOAP-Nachricht:
| Parameter | Werte | Beschreibung | ||
Der API-Key aus Ihrer Registrierung. | Der API-Key aus Ihrer Registrierung. | |||
| REQUEST |
| Suchschlüssel (MPN/SKU) mit optionalen Angaben wie Menge und Hersteller. Es können max. 25 Suchschlüssel, durch das Pipe-Symbol "|" getrennt, pro Anfrage übermittelt werden. | ||
|
| Ausgabeformat für das Suchergebnis. | ||
|
| Sprache (Datenblatt, Artikelbeschreibung) |
Beispiel für eine SOAP-Anfrage mit mehreren SKUs/MPNs
Rückgabewerte
Die Schukat Preis- und Bestands-API liefert Ihnen zum Beispiel folgende Informationen in der Rückantwort:
| Element | XML-Tag |
| Artikel number | SKU |
| Short description of article | DESC |
| Product URL | PURL |
| Datasheet URL | DS |
| Manufacturer | MFR |
| Manufacturer part number | MPN |
| Mindestbestellmenge | MOQ |
| In stock | INST |
| Current stock | STOCK |
| Availability code | AVC |
| Availability information | AVM |
| Packaging Unit | PU |
| Price unit | PRU |
| Replenishment time in weeks | DYTM |
| Next goods receipt | NGR |
| RoHS complaint | ROHS |
| Quantity | QUAx |
| Price grade | PRBxx |
Alle Daten befinden sich im Body-Element des SOAP-Struktur.
HTTP-Statuscode
Bitte beachten Sie, dass alle gültigen Antworten im XML- und JSON-Format einen HTTP-Statuscode von 200 tragen. Das bedeutet, dass ungültige, missgebildete oder ratenbeschränkte SOAP-Anfragen immer noch einen HTTP-Statuscode von 200 zurückgeben können. In JSON- und XML-Antworten zeigen die Felder ERRC, ERRM, SUCC und PERR, ob eine Anfrage gut geformt und gültig ist. Das Element NORF der Ausgabestruktur liefert zusätzlich die Anzahl der gefunden Ergebnisse zu jeder übermittelten Materialsuche.
Testen der API-Schnittstelle per SOAP-Tool
Für einen unkomplizierten Test der Schnittstelle mit eigenen Zugangsdaten empfehlen wir Ihnen den Einsatz von SoapUI oder POSTMAN in der aktuellsten Version. Mit Hilfe der Webservice-Tools und unserer WSDL-Datei können Sie ohne großen Zeitaufwand erste Test-Anfragen auf die Schnittstelle umsetzen, ohne dafür eigenen Programmcode erstellen zu müssen. Die WSDL-Datei stellen wir Ihnen gern auf Anfrage zur Verfügung.
Für Fragen rund um das Thema Web-API wenden Sie sich bitte per E-Mail (api-service@schukat.com) an unser Support-Team.