Delivery und Kickoff: Execution-Flow, Zahlung und Change-Kontrolle
Den vollständigen Post-Sign-Execution-Flow verstehen — vom Execution-Handoff über die Stripe-Zahlung, Projektaktivierung bis zur Abschlussabrechnung.
Schrittübergreifender Flow mit Aktionen, Signalen und Übergaben.
In diesem Guide
Ownership und Review-Disziplin
Änderungssignale im Blick behalten
- package schema changes
- pricing generation logic updates
- commercial review policy updates
- send modal behavior changes
- buyer signing flow updates
- deal room experience changes
- execution next action changes
- kickoff and handoff logic changes
- change request workflow updates
Operator-Guidance
Was das in QuoterAgent bedeutet
Nutzen Sie diesen Guide als operative Referenz für Delivery und Kickoff: Execution-Flow, Zahlung und Change-Kontrolle. Er erklärt, welche Fläche hier gesteuert wird, woran gute Ausführung erkennbar ist und welche Teams diese Inhalte dauerhaft belastbar halten müssen.
- Nachdem ein Client ein Angebot unterzeichnet, wechselt QuoterAgent in eine Execution-Phase mit einer definierten Schrittfolge. Jeder Schritt hat ein Gate: Die Zahlung muss bestätigt sein, bevor die Aktivierung erfolgt, und die Delivery muss explizit als abgeschlossen markiert sein, bevor der Abschluss möglich ist. Dieser Guide führt diese Sequenz der Reihe nach durch.
- Die Execution-Gates sind bewusst gesetzt. Aktivierung vor Zahlungsbestätigung erzeugt Cashflow-Risiko. Abschluss vor markierter Delivery-Completion löscht den Audit-Trail. QuoterAgent erzwingt diese Gates, damit die kommerzielle Integrität des unterzeichneten Angebots bis zur Abrechnung erhalten bleibt.
- Primäre Owner für diesen Bereich sind aktuell: Produkt, Support.
Was zu tun ist
Behandeln Sie diesen Guide als Arbeitscheckliste, nicht als Hintergrundtext. Nutzen Sie ihn, bevor Einstellungen geändert, externe Inhalte veröffentlicht oder Aufgaben an andere Operatoren übergeben werden.
- Diesen Guide unmittelbar nach Unterzeichnung eines Angebots öffnen. Das Execution-Panel wird ab diesem Zeitpunkt verfügbar. Keine Schritte überspringen — die Aktivierung ist an die Zahlungsbestätigung gebunden, der Abschluss an die Delivery-Completion.
- Wenn Stripe noch nicht verbunden ist, jetzt tun — vor dem ersten Angebots-Versand, nicht danach. Wenn eine Zahlung in 'pending' feststeckt, prüfen, ob der Stripe-Webhook aktiv und auf das Ereignis 'checkout.session.completed' abonniert ist.
- Zu Einstellungen → Integrationen → Stripe gehen und prüfen, ob das Konto verbunden und der Webhook-Endpoint aktiv ist.
- Im Stripe-Dashboard bestätigen, dass der Webhook auf 'checkout.session.completed' abonniert ist und auf die QuoterAgent-Webhook-URL zeigt.
Wo das im Workflow auftaucht
Dieser Guide ist am wichtigsten, wenn Arbeit zwischen Setup, Authoring, buyer-facing Zustellung und Post-Sign-Execution wechselt. Folgen Sie den verlinkten Guides, damit nicht nur eine einzelne Fläche isoliert optimiert wird.
- Der Execution-Flow setzt drei Dinge voraus, die vor Unterzeichnung eines Angebots in Betrieb sein müssen: Stripe muss in Einstellungen verbunden sein, das Angebot muss eine definierte Pricing-Struktur haben, und ein Webhook-Endpoint muss im Stripe-Dashboard aktiv sein und auf QuoterAgents Webhook-URL zeigen.
- Prüfen Sie den verwandten Guide "Sending und Signing: buyer-facing Flow und Acceptance-Vertrauen", wenn dieser Schritt von einer anderen Fläche abhängt.
- Prüfen Sie den verwandten Guide "Pakete und Pricing: kommerzielle Struktur und Angebotsklarheit", wenn dieser Schritt von einer anderen Fläche abhängt.
Häufige Fehlerbilder und Risiken
Die meisten Qualitätsprobleme hier entstehen durch Drift: veraltetes Setup, schwache kommerzielle Grenzen oder Teams, die den Review-Moment vor customer-visible Zustellung überspringen. Diese Signale helfen, Probleme vor dem Buyer zu erkennen.
- package schema changes
- pricing generation logic updates
- commercial review policy updates
- Die Zahlungsbestätigung kommt vom Stripe-Webhook, nicht von der Redirect-URL — ein Client kann zahlen und den Browser schließen, ohne dass sich der Status aktualisiert, wenn der Webhook nicht konfiguriert ist.
- Status 'partially_paid' bedeutet: der Kickoff-Betrag wurde eingezogen, aber die Abschlusszahlung wurde noch nicht initiiert.
Was das ist
Nachdem ein Client ein Angebot unterzeichnet, wechselt QuoterAgent in eine Execution-Phase mit einer definierten Schrittfolge. Jeder Schritt hat ein Gate: Die Zahlung muss bestätigt sein, bevor die Aktivierung erfolgt, und die Delivery muss explizit als abgeschlossen markiert sein, bevor der Abschluss möglich ist. Dieser Guide führt diese Sequenz der Reihe nach durch.
- Schritt 1 — Execution-Handoff erstellen: nach Unterzeichnung das Execution-Panel öffnen und einen Handoff-Eintrag erstellen, um die Post-Sign-Phase zu starten.
- Schritt 2 — Kickoff-Zahlung initiieren: das System erstellt eine Stripe-Checkout-Session und sendet dem Client einen Zahlungslink für den vereinbarten Vorauszahlungsbetrag.
- Schritt 3 — Zahlungsbestätigung: Stripes Webhook bestätigt die Zahlung. Status wird 'paid' (Gesamtbetrag) oder 'partially_paid' (nur Kickoff-Betrag). Die Aktivierung ist bis zu diesem Schritt gesperrt.
- Schritt 4 — Projekt aktivieren: nach Zahlungsbestätigung kann das Projekt als aktiv markiert und die Delivery gestartet werden.
- Schritt 5 — Delivery als abgeschlossen markieren: wenn alle Deliverables übergeben wurden, die Delivery im Execution-Panel explizit als abgeschlossen kennzeichnen.
- Schritt 6 — Abschlusszahlung (falls zutreffend): wenn das Projekt eine Kickoff+Final-Aufteilung nutzt, die finale Stripe-Zahlung initiieren. Webhook-Bestätigung setzt Status auf 'paid'.
- Schritt 7 — Abschluss: nur verfügbar, wenn Delivery als abgeschlossen markiert und Zahlung vollständig bestätigt ist.
Wann einsetzen
Diesen Guide unmittelbar nach Unterzeichnung eines Angebots öffnen. Das Execution-Panel wird ab diesem Zeitpunkt verfügbar. Keine Schritte überspringen — die Aktivierung ist an die Zahlungsbestätigung gebunden, der Abschluss an die Delivery-Completion.
- Wenn ein Client ein Angebot unterzeichnet und die Delivery starten kann.
- Bei der Fehlersuche bei einem blockierten Zahlungsstatus (z.B. Stripe-Session erstellt, Status aber weiter 'pending').
- Wenn ein Client nach Unterzeichnung Scope-Änderungen wünscht — Change-Request-Disziplin nutzen, um die kommerziellen Bedingungen zu schützen.
Warum es wichtig ist
Die Execution-Gates sind bewusst gesetzt. Aktivierung vor Zahlungsbestätigung erzeugt Cashflow-Risiko. Abschluss vor markierter Delivery-Completion löscht den Audit-Trail. QuoterAgent erzwingt diese Gates, damit die kommerzielle Integrität des unterzeichneten Angebots bis zur Abrechnung erhalten bleibt.
- Die Zahlungsbestätigung kommt vom Stripe-Webhook, nicht von der Redirect-URL — ein Client kann zahlen und den Browser schließen, ohne dass sich der Status aktualisiert, wenn der Webhook nicht konfiguriert ist.
- Status 'partially_paid' bedeutet: der Kickoff-Betrag wurde eingezogen, aber die Abschlusszahlung wurde noch nicht initiiert.
- Scope-Änderungen nach Unterzeichnung sollten als formale Change Requests behandelt werden, nicht als stille Angebots-Bearbeitungen.
Wie es verbunden ist
Der Execution-Flow setzt drei Dinge voraus, die vor Unterzeichnung eines Angebots in Betrieb sein müssen: Stripe muss in Einstellungen verbunden sein, das Angebot muss eine definierte Pricing-Struktur haben, und ein Webhook-Endpoint muss im Stripe-Dashboard aktiv sein und auf QuoterAgents Webhook-URL zeigen.
- Stripe-Verbindung → Kickoff-Payment-Session → Webhook-Bestätigung → Aktivierungs-Gate.
- Angebots-Pricing → bestimmt, ob das Projekt Vollzahlung oder Kickoff+Final-Aufteilung nutzt.
- Delivery-Übergabe-Bestätigung → Abschluss-Gate — muss manuell markiert werden, geschieht nicht automatisch.
Nächste Schritte
Wenn Stripe noch nicht verbunden ist, jetzt tun — vor dem ersten Angebots-Versand, nicht danach. Wenn eine Zahlung in 'pending' feststeckt, prüfen, ob der Stripe-Webhook aktiv und auf das Ereignis 'checkout.session.completed' abonniert ist.
- Zu Einstellungen → Integrationen → Stripe gehen und prüfen, ob das Konto verbunden und der Webhook-Endpoint aktiv ist.
- Im Stripe-Dashboard bestätigen, dass der Webhook auf 'checkout.session.completed' abonniert ist und auf die QuoterAgent-Webhook-URL zeigt.
- Den Billing-und-Admin-Guide für Plan-Level-Kontrollen prüfen, die den Zugang zum Execution-Panel beeinflussen.
Verwandte Guides
Sending und Signing: buyer-facing Flow und Acceptance-Vertrauen
Publish, Teilen und Acceptance steuern, damit Buyer-Experience klar bleibt und Lifecycle-Grenzen intakt bleiben.
Guide öffnen
Pakete und Pricing: kommerzielle Struktur und Angebotsklarheit
Pricing-Proposals gestalten, die verständlich, belastbar und mit Scope-Zusagen synchron sind.
Guide öffnen
Referenz und Glossar: kanonische Proposal- und Workflow-Terminologie
Gemeinsame Definitionen für Scope, Pricing, Lifecycle und buyer-facing Operations in QuoterAgent.
Guide öffnen
