Die QuoteCrest API verwenden

Übersicht

Im Business-Tarif stellt QuoteCrest eine vollständige REST API bereit, damit Ihre eigene Software — ein ERP, ein CRM, eine Field-Service-App — die Angebotserstellung direkt steuern kann. Alles, was die App kann, ist verfügbar: Angebote und Positionen, Kunden, die Artikelbibliothek, Steuersätze, AGB-Vorlagen, Zahlungen, PDF-Erzeugung, der KI-Angebotsassistent und Auslöser für die Buchhaltungssynchronisierung.

Die vollständige, stets aktuelle Endpunkt-Referenz finden Sie unter quotecrest.com/api-docs.

Zugang erhalten

Stellen Sie sicher, dass Ihr Team den Business-Tarif nutzt (Einstellungen → Abrechnung). API-Aufrufe von Free- oder Pro-Teams geben 403 plan_required zurück.
Gehen Sie zu Einstellungen → Entwickler und klicken Sie auf Anwendung registrieren.
Vergeben Sie einen Namen, Ihre Redirect-URI (HTTPS, oder localhost während der Entwicklung) und die benötigten Scopes: read für Lesezugriff, write zum Erstellen und Aktualisieren.
Kopieren Sie das Client Secret, sobald es angezeigt wird — es erscheint genau einmal. Die Client ID bleibt auf der Anwendungsseite sichtbar.

Authentifizierung

Die API verwendet OAuth 2.0 Authorization Code mit PKCE — keine API-Schlüssel. Ihre App leitet einen Benutzer zu /oauth/authorize, er genehmigt die angeforderten Scopes, und Sie tauschen den zurückgegebenen Code (plus Ihren PKCE-Verifier) unter /oauth/token gegen ein Access Token ein.

Access Tokens sind 2 Stunden gültig; verwenden Sie das Refresh Token, um ein neues Paar zu erhalten.
Refresh Tokens rotieren bei jeder Verwendung — speichern Sie immer das neueste Paar.
Jedes Token ist an ein Team gebunden: das Team des Benutzers, der es autorisiert hat.

Senden Sie das Token bei jeder Anfrage mit:

Authorization: Bearer YOUR_ACCESS_TOKEN

Beginnen Sie mit GET /api/v1/me — der Aufruf gibt das autorisierte Team, dessen Angebotsvorgaben und die Scopes Ihres Tokens zurück.

Was Sie bauen können

Angebotsautomatisierung — Kunden und Angebote erstellen (POST /api/v1/quotes), Positionen gesammelt hinzufügen, senden oder veröffentlichen und das PDF herunterladen. Team-Vorgaben (AGB, Gültigkeitsdauer, Zahlungsbedingungen, Preismodus) werden automatisch angewendet.
KI-Angebote — POST /api/v1/ai_quotes verwandelt eine Auftragsbeschreibung in Alltagssprache mithilfe Ihrer Artikelbibliothek in einen vollständigen Angebotsentwurf.
Zahlungsverfolgung — fragen Sie status / payment_status eines Angebots ab oder listen Sie /api/v1/payments für Beträge, Gebühren und Netto-Auszahlungen auf.
Buchhaltung — prüfen Sie den Verbindungsstatus unter GET /api/v1/integrations und stoßen Sie einen QuickBooks- oder Xero-Katalogabruf mit POST /api/v1/integrations/{provider}/sync an.

Eine vollständige Anleitung mit Beispielanfragen finden Sie in unserem zweiteiligen Leitfaden: Ihren Workspace einrichten und Ihre App mit der API verbinden.

Limits und Fehler

Der allgemeine API-Verkehr ist pro IP ratenbegrenzt; die KI-Generierung ist auf 10 Anfragen pro Minute und Team begrenzt. Eine 429-Antwort bedeutet: warten und erneut versuchen.
401 — abgelaufenes oder widerrufenes Token (aktualisieren und erneut versuchen). 402 insufficient_credits — das KI-Credit-Guthaben des Teams ist aufgebraucht. 422 — Validierungsfehler, mit Details im Antwortkörper.

Widerrufen Sie eine verbundene Anwendung jederzeit unter Einstellungen → Entwickler oder als Endbenutzer über Ihre Seite der autorisierten Anwendungen — ihre Tokens funktionieren sofort nicht mehr.