DE
DE
Die Übermittlung von Bekanntmachungen an den Vermittlungsdienst kann über die REST-API des Vermittlungsdienst oder über das eDelivery-Network PEPPOL erfolgen.
Unter https://ozg-vermittlungsdienst.de werden die REST-API und die dazugehörige Dokumentation der vorhandenen Endpoints zur Verfügung gestellt.
Für die Nutzung der API müssen einmalig Zugangsdaten beantragt werden. Die Autorisierung erfolgt über OAuth 2.0.
Die Einrichtung eines neuen Accounts erfolgt über das Self-Service-Portal (Produktionsumgebung: https://self-service.datenservice-oeffentlicher-einkauf.de). Ein Konto kann im Portal erstellt werden, indem eine E-Mail-Adresse und ein Passwort festgelegt werden. Nach Bestätigung der E-Mail-Adresse kann der Nutzer sich anmelden und das Antragsformular für einen neuen VD-Account ausfüllen. Pro Vergabeplattform ist ein separater Benutzer notwendig.
Nach der Erstellung des Benutzers wird zur Überprüfung an die angegebene Benutzer-E-Mail-Adresse eine Authentifizierungs-E-Mail versendet, welche einen Link zur Authentifizierung und zur Erstellung des Passworts enthält. Werden z.B. 10 Accounts für eine Umgebung beantragt, werden auch 10 individuelle E-Mail-Adressen benötigt. Die E-Mail-Adresse dient zum Abruf der Tokens, die zur eindeutigen Authentifizierung mit dem Account erforderlich sind. Deshalb muss E-Mail-Adresse einzigartig sein. Der Link ist 10 Tage gültig. Nach einem Klick auf den Link erscheinen Anweisungen zur Passwort-Erstellung. Mit den erstellten Zugangsdaten können mit Hilfe der API ein Access-Token und ein Refresh-Token generiert werden. Es ist zu beachten, dass pro Entwicklungsumgebung (Preview, Staging, Produktion) ein Zugang zu beantragen ist. Es wird keine Synchronisierung der Zugangsdaten durchgeführt. - und -Accounts können in der entsprechenden Self-Service-Portalumgebung angefordert werden.
Der Endpunkt POST /api/token wird mit den zu übergebenden Parametern username und password genutzt, um einen access_token und refresh_token zu erhalten. username ist hierbei die angegebene E-Mail-Adresse.
Der access_token ist 24 Stunden gültig und kann bei allen folgenden Anfragen im Header folgendermaßen zur Autorisierung genutzt werden: Authorization: Bearer <<access_token>>. Nach Ablauf der 24 Stunden ist eine erneute Authentifizierung nötig. Um eine regelmäßige Authentifizierung mit username und password zu vermeiden, kann mit Hilfe des refresh_token und dem Endpunkt POST /api/token/refresh ein neuer access_token generiert werden, ohne eine erneute vollständige Authentifizierung durchführen zu müssen.
Durch das Anfragen eines neuen Tokens, wird der vorige Token nicht invalidiert.
Beispielantwort der Endpunkte POST /api/token und POST /api/token/refresh:
{
"access_token": "eyJhbGciOikpXVCJ9.eyJzMDIyfQ.SflKxwRJSM",
"expires_in": 36000,
"refresh_expires_in": 36000,
"refresh_token": "eyJhbGciOikpXVCJ9.eyJzMDIyfQ.SflKxwRJSM",
"token_type": "Bearer",
"not-before-policy": 0,
"session_state": "e65f24ae-4e90-4635-8ae7-4fb89fe471bf",
"scope": "profile email"
}
Weitere Informationen zum Konzept des Refresh-Token und Hinweise zur Umsetzung werden unter https://auth0.com/blog/refresh-tokens-what-are-they-and-when-to-use-them/ zur Verfügung gestellt.
Die Einlieferung von Bekanntmachungen an den Datenservice Öffentlicher Einkauf kann von Vergabeplattformen auch über die Peppol-Infrastruktur erfolgen.
In der Peppol-Infrastruktur registrierte Systeme können unter Verwendung des Peppol-Profils „P008 – Publish Notices“ Bekanntmachungen an den Adressaten mit der Peppol-ID „0204:994-DOEVD-83“ (Produktion) senden.
Die Kommunikation erfolgt über die Verwendung eines pre-award-fähigen AccessPoints, der entweder
Wichtig: Zur vollständigen pre-award-Fähigkeit des AccessPoints gehört die Unterstützung von „REM Evidence“, wie in der Dokumentation unter folgendem Link beschrieben:
Peppol BIS eDelivery Guide for Pre-Award v1.3
Fragen zur Registrierung sind über eine Peppol-Authority zu klären:
Liste der Peppol-Authorities
Die primäre Schnittstelle für die Übermittlung von Bekanntmachungen ist das PEPPOL-Netzwerk. Bekanntmachungen können wie folgt übermittelt werden:
0204:994-doevd-830204:994-doevdtest-85urn:fdc:peppol.eu:prac:bis:p008:1.2
urn:fdc:peppol.eu:prac:trns:t015:1.2).urn:fdc:peppol.eu:prac:trns:t016:1.2).oeffentliche-vergabe-peppoloeffentliche-vergabe-peppol-testPEPPOL-Nachrichten bestehen aus mehreren Schichten, die durch verschiedene Standards definiert sind. Jede Schicht umschließt die Daten der nächsten Schicht und erweitert sie um spezifische Aspekte, die erforderlich sind. Die Schichten von außen nach innen:
META-INF/ASiCManifest.xml, die alle enthaltenen Dateien mit Prüfsummen auflistet;META-INF/ASiCManifest.xml mit RootFile=true markiert. Diese Datei ist das Geschäfts- oder Prozessdokument, das verarbeitet werden soll;urn:fdc:peppol.eu:prac:trns:t015:1.2) empfangen, um Bekanntmachungen zu veröffentlichen;urn:fdc:peppol.eu:prac:trns:t016:1.1);Der PEPPOL-Zugangspunkt für den Vermittlungsdienst und der Bekanntmachungsservice werden vom Beschaffungsamt des BMI (BeschA) betrieben.
Self-Service-Portal der gewünschten Umgebung aufrufen (zu finden unter Systemumgebungen in der Zeile Self Service Portal ).
Auf ‚Passwort vergessen?' klicken.
E-Mail-Adresse eintragen und auf ‚Absenden' klicken.
Die Meldung ‚Sie sollten in Kürze eine E-Mail mit weiteren Instruktionen erhalten' wird angezeigt.
Um einen Zugang zu löschen, ist eine E-Mail an den Support des Datenservices Öffentlicher Einkauf support@datenservice-oeffentlicher-einkauf.de zu senden.
In der E-Mail müssen folgende Angaben enthalten sein:
Nach Prüfung der angegebenen Daten in der E-Mail werden die Löschung des Zugangs durchführt und eine Bestätigung per E-Mail versendet.
Überprüfen der E-Mails: Ein Link zum Zurücksetzen der Anmeldeinformationen ist in der E-Mail erhalten.
Auf ‚Link zum Zurücksetzen von Anmeldeinformationen' klicken.
Der Benutzer wird auf die Seite ‚Passwort aktualisieren' umgeleitet.
Neues Passwort eintragen und bestätigen und auf ‚Absenden' klicken.
Das Passwort muss aus mindestens 8 Zeichen bestehen, 1 Großbuchstaben und 1 Zahl enthalten.
Das Passwort muss in der Software des Fachverfahrensherstellers hinterlegt werden, um sicher zu gehen, dass die Verbindung mit dem Vermittlungsdienst funktioniert.