Schnittstelle
Belege aus anderen Programmen – über die REST-API.
Umfang
Was die API kann.
| Bereich | Möglich | Recht |
|---|---|---|
| Belege | Auflisten (auch nur seit einem Zeitpunkt geänderte) und abrufen, PDF – auch das archivierte Original – und E-Rechnung (ZUGFeRD, ebInterface) herunterladen, Zahlungen eines Belegs und den Zahlungsvorschlag samt Skonto abrufen | documents:read |
| Belege | Anlegen – Kontakt wird gefunden oder angelegt, Artikel werden übernommen –, ausstellen, Status ändern, mit Stornobeleg stornieren, Zahlungen erfassen – selbst erfasste innerhalb von 24 Stunden auch wieder löschen – und das Ergebnis eines Angebots (angenommen, abgelehnt) eintragen | documents:write |
| Belege | Per E-Mail versenden – mit Vorlage, PDF und auf Wunsch E-Rechnung im Anhang | documents:send |
| Kontakte | Auflisten, filtern und abrufen – mit Ansprechpersonen, Adressen sowie Notizen, Anrufen, Terminen und Besuchen | contacts:read |
| Kontakte | Anlegen und ändern, Adressen verwalten | contacts:write |
| Artikel | Auflisten und abrufen, Artikelbild laden | articles:read |
| Artikel | Anlegen, ändern und Lagerbestand buchen (Eingang, Ausgang, Inventur) | articles:write |
| Eingangsrechnungen | Rechnungen und Gutschriften von Lieferanten auflisten (auch nur seit einem Zeitpunkt geänderte) und abrufen – mit Zeilen und Zahlungen | purchase-invoices:read |
| Eingangsrechnungen | Rechnungen und Gutschriften von Lieferanten erfassen – als Entwurf zum Prüfen oder gleich gebucht – und Zahlungen an Lieferanten buchen | purchase-invoices:write |
| Zeiten | Zeiteinträge aller Mitglieder auflisten (auch nur seit einem Zeitpunkt geänderte) und abrufen – mit Kunde, Artikel und Rechnung | time-entries:read |
| Zeiten | Zeit für die Verrechnung für ein Mitglied erfassen – als Dauer oder mit Beginn, Ende und Pause, etwa aus einer Baustellen-App | time-entries:write |
Beispiel
Eine Shop-Bestellung wird zur Rechnung.
"issue": true stellt die Rechnung sofort aus. Beträge werden in Cent übergeben, Steuersätze in Basispunkten (2000 = 20 %). curl -X POST https://crm.buchify.at/api/v1/documents \
-H "Authorization: Bearer $BUCHIFY_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Idempotency-Key: shop-order-1001" \
-d '{
"type": "invoice",
"order_reference": "SHOP-1001",
"contact": {
"first_name": "Eva",
"last_name": "Beispiel",
"email": "eva.beispiel@example.com",
"street": "Ring 1", "zip": "1010", "city": "Wien", "country": "AT"
},
"items": [
{ "article_id": 42, "quantity": 2 },
{ "title": "Versand", "unit_price": 590, "vat_rate": 2000 }
],
"issue": true
}'contacts:write. Die vollständige Beschreibung aller Felder steht in der API-Dokumentation. Sicher und nachvollziehbar
Gebaut für den Dauerbetrieb.
API-Schlüssel je Firma
Inhaber erstellen Schlüssel in den Firmendaten. Der Schlüssel wird nur einmal angezeigt, kann ein Ablaufdatum haben und auf einzelne IP-Adressen oder Netze beschränkt werden.
Schlüssel erneuern ohne Ausfall
Ein Schlüssel lässt sich mit denselben Rechten neu erzeugen; der alte gilt auf Wunsch noch 1 Stunde, 24 Stunden oder 7 Tage weiter – oder wird sofort ungültig.
Webhooks
Buchify meldet gewählte Ereignisse sofort an Ihr System – etwa „Beleg ausgestellt“, „Beleg bezahlt“, „Zahlung erfasst“, „Kontakt geändert“ oder „Lagerbestand geändert“. Inhaber richten bis zu 10 Webhooks je Firma ein, nur über HTTPS.
Signiert und zuverlässig zugestellt
Jede Nachricht ist mit HMAC-SHA256 signiert. Nimmt Ihr System sie nicht an, wiederholt Buchify die Zustellung bis zu sechsmal – von einer Minute bis zu einem Tag später; jede Zustellung lässt sich im Protokoll nachsehen und erneut senden.
Keine doppelten Belege
Mit dem Header
Idempotency-Keyliefert eine Wiederholung derselben Anfrage (24 Stunden je Schlüssel) das ursprüngliche Ergebnis – nach einem Timeout entsteht keine zweite Rechnung.Dieselbe Logik wie in der Oberfläche
Nummernkreise, Lagerbuchungen, Sperren und Berechnung arbeiten genauso wie beim Erfassen per Hand. Parallele Aufrufe sind abgesichert.
Protokolliert
Jede Anfrage mit gültigem Schlüssel und jede Webhook-Zustellung steht 30 Tage im Protokoll; Änderungen erscheinen dort mit dem Namen des Schlüssels, etwa „API: Shop“.
Klare Grenzen
Bis zu 120 Anfragen pro Minute und Schlüssel. Fehlermeldungen nennen die Felder so, wie sie geschickt wurden – auf Deutsch oder Englisch über
Accept-Language.Offen dokumentiert
Die Referenz aller Endpunkte, Felder und Antworten ist öffentlich unter crm.buchify.at/docs/api einsehbar.
Zugang zu Buchify
Ihr Shop schreibt die Rechnungen – Buchify behält den Überblick.
Zugänge werden persönlich eingerichtet – schreiben Sie unserem Vertriebspartner Tegra IT, Ihre Firma wird angelegt und Sie erhalten die Einladung.