Artikel & Mengen
Artikelnummer, Beschreibung, Menge und abgestimmter Einheitencode.
STASTO × IHR BESCHAFFUNGSSYSTEM
Im Store auswählen.
Im ERP weiterarbeiten.
Öffnen Sie den STASTO-Katalog aus Ihrem Beschaffungssystem. Finden Sie die passenden Komponenten und übernehmen Sie den Warenkorb in Ihren Einkaufsprozess.
Ihr BeschaffungssystemKatalogsitzung starten
OCI
STASTO STOREFinden. Auswählen. Warenkorb füllen.
PneumatikArmaturen
Warenkorbrückgabe
Zurück in Ihrem EinkaufsprozessIm ERP prüfen und weiterbearbeiten
01 / PUNCHOUT
In vier Schritten vom Katalog zum Einkauf.
- 01
Im ERP starten
Starten Sie den STASTO-Katalog aus Ihrem Beschaffungssystem. Katalogzugang und Rücksprungadresse werden an den Store übergeben.
- 02
Komponenten auswählen
Suchen Sie nach Artikelnummer oder Begriff, wählen Sie über Produktbilder und grenzen Sie Varianten mit technischen Filtern ein.
- 03
Warenkorb übertragen
Starten Sie PunchOut im Warenkorb. Prüfen Sie die Übertragungsübersicht und bestätigen Sie anschließend die Rückgabe an Ihr ERP.
- 04
Einkauf fortsetzen
Prüfen Sie die übernommenen Positionen in Ihrem Beschaffungssystem und setzen Sie Ihren internen Freigabe- und Bestellprozess fort.
Die Warenkorbrückgabe allein löst noch keine Bestellung bei STASTO aus. Die weiteren Einkaufsschritte erfolgen in Ihrem Beschaffungssystem.
02 / SETUP
Alles für Ihr Integrationsteam.
Katalog-Einstieg
POST
https://www.stasto.eu/oci/catalogProduktiv-Endpunkt. Stimmen Sie vor Ihrem Integrationstest eine separate Testumgebung mit STASTO ab.
| Parameter | Bedeutung |
|---|---|
HOOK_URL | Erforderlich. Die von Ihrem Beschaffungssystem für die aktuelle Sitzung bereitgestellte Rücksprungadresse. |
username | Der abgestimmte Benutzerlogin für den Katalog. Bei Anmeldung über Parameter erforderlich. |
password | Das Passwort dieses Katalogzugangs. Bei Anmeldung über Parameter erforderlich. |
Aufrufbeispiel · POST
Beispiel mit Platzhaltern. Übergeben Sie die Werte URL-kodiert im Request-Body und ersetzen Sie alle Platzhalter in Ihrer Integrationskonfiguration.
POST /oci/catalog HTTP/1.1
Host: www.stasto.eu
Content-Type: application/x-www-form-urlencoded
HOOK_URL=https%3A%2F%2Ferp.example%2Foci%2Freturn&username=STASTO_LOGIN&password=STASTO_PASSWORDAlternative Anmeldung und Sitzungsverhalten
HTTP Basic Authentication wird ebenfalls unterstützt. Lassen Sie dabei die Parameter username und password weg und übergeben Sie den Zugang im Authorization-Header. HOOK_URL bleibt erforderlich.
GET wird für kompatible Systeme akzeptiert. Bevorzugen Sie HTTPS mit POST, damit Zugangsdaten nicht im URL-Verlauf und in URL-Protokollen erscheinen. Nach der Anmeldung wird der Browser auf /shop weitergeleitet; behalten Sie dieselbe Browsersitzung für die Warenkorbrückgabe bei.
03 / DATA
Was in Ihrem ERP ankommt.
Das Rückgabeformular sendet Positionsdaten per Browser-POST an Ihre HOOK_URL. Die Felder werden je Warenkorbposition ab 1 nummeriert. Die Tabelle zeigt die Standardzuordnung; abgestimmte Kundeneinstellungen können einzelne Werte überschreiben.
Preise & Lieferzeit
Einzelpreis nach Rabatt, Währung und Lieferzeit in ganzen Tagen.
Klassifikation & Kundendaten
Warengruppe, optionale Kundenartikelnummer und Produktbild.
OCI-Feldreferenz
| Feld | Standardinhalt |
|---|---|
NEW_ITEM-VENDORMAT[1] | STASTO-Artikelnummer. |
NEW_ITEM-DESCRIPTION[1] | Produktname. |
NEW_ITEM-LONGTEXT_1:132[] | Verkaufsbeschreibung, ersatzweise der Produktname. |
NEW_ITEM-QUANTITY[1] | Menge der Warenkorbposition. |
NEW_ITEM-UNIT[1] | Kundenspezifische Einheitenzuordnung, sonst die gepflegte OCI-Einheit; Rückfallwert C62. Strikte Prüfungen können eine ungültige Zuordnung blockieren. |
NEW_ITEM-PRICE[1] | Einzelpreis aus dem Warenkorb nach Rabatt. |
NEW_ITEM-PRICEUNIT[1] | 1 (Preis je Einheit). |
NEW_ITEM-CURRENCY[1] | Warenkorbwährung, zum Beispiel EUR. |
NEW_ITEM-VENDOR[1] | Name der verkaufenden STASTO-Gesellschaft. |
NEW_ITEM-LEADTIME[1] | Lieferzeit in ganzen Tagen, aufgerundet. |
NEW_ITEM-MATGROUP[1] | Konfigurierter eClass-Code oder Kategorie-Rückfallwert. Siehe die Klassifikationshinweise unten. |
NEW_ITEM_ATTACHMENT[1] | Absolute URL des Produktbilds, sofern ein Bild gepflegt ist. |
NEW_ITEM_ATTACHMENT_TITLE[1] | Produkttitel zum Bild. |
NEW_ITEM-CUST_FIELD1[1] … NEW_ITEM-CUST_FIELD4[1] | Standardmäßig leer; feste kundenspezifische Werte sind konfigurierbar. |
NEW_ITEM-CUST_FIELD5[1] | Kundenartikelnummer, falls gepflegt, oder ein konfigurierter Festwert. |
Das Rückgabeformular sendet außerdem ~OkCode=ADDI, ~target=_top, ~ForceTarget=yes und ~caller=CTLG. Stimmen Sie diese Steuerfelder bei der Abnahme mit Ihrem Empfänger ab.
eClass, Warengruppen und Einheitenzuordnung
eClass 7.1 ist der Standard. eClass 8.1 setzt das entsprechende Feld und gepflegte Daten voraus. Die erste zugeordnete Website-Kategorie liefert die Klassifikation; Trennstriche werden aus dem Code entfernt.
Fehlt der gewählte Code, wird die konfigurierte Rückfallversion geprüft, danach die interne Kategorie oder General verwendet. Bei deaktivierter Klassifikation wird General gesendet. Stimmen Sie ab, welche Werte Ihr ERP akzeptiert.
Einheitencodes und feste Feldwerte werden für das Kundenunternehmen konfiguriert. Das Lieferantenfeld bezeichnet immer die verkaufende Gesellschaft. Produktbilder werden als Links übertragen; die Warenkorbrückgabe enthält kein Dokumentenpaket.
04 / CHECK
Einen vollständigen Ablauf prüfen.
Verwenden Sie vor der Freigabe für Ihre Einkäufer eine abgestimmte Testumgebung und einen kleinen Beispielwarenkorb.
- Katalog aus dem ERP öffnen und den richtigen Kundenkontext sowie die Preise prüfen.
- Zwei unterschiedliche Artikel auswählen und mindestens eine Menge ändern.
- Artikelnummern, Menge, Einheit, Währung, Preis und Lieferzeit in der Übertragungsübersicht prüfen.
- Rückgabe bestätigen und alle übernommenen Positionen im ERP vergleichen, einschließlich Klassifikation und Kundenfeldern.
Im Warenkorb ist die Option zum Leeren standardmäßig aktiviert. Das Leeren erfolgt beim Erstellen der Übertragungsübersicht, bevor das ERP den Empfang bestätigt. Berücksichtigen Sie dies beim Test eines erneuten Übertragungsversuchs.
05 / SUPPORT
Fragen zur Verbindung?
Nennen Sie bei einer Supportanfrage Ihr Beschaffungssystem, den Zeitpunkt des Versuchs und die Fehlermeldung. Teilen Sie Zugangsdaten nur über einen abgestimmten sicheren Kanal.
Anbindung besprechenHOOK_URL fehlt – was bedeutet das?
Ihr ERP muss die Rücksprungadresse beim Öffnen von /oci/catalog mitgeben. Prüfen Sie die exakte Großschreibung HOOK_URL und die URL-Kodierung.
Die Anmeldung scheitert. Was ist zu prüfen?
Prüfen Sie den abgestimmten Kataloglogin, das Passwort und die Anmeldemethode. Ein erfolgreicher HTTP-Status allein bestätigt keine erfolgreiche Anmeldung: Prüfen Sie, ob der Browser den Shop erreicht.
Im Warenkorb fehlt die PunchOut-Schaltfläche.
Starten Sie die Sitzung aus Ihrem ERP über /oci/catalog und fügen Sie einen Artikel hinzu. Ein direkter Shop-Aufruf hinterlegt keine PunchOut-Rücksprungadresse. Wechseln Sie nicht die Browsersitzung.
Der Warenkorb kommt nicht im ERP an.
Bestätigen Sie den zweiten Übertragungsschritt in der Übersicht. Prüfen Sie, ob die Rücksprungadresse den Formular-POST annimmt, ob die Sitzung abgelaufen ist und ob der Browser eingebettete Fenster einschränkt. Wurde der Warenkorb geleert, prüfen Sie vor einem erneuten Versuch zuerst das ERP.
Eine Position wird wegen Einheit oder Warengruppe abgelehnt.
Vergleichen Sie die übertragenen Werte UNIT und MATGROUP mit den im ERP erlaubten Werten. Stimmen Sie Einheitenzuordnung, eClass-Version und Rückfallwerte mit STASTO ab.
Gilt diese Anleitung auch für cXML?
Diese Anleitung beschreibt die implementierte OCI-Schnittstelle. Besprechen Sie andere Protokolle oder systemspezifische Anforderungen vor der Einrichtung mit STASTO.
Lernen Sie den Store kennen.Zum Store-LeitfadenSortiment ansehen