Automatische Offertenerstellung: Schnittstellen testen

In einem kleinen Handwerksbetrieb kommt eine Anfrage über das Website-Formular herein: zwei Räume, gewünschte Leistung, Terminfenster und eine Bemerkung zur Zufahrt. Die Angaben werden automatisch in die Offertenvorlage übertragen. Im Entwurf steht die Anzahl Räume jedoch im Feld «Menge», das Terminfenster erscheint als zugesagter Ausführungstermin und die Preisposition stammt aus einer veralteten Liste.

Das Problem liegt nicht beim Formulieren der Offerte. Es liegt an den Schnittstellen zwischen Formular, Preisliste und Dokumentvorlage. Dieser Artikel konzentriert sich deshalb auf eine klar abgegrenzte technische Aufgabe: Felder richtig zuzuordnen und die Übergabe systematisch zu testen. Für die allgemeine Vorlagenarbeit und das Formulieren von Offerten finden Sie im Beitrag Offertenprozess in 15 Minuten: Vorlage und KI-Schnellstart eine separate Anleitung.

Das Ziel: Jeder Wert landet kontrolliert am richtigen Ort

Bei einer automatischen Offertenerstellung durchlaufen Angaben meist mehrere Stationen: Anfrageformular oder E-Mail, interne Erfassung, Preisliste, Berechnung und Dokumentvorlage. An jeder Übergabe können Werte verloren gehen, falsch interpretiert oder überschrieben werden.

Eine funktionierende Schnittstelle muss für jedes Feld fünf Fragen beantworten:

1. Woher kommt der Wert?
2. Wie heisst das Feld in der Quelle?
3. In welches Zielfeld wird der Wert übertragen?
4. Welches Format ist erlaubt?
5. Was geschieht bei einem fehlenden oder ungültigen Wert?

Dafür benötigen Sie kein grosses IT-Projekt. Eine Tabelle mit klaren Feldregeln reicht für einen ersten kontrollierten Ablauf.

Schritt 1: Eine Feldzuordnung erstellen

Beginnen Sie mit einer einzigen, häufig vorkommenden Offertenart. Listen Sie alle Angaben auf, die vom Eingang der Anfrage bis in den Offertenentwurf gelangen. Trennen Sie dabei Kundeneingaben, interne Ergänzungen und Werte aus kontrollierten Quellen.

Quellfeld	Zielfeld	Format	Quelle	Regel bei Fehler
anfrage_id	referenz	Text, eindeutig	Erfassungssystem	Prozess stoppen
leistung_code	position_code	Freigegebener Schlüssel	Interne Auswahl	Manuell zuordnen
menge	position_menge	Zahl	Anfrage oder Prüfung	Rückfrage auslösen
einheit	position_einheit	Definierte Auswahl	Leistungskatalog	Prozess stoppen
terminwunsch	kundenwunsch_termin	Datum oder Zeitraum	Kundenanfrage	Nicht als Zusage ausgeben
preis_version	interner_preisstand	Versionskennung	Preisliste	Prozess stoppen

Verwenden Sie eindeutige Feldnamen. Ein allgemeines Feld wie «Termin» ist riskant, weil es einen Kundenwunsch, einen internen Planungstermin oder eine verbindlich geprüfte Zusage bezeichnen kann. Besser sind getrennte Felder wie «terminwunsch», «geplanter_termin» und «bestaetigter_termin».

Schritt 2: Datentypen und erlaubte Werte festlegen

Ein Feldname allein verhindert keine Fehler. Definieren Sie zusätzlich, welche Werte ein Feld annehmen darf. Besonders wichtig sind Zahlen, Einheiten, Datumsangaben, Auswahlfelder und interne Schlüssel.

• Mengen: nur als Zahl speichern, nicht zusammen mit der Einheit im selben Feld.
• Einheiten: aus einer festgelegten Liste wählen, beispielsweise Stück, Stunde oder Meter.
• Datumsangaben: ein einheitliches Format verwenden und ungenaue Angaben wie «möglichst bald» separat speichern.
• Ja-Nein-Felder: einen unbekannten Zustand zulassen, statt fehlende Angaben automatisch als Nein zu behandeln.
• Leistungen: über eindeutige interne Codes mit der Preisliste verbinden.
• Freitext: nur für Beschreibungen und Hinweise nutzen, nicht als versteckte Quelle für Preise oder Mengen.

Die Trennung von Menge und Einheit ist beispielsweise entscheidend. Der Eintrag «10 m» lässt sich schlechter prüfen und berechnen als die Menge «10» plus die Einheit «m». Dasselbe gilt für Preise: Ansatz, Menge, Rabatt, Zuschlag und Steuerbehandlung gehören in getrennte Felder.

Schritt 3: Die Preisliste über Schlüssel anbinden

Die Schnittstelle sollte einen Preis nicht anhand einer ähnlich klingenden Beschreibung suchen. Nutzen Sie stattdessen einen eindeutigen Leistungscode. Dieser verbindet die ausgewählte Leistung mit Bezeichnung, Einheit und freigegebenem Preisstand.

Speichern Sie beim erzeugten Entwurf auch die Version oder den Stand der verwendeten Preisliste. So bleibt erkennbar, auf welcher Grundlage die Positionen erstellt wurden. Falls ein Leistungscode fehlt, mehrfach vorkommt oder in der gewählten Preisversion nicht vorhanden ist, muss der Ablauf stoppen.

Berechnungen sollten durch festgelegte Formeln erfolgen. Eine KI kann Unstimmigkeiten markieren, sollte aber nicht selbständig Preise einsetzen, Rabatte bestimmen oder fehlende Mengen schätzen. Praktische Prüfpunkte zu Zahlen und Berechnungen enthält der Artikel Offertenfehler mit KI: Kalkulationsfallen sicher erkennen.

Schritt 4: Platzhalter der Dokumentvorlage prüfen

Ordnen Sie jedes Zielfeld einem sichtbaren Platzhalter in der Offertenvorlage zu. Prüfen Sie dabei nicht nur Kundendaten und Positionen, sondern auch Referenznummer, Preisstand, Annahmen, Ausschlüsse, Terminstatus und Bedingungen.

Legen Sie für leere Werte eine Regel fest:

• Ein Pflichtfeld stoppt die Dokumenterstellung.
• Ein optionales Feld bleibt leer oder der zugehörige Abschnitt wird entfernt.
• Ein unklarer Wert wird sichtbar als «zu prüfen» markiert.
• Ein Standardtext darf nur eingesetzt werden, wenn er intern freigegeben ist.

Vermeiden Sie Platzhalter, die fehlende Inhalte unbemerkt durch plausible Standardsätze ersetzen. Ein optisch vollständiger Entwurf kann fachlich falsch sein.

Schritt 5: Feldzuordnung mit KI gegenprüfen

Eine KI kann zwei Feldlisten vergleichen und mögliche Fehlzuordnungen aufzeigen. Verwenden Sie dafür anonymisierte Beispieldaten ohne Namen, Adressen, E-Mail-Adressen oder andere Personendaten. Die KI soll prüfen, nicht fehlende Regeln erfinden.

Aufgabe: Prüfen Sie die folgende Feldzuordnung zwischen Anfrageformular, Preisliste und Offertenvorlage. Erstellen Sie keine Offerte und erfinden Sie keine Werte.

Prüfen Sie: 1. Felder ohne Ziel, 2. Zielfelder ohne Quelle, 3. unterschiedliche Datentypen, 4. vermischte Mengen und Einheiten, 5. mehrdeutige Feldnamen, 6. Terminwünsche, die als Zusage ausgegeben werden könnten, 7. Preisfelder ohne eindeutigen Leistungscode und Preisstand.

Ausgabe: Erstellen Sie eine Tabelle mit Quellfeld, Zielfeld, erkanntem Risiko, empfohlener Korrektur und Prüfstatus. Kennzeichnen Sie jede Annahme ausdrücklich. Wenn eine Information fehlt, schreiben Sie «nicht bestimmbar».

Feldzuordnung: [Anonymisierte Feldliste einsetzen]

Kontrollieren Sie jeden Hinweis anhand Ihrer tatsächlichen Systeme. Die KI kennt weder Ihre internen Felddefinitionen noch die fachliche Bedeutung Ihrer Leistungscodes.

Schritt 6: Einen kleinen Schnittstellentest durchführen

Testen Sie nicht sofort mit echten neuen Kundenanfragen. Erstellen Sie zunächst anonymisierte Testfälle mit erwarteten Ergebnissen. Ein guter Test umfasst sowohl normale als auch absichtlich fehlerhafte Eingaben.

Testfall	Eingabe	Erwartetes Ergebnis
Normalfall	Gültiger Code, Menge und Einheit	Position korrekt übernommen
Menge fehlt	Leistung ohne Mengenangabe	Stopp und Rückfrage
Code unbekannt	Nicht vorhandener Leistungscode	Keine Preisübernahme
Termin unklar	«Ausführung möglichst im Mai»	Als Wunsch, nicht als Zusage ausgegeben
Alte Preisversion	Nicht freigegebener Preisstand	Stopp vor Dokumenterstellung
Zusatztext	Bemerkung mit abweichender Menge	Widerspruch wird markiert

Protokollieren Sie für jeden Test das erwartete und das tatsächliche Ergebnis. Prüfen Sie die Werte an jeder Station: nach der Erfassung, nach der Preiszuordnung und im fertigen Dokument. So erkennen Sie, an welcher Schnittstelle eine Abweichung entsteht.

Klare Stopppunkte einbauen

Eine technische Übergabe darf nicht in jedem Fall automatisch weiterlaufen. Sinnvolle Stopppunkte sind:

• Pflichtfeld fehlt oder hat das falsche Format.
• Leistungscode ist unbekannt oder nicht eindeutig.
• Menge und Einheit passen nicht zur Preisposition.
• Preisstand ist nicht freigegeben.
• Freitext widerspricht einem strukturierten Feld.
• Eine manuelle Preisänderung wurde nicht gekennzeichnet.
• Die Offerte wurde noch nicht fachlich freigegeben.

Der letzte Stopppunkt bleibt die menschliche Kontrolle. Empfänger, Leistungsumfang, Mengen, Einheiten, Preise, Summen, MWST-Behandlung, Termine und Ausschlüsse müssen vor dem Versand geprüft werden. Steuerliche Fragen sind mit einer Treuhandfachperson zu klären.

Typische Fehler beim Schnittstellentest

• Nur den Normalfall testen: Viele Probleme zeigen sich erst bei leeren, ungültigen oder widersprüchlichen Werten.
• Feldnamen mit Bedeutung verwechseln: Zwei Felder können gleich heissen und trotzdem etwas anderes meinen.
• Direkt im Dokument korrigieren: Die Quelldaten bleiben falsch und erzeugen beim nächsten Lauf denselben Fehler.
• Preislisten ohne Version verwenden: Später lässt sich die Grundlage des Entwurfs nicht mehr sicher nachvollziehen.
• Automatischen Versand aktivieren: Eine fehlerfreie technische Übergabe ersetzt keine fachliche Freigabe.

Nach der freigegebenen Offerte braucht es zudem einen kontrollierten Statuswechsel und eine passende Auftragsbestätigung. Hinweise dazu finden Sie unter Auftragsbestätigung mit KI: Fehler erkennen, bevor die Arbeit anfängt.

Datenschutz bei Tests und Übergaben

Geben Sie keine Personendaten oder vertraulichen Geschäftsinformationen in öffentliche KI-Werkzeuge ein. Nutzen Sie für Schnittstellentests erfundene oder wirksam anonymisierte Datensätze und neutrale Kennungen wie «Testkunde 01». Klären Sie zudem, welche Systeme Daten speichern, wer darauf zugreifen kann und wie lange Testdaten erhalten bleiben.

Berücksichtigen Sie das Schweizer Datenschutzgesetz und die Einstellungen sowie Vertragsbedingungen der eingesetzten Dienste. Diese Hinweise sind keine Rechtsberatung. Bei Unsicherheiten ist eine Datenschutzfachperson beizuziehen.

Fazit: Erst die Übergabe sichern, dann automatisieren

Bei der automatischen Offertenerstellung entscheidet nicht die Qualität eines Formulierungsvorschlags über die Zuverlässigkeit, sondern die saubere Feldzuordnung. Definieren Sie eindeutige Quellen, Zielfelder, Formate, Leistungscodes und Fehlerregeln. Testen Sie danach Normalfälle und Ausnahmen an jeder Schnittstelle zwischen Formular, Preisliste und Dokumentvorlage. Erst wenn falsche oder fehlende Werte zuverlässig stoppen, sollte der Ablauf für echte Offerten eingesetzt werden.

Nächster sinnvoller Schritt

Wenn Mitarbeitende KI nutzen: Regeln und Nachweise nicht vergessen

Büro-KI hilft, wiederkehrende Büroarbeit sauberer vorzubereiten. Sobald mehrere Personen KI-Tools nutzen oder Kundendaten betroffen sein können, braucht es zusätzlich klare interne Regeln, Zuständigkeiten und eine nachvollziehbare Dokumentation.

KI-Regelmappe prüfen

Informations- und Orientierungshilfe, keine Rechtsberatung und keine Compliance-Garantie.