Zum Hauptinhalt springen

Anpassen des Angebots-, Kauf- und Zahlungsflusses im Kundenportal mithilfe der API

Verfasst von Fabian Heldt

Das Kundenportal enthält alles, um ein Projekt vollautomatisch zu berechnen, dem Kunden die Möglichkeit zu geben, Bestellungen aufzugeben, und Zahlungen über Stripe abzuwickeln.

In manchen Fällen benötigen Sie vielleicht mehr Flexibilität und Kontrolle über die Berechnung, die Bestelloptionen und die Zahlungsmethoden, aber Sie müssen Ihren Kunden trotzdem eine automatisierte und sofortige Kaufabwicklung ermöglichen.

Hier sind einige Anwendungsfälle:

  • Erweitern Sie die Berechnung für kundenspezifische Teile/PCBs (möglicherweise unter Verwendung von Input aus Ihrem ERP)

  • Genauere Schätzungen der Vorlaufzeit (möglicherweise unter Verwendung von Daten aus Ihrem MRP)

  • Zahlungen ohne Stripe abwickeln

  • ...und vieles mehr

Der Rest der Seite beschreibt, wie Sie den Angebots- und Einkaufsfluss mithilfe unserer APIs anpassen können.

Voraussetzungen:

In Einstellungen → Kundenportal ist die Einstellung, dass Kunden Käufe tätigen können, auf "Nach dem manuellen Upload eines Angebotes" gesetzt.

💡 Mit dieser Option kann entweder ein Benutzer das Angebot über die Registerkarte "Angebot" in der Benutzeroberfläche hochladen oder Ihr Code kann das Angebot über die API hochladen. In beiden Fällen wird die Kaufoption dem Benutzer erst nach dem Hochladen angezeigt.

Wenn Sie Rechnungen aus Ihrem ERP oder CRM versenden möchten, anstatt Stripe als Zahlungsabwickler zu verwenden, deaktivieren Sie die Option "Stripe für die Zahlung auf Rechnung verwenden". Bitte beachten Sie, dass die unmittelbare Bezahlung, wenn Sie sie als Zahlungsoption zulassen, immer Stripe verwendet.

Dies sind die Schritte für den Angebots- und Kaufprozess:

  • Der Kunde sendet das Projekt.

  • Der Projektstatus ändert sich in "Angebot in Bearbeitung".

  • Der Webhook rfq_status_change wird mit dem Status QuotationInProgress aufgerufen.

  • Als Reaktion auf den Webhook wird Ihr Code ausgeführt:

💡 Webhooks können in manchen Situationen nicht aufgerufen werden, z. B. bei einem vorübergehenden Verlust der Netzwerkverbindung. Daher sollte Ihr Code in regelmäßigen Abständen die Liste der Projekte mit Hilfe der API "Get all RfQs" durchgehen und nach Projekten suchen, die neu den Status "QuotationInProgress" erhalten haben, und diese verarbeiten.

Sie können mehr oder weniger Optionen als in der ursprünglichen Kalkulation angeben und die Bestellgröße, die Vorlaufzeit und den Preis frei ändern. Wenn sich die Optionen auf in Ihrem ERP gespeicherte Preispunkte beziehen, können Sie für jede Option eine externe_id angeben, die Sie später abrufen können, wenn der Kunde einen Auftrag erteilt.

  • Ihr Code lädt ein Angebotsdokument mit Hilfe der Angebots-API hoch.

  • Sobald Ihr Code ein Angebotsdokument hochgeladen hat, wird der Projektstatus automatisch auf "Angebot verfügbar" (QuotationAvailable) geändert.

  • Der Kunde kann nun auf die Schaltfläche "Zur Kasse gehen" klicken.

  • Dem Kunden werden die Bestelloptionen angezeigt.

  • Der Kunde tätigt einen Kauf.

  • Der Projektstatus ändert sich in "Order placed".

  • Der Webhook rfq_status_change wird mit dem Status OrderPlaced aufgerufen.

  • Als Reaktion auf den Webhook (oder bei einer periodischen Überprüfung der Liste der Projekte) wird Ihr Code ausgeführt:

    Ihr Code ruft Informationen über die Bestelloption ab, die der Kunde mit Hilfe der API für Bestelldetails erworben hat.

Die Bestelldetails enthalten die external_id, die Sie verwenden können, um mit einem in Ihrem ERP gespeicherten Preispunkt zu korrelieren.

Wenn Sie Stripe nicht für die Zahlungsabwicklung verwenden, stößt Ihr Code den Rechnungsstellungsprozess in Ihrem ERP oder CRM an.

Hat dies deine Frage beantwortet?