Was wir nachweisen wollen
Eine erfolgreiche Übertragung im Testshop ist der Anfang. Der Nachweis entsteht im Einkaufssystem: die erwarteten Artikel, Mengen, Preise, Preiseinheiten und Währungen stehen nach dem Neuladen im richtigen YourProcure-Warenkorb.
Die Produkte und Preise sind feste Testdaten. Fehlerfälle verändern gezielt genau ein Feld oder die Struktur der Rückgabe. Dadurch lässt sich ein Problem reproduzieren und von einer Änderung im echten Lieferantenkatalog trennen.
Nettovergleich ohne Steuern, Versand oder Rabatte. Mengen und Preise werden als Zeichenketten mit Dezimalpunkt übertragen; Preisbasis und Währungsrundung müssen in YourProcure vereinbart sein.
Der echte Rundlauf
Playwright kann dieselben Schritte aus eurem Arbeits-Agenten automatisieren. Der Testshop allein kann keine YourProcure-Abnahme bestätigen. Direkte Parsertests ergänzen den Browserrundlauf.
Das passende Profil für eure Anbindung
Für eine neue YourProcure-Anbindung mit dem Profil 4 oder 5 beginnen. Profil 2 und 3 helfen bei älteren Lieferantenformaten. Profil 1 ist eine experimentelle Minimalausgabe und kein nachgewiesener OCI-1-Standard.
| Profil | Was der Simulator bereitstellt | MATNR / VENDORMAT / PRICEUNIT | Profiladresse |
|---|---|---|---|
| 1.0 · experimentell | Nur DESCRIPTION, QUANTITY, UNIT, PRICE, CURRENCY, PRICEUNIT und VENDORMAT. Kein Langtext, keine Herstellerreferenz, keine Zusatzfunktion. | nicht enthalten / 22 / 9 Eigene Testannahmen aus 2B. | /oci/1/setup |
| 2.0 · SAP 2B-Teilprofil | Ausgewählte HTML-Felder einschließlich Langtext und Herstellerreferenzen. DETAIL und VALIDATE; bei diesen Funktionen keine QUANTITY-Aufrufanforderung. Keine EXT_SCHEMA-/EXT_CATEGORY-Felder. | 18 / 22 / 9 | /oci/2/setup |
| 3.0 · HTML-Teilprofil | Ausgewählte HTML-Felder einschließlich der dokumentierten CLASS-Felder. DETAIL und VALIDATE. In diesem Teilprofil keine BACKGROUND_SEARCH-Funktion. | 18 / 40 / 9 | /oci/3/setup |
| 4.0 · HTML-Teilprofil | Ausgewählte HTML-Rückgabe. DETAIL, VALIDATE und BACKGROUND_SEARCH. | 40 / 40 / 5 | /oci/4/setup |
| 5.0 · erweitertes Teilprofil | HTML-Grundlage wie Profil 4; zusätzlich DOWNLOADJSON für feste Voll-/Delta-Daten und QUANTITYCHECK. | 40 / 40 / 5 HTML-Feldgrenzen; JSON hat ein eigenes Schema. | /oci/5/setup |
Die Profiladresse in YourProcure verwenden
Beispiel für Profil 4: https://oci-test.teamstube.de/oci/4/setup. Beim Betrieb unter dem Portalpfad lautet das Beispiel https://portal.teamstube.de/oci-test/oci/4/setup. Verwendet die tatsächlich im Installationsbericht angegebene Basisadresse plus die gewünschte Profiladresse.
In YourProcure einen Testkatalog je benötigtem Profil anlegen oder die Profiladresse gezielt umstellen. OCI_VERSION=4.0 zur Adresse /oci/4/setup senden. Testzugang und die zur Laufzeit erzeugte HOOK_URL bleiben Bestandteile des Aufrufs.
Technische Grundlagen: SAP OCI 2.0B, 11.07.2000 (Spiegel) · SAP OCI 3.0, 23.11.2001 (Spiegel) · SAP OCI 4.0 · SAP OCI 5.0. Die Vergleichstabelle beschreibt die Auswahl dieses Simulators und ist keine vollständige Versionsgeschichte.
28 Testfälle zum Nachvollziehen
Jeder Fall zeigt seine gültigen Versionsprofile, das Testziel, feste Produkte, rohe Rückgabedaten und die Prüferwartung. Zum Lesen aufklappen; über den Versionsfilter die für eure Anbindung passenden Fälle auswählen.
Produkte mit einem konkreten Testzweck
Alle Namen, Artikelkennungen und Angaben sind frei erfunden. Die Kennung in VENDORMAT ist die Lieferantenartikelnummer; EXT_PRODUCT_ID identifiziert den Artikel im Testkatalog. Eine Buyer-Materialnummer wird nicht erfunden.
| Artikel | Einheit | Preis / Basis | Was er prüft |
|---|
10 Blatt × 19,900 EUR ÷ 100 = 1,990 EUR
Ein Schachtelinhalt ist etwas anderes als die Preiseinheit: 2 Schachteln Papier zu 4,990 EUR ergeben 9,980 EUR, auch wenn jede Schachtel 500 Blatt enthält. EA, BX und MTR sind Testcodes; das Mapping auf eure YourProcure-Einheiten muss einmal abgestimmt werden.
Die gemeinsamen HTML-Rückgabefelder
Die gewöhnlichen Positionsfelder heißen NEW_ITEM-FELD[n]. Der Index beginnt in den normalen Fixtures bei 1. Alle Feldwerte werden als Text übertragen. Welche zusätzlichen Felder ausgegeben werden und welche Grenzen gelten, richtet sich nach dem gewählten Profil.
| OCI-Feld | In Teststube | Prüfpunkt |
|---|---|---|
DESCRIPTION[n] | Kurzbeschreibung | 40 Zeichen in den gewählten Profilen; bei Profil 1 eine eigene Testannahme. Ab Profil 2 alternativ eine bekannte Buyer-Materialnummer in MATNR. |
QUANTITY[n] | Menge, z. B. 2.000 | Im definierten Kernprofil stets erforderlich; keine Tausendertrennzeichen. |
UNIT[n] | EA, BX oder MTR | Erforderlich, wenn MATNR nicht gesetzt ist; Mapping vereinbaren. |
PRICE[n] / PRICEUNIT[n] | Preis je Preisbasis | 19.900 je 100 ist ein anderer Stückpreis als 19.900 je 1. Leere Preiseinheit bedeutet 1. |
CURRENCY[n] | EUR | Erforderlich, wenn PRICE gefüllt ist. |
VENDORMAT[n] | TS-001 usw. | Artikelnummer des Lieferanten; nicht in MATNR schreiben. |
EXT_PRODUCT_ID[n] | Katalogkennung des Artikels | Eindeutige Referenz für den externen Katalog; im minimalen Profil 1 nicht enthalten. |
NEW_ITEM-LONGTEXT_n:132[] | Vollständige Beschreibung | Sonderform des Feldnamens ab Profil 2; im minimalen Profil 1 nicht enthalten. |
MANUFACTCODE[n] / MANUFACTMAT[n] | TSLAB / M-TS-001 usw. | Synthetische Herstellerreferenzen ab Profil 2, getrennt von der Lieferantenkennung. |
Quelle: SAP Open Catalog Interface 4.0, Abschnitte 3 und 4. Diese Seite fasst die für die Fixtures relevanten Regeln zusammen; sie ersetzt die Spezifikation nicht.
Den Katalog in YourProcure anbinden
Nach der Installation enthält der erzeugte Installationsbericht die Katalogadresse und die persönlichen Testzugangsdaten. Die Katalogadresse wird als Lieferantenkatalog in eurem QS-System hinterlegt.
| Aufrufparameter | Wert / Herkunft | Zweck |
|---|---|---|
USERNAME / PASSWORD | Aus dem Installationsbericht | Separater Testshop-Zugang; vorzugsweise per POST senden. |
HOOK_URL | Zur Laufzeit aus YourProcure | Rücksprungadresse für genau diese Sitzung. Der Browser sendet die Artikel dorthin. |
OCI_VERSION | 1.0 bis 5.0, passend zur Profiladresse | Informative Versionsangabe. Das serverseitig gewählte Profil bestimmt die Feldausgabe. Ein Versionswert allein bedeutet keine vollständige Normkonformität. |
http_content_charset | UTF-8 für die ersten Tests | Vereinbarte Zeichencodierung für Aufruf und Rückgabe. |
returntarget | Von YourProcure, passend zum Aufruf | Ziel für die Formularrückgabe, etwa ursprüngliches Fenster oder übergeordneten Frame. |
Die Installation stellt den Lieferantensimulator bereit. Die Katalogkonfiguration und der Testbenutzer müssen einmal in YourProcure angelegt werden; dafür braucht es eure vorhandenen Anbindungsrechte. Erlaubte Rücksprungziele müssen die QS-Adressen von YourProcure enthalten.
OCI 1–5: ausgewählte Testprofile
OCI 1–5 · HTML-Rückgabe
Ein Testablauf von Katalogaufruf über Artikelauswahl bis zur Formularrückgabe. Die 28 Fälle prüfen positive Rückgaben, kontrollierte Fehlerdaten und ausgewählte Feldgrenzen. Jeder Fall ist den passenden Profilen zugeordnet.
Die fehlerhaften Werte werden absichtlich unverändert ausgegeben. Der Testshop repariert keine falschen Mengen, Feldnamen oder Preise.
OCI5 · Definiertes Funktionsprofil
JSON-Voll- und Deltaimport mit festen Fixtures sowie Mengencheck. Die Funktionen prüfen, ob YourProcure die angebotenen Daten und Änderungen nach dem vereinbarten Profil verarbeitet.
Kein Versprechen vollständiger OCI5-Konformität. Secure OCI ist nicht enthalten. Andere OCI5-Funktionen müssen gesondert bewertet werden.
Für die Abnahme zählt das Ergebnis im Einkaufssystem. Die JSON-Datei muss importiert sein, nicht nur heruntergeladen. Beim Delta sind geänderte, gelöschte und neue Artikel getrennt zu prüfen. Beim Mengencheck muss das Einkaufssystem die simulierte verfügbare Menge fachlich richtig behandeln.
Drei zusätzliche OCI5-Prüfabläufe
Diese Import- und Mengenprüfungen ergänzen die 28 HTML-Fälle und gelten ausschließlich für das OCI-5-Teilprofil. Sie sind ausführbar, wenn YourProcure die jeweiligen Funktionen unterstützt. SCENARIO ist ein eigener Teststube-Parameter zur Auswahl fester Datenstände.
J-01Vollimport über drei SeitenOCI5
Testziel und Schritte
- Für den Testkatalog einen leeren Importbestand vorbereiten.
FUNCTION=DOWNLOADJSON,SCENARIO=full,PAGESIZE=5,REQUESTEDPAGE=1aufrufen.- Alle drei Seiten importieren; zurückgegebene
TRANSACTIONIDfür Folgeseiten beibehalten. - Den gespeicherten YourProcure-Katalog prüfen.
Erwartetes Ergebnis
- 12 eindeutige aktive Artikel TS-001 bis TS-012, verteilt auf 5 + 5 + 2 Positionen.
- Preis TS-001: 4.950 EUR; TS-002: 19.900 EUR je 100; TS-012: 12.995 EUR.
- Beschreibungen, Langtext und Einheit-Mapping vollständig; keine Artikel durch Seitenwechsel verloren oder doppelt.
J-02Delta: ändern, löschen und neu anlegenOCI5
Testziel und Schritte
- Zuerst J-01 als feste Baseline importieren.
FUNCTION=DOWNLOADJSON,SCENARIO=delta,LASTUPDATED=01102026120000aufrufen und das Delta importieren.- Gespeicherte Artikel und aktiven Bestand prüfen.
- Mit
LASTUPDATED=02102026120000erneut abfragen: keine weiteren Änderungen.
Erwartetes Ergebnis
- Drei Änderungsdatensätze: TS-001 hat Preis 5.250 EUR; TS-011 erhält Löschkennzeichen; OCI5-NEW-001 „Testmarker Set“ kommt mit 3.900 EUR je 1 EA hinzu.
- 12 aktive Artikel nach dem Delta. TS-011 ist nicht mehr bestellbar; der neue Artikel ist vorhanden.
- Unveränderte Artikel bleiben erhalten. Wiederholungsabfrage am Änderungszeitpunkt liefert 0 Änderungen.
J-03Verfügbare Menge und Lieferzeit prüfenOCI5
Testziel und Schritte
FUNCTION=QUANTITYCHECK,SCENARIO=full,EXT_PRODUCT_ID=TS-001,QUANTITY=1000.000aufrufen.- Dieselben Werte mit
QUANTITY=1001.000erneut aufrufen. - Antwortfelder prüfen und die vereinbarte Darstellung beziehungsweise Reaktion in YourProcure vergleichen.
Erwartetes Ergebnis
- In beiden Antworten verfügbare Menge 1000; erste Lieferzeit 2 Tage, bei Mengenüberschreitung 9 Tage.
- YourProcure interpretiert verfügbare Menge und Lieferzeit korrekt.
- Vorschlag für den fachlichen Sollvertrag: Mengenüberschreitung verständlich anzeigen; Menge niemals unbemerkt verändern.
Technische Grundlage: SAP Open Catalog Interface 5.0, Abschnitte 6.6–6.8. Preisänderungen, Löschartikel, Zeitpunkte und die zusätzliche Lieferzeit sind eigene Testfixtures.