Webshop-Schnittstelle planen: Lastenheft und Abnahmematrix

Was gehört in den ersten Abschnitt des Lastenhefts?

Beschreiben Sie Anlass, betroffene Systeme, Mussprozesse und die Grenzen des Auftrags.

Beginnen Sie mit einem beobachteten Problem, etwa doppelter Erfassung oder unklaren Beständen. Dokumentieren Sie das derzeitige Vorgehen und das gewünschte Ergebnis. Damit kann ein Umsetzungspartner erkennen, ob eine neue Verbindung gebraucht wird oder eine bestehende Konfiguration und Zuständigkeit korrigiert werden muss.

Benennen Sie Systeme, Versionen, Ansprechpartner und betroffene Verkaufskanäle. Halten Sie ausdrücklich fest, was nicht Teil dieses Auftrags ist, wenn eine Verwechslung wahrscheinlich wäre: beispielsweise die redaktionelle Überarbeitung aller Produkttexte oder die Einführung eines neuen Lagers. Solche Grenzen gehören in das fachliche Briefing, nicht versteckt in eine spätere Kostendiskussion.

Wie beschreiben Sie die zu übertragenden Daten?

Geben Sie pro Datenobjekt Quelle, Ziel, Richtung, Kennung und erwartete Rückmeldung an.

Erstellen Sie eine kompakte Matrix für Artikel, Varianten, Preise, Bestand, Auftrag und Versand. Nehmen Sie nur Daten auf, die der Ablauf benötigt. Definieren Sie fachliche Kennungen unabhängig von sichtbaren Namen. Eine Umbenennung des Artikels darf seine Zuordnung zur Variante und offenen Bestellung nicht zerstören.

Ergänzen Sie Feldregeln: Pflichtangaben, erlaubte Werte, Mengeneinheiten und die Bedeutung leerer Felder. Soll ein fehlender Wert den alten Stand erhalten, ihn löschen oder einen Fehler auslösen? Klären Sie diese Unterschiede am Beispiel. Andernfalls können zwei technisch korrekt wirkende Umsetzungen zu völlig anderen Stammdaten führen.

Wie genau müssen Zeitpunkt und Übertragungsweg beschrieben sein?

Beschreiben Sie das fachliche Ereignis und die erforderliche Reaktion; die technische Lösung muss diese Anforderung nachweisbar erfüllen.

Verwenden Sie konkrete Aussagen wie „nach bestätigtem Wareneingang wird der verkaufbare Bestand neu berechnet“. Ergänzen Sie, wie lange eine Verzögerung in Ihrem Betrieb akzeptabel ist und was bei Überschreitung passiert. Erfinden Sie dafür keinen pauschalen Echtzeitwert, sondern begründen Sie ihn aus Auftragsvolumen und Verkaufsrisiko.

Ein Partner kann Ereignismeldungen, regelmäßige Abfragen oder einen kombinierten Weg vorschlagen. Shopify weist für seine Webhooks auf mögliche fehlende Zustellungen und nicht garantierte Reihenfolge hin. Fordern Sie deshalb einen erklärten Abgleich und eine Konfliktregel an, statt allein das Wort Echtzeit als Qualitätsnachweis zu verwenden.

Beleg: Shopify: Webhooks und ergänzender Abgleich

Was muss das Lastenheft zu Fehlern und Zugriffen sagen?

Verlangen Sie verständliche Fehlervorgänge, gezielte Wiederholung und passende Zugriffsrechte.

Beschreiben Sie, was ein fachlicher Bearbeiter bei einer ungültigen Adresse oder unbekannten Artikelkennung sehen muss. Die Meldung soll den Vorgang auffindbar machen und die nächste Aktion erklären. Halten Sie fest, welche Korrektur im führenden System erfolgen muss und wann eine Wiederholung zulässig ist.

Ordnen Sie technische Zugänge und die Verantwortung für deren Pflege zu. Die Verbindung soll nur die für den Prozess nötigen Daten lesen und ändern können. Zugangsschlüssel gehören nicht in das allgemein verteilte Lastenheft. Ergänzen Sie stattdessen, wer sie bereitstellt, sicher verwaltet und nach einer Übergabe prüft.

Wie werden aus Anforderungen vergleichbare Angebote?

Lassen Sie Mussfälle einzeln zuordnen und geben Sie je Fall messbare Sollzustände vor.

Bitten Sie jeden Kandidaten, Standard, Konfiguration, Entwicklung und offene Lücke auszuweisen. Fordern Sie neben Einrichtung auch Testbegleitung, Dokumentation und Betriebsübergabe an. Eine günstigere Umsetzung kann sonst nur deshalb günstiger wirken, weil die fachliche Prüfung auf Ihr Team verlagert wurde.

Für die Abnahme reichen Sie Ausgangsdaten, Aktion und Sollzustand je System ein. Führen Sie Normalfall, Wiederholung, Teilversand und einen bewusst fehlerhaften Datensatz durch. Halten Sie Abweichung, Verantwortlichen und Freigabebedingung fest. Neue Anforderungen nach dieser Vereinbarung sollten sichtbar bewertet werden, statt unbemerkt den Umfang zu verändern.