Schritt-für-Schritt – Token-Erstellung und Löschung
Dieses Kapitel beschreibt die Schritt-für-Schritt-Erstellung und Löschung eines API-Tokens für die Nutzung der Onlinedienst Weinbau API.
Schritt 1: Zugriff auf das Unternehmenskonto (mUK)
Section titled “Schritt 1: Zugriff auf das Unternehmenskonto (mUK)”Nachdem Sie den API-Zugang freigeschaltet haben, können Sie sich mit Ihrem ELSTER-Zertifikat und dem zugehörigen Passwort auf https://onlinedienst-weinbau.de/ einloggen und das Unternehmenskonto nutzen.
Schritt 2: Betriebsnummer und zuständige Behörde
Section titled “Schritt 2: Betriebsnummer und zuständige Behörde”Welche Behörde kann mir meine Betriebsnummer nennen oder mir eine Betriebsnummer vergeben?
Sie können Ihre zuständige Behörde auf dem Onlineportal des Bundes unter der Internetadresse https://servicesuche.bund.de ermitteln.
Auf der Startseite des Portals müssen Sie Ihren Sitzort, die zugehörige Postleitzahl auswählen und Ihr Anliegen eingeben. Als Anliegen geben Sie bitte „Onlinedienst Weinbau“ ein und klicken auf „suchen“.
Wählen Sie aus den angezeigten Ergebnissen die gewünschte Leistung aus (derzeit nur „Begleitdokumente für Weintransporte ausstellen“) und klicken dann auf die Informationsseite dieser Leistung. Unter dem Menüpunkt „Anlaufstellen“ erhalten Sie die Adresse, Telefonnummer und E-Mail-Adresse Ihrer zuständigen Behörde. Alternativ können Sie Ihre zuständige Behörde auch über das Onlineportal ermitteln.
Schritt 3: API-Token erstellen
Section titled “Schritt 3: API-Token erstellen”Klicken Sie im Onlinedienst Weinbau auf den Reiter Begleitdokument und dann auf den Unterreiter API-Schnittstelle.
Voraussetzungen:
- Die Nutzung der API muss in Ihrem Bundesland freigeschaltet sein.
Anschließend können Sie ein neues Token erstellen:
- Klicken Sie auf Neues Token erstellen.
- Wählen Sie einen aussagekräftigen Namen für das Token.
- Legen Sie eine Gültigkeitsdauer fest.
- Bestätigen Sie die Erstellung.
- Kopieren Sie das Token an einen sicheren Ort, da es nur einmal vollständig angezeigt wird.
Nach diesem Schritt sind Sie bereit, die API zu benutzen und können Begleitdokumente abrufen, einreichen oder Stammdaten abfragen.
Schritt 4: API-Token löschen
Section titled “Schritt 4: API-Token löschen”Um ein bestehendes API-Token zu löschen, wählen Sie das gewünschte Token in der Übersicht aus.
Anschließend erscheint ein Hinweisfenster, das fragt:
“Sind Sie sicher, dass Sie dieses Token löschen möchten?”
Bestätigen Sie diesen Hinweis, um das Token endgültig zu entfernen.
Damit wird der Zugriff auf die API über dieses Token sofort deaktiviert.
