Ein Zugriffstoken ermöglicht einem externen Tool, zum Beispiel einer Buchhaltungssoftware, einige Ihrer Malt-Daten zu lesen. Sie erstellen es unter Mein Konto und kopieren es dann in das Tool. Malt zeigt es nur einmal an.
- Öffnen Sie Mein Konto und dann API-Schlüssel.
- Erstellen Sie ein Token mit der Berechtigung READ_INVOICE für ein Tool, das Ihre Rechnungen importiert.
- Kopieren Sie es sofort. Wenn es nicht mehr angezeigt wird, erstellen Sie ein neues: Die Seite zeigt es nur einmal.
Wo Sie es erstellen
- Öffnen Sie Mein Konto.
- Wählen Sie API-Schlüssel. Die Seite heißt Zugriffstokens.
- Klicken Sie auf Token erstellen.
- Lassen Sie unter Tokentyp den Wert Account.
- Wählen Sie unter Berechtigungen READ_INVOICE. Das ist der Lesezugriff auf Ihre Rechnungen. Für ein Tool, das Ihre Rechnungen importiert, reicht diese Berechtigung.
- Füllen Sie Tokenname aus. Der Name des Tools passt.
- Notiz (optional) kann leer bleiben.
- Klicken Sie auf Erstellen.
- Kopieren Sie das Token sofort. Die Seite zeigt: „Vergewissern Sie sich, dass Sie Ihr neues Zugriffstoken jetzt kopieren. Sie werden es danach nicht mehr abrufen können!“
Der Bildschirm zeigt den Code READ_INVOICE, nicht einen Satz wie „Rechnungen lesen“.
In das Tool einfügen
Fügen Sie das Token im Tool an der Stelle ein, die für die Verbindung mit Malt vorgesehen ist. Fügen Sie es vollständig ein, ohne Leerzeichen davor oder danach.
Wenn Sie das Fenster geschlossen haben, bevor Sie es kopieren konnten, erstellen Sie ein neues und löschen Sie das nicht kopierte. Ein neues Token reicht in diesem Fall.
Wenn das Tool das Token ablehnt
Der Ablehnungsgrund erscheint im Tool, nicht auf Malt.
- Prüfen Sie, ob das eingefügte Token vollständig ist, ohne Leerzeichen davor oder danach.
- Prüfen Sie, ob die Berechtigung READ_INVOICE ausgewählt ist.
- Erstellen Sie bei Bedarf ein neues Token mit dieser Berechtigung und fügen Sie dieses ein.
Wenn das Tool auch dieses neue Token ablehnt, schreiben Sie an den Malt-Support. Nennen Sie den Tokennamen, das Erstellungsdatum und die vom Tool angezeigte Meldung. Senden Sie das Token nicht.
Wann Sie den Support kontaktieren
Schreiben Sie dem Support in zwei Fällen.
- Die Seite zeigt: „Ein unerwarteter Fehler ist aufgetreten, das Zugriffstoken konnte nicht erstellt werden.“
- Ein Tool lehnt ein Token ab, das Sie gerade erstellt haben, obwohl READ_INVOICE ausgewählt ist und das Token vollständig eingefügt wurde.
Nennen Sie den Tokennamen, das Datum und die vom Tool angezeigte Meldung. Senden Sie das Token nicht: Es gibt Zugriff auf Ihre Rechnungen.
Wenn das Token nicht mehr angezeigt wird, können Sie selbst ein neues erstellen. Die Seite zeigt es nur einmal.