To illustrate the possibilities of the XVergabe Bidder Interface, the following sections describe the exchange between bidder client and platform in some exemplary scenarios.

Subscribing for an open Tendering Procedure

The scenario in Figure 4 shows how a bidder client can subscribe a tendering procedure and download the tendering documents using the XVergabe Bidder Interface.

1. The bidder subscribes to an open tendering procedure he is interested in. The client calls the subscribe operation on the platform to make his interest known. The platform registers his subscription in its database.
2. The bidder synchronizes his local data with the platform’s data to become up to date. The client calls the getMessages operation to retrieve all messages directed at the client’s user. The list of messages returned contains a TenderMetaInformation and an InvitationToTender for the tendering procedure he previously subscribed for. The TenderMetaInformation message contains all the data about the procedure the client needs. The InvitationToTender message contains the IDs of the tendering documents among other information.
3. The client recognizes that the InvitationToTender message contains IDs of tendering documents and calls getDocument with these IDs to download the documents from the platform. After the download, the bidder can review the downloaded tendering documents.

Figure 4 - Subscribing to a tendering procedure and downloading the tendering documents via XVergabe Bidder Interface.

Exchanging Questions & Answers

The scenario in Figure 5 shows how a bidder can send questions concerning a tendering procedure and receive the answers to the questions via the Bidder Interface.

1. The EO composes a set of questions (for example in the form of a PDF document) concerning a tendering procedure he previously subscribed for. These questions are sent to the platform by a call of sendMessage. The message is a ClientInquiry containing the questions document. The platform stores the questions document to be answered by the CA.
2. The contracting authority answers the questions and stores the answers in another document (again, this might be a PDF document) on the platform. Afterwards, the EO synchronizes his client to the platform. The client calls the getMessages operation and receives a ServerInquiry message (potentially among other messages). The ServerInquiry contains the ID of the answers document.
3. The client recognizes that the ServerInquiry contains the ID of a document and calls getDocument to download the document from the platform. The bidder can then review the answers.