Page History

Ziel der XVergabe-Kommunikationsschnittstelle ist die Schaffung eines einheitlichen und standardisierten Zugangs zu den unterschiedlichen elektronischen Bekanntmachungs- und Vergabeplattformen der öffentlichen Hand aus Sicht der Bieter(werkzeuge). Hierfür wurde ein plattformübergreifender Standard für den zuverlässigen und sicheren Austausch von Daten und Dokumenten zwischen Wirtschaftsteilnehmern (Unternehmen) und den elektronischen Vergabeplattformen definiert, die die Teilnahme der Wirtschaftsteilnehmer an elektronischen Vergabeprozessen der öffentlichen Verwaltung erleichtert und auf diese Weise dazu beiträgt, Prozesskosten einzusparen.

Die XVergabe-Kommunikationsschnittstelle definiert somit eine Schnittstelle zwischen Vergabeplattformen und Bieteranwendungen. Die Bieteranwendung wird somit in die Lage versetzt, verschiedene Vergabeplattformen anzusprechen und die definierten Anwendungsfälle im Vergabe- und Beschaffungswesen gleichförmig abzubilden. Die XVergabe-Kommunikationsschnittstelle fördert hierdurch die Erstellung von so genannten „Multi Plattform Bieter Anwendungen bzw. Clients“ (kurz auch: MPBC), die mittelbar eine Vereinfachung für die Wirtschaftsteilnehmer bei der Beteiligung an der elektronischen Vergabe darstellen.

Die XVergabe-Kommunikationsschnittstelle definiert hierbei (noch) nicht:

• wie Vergabeunterlagen zu strukturieren sind (und deren inhaltlich-semantisches Datenmodell),
• die Schnittstellen der Vergabeplattformen zu Bekanntmachungsplattformen,
• die Schnittstellen der Vergabeplattformen/Vergabemanagementsysteme zu den Vergabestellen.

Mit der Ausarbeitung der beiden erst genannten Themen sind jedoch XVergabe-Arbeitsgruppen befasst.

Die XVergabe-Kommunikationsschnittstelle umfasst die Spezifikation eines Web-Services zum Austausch von Nachrichten und Dokumenten. In diesen Nachrichten werden die zwischen einem Bieter und einer Vergabestelle auszutauschenden Daten und Dokumente um zusätzliche Metainformationen zur Einordnung in den jeweiligen Prozessschritt des Vergabeverfahrens angereichert.

Die XVergabe-Kommunikationsschnittstelle definiert weiterhin keine über die Schnittstelle hinausgehenden Anforderungen an eine Bieteranwendung oder Plattform.

Rahmenbedingungen

Beim Entwurf der XVergabe-Kommunikationsschnittstelle wurde eine Reihe von Annahmen basierend auf Erfahrungen aus der Praxis getroffen, die das Design der Schnittstelle und deren Verhalten beeinflussten.

So geht die XVergabe-Schnittstelle davon aus, dass ein Client eines Teilnehmers nicht permanent online erreichbar oder gar technisch adressierbar ist. Somit basiert das Kommunikationsverhalten der Schnittstelle im Wesentlichen auf Aktionen, die die Bieteranwendung auslöst. Um Kommunikationsnachrichten mit einem Teilnehmer austauschen zu können, MUSS eine Plattform der Bieteranwendung diese zum Abruf bereitstellen. Hierfür muss der Teilnehmer innerhalb der Plattform authentifiziert und einem Nutzer zugeordnet werden. Eine ggf. hierfür notwendige Registrierung des Nutzers an der Plattform ist (noch) nicht Teil der XVergabe-Kommunikationsschnittstelle. Derzeit wird von vorregistrierten Nutzern ausgegangen, die sich authentifizieren können. Sofern die Authentifizierung fehl schlägt (oder schlicht aus Sicht des Teilnehmers nicht möglich ist) SOLL eine Plattform den Teilnehmer auf eine Webseite zur Registrierung hinweisen, die die Plattform anbietet.

In der Regel wird eine

Ebenso wird davon ausgegangen, dass Nachrichten zur Prozesssteuerung von der Vergabestelle (bzw. –plattform) an die Bieteranwendung keine Anlagen als Binärdaten (bspw. die Auftragsunterlagen im PDF-Format) enthalten. Diese werden seitens einer Plattform lediglich referenziert. Eine Bieteranwendung MUSS diese Dokumente explizit von der Plattform über die XVergabe-Kommunikationsschnittstelle anfordern. Somit werden auch leichtgewichtige Clients unterstützt, die ggf. keinen Zugriff auf die Unterlagen benötigen (bspw. um lediglich Statusinformationen über das Verfahren mitzuteilen).

Umgedreht enthalten Nachrichten vom Bieter aber immer die ggf. referenzierten Anlagen direkt innerhalb der Kommunikationsnachricht.

Da einige Vergabestellen und Betreiber von Vergabeplattformen Anforderungen an die Transport-Infrastruktur stellen, berücksichtigt die XVergabe-Kommunikationsschnittstelle für die „Geschäfts-kritischen“ Anwendungsfälle „Abgabe von Angeboten“, „Abgabe von Teilnahmeanträgen“ sowie deren Rückzüge neben den hierfür der Schnittstelle definierten Möglichkeiten auch die Möglichkeit zur Abbildung dieser Anwendungsfälle über eine OSCI-Transport-Infrastruktur (derzeit in Version 1.2). Sofern eine Vergabeplattform oder Vergabestelle entsprechende Anforderungen umsetzen muss, MUSS sie die Bieteranwendung hierüber in Kenntnis setzen. Dies geschieht technisch in der XVergabe-Kommunikationsschnittstelle durch Mitteilung der technischen Verbindungsparameter für OSCI-Transport innerhalb der Aufforderung zur Angebotsabgabe bzw. Aufforderung zur Abgabe eines Teilnahmeantrags. Die jeweiligen Rückzüge MÜSSEN durch eine solche Plattform dann auch über OSCI-Transport angenommen und verarbeitet werden. Die Plattformen SOLLEN sich auf eine Form der Einreichung von Angeboten (XVergabe-Kommunikationsschnittstelle oder OSCI-Transport) festlegen. D.h. eine Plattform SOLL eine Angebotsabgabe über die XVergabe-Kommunikationsschnittstelle ablehnen, wenn sie die technischen Parameter zur Angebotsabgabe via OSCI-Transport mitgeteilt hat. Der Ablauf der Kommunikation (Choreographie) in einem Szenario, in dem für die Angebotsabgabe und –rückzug OSCI-Transport eingesetzt wird, wird im Kapitel „Abgabe von Angeboten, TNAs und Rückzügen via OSCI-Transport“ nochmals detailliert beschrieben. Eine Bieteranwendung MUSS im Gegensatz zu einer Plattform OSCI-Transport immer unterstützen.

Darüber hinaus setzen verschiedene Vergabestellen und deren Plattformen unterschiedliche Anforderungen hinsichtlich dem Einsatz von Signaturen und Verschlüsselungen sowie der Strukturierung von Angeboten und Teilnahmeanträgen (TNA) um. Die XVergabe-Kommunikationsschnittstelle unterstützt diese Vielfalt derart, dass die Vergabestelle bzw. die –plattform ebenfalls in den Nachrichten zur Angebotsaufforderung („InvitationToTender“, kurz: ITT) bzw. Aufforderung zur Abgabe eins Teilnahmeantrags („InvitationToParticipation“, kurz: ITP) ihre jeweiligen Anforderungen definiert und der Bieteranwendung und somit auch dem Teilnehmer mitteilt. Sie legt in den genannten Nachrichten fest:

• welche Dokumente Teil des Angebots bzw. des TNAs sein sollen,
• ob diese Dokumente vom Teilnehmer bzw. Bieter eigenständig beigebracht werden müssen oder von der Vergabestelle bezogen und ausgefüllt zurück übersandt werden müssen (Formulare),
• ob ein entsprechendes Dokument einzeln signiert werden soll oder ob eine so genannte Containersignatur über alle Bestandteile des Angebots bzw. des TNAs erbracht werden soll,
• welches Signaturniveau der Bieter bzw. Teilnehmer für die Signatur der Dokumente mindestens erbringen SOLL (die Prüfung auf Einhaltung und der Umgang mit dem Prüfergebnis obliegt der Vergabestelle),
• ob und für wen das Angebot bzw. der TNA verschlüsselt werden soll und
• ob der jeweilige Rückzug ein bestimmtes Mindest-Signaturniveau erfordert.

Die XVergabe-Kommunikationsschnittstelle sieht keine Möglichkeit zur Einschränkung der zu nutzenden Zertifikate bzw. Signaturkarten auf bestimmte Zertifizierungsdiensteanbieter oder Hersteller vor. Sofern eine Plattform dies erfordert, muss sie dies in den Allgemeinen Geschäftsbedingungen regeln, denen der Teilnehmer im Rahmen der Registrierung zugestimmt hat.

Für die Erbringung von Signaturen definiert die XVergabe jedoch den folgenden technischen Rahmen, der umgesetzt werden MUSS:

• Signaturen MÜSSEN im „PKCS#7 Enveloped“ Format (vgl. RFC 2315) angebracht werden, d.h. das zu signierende Dokument wird zusammen mit seinen Signaturdaten in einer neuen Datei zusammengefasst, die das Originaldokument ersetzt.
• sofern mehrere Einzel-Dokumente zu signieren sind, so MÜSSEN diese wie vor genannt einzeln signiert werden. Sie werden anschließend im so genannten Angebots- bzw. TNA-Container zusammengefasst.
• Dokumente, welche inline signiert werden (bspw. PDF-Signatur im Dokument selbst), MÜSSEN sofern als „zu signieren“ seitens der Vergabestelle markiert ebenso wie oben beschrieben (ggf. zusätzlich) signiert werden. Die Angabe der Inline-Signatur wird durch XVergabe nicht explizit unterstützt.
• so genannte Container-Signaturen MÜSSEN wie folgt durch eine Bieteranwendung unterstützt werden:
• Sofern die Vergabestelle (bzw. -plattform) Containersignatur für die Angebots- bzw. TNA-Abgabe vorgesehen und in der ITT bzw. ITP definiert hat, „überschreibt“ diese Angabe jede Signaturanforderung auf Dokumentenebene. D.h. wenn Containersignaturen gefordert werden, entfällt die Anforderung an die Signatur von einzelnen Dokumenten.
• Containersignaturen werden durch die Signatur einer „Meta-Datei“ (offercontent.xml bzw. participationcontent.xml) – definiert innerhalb des XVergabe-Kommunikationsschnittstellen-Datenmodells – innerhalb des Angebots- bzw. TNA-Containers umgesetzt. Diese „Meta-Datei“ MUSS ein Inhaltsverzeichnis aller Bestandteile (Dokumente/Dateien) des Angebots bzw. TNAs zusammen mit deren SHA512-Hashwerten enthalten.
• Die Signatur über die „Meta-Datei“ MUSS ebenfalls im PKCS#7 Enveloped Format erfolgen.
• Die eingesetzten Signaturalgorithmen und deren Parametrisierung MÜSSEN den Ausführungen des aktuell gültigen Algorithmenkatalogs des Bundesamts für Sicherheit in der Informationstechnik (BSI) entsprechen. XVergabe schränkt die verwendbaren Algorithmen und Parameter nicht weiter ein.

Die XVergabe-Kommunikationsschnittstelle sieht Signaturen ausschließlich im Rahmen der Geschäfts-kritischen Anwendungsfälle „Abgabe von Angeboten“, „Abgabe von Teilnahmeanträgen“ sowie deren Rückzügen vor. Weitere Nachrichten KÖNNEN jedoch signierte Anlagen zur Nachricht beinhalten.

Für Angebots- und TNA-Container ist eine Verschlüsselung vorgesehen. Hierfür MUSS die Vergabeplattform bzw. –stelle der Bieteranwendung den für die Verschlüsselung zu verwendenden Schlüssel (Public Key) in Form eines DER-codierten X.509-Zertifikats zur Verfügung stellen (in der ITT- bzw. ITP-Nachricht). Die XVergabe-Kommunikationsschnittstelle legt für die Verschlüsselung folgenden technischen Rahmen, der unterstützt werden MUSS:

• Verschlüsselungen MÜSSEN mittels RSA v1.5 (PKCS#1) und einer Mindestschlüssellänge von 2048 Bit durchgeführt werden.
• Hybride Verschlüsselung, die in der Regel performanter als reine asymmetrische Verschlüsselung ist, wird durch die XVergabe-Kommunikationsschnittstelle unterstützt und ist dann anzuwenden, wenn die Vergabeplattform dies in der ITT- bzw. ITP-Nachricht als Option kennzeichnet. In diesem Fall erzeugt die Bieteranwendung einen symmetrischen Schlüssel, mit dem die Angebots- bzw. TNA-Container verschlüsselt werden. Dieser symmetrische Schlüssel wird mit dem von der Plattform bereitgestellten öffentlichen Schlüssel verschlüsselt.
• Folgende symmetrische Verschlüsselungsalgorithmen SOLLEN unterstützt werden:
• 3DES
• AES 128
• AES 192
• AES 256
• Als Verschlüsselungsformat MUSS PKCS#7 eingesetzt werden.

Die XVergabe-Kommunikationsschnittstelle führt nicht aus, ob das Sicherheitskonzept der Vergabeplattform Verfahrens- oder Teilnehmer-spezifische Schlüssel bereitstellen muss. Ebenso werden keine Anforderungen an das Schlüsselmanagement der Vergabeplattform gestellt.

Die XVergabe-Kommunikationsschnittstelle sieht für die Nutzung von OSCI-Transport vor, dass der Payload (also bspw. die Angebotsabgabenachricht inkl. verschlüsseltem Angebotscontainer, der ggf. signierte Dokumente enthält) identisch zum Transportweg der XVergabe-Kommunikationsschnittstelle gebildet wird. Lediglich die genutzte Transportinfrastruktur ändert sich. Somit bilden XVergabe-Nachrichten den Payload (dort auch Fachdaten genannt) von OSCI-Transport-Nachrichten.

Die XVergabe-Kommunikationsschnittstelle geht weiterhin davon aus, dass ein Vergabeverfahren einem Lebenszyklus (auch Verfahrensstatusmodell) unterliegt. Dies ist im Kapitel „Verfahrensstatusmodell“ näher beschrieben. Das Verfahrensstatusmodell regelt hierbei auch in welchem Status des Verfahrens welche Nachrichten der XVergabe-Kommunikationsschnittstelle unterstützt werden MÜSSEN bzw. nicht unterstützt werden DÜRFEN. Dieses Verfahrensstatusmodell MUSS durch die die Schnittstelle implementierenden Anwendungen (Plattformen und Bieteranwendungen) gleichermaßen umgesetzt werden, da es die steuernde Basis der Kommunikation darstellt.

Die XVergabe-Kommunikationsschnittstelle MUSS https-gesichert in den Plattformen umgesetzt werden. Für die Zertifikate der Plattformen die hierfür eingesetzt sind, werden seitens XVergabe keine weiteren Anforderungen definiert. Zusätzlich zu dieser Absicherung bzgl. Vertraulichkeit und Integrität der Kommunikation MÜSSEN Bieteranwendungen eine https-Clientauthentifizierung durchführen. Diese dient dem Nachweis der Konformität der Bieteranwendung. XVergabe-Konformitätsbestätige Clientanwendungen erhalten vom Beschaffungsamt ein Zertifikat, welches die Bieteranwendung im Rahmen der https-Clientauthentifizierung einer XVergabe-konformen Plattform präsentieren MUSS. 

Es kann nicht ausgeschlossen werden, dass die in den Anlagen (bspw. Auftragsunterlagen) enthaltenen Informationen abweichen von den Informationen, die bspw. in der ITT aufgeführt werden. Daher gilt grundsätzlich: Die Informationen der ausgetauschten Dokumente sind führend! Die XVergabe-Kommunikationsschnittstelle dient dem einheitlichen Austausch dieser Dokumente.

Für die Kommunikation SOLL eine Plattform Begrenzungen für die Größe der durch die Bieteranwendung in den Nachrichten eingebundenen Anlagen festlegen können. Diese Größenbeschränkung SOLLEN sowohl pro Anlage als auch über alle Anlagen einer Nachricht zusammen aufführbar sein. Die XVergabe-Kommunikationsschnittstelle ermöglicht diese beschränkenden Angaben in der TenderMetaInformation-Nachricht (TMI). Eine Bieteranwendung SOLL diesen darin aufgeführten Größenbeschränkungen Folge leisten, um eine zuverlässige Kommunikation sicherzustellen. Ein Überschreiten der Größenbeschränkungen kann zur technischen Nicht-Verarbeitbarkeit der Nachricht führen. Bei den Angaben ist zu beachten, dass es sich um Brutto-Angaben handelt, d.h. der durch die notwendige base64-Transformation der Daten entstehende Overhead von ca. 33% ist in der Angabe mit eingerechnet.

Innerhalb von XVergabe-Nachrichten und Dokumenten werden eindeutige Identifier vergeben. Diese dienen dazu das entsprechende Objekt an anderer Stelle zu referenzieren (bspw. die ITT-Nachrichten-ID bei der Angebotsabgabe um Plattform-seitig prüfen zu können, ob sich das Angebot auf die letzte Version der Auftragsunterlagen bezieht) bzw. um Objekte innerhalb einer Nachricht miteinander zu verknüpfen (bspw. Anlagen). Sämtliche Identifier sind im Format einer UUID aufgebaut und sind hierdurch global (Plattform-übergreifend) eindeutig. Sofern nicht anders angegeben, gilt ein übertragenes Verursacherprinzip: Derjenige Kommunikationsteilnehmer MUSS eine ID für das relevante Objekt vergeben, wenn er es erzeugt, d.h. die Nachrichten-ID MUSS jeweils von der Bieteranwendung und der Plattform erzeugt werden (in Abhängigkeit davon, wer die Nachricht erzeugt). Eine Plattform-seitig erstellte Nachrichten-ID MUSS weiterhin auch für gleichförmige Nachrichten an unterschiedliche Teilnehmer unterschiedlich sein (bspw. im Falle von Antworten auf Bieterfragen erhält jede einzelne Nachricht an einen Teilnehmer, obwohl die gleiche Information übertragen wird (die Antworten), eine unterschiedliche Nachrichten-ID.

Vergabeplattformen KÖNNEN für die Angebots- und TNA-Abgabe die zugehörigen Dokumente auf logische Container (Angebots- bzw. TNA-Container) durch die Bieteranwendung verteilen lassen. Hierdurch wird der Prozess der Angebots- bzw. TNA-Öffnung Plattformseitig von der Größe des Angebots entkoppelt. Die Plattform legt daher für die Bieteranwendung fest, welche Angebotsbestandteile in den primären Angebotscontainer (primary Container) eingebracht werden SOLLEN und welche nicht – die übrigen Angebotsbestandteile SOLLEN dann durch die Bieteranwendung zusammen mit den durch den Bieter selbständig (ohne Aufforderung) beigebrachten Dokumenten in den sekundären Angebotscontainer eingebracht werden. Legt eine Plattform fest, dass keine Aufteilung notwendig ist, werden SOLLEN alle Dokumente im primary Container zusammengefasst werden. 

Anchor
anwendungsfaelle anwendungsfaelle

Abgebildete Anwendungsfälle

Das elektronische Vergabe- und Beschaffungswesen kann anhand der nachfolgend dargestellten Prozesskette zusammenfassend beschrieben werden:

Die Unterteilung der eBeschaffungsprozesskette in „Pre-Awarding“ und „Post-Awarding“ Phase wurde der Vollständigkeit halber mit aufgeführt. Sämtliche Prozesse nach Zuschlag an den Auftragnehmer sind nicht Teil der XVergabe-Kommunikationsschnittstelle und werden im Rahmen anderer Standardisierungsaktivitäten beschreiben (bspw. Steuerungsprojekt „E-Rechnung“ des IT-Planungsrats).

Mit XVergabe sind somit die Prozesse und Anwendungsfälle bis inkl. Zuschlag an den Auftragnehmer abbildbar. Eine Besonderheit bildet die Prozessgruppe „eNotice“, die den elektronischen Austausch von Bekanntmachungen beschreibt. Diese wird zwar durch eine XVergabe-Arbeitsgruppe technisch ausgeprägt, jedoch ist dies NICHT Teil der hier beschriebenen XVergabe-Kommunikationsschnittstelle.

Die XVergabe-Kommunikationsschnittstelle unterstützt somit die folgenden Prozessgruppen:

• eSubscription: Ein Wirtschaftsteilnehmer meldet sich innerhalb eines Vergabeverfahrens an, um Aktualisierung innerhalb des Verfahrens zu erhalten. Dies ist nicht mit einem Teilnahmeantrag o.ä. gleich zu setzen, sondern dient lediglich dazu einen Teilnehmer (technisch) einem Verfahren zuzuordnen. Die XVergabe-Kommunikationsschnittstelle bietet hierfür eine „subscribe“-Möglichkeit (Operation in der Schnittstelle), die von einem Bieterclient aufgerufen werden kann. Diese bildet die Grundlage für den weiteren Nachrichtenaustausch. Ein Teilnehmer kann ohne vorherige subscribe keine Kommunikation mit der Vergabeplattform (und somit der Vergabestelle) innerhalb des Vergabeverfahrens durchführen.
• eAccess: Diese Prozessgruppe umfasst den Zugang zu Auftragsunterlagen im Vergabeverfahren durch einen (angemeldeten) Teilnehmer. Im Rahmen der XVergabe-Kommunikationsschnittstelle stellt die Vergabeplattform der Bieteranwendung in Abhängigkeit des Vergabeverfahrens nach erfolgreicher Anmeldung (eSubscription) eine Nachricht zum Abruf bereit - entweder „InvitationToTender“ (ITT), wenn das Verfahren ohne vorgeschalteten Teilnahmewettbewerb abläuft, oder „InvitationToParticipation“ (ITP), wenn ein vorgeschalteter Teilnahmewettbewerb durchgeführt wird. Diese Nachricht kann ein Client über die XVergabe-Kommunikationsschnittstellen-Operation getMessages abrufen. Die Nachricht selbst enthält noch nicht die Auftrags- bzw. Teilnahmeunterlagen sondern lediglich Referenzen auf diese. Ein Client SOLL diese über die XVergabe-Kommunikationsschnittstellen-Operation getDocuments anschließend separat von der Plattform abrufen. Der Teilnehmer bzw. Bieter erhält somit in dieser Prozessgruppe alle für die Erstellung eines TNAs bzw. Angebots relevanten Auftrags- bzw. Teilnahmeunterlagen. Ebenso erfährt der Teilnehmer bzw. Bieter durch die ITP- bzw. ITT-Nachricht wie der Teilnahmeantrag bzw. das Angebot zu strukturieren, welche Bestandteile zu signieren, ob und wie TNA bzw. Angebot zu verschlüsseln und ob die TNA- bzw. Angebotsabgabe über die XVergabe-Kommunikationsschnittstelle selbst oder über OSCI-Transport erfolgen muss. Er wird somit in die Lage versetzt einen TNA bzw. ein Angebot aufzubereiten und die Einreichung durchzuführen.
• eEnquiry: Diese Prozessgruppe bildet die Bieterkommunikation innerhalb eines Verfahrens ab. Somit wird es ermöglicht, Bieterfragen zu stellen und die konsolidierten Antworten der Vergabestelle allen Bietern mitzuteilen. Ebenso wird hierdurch ein normaler Kommunikationsweg, auf dem die Vergabestelle mit dem Bieter kommunizieren kann eröffnet. Die XVergabe-Kommunikationsschnittstelle unterstützt dies durch so genannte „Inquiry“-Nachrichten, die der Bieter mittels der sendMessage-Operation der XVergabe-Kommunikationsschnittstelle an die Plattform übermittelt. Die Vergabestelle stellt Antworten ebenfalls als „Inquiry“-Nachrichten dem Bieter zum Abruf mittels getMessages zur Verfügung. Inquiry-Nachrichten können Anlagen enthalten bzw. referenzieren.
• eSubmission: Die Kernprozessgruppe im Vergabewesen zur Einreichung eines Angebots durch den Bieter. Wie oben bereits aufgeführt unterstützt die XVergabe-Kommunikationsschnittstelle zwei Möglichkeiten und überlässt der jeweiligen Plattform bzw. Vergabestelle die Wahl: Im Standardfall werden Angebote in einer „Offer“-Nachricht mittels sendSynchronousMessage-Operation der XVergabe-Kommunikationsschnittstelle an die Plattform zugestellt. Im Gegensatz zur sendMessage-Operation, die für eEnquiry genutzt wird, erhält die Bieteranwendung mit der sendSynchronousMessage-Operation direkt eine fachlich-inhaltliche Antwort zurück: die Zustellquittung der Plattform über den Eingang des Angebots. Wie das Angebot in der Offer-Nachricht aufzubauen ist, MUSS die Bieteranwendung aus der im Rahmen von eAccess bereitgestellten ITT-Nachricht entnehmen. Alternativ legt die Vergabeplattform bzw. Vergabestelle in der ITT-Nachricht fest, dass die Angebotsabgabe via OSCI-Transport erfolgen soll und definiert in der ITT-Nachricht auch die hierfür notwendigen technischen Parameter. In diesem Fall MUSS die Bieteranwendung das aufbereitete Angebot über einen definierten Ablauf unter Nutzung der getOSCITransferID-Operation der XVergabe-Kommunikationsschnittstelle und anschließender Übermittlung einer OSCI-Transport-Nachricht an den in der ITT-Nachricht definierten Zustellpunkt (OSCI-Intermediär) übertragen. 
  Über die Angebotsabgabe hinaus sind auch Teilnahmeantrags-Abgabe und Rückzüge von Angeboten bzw. TNAs zur Prozessgruppe eSubmission zu zählen. Die TNA-Abgabe läuft analog zur beschriebenen Angebotsabgabe ab: Im Falle der TNA-Einreichung via XVergabe-Schnittstelle wird eine „Participation“-Message via sendSynchronousMessage-Operation der XVergabe-Kommunikationsschnittstelle an die Plattform zugestellt und die Bieteranwendung erhält die Eingangsquittung von der Plattform zurück. Alternativ wird der TNA mittels OSCI-Transport wie beschrieben zugestellt. Im jeweiligen OSCI-Transport-Fall werden zwei Quittungen ausgestellt: Einmal bei der Einreichung des Angebots bzw. TNAs beim OSCI-Intermediär durch diesen – diese ist die rechtlich bindende Eingangsquittung. Zusätzlich MUSS ihm eine Zustellquittung im XVergabe-Datenmodell asynchron zum Abruf mittels getMessages-Operation der XVergabe-Kommunikationsschnittstelle zur Verfügung gestellt werden. Die Quittungen, die die Plattform nach dem XVergabe-Datenmodell ausstellen MUSS, MUSS – unabhängig davon ob der Zustellweg OSCI-Transport oder XVergabe-Kommunikationsschnittstelle war – eine Referenz auf das Angebot bzw. den TNA enthalten, unter der die Plattform das Angebot bzw. den TNA verwaltet. Diese Referenz MUSS der Bieter beim Rückzug des Angebots oder des TNAs angeben. Auch ein Rückzug wird analog zur Abgabe des Angebots bzw. des TNAs über die zwei beschriebenen Wege durch die XVergabe-Kommunikationsschnittstelle unterstützt. Sofern eine Plattform die Angebots- bzw. TNA-Abgabe via OSCI-Transport definiert, so SOLL sie eine Abgabe via XVergabe-Kommunikationsschnittstelle nicht zulassen. Weiterhin SOLL die Plattform dann auch den jeweiligen Rückzug via OSCI-Transport abbilden.
  Angebots- bzw. TNA-Rückzüge SOLLEN explizit erfolgen, d.h. es soll eine Rückzugsnachricht an die Plattform übermittelt werden.
• eAward: Zuschlagsmitteilungen bzw. Absagen werden von der Vergabestelle an die Bieter versendet. Die XVergabe-Kommunikationsschnittstelle unterstützt diese Prozesse durch den Nachrichtentyp „ResultNotice“. Diese Nachrichten werden durch die Vergabeplattform einer Bieteranwendung zum Abruf mittels getMessages-Operation angeboten. Im Positivfall enthalten sie die Zuschlagsentscheidung der Vergabestelle. Ebenso werden mittels ResultNotices auch die Ergebnisse des Ausgangs des Teilnahmewettbewerbs abgebildet. Werden also Teilnehmer nach Auswertung des Teilnahmewettbewerbs nicht zum Angebot aufgefordert, so SOLL die Plattform diesen Nutzern eine negative ResultNotice übermitteln. Positive ResultNotices können im Teilnahmewettbewerb entfallen – die zu berücksichtigenden Bieter erhalten im Rahmen von eAccess dann eine Aufforderung zur Angebotsabgabe (ITT).

Unterstützte Verfahrensarten

Mit der XVergabe-Kommunikationsschnittstelle sind derzeit die folgenden Verfahrensarten abbildbar:

Verhandlungsverfahren können lt. VOF und VOB auch unterschwellig angewandt werden, lt. VOL nur oberschwellig – die XVergabe-Kommunikationsschnittstelle unterscheidet dies nicht explizit bzgl. der Schwellwerte.

Preisanfragen werden nicht explizit aufgeführt, da diese in der Regel wie Freihändige Vergaben durchgeführt werden.

Auch Verfahren nach VSVgV werden nicht explizit aufgeführt. Die Klarstellung, dass es sich um Verfahren nach VSVgV handelt, erfolgt in der Regel in den Auftragsunterlagen direkt. Eine Auswirkung auf die Umsetzbarkeit innerhalb der XVergabe-Kommunikationsschnittstelle ist nicht gegeben. 

Weitere Verfahrensarten (insb. Wettbewerblicher Dialog, Interessensbekundungsverfahren mit Interessensbestätigung, Innovationspartnerschaften, Dynamisches Beschaffungssystem sowie Auktionen) werden im Rahmen der Weiterentwicklung der XVergabe-Kommunikationsschnittstelle hinsichtlich ihrer Umsetzung mit XVergabe geprüft.

Logischer Aufbau der XVergabe-Kommunikationsschnittstelle

Die nachfolgende Abbildung verdeutlicht den logischen Aufbau der Schnittstelle:

Wie bereits ausgeführt, beschreibt die XVergabe-Kommunikationsschnittstelle eine SOAP Web-Service-Schnittstelle einer Vergabeplattform. Hierfür wird eine technische Beschreibung in Form einer WSDL-Datei als Teil der XVergabe-Kommunikationsschnittstelle bereitgestellt. Dieser Web-Service bildet die Transport-Ebene.

Die über die darin definierten Operationen auszutauschenden fachlichen Nachrichten bilden die nächste Ebene der XVergabe-Kommunikationsschnittstelle. Diese fachlichen Nachrichten werden im Datenmodell „Messages“ genannt. Sie unterscheiden sich von den Web-Service-Messages, weil sie vom Transportprotokoll (hier SOAP) abstrahieren und auch über andere Transportwege übermittelt werden können (bspw. OSCI-Transport).

Die Nachrichten selbst enthalten wiederum die fachlichen Informationen, die die innerste Ebene „Documents“ darstellen. Diese fachlichen Informationen sind vorerst soweit strukturiert, wie sie für eine Prozesssteuerung notwendig sind. Die eigentlichen Daten bleiben vorerst in binären Anlagen (bspw. PDF-Dokumenten) ausgelagert.

Anchor
bestandteile bestandteile

Bestandteile der XVergabe-Kommunikationsschnittstelle

Die XVergabe-Kommunikationsschnittstelle umfasst die Zusammenstellung der folgenden Artefakte:

• eine Menge von WSDL-Dateien, die die Web-Service-Schnittstelle definieren,
• eine Menge von kommentierten XML Schema Dateien, die die Datenstrukturen für den Datenaustausch definieren,
• eine Menge von HTML-Dateien, die die XML Schema Dateien (visuell) dokumentieren (technische Dokumentation), automatisiert generiert aus den XML Schema Dateien,
• das technische Datenmodell in Form von XÖV-profilierten UML-Klassendiagrammen, aus denen über die XÖV-Werkzeugkette die XML Schema Dateien generiert wurden,
• diese Dokumentation, 
• zukünftig auch: diese Dokumentation zusätzlich in englischer Sprache. 

WSDL-Dateien

Folgende WSDL-Dateien sind Bestandteil der XVergabe-Kommunikationsschnittstelle und MÜSSEN von einer XVergabe-konformen Plattform implementiert werden:

XML Schema Dateien

Folgende XML Schema Dateien sind Bestandteil der XVergabe-Kommunikationsschnittstelle und MÜSSEN von einer XVergabe-konformen Plattform implementiert werden:

Technische Dokumentation (HTML)

Die technische Dokumentation wird aus den XML Schema Dateien in Form einer HTML-Datei (doc/html/xvergabe-service.html) automatisch generiert. Sie enthält einen Großteil der Dokumentation und Spezifikation der XVergabe-Kommunikationsschnittstelle. Sie beschreibt die Datentypen, Dokumente, Nachrichten und deren Attribute im Detail. 

Technisches Datenmodell

Das technische Datenmodell wird als MagicDraw-Projektdatei (derzeit: MagicDraw Version 16.8) bereitgestellt (magicdrawsource/xvergabe_2015.mdzip). Die Projektdatei enthält XÖV-profilierte UML-Klassendiagramme, aus denen die oben aufgeführten XML Schema Dateien automatisiert generiert werden (können) – mit Ausnahme der unter „build/ext“ extern eingebundenen XML Schema Dateien. Für die Projektdatei sowie die automatische Generierung von XML Schema Dateien enthält das Verzeichnis zusätzlich notwendige Dateien, die entweder von MagicDraw oder von der XÖV-Werkzeugkette benutzt werden.

Web-Service

Nachfolgend wird der in der XVergabe-Kommunikationsschnittstelle definierte Web-Service kurz beschrieben. Der Web-Service wird technisch durch zwei WSDL 1.1 Dateien (siehe oben) beschreiben und sieht als Kommunikationsprotokoll SOAP 1.2 vor. Fehler werden nicht auf Ebene von SOAP als SOAP-Faults definiert, sondern Transport-Unabhängig auf Nachrichten- bzw. Dokumentenebene (ResponseDocument), die Responses auf SOAP-Ebene nutzen jedoch das ResponseDocument. Somit werden ggf. auftretende Fehler innerhalb des SOAP-Bodys transportiert.

Operationen

Die Kommunikation mit dem Webservice wird immer durch die Bieteranwendung ausgelöst. Er bietet die folgenden Operationen, die immer aus einer jeweiligen Request- (Anfrage) und Response- (Antwort) Nachricht bestehen. Die nähere Definition der Requests und Responses ist der technischen Dokumentation zu entnehmen.

Generell gilt für alle Operationen:

• Die aufrufende Bieteranwendung MUSS von der Plattform als XVergabe-konformer Client authentifiziert werden. Dies wird mittels HTTPS-Clientauthentifizierung und Überprüfung auf Verwendung eines vom BeschA ausgestelltem Zertifikat sichergestellt.
• Die Nachricht der Bieteranwendung MUSS von der Plattform auf syntaktische und inhaltliche Korrektheit hin (bspw. ob die referenzierten Anlagen (und nur diese) in der Nachricht vorhanden sind) überprüft werden. Entsprechende Verstöße sind mittels eines Errorcodes in der jeweiligen Response anzuzeigen.
• Der aufrufende Nutzer der Bieteranwendung MUSS durch die Plattform authentifiziert werden, um die Zuordnung von Nachrichten und Verfahren für und von dem Nutzer abzubilden. Authentifizierungsfehler müssen von der Plattform durch einen entsprechenden ERROR-Code angezeigt werden. Die Plattform KANN zusätzlich in der jeweiligen Response auf eine Plattform-spezifische Web-Seite verweisen, mit der die Authentifizierungsmittel überprüft bzw. geändert werden können (bspw. Seite für Passwortänderungen). 
  Sofern die Operation ohne Authentifizierungsmittel (also ohne Username-Token) des Bieters aufgerufen wird, MUSS die Plattform einen entsprechenden Errorcode in der Response zusammen mit einer URL zur Registrierungs-Webseite angeben, damit ein Nutzer der Bieteranwendung in die Lage versetzt wird, die Registrierung dort durchzuführen und in den Besitz von Nutzername und Passwort zu kommen, aus dem das Username-Token gebildet werden kann.
• Der aufrufende Nutzer MUSS für die jeweilige Aktion autorisiert werden, d.h. es MUSS bspw. überprüft werden, ob der Nutzer für das angegebene Vergabeverfahren berechtigt ist, die entsprechende Aktion auszuführen oder ob der Benutzer berechtigt ist auf ein angegebenes Dokument zuzugreifen. Sofern ein Autorisierungsverstoß festgestellt wird MUSS die Plattform dies der Bieteranwendung durch einen entsprechenden Errorcode anzeigen.
• Die Plattform MUSS sicherstellen, dass die Operation und darüber transportierte Nachricht innerhalb des Verfahrensstatusmodells zulässig ist. Verstöße dagegen MÜSSEN der Bieteranwendung durch einen Errorcode angezeigt werden. Bestimmte Anwendungsfälle im Verfahrensstatusmodell obliegen der Auslegung der Vergabeplattform bzw. Vergabestelle (bspw. Annahme eines abgegebenen Angebots nach Angebotsfrist aber vor Zuschlag). Solche werden in der Regel mit einem Warningcode ggü. der Bieteranwendung angezeigt.