Modul · 6 €/Monat zzgl. MwSt.
Deine eigene Software arbeitet mit almdesk zusammen.
Für alle, die almdesk mit eigener Software verbinden wollen: eine REST-Schnittstelle für Kunden, Produkte, Belege und Bestellungen und Webhooks, die melden, wenn sich etwas tut.
Das kann das Modul
Schlüssel mit Namen. Du legst mehrere Schlüssel an und gibst jedem einen Namen. Den Schlüssel selbst zeigt almdesk genau einmal.
Lesen oder lesen und schreiben. Je Schlüssel legst du fest, ob er nur lesen darf oder auch schreiben.
Im Blick und widerrufbar. In der Liste steht, wann ein Schlüssel zuletzt benutzt wurde. Du kannst ihn widerrufen.
Kunden und Produkte. Kunden lesen, anlegen, ändern und löschen. Produkte lesen, anlegen und ändern.
Belege und Bestellungen. Belege lesen, gefiltert nach Art, Status, Kunde und Zeitraum, und Belege anlegen. Bestellungen lesen.
Webhooks für vier Ereignisse. Rechnung angelegt, Rechnung bezahlt, Kunde angelegt, Kunde geändert. Du trägst die Adresse ein und kreuzt die Ereignisse an. Webhooks lassen sich pausieren, fortsetzen und löschen.
Signiert, wiederholt, protokolliert. Jede Zustellung ist signiert. Kommt sie nicht an, versucht almdesk es fünfmal erneut und pausiert den Webhook nach wiederholten Fehlern. Die letzten 50 Zustellungen stehen im Protokoll.
Klare Regeln für den Zugriff. Anmeldung per Bearer-Token, bis zu 60 Anfragen je Minute und Schlüssel.
Kurz-Dokumentation in der App. Endpunkte, Ereignisse und ein Beispiel für die Signaturprüfung.
So läuft es
Schlüssel anlegen. In den Einstellungen unter „API-Zugriff“ legst du einen Schlüssel an und nennst ihn zum Beispiel „Zeiterfassung“. Kopier ihn gleich: almdesk zeigt ihn nur einmal.
Anfragen schicken. Dein Programm meldet sich mit dem Schlüssel an, liest Kunden oder legt einen Beleg an.
Webhook einrichten. Du trägst die Adresse deines Programms ein und kreuzt die Ereignisse an. Von da an meldet almdesk zum Beispiel jede bezahlte Rechnung.
Nachsehen. Im Zustell-Protokoll steht, was ankam und was nicht.
Greift ineinander
Grundtarif. Die Schnittstelle arbeitet mit denselben Kunden, Produkten und Belegen wie die Oberfläche.
Voraussetzung. Jemand, der programmiert. Fertige Anbindungen an andere Werkzeuge bringt das Modul nicht mit.
Preis
6 € im Monat zzgl. MwSt.
6 € im Monat oder 60 € im Jahr, jeweils zzgl. MwSt. und zusätzlich zum Grundtarif. Abwählen kannst du es jederzeit in den Einstellungen unter „Module“. Es bleibt dann bis zum Ende des Abrechnungszeitraums aktiv. In den 30 Testtagen ist das Modul dabei, wenn du es bei der Anmeldung auswählst.
Fragen und Antworten
Was kann ich über die Schnittstelle tun?
Kunden lesen, anlegen, ändern und löschen. Produkte lesen, anlegen und ändern. Belege lesen und anlegen. Bestellungen lesen.
Kann ich almdesk mit meinem Werkzeug verbinden?
Wenn dein Werkzeug eine REST-Schnittstelle ansprechen oder Webhooks empfangen kann, oder wenn jemand das für dich programmiert: ja. Fertige Anbindungen liefern wir nicht mit.
Was mache ich, wenn ein Schlüssel in falsche Hände gerät?
Du widerrufst ihn in der Liste und legst einen neuen an. Schlüssel, die nur lesen sollen, beschränkst du von Anfang an aufs Lesen.
Gibt es ein Limit?
Ja, 60 Anfragen je Minute und Schlüssel.