Abnahmetest und Akzeptanztest: Abnahme von Softwareprojekten
Ein Akzeptanztest, oft Abnahmetest genannt, entscheidet mit darüber, ob dein Kunde die Software abnimmt, und damit über deine Zahlung. Du erfährst, was das Bürgerliche Gesetzbuch (BGB) an die Abnahme knüpft und was ins Abnahmeprotokoll gehört. Bestandene Tests belegen die Abnahmekriterien; wie du sie vor jedem Release wiederholst, steht im Beitrag zum Regressionstest vor der Abnahme.
Inhaltsverzeichnis
- Was ist ein Akzeptanztest in der Software?
- Software-Abnahme nach BGB: warum sie die Zahlung fällig macht
- Abnahmekriterien für den Akzeptanztest der Software vor Projektstart festlegen
- Abnahmeprotokoll für Software: was hineingehört
- Akzeptanztest der Software: wie bestandene Tests die Abnahme belegen
- Abnahmetest für Software: Software-Release-Freigabe und Ablauf
- Wenn der Kunde die Software-Abnahme verweigert
- Nächster Schritt für Softwarehäuser und Beratungen
Was ist ein Akzeptanztest in der Software?
Ein Akzeptanztest, auch Abnahmetest genannt, ist die letzte Teststufe vor der Übergabe. Der Kunde oder sein Vertreter prüft in einer Umgebung wie der Produktion, ob die Software die vereinbarten Anforderungen erfüllt. Besteht sie, kann er sie abnehmen. Findet er Mängel, hält er sie fest, bevor er entscheidet.
Das Ziel ist Vertrauen: Der Test zeigt, dass die Software im Alltag des Kunden taugt. Er prüft von außen, ohne den Code zu kennen. Anwender prüfen bei der Benutzerabnahme, der Betrieb bei der Betriebsabnahme.
Akzeptanztest, Abnahmetest, User Acceptance Test: drei Namen in der Softwareentwicklung
Die drei Begriffe meinen im Alltag dasselbe, auch beim Abnahmetest in der Softwareentwicklung und beim User-Akzeptanztest.
"Akzeptanztest" und "Abnahmetest" nennen die Teststufe, "User Acceptance Test" (UAT) betont, dass Anwender mitprüfen. Das ISTQB/GTB-Glossar führt den Akzeptanztest als Synonym des Abnahmetests. Die rechtliche Abnahme ist ein eigener Schritt. Der Test liefert die Entscheidungsgrundlage. Erst die Erklärung des Kunden macht daraus die Abnahme.
Software-Abnahme nach BGB: warum sie die Zahlung fällig macht
Keine Rechtsberatung. Dieser Abschnitt ist eine allgemeine Information. Lass die Klauseln deines Vertrags von einer Anwältin oder einem Anwalt prüfen.
Die Abnahme macht deine Zahlung fällig: § 641 BGB verlangt die Vergütung bei der Abnahme (Abs. 1).
§ 640 BGB regelt die Abnahme eines Werks und gilt für den Werkvertrag. Ob dein Softwarevertrag einer ist, steht im Vertrag. Die Vertragsart entscheidet.
Das Abnahmeprotokoll für Software hält bei einem Werkvertrag den Zeitpunkt der Abnahme fest. § 640 BGB regelt in drei Absätzen:
- Abs. 1: Der Besteller muss das vertragsgemäße Werk abnehmen. Wegen unwesentlicher Mängel darf er die Abnahme nicht verweigern.
- Abs. 2: Setzt du nach der Fertigstellung eine angemessene Frist und verweigert der Besteller die Abnahme nicht innerhalb der Frist, gilt das Werk als abgenommen. Das gilt nicht, wenn er die Abnahme innerhalb der Frist unter Angabe mindestens eines Mangels verweigert. Für Verbraucher gelten zusätzliche Hinweispflichten.
- Abs. 3: Nimmt der Besteller ein Werk trotz eines bekannten Mangels ab, braucht er einen Vorbehalt. Ohne Vorbehalt verliert er bestimmte Mängelrechte.
Auch bei Mängeln wirkt § 641 BGB: Verlangt der Besteller die Beseitigung eines Mangels, darf er nach Fälligkeit einen angemessenen Teil der Vergütung verweigern. Angemessen ist in der Regel das Doppelte der Beseitigungskosten (Abs. 3).
Abnahmekriterien für den Akzeptanztest der Software vor Projektstart festlegen
Lege die Kriterien fest, bevor das Projekt beginnt. Jedes Kriterium beschreibt ein Verhalten, das sich mit Ja oder Nein prüfen lässt. Ein Beispiel: "Ein Benutzer kann einen Zeiteintrag bearbeiten." Vage Sätze wie "die Software ist schnell" lassen sich später nicht prüfen.
Schreibe die Kriterien in ein Dokument mit Version, zum Beispiel in den Testplan. Wie das aussieht, zeigt unser Beitrag zu Testplan und Testkonzept. Verweise im Protokoll auf genau diese Version.
Gib jedem Kriterium eine Test-ID, damit das Protokoll später auf den Testfall im Bericht zeigt. Wer die Kriterien vor dem Code als Beispiele schreibt (ATDD, BDD), hat die Akzeptanztests schon während der Entwicklung.
Abnahmeprotokoll für Software: was hineingehört
Ein Abnahmeprotokoll in der Softwareentwicklung hält für ein Softwareprojekt fest, was abgenommen wurde und wie der Kunde auf Basis welcher Kriterien entschieden hat. Es hat zehn Abschnitte:
| Abschnitt | Inhalt |
|---|---|
| 1. Kopf | Projekt, Vertrag, Vertragsart, Datum und Ort |
| 2. Parteien | Auftraggeber und Auftragnehmer mit Teilnehmenden und Rolle |
| 3. Abnahmegegenstand | Software, Version, Abnahmeumgebung, Teilabnahme |
| 4. Abnahmekriterien | Verweis auf das vereinbarte Dokument mit Version |
| 5. Testnachweis | Testlauf, Ergebnisse, Release-Gate, Anlage |
| 6. Mängelliste | Nummer, Beschreibung, Testfall, Einstufung, Frist, Verantwortlich |
| 7. Entscheidung | erteilt, unter Vorbehalt erteilt oder verweigert |
| 8. Vorbehalte | bekannte Mängel, deren Rechte vorbehalten bleiben |
| 9. Unterschriften | beide Parteien mit Name, Funktion, Datum |
| 10. Anlagen | Testbericht und Testplan mit weiteren Nachweisen |
Jeder Mangel bekommt fünf Angaben in der Spalte "Beschreibung": Fundstelle, Sollzustand, Istzustand, Auswirkung und Beleg.
Vorlage: Abnahmeprotokoll Software zum Download
Die Vorlage hat genau diese zehn Abschnitte. Pro Abschnitt steht eine Anweisung in grauer Schrift. Du lädst sie ohne Formular am Ende dieser Seite als Word-Datei herunter. Unter CC BY 4.0 darfst du sie anpassen.
Akzeptanztest der Software: wie bestandene Tests die Abnahme belegen
Ein bestandener Test belegt ein Kriterium, das du im Protokoll abhaken willst. Eine Vorführung belegt nur, was in ihr vorkam.
Wir würden den Bericht an jedes Protokoll hängen. Dann kann der Kunde Zeile für Zeile prüfen, statt dir zu glauben. Das ist unsere Einschätzung, kein Erfahrungswert aus einem Kundenprojekt.
Testbericht und Release-Gate als Anlage zum Software-Abnahmeprotokoll
Ein Testausführungsbericht (kurz: Bericht) belegt je Testfall das Ergebnis. Wir bauen ihn mit qa-signoff Pro, das wir verkaufen.
Der Bericht zeigt, was seit dem letzten Lauf behoben wurde, und gruppiert, was noch Arbeit braucht: Regressionen, fehlgeschlagene, instabile und teilweise bestandene Testfälle sowie fehlende Tests. Dazu kommt ein Release-Gate: PASS oder BLOCKED.
Ein echtes Beispiel ist der Testbericht aus dem Kimai-Praxistest. Der Bericht misst eine App: Kimai 2.67.0, eine Open-Source-Zeiterfassung, getestet mit Playwright 1.49.0 und Chromium 131.0.6778.33.
Im gemessenen Lauf brauchten alle Tests etwa 6 Minuten (README des Berichts).
Laut README waren im gemessenen Lauf etwa 98 Ergebnisse bestanden, etwa 2 davon nur teilweise. Eine Zeile steht für einen Testfall in einem Projekt, also einer Rolle auf einem Gerät. Dahinter stehen etwa 55 verschiedene Testfälle, das sind etwa 55 von etwa 350 im Backlog. Der Lauf misst eine einzige App. Die Umgebung läuft über HTTP, darum entfiel ein HTTPS-Check.
Die Preise für den Bericht stehen unter Preise für qa-signoff Pro.
Was ein grünes Release-Gate bei der Software-Abnahme nicht beweist
PASS heißt nicht, dass jedes Abnahmekriterium gilt. Das Release-Gate steht auf PASS, wenn die Erfolgsquote bei mindestens 80 % liegt (Gate-Tabelle im README). Das Release-Gate verlangt auch keine Regression und keine Abweichung zwischen Testfall und Test.
Ein grünes Gate lässt also fehlgeschlagene Testfälle zu. Fehlgeschlagene und blockierte Testfälle gehören in die Mängelliste.
Im gemessenen Kimai-Lauf blieben etwa 11 von etwa 66 bearbeiteten Testfällen blockiert, etwa 17 % (README des Berichts). Die Ursache der blockierten Fälle lag bei Kimai (ein Fehler oder ein nicht erfülltes Kriterium) oder bei der Umgebung.
Ein Beispiel aus dem Kimai-Lauf: Die Prüfung der Weiterleitung nach dem Abmelden bestand. Trotzdem zeigte die Zurück-Taste des Browsers das Dashboard wieder. Erst die Prüfung auf fehlenden Seiteninhalt (TC-WEB-001 und TC-WEB-002) fand das. Ein grüner Test sagt nur, was er geprüft hat.
In der Mängelliste steht der Fall so:
- Fundstelle: Dashboard nach dem Abmelden, bei Benutzer und Super-Admin, am Desktop und am iPhone
- Sollzustand: "Nach dem Abmelden zeigt die Zurück-Taste keinen geschützten Seiteninhalt"
- Istzustand: "Die Zurück-Taste zeigt das Dashboard"
- Auswirkung: "An einem gemeinsam genutzten Rechner sieht die nächste Person das Dashboard der Person, die sich abgemeldet hat"
- Beleg: Sperrvermerk in den Testfällen TC-WEB-001 und TC-WEB-002
Ob der Mangel wesentlich ist, entscheidet dein Vertrag. Arbeiten Nutzer an persönlichen Geräten mit unkritischen Daten, ist er unwesentlich. Nennt der Vertrag gemeinsam genutzte Arbeitsplätze oder Datenschutzanforderungen, ist er wesentlich. Diese Bewertung nimmt dir der Bericht nicht ab.
Ein Bericht prüft Verhalten; Aussehen und Wortlaut bleiben deine Aufgabe.
Der Bericht taugt nicht als Beleg, wenn dein Vertrag die Abnahme als unterschriebenen Rundgang definiert. Weicht die Umgebung von der Produktion ab, brauchst du andere Belege.
Abnahmetest für Software: Software-Release-Freigabe und Ablauf
Beim Abnahmetest für Software führt der Auftragnehmer die vereinbarten Tests auf der Abnahmeumgebung aus, die der Produktion entspricht. Der Kunde prüft das Ergebnis und entscheidet. Mit seinem Eintrag im Protokoll endet der Abnahmetest, und die Software-Release-Freigabe folgt daraus. Die sechs Schritte zeigen den Ablauf mit je einer Stolperstelle.
- Du legst die Kriterien mit dem Kunden schriftlich fest. Ohne Version weiß später niemand, wogegen getestet wurde.
- Die Tests laufen auf der Abnahmeumgebung. Ergebnisse aus einer anderen Umgebung zählen nicht.
- Du schickst das Protokoll mit dem Bericht, solange das Gate nicht BLOCKED zeigt. Ohne Bericht muss der Kunde dir die Testergebnisse glauben.
- Du setzt eine angemessene Frist (§ 640 Abs. 2). Ohne Frist greift die Abnahmefiktion nicht.
- Du trägst die Entscheidung des Kunden mit Datum im Protokoll ein. Ohne Datum bleibt offen, wann die Abnahme galt. Nimmt er bis zum Fristende nicht ab und nennt keinen Mangel, gilt das Werk als abgenommen (§ 640 Abs. 2).
- Vor jedem späteren Release läuft dieselbe Suite wieder, als Regressionstest vor der Abnahme. Ohne Wiederholung fällt eine Regression erst beim Kunden auf.
Wenn der Kunde die Software-Abnahme verweigert
Der Kunde darf die Abnahme nur wegen eines wesentlichen Mangels verweigern (§ 640 Abs. 1). Er muss den Mangel benennen. Eine Test-ID macht das Gespräch konkret, denn dann geht es um einen Testfall im Bericht.
Behebe den Mangel, lass den betroffenen Test neu laufen und schicke einen neuen Stand des Protokolls.
Wer solche Läufe regelmäßig braucht, findet bei Testautomatisierung ohne eigenes Testteam, wie das ohne eigene Testabteilung klappt.
Nächster Schritt für Softwarehäuser und Beratungen
Nimm die Vorlage und hänge den Bericht an dein nächstes Protokoll. Die Preise für qa-signoff Pro findest du auf der Preisseite.
Abnahmeprotokoll Software Vorlage herunterladen (DOCX, 3 KB)
Lizenziert unter CC BY 4.0. Namensnennung: qa-signoff, https://qa-signoff.com/de/blog/abnahmetest-akzeptanztest/
Ein Testausführungsbericht mit Release-Gate (PASS oder BLOCKED) als Anlage zu jedem Abnahmeprotokoll: qa-signoff Pro für Softwarehäuser und Beratungen.
Pro-Preise ansehen