API & Webhooks · Enterprise
Verbinden Sie Ihre Angebote mit dem Rest Ihrer Systeme
Über die REST API von QuotWay lesen Ihr ERP, Ihr CRM oder Ihr eigener Shop Angebote und senden neue Angebotsanfragen ein, und signierte Webhooks melden Ihren Systemen in dem Moment, in dem ein Käufer annimmt, ein Gegenangebot macht oder ein Angebot umgewandelt wird. Scoped Keys, Payloads ohne personenbezogene Daten und dokumentierte Limits. Verfügbar im Tarif Enterprise – auch während der 14-tägigen kostenlosen Testphase.
Enterprise · 14-tägige Testphase inklusive API · OpenAPI-3.1-Spezifikation
Zwei Wege hinein
QuotWay verbindet sich auf zwei Wegen mit anderen Systemen: über eine REST API, die Ihre Systeme aufrufen, um Angebote zu lesen und anzulegen, und über Webhooks, die QuotWay an Ihre Systeme sendet, sobald sich ein Angebot ändert. Die meisten Integrationen nutzen beides – der Webhook sagt, dass etwas passiert ist, die API liefert die Details.
- REST API – https://api.quotway.com/v1: Angebote auflisten und abrufen, Angebotsanfragen anlegen, Nachrichten posten, ein von Ihrem Team kalkuliertes Angebot senden, PDFs herunterladen und Analysen abrufen
- Webhooks – ein signierter HTTPS-Request für 25 Angebotsereignisse, von der neuen Anfrage bis zur genehmigten, umgewandelten und bezahlten Bestellung
Was Sie damit bauen können
Beispiele dafür, was Sie mit API und Webhooks zusammen anbinden können.
ERP-Schnittstelle und Bestellsync
Erhalten Sie quote.converted in dem Moment, in dem ein Bestellentwurf entsteht, und quote.order_completed, wenn er bezahlt ist – und übernehmen Sie dann Positionen und Summen des Angebots in Ihr ERP oder Ihre Warenwirtschaft.
CRM-Pipeline
Spiegeln Sie jedes Angebot als Deal: Webhooks verschieben die Phase, die API liefert den Wert – über die headline-Zahl des Angebots, sodass ein teilweise angenommenes Angebot zeigt, was tatsächlich vereinbart wurde, nicht das ursprüngliche Angebot.
Headless und eigene Shops
Senden Sie Angebotsanfragen aus jedem Frontend mit POST /v1/quotes. Sie durchlaufen dieselben Zielregeln, dieselbe Formularvalidierung und dieselbe Automatisierung wie Ihr Onlineshop.
Finanzen und Reporting
Synchronisieren Sie Angebote inkrementell in ein Data Warehouse, oder rufen Sie vorberechnete Kennzahlen zu Pipeline, Konversion und Antwortzeit nach Tag, Woche oder Monat ab.
Team-Benachrichtigungen
Leiten Sie quote.merchant_approval.requested oder ein hochwertiges quote.created an das Werkzeug weiter, das Ihr Team ohnehin im Blick hat.
Enterprise
Gebaut für den Produktivbetrieb
Die API ist für die Systeme gebaut, die B2B-Händler tatsächlich betreiben: berechenbar, dokumentiert und sicher wiederholbar.
Scoped Keys
Fünf Scopes (Angebote lesen, personenbezogene Käuferdaten lesen, Analysen lesen, Angebote schreiben, Webhooks verwalten). Optionaler Ablauf und IP-Allowlists. Rollen Sie einen Key mit 24 Stunden Überlappung, oder widerrufen Sie ihn sofort. Nur für Admins.
Käuferdaten nur auf Wunsch
Ein Angebot enthält Name, E-Mail, Telefon und Adressen des Käufers nur für einen Key mit dem Käuferdaten-Scope. Webhook-Payloads enthalten nie personenbezogene Käuferdaten – sie nennen das Angebot und verlinken darauf.
Signaturen nach Standard Webhooks
Prüfen Sie Zustellungen mit den offiziellen Open-Source-Bibliotheken für Node, Python und weitere Sprachen. Rotieren Sie ein Secret mit 24 Stunden Überlappung.
Wiederholungen, um die Sie sich nicht kümmern müssen
Fehlgeschlagene Zustellungen werden etwa 3,7 Tage lang mit Backoff wiederholt; ein Zustellprotokoll zeigt jeden Versuch, und Sie können jede Zustellung erneut senden.
Nichts geht verloren
Jedes Ereignis ist zusätzlich 30 Tage lang über einen Events-Feed abrufbar, mit denselben IDs wie die Webhooks – ein Empfänger, der ausgefallen war, kann also aufholen.
Sichere Wiederholungen
Ein Idempotency-Key bei jedem Schreibzugriff sorgt dafür, dass ein Netzwerk-Timeout kein doppeltes Angebot und keine doppelte Nachricht erzeugt.
Klare Verträge
OpenAPI-3.1-Spezifikation, Fehler nach RFC 9457 mit einem stabilen Code für jeden Fehlerfall, Cursor-Paginierung und veröffentlichte Rate Limits (120 Requests pro Minute je Key, 300 je Shop).
Die Preise bestimmt weiterhin Ihr Team
Die QuotWay API setzt nie einen Preis. Sie kann die Anfrage eines Käufers erfassen und ein Angebot senden, das Ihr Team bereits kalkuliert und gespeichert hat – und selbst dann gelten Ihr Mindestpreis und Ihre Genehmigungsrichtlinien genau wie im Admin.
- Angebotsanfragen über die API verwenden die Katalogpreise aus Shopify; Ihr Team kalkuliert das Angebot wie gewohnt
- Ein vorbereitetes Angebot unter Ihrem Mindestpreis zu senden, erfordert dieselbe ausdrückliche Bestätigung wie im Admin – und der Mindestpreis berücksichtigt jeden Rabatt auf das ganze Angebot, genau wie im Admin
- Ein fester Rabatt auf das ganze Angebot, der größer ist als die Zwischensumme des Angebots, wird abgewiesen (422 invalid_proposal)
- Greift eine Genehmigungsrichtlinie, wartet das Angebot auf Ihre Freigabe, statt an den Käufer zu gehen
In vier Schritten verbinden
- 1
Key erstellen
Öffnen Sie in QuotWay Einstellungen → Integrationen → API-Keys, wählen Sie die Scopes und kopieren Sie den Key.
- 2
Ersten Aufruf machen
Ein curl-Request an https://api.quotway.com/v1/ping mit dem Key bestätigt Shop und Scopes.
- 3
Webhook-Endpunkt hinzufügen
Fügen Sie unter Einstellungen → Integrationen → Webhooks Ihre HTTPS-URL hinzu, wählen Sie die Ereignisse und kopieren Sie das Signing Secret.
- 4
Prüfen und verarbeiten
Prüfen Sie die Signatur jeder Zustellung, antworten Sie mit 200 und rufen Sie das Angebot ab, wenn Sie seine Details brauchen.
Weiter entdecken
Fragen, beantwortet
Hat QuotWay eine API?
Ja. QuotWay hat eine REST API unter https://api.quotway.com/v1, um Angebote zu lesen, Angebotsanfragen anzulegen, Nachrichten zu posten, vorbereitete Angebote zu senden, Angebots-PDFs herunterzuladen und Analysen abzurufen. Sie ist mit einer OpenAPI-3.1-Spezifikation dokumentiert und im Tarif Enterprise verfügbar.
Unterstützt QuotWay Webhooks?
Ja. QuotWay sendet für 25 Angebotsereignisse einen signierten HTTPS-Webhook – darunter Angebot erstellt, Angebot gesendet, Gegenangebot, angenommen, teilweise angenommen, abgelehnt, in einen Bestellentwurf umgewandelt, Bestellung bezahlt sowie Genehmigung angefragt oder entschieden. Die Webhooks folgen der Spezifikation Standard Webhooks und sind im Tarif Enterprise verfügbar.
Welcher Tarif enthält API und Webhooks?
Enterprise ($199/Monat). Ein Shop in der 14-tägigen kostenlosen Testphase kann beides nutzen, sodass Sie vor dem Abschluss bauen und testen können. Wechselt ein Shop in einen niedrigeren Tarif, bleiben seine Keys und Endpunkte erhalten, sind aber pausiert.
Kann ich Angebote aus einem Headless-Shop anlegen?
Ja. POST /v1/quotes erfasst die Angebotsanfrage eines Käufers aus jedem Frontend. Positionen verweisen auf Shopify-Produktvarianten (oder sind freie Positionen), und die Anfrage durchläuft die Zielregeln, die Validierung des Angebotsformulars und die Automatisierungsregeln des Shops – genau wie eine Anfrage aus dem Onlineshop.
Kann die API Preise ändern oder ein Angebot annehmen?
Nein. Die API setzt oder ändert nie Preise, und sie kann ein Angebot nicht im Namen anderer annehmen, ablehnen oder umwandeln. Sie kann ein Angebot senden, das Ihr Team bereits in QuotWay kalkuliert und gespeichert hat, und Ihr Mindestpreis und Ihre Genehmigungsrichtlinien gelten weiterhin.
Enthalten Webhooks Kundendaten?
Nein. Webhook-Payloads identifizieren das Angebot und enthalten eine kurze Zusammenfassung – Status, Währung und Summen –, aber nie Name, E-Mail, Telefon oder Adresse des Käufers. Rufen Sie das Angebot über die API mit einem Key mit Käuferdaten-Scope ab, wenn Sie diese Angaben brauchen.
Was passiert, wenn mein Endpunkt nicht erreichbar ist?
QuotWay wiederholt eine fehlgeschlagene Zustellung siebenmal über etwa 3,7 Tage, und jedes Ereignis bleibt 30 Tage lang über den Events-Feed abrufbar, sodass Sie aufholen können. Ein Endpunkt, der fünf Tage lang durchgehend fehlschlägt, wird abgeschaltet, und der Shop erhält eine E-Mail.
Gibt es eine Zapier-App oder eine HubSpot-Integration?
Derzeit nicht. Sie können QuotWay über die REST API und Webhooks mit anderen Werkzeugen verbinden und über die Shopify-Flow-Integration mit Shopifys eigener Automatisierung.
Bringen Sie Ihre Angebote dorthin, wo Ihr Geschäft läuft
Fügen Sie QuotWay kostenlos hinzu, starten Sie eine 14-tägige Testphase von Enterprise und verbinden Sie Ihr erstes System über API und Webhooks – dokumentiert, mit Scopes und signiert.
Kostenloser Lite-Tarif · 14 Tage Testphase in kostenpflichtigen Tarifen · Funktioniert mit Shopify Plus