Schritt-für-Schritt – API-Zugang

Dieses Kapitel beschreibt den Schritt-für-Schritt-Ablauf zur Nutzung der Onlinedienst Weinbau API.
Es umfasst die Voraussetzungen und den Zugriff über das Unternehmenskonto (mUK).

Der Fokus liegt auf den konkreten Schritten, die erforderlich sind, um die API erfolgreich zu verwenden.

Schritt 0: Voraussetzungen für die Teilnahme

Unter welchen Voraussetzungen kann ich am Onlinedienst Weinbau teilnehmen?

Sie können am Onlinedienst Weinbau teilnehmen, wenn Sie ein Betrieb der Weinbranche sind (Marktteilnehmer im Sinne von Art. 8 der VO (EU) 2018/273) und über eine Betriebsnummer verfügen. Die Betriebsnummer wird von der zuständigen Behörde Ihres Bundeslandes vergeben. Sofern Sie noch keine Betriebsnummer haben bzw. diese Ihnen nicht bekannt ist, wenden Sie sich bitte an Ihre zuständige Behörde (siehe Schritt 2).

Zur Teilnahme am Onlinedienst Weinbau müssen Sie über das bundesweit einheitliche Unternehmenskonto („Mein Unternehmenskonto“, kurz: mUK) verfügen, mit dem Sie sich bei vielen staatlichen, digitalen Leistungen autorisieren können (siehe Schritt 1).

Schritt 1: Zugriff auf das Unternehmenskonto (mUK)

Wie komme ich zu meinem Unternehmenskonto (mUK)?

Das mUK basiert auf der aus der Finanzverwaltung bekannten Technologie von ELSTER. Wenn Sie bereits ein ELSTER Zertifikat besitzen, können Sie auf der Startseite von https://mein-unternehmenskonto.de auf den Button „Einloggen“ klicken und sich mit Ihrem ELSTER Zertifikat und dem zugehörigen Passwort einloggen, um das Konto zu erstellen.

Wenn Sie noch nicht über ein ELSTER Zertifikat verfügen, drücken Sie den Button „Konto erstellen“. Sie werden dann auf das ELSTER Portal umgeleitet und müssen dort den geführten Prozess durchlaufen. Bitte beachten Sie, dass das zugehörige Passwort postalisch zugestellt wird und der Vorgang deshalb mehrere Tage dauern kann.

Schritt 1.1: Berechtigungen im Unternehmenskonto für Organisationskonten

Hinweis: Dieser Schritt ist nur relevant für Organisationskonten im mUK.

Die Nutzung des Onlinedienstes Weinbau sowie das Erstellen von API-Tokens ist nur möglich, wenn der Onlinedienst zuvor im Unternehmenskonto aktiviert wurde.
Die Verwaltung erfolgt ausschließlich über das Unternehmenskonto unter https://meinuk.de.

Voraussetzungen

Nutzung eines Organisationskontos im mUK
Ein Benutzerkonto ist der Organisation zugeordnet
Der Onlinedienst Weinbau ist für die Organisation aktiviert

Berechtigungen vergeben

Melden Sie sich im Unternehmenskonto (mUK) an.
Aktivieren Sie den Onlinedienst Weinbau für Ihre Organisation.
Öffnen Sie die Rollen- und Berechtigungsverwaltung.
Wählen Sie das entsprechende Benutzerkonto aus.
Aktivieren Sie die benötigten Funktionsrollen.

Für die Nutzung der API ist mindestens folgende Funktionsrolle erforderlich:

Zugriff auf die Schnittstelle verwalten

Ermöglicht das Erstellen und Verwalten von API-Tokens für den Zugriff auf die REST-Schnittstelle.
Die Schnittstelle wird für die Anbindung eigener Systeme an den Onlinedienst Weinbau benötigt.

Wichtige Hinweise zu Funktionsrollen und Tokens

Wird die Funktionsrolle entzogen, bleiben bereits erstellte API-Tokens weiterhin gültig
Bestehende Tokens müssen in diesem Fall manuell gelöscht werden
Diese Regelung betrifft ausschließlich Zertifikate vom Typ Organisationskonto

Schritt 1.2: Weiterführende Informationen

Eine ausführliche Beschreibung zur Einrichtung und Nutzung des Unternehmenskontos finden Sie im offiziellen Quickstart-Guide:

📄 Quickstart Guide – Nutzende Organisationen (barrierefrei)
https://meinuk.de/assets/downloads/Quickstart_Guide_nutzende_Organisationen_barrierefrei.pdf

Hinweis:
Erst nach erfolgreicher Aktivierung des Onlinedienstes und Vergabe der entsprechenden Funktionsrollen ist die Erstellung eines API-Tokens möglich.
Danach können Sie mit der technischen Anbindung an die Onlinedienst Weinbau API beginnen.