Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
247 lines (147 sloc) 7.47 KB

Tutorial

Creating auction

As long as lot's rectificationPeriod expires, a procedure is being created automatically:

Note that the procedure initially receives pending.activation status.

Let's see what listing of auctions reveals us:

We do see the auction's internal id (that can be used to construct full URL https://lb.api-sandbox.ea2.openprocurement.net/api/2.3/auctions/) and its dateModified datestamp.

Procedure activation

The initial version of the procedure comes with concierge as an owner, pointing an entity whom the procedure has been originally created by.

You have been given the access_transfer key while creating a lot. Consider that access_transfer is used to retrieve procedure ownership so that to activate the process.

In order to switch the procedure to active.tendering a Transfer object has to be created first:

Transfer object contains new access_token & access_transfer. Those are the ones to replace the previous data within the access while changing the ownership of a procedure.

Transfer can be retrieved by id:

For the procedure ownership to be changed, you should send POST request to the appropriate /auctions/<id>/ with data section containing id of the Transfer and access_transfer received while creating the lot:

You should also switch the procedure to active.tendering.


Success! Now we can see that new object has changed its owner and status.

Enquiries

When auction is in active.tendering status, interested parties can ask questions:

Organizer can answer them:

And one can retrieve the question list:

Or an individual answer:

Registering bid

Bidder can register a bid in draft status:

And activate a bid:

Then upload proposal document:

It is possible to check the uploaded documents:

For the best effect (biggest economy) auction should have multiple bidders registered:

Activate second bidder:

Upload second bidder proposal:

Now procedure is ready for auction stage.

Auction

After auction is scheduled anybody can visit it to watch. The auction can be reached at Auction.auctionUrl:

And bidders can find out their participation URLs via their bids:

See the Bid.participationUrl in the response. Similar, but different, URL can be retrieved for other participants:

1 Submitted Proposal

If only one bid has been registered and minNumberOfQualifiedBids:1 the procedure automatically changes its status to active.qualification. The award is being created in pending.admission status:

Pay attention to the admissionPeriod generated. For the process to move forward, you have to upload an admission protocol (documentType: admissionProtocol) in time (up to admissionPeriod.endDate):

And update it with more details:

With the document being uploaded you have to switch the award to pending status:

You can also reject working with a bidder by uploading a document (rejectionProtocol or act) and switching the award to unsuccessful.

With the award being switched to pending, two more periods are being generated. These are verificationPeriod with the auto-generated duration of 0-10 business days & signingPeriod with the auto-generated duration of 40 business days.:

The first thing to be done is auctionProtocol uploading:

We can also update it with more details:

With the document being uploaded you have to switch the award to active status:

Now you can see that the contract object has been created:

To complete the process you have to upload a document (contractSigned):

Setting the correct documentType:

Note that dateSigned has to be mentioned as well. dateSigned should be no earlier than signingPeriod.endDate.

To activate a contract one more POST request should be done:

And finally the procedure is in complete status:

2 submitted proposals or more

After the competitive auction two awards are created:

  • for the first candidate (a participant that has submitted the highest valid bid at the auction) - initially has a pending status and awaits auction protocol to be uploaded by the organizer;
  • for the second candidate (a participant that has submitted the second highest valid bid at the auction)- initially has a pending.waiting status.

There are two more scenarios that can happen after the competitive auction:

  • If the two highest bidders have invalid bids (lower than auction starting price + minimal step), the awards will not be created at all, and the qualification procedure will automatically receive the unsuccessful status.
  • If the second highest bidder has a bid that is less than the starting price + minimal step, two awards are created, with one of them receiving a pending status and undergoing the qualification procedure, and the other (with an invalid bid) automatically becoming unsuccessful.

Refusal of waiting by another participant

The second candidate (participant that has submitted the second highest valid bid at the auction) can refuse to wait for the disqualification of the first candidate:

Disqualification of a candidate

In case of a manual disqualification, the organizer has to upload file with cancellation reason (documentType: rejectionProtocol/act):

Update rejection protocol:

And disqualify candidate:

You can’t perform that action at this time.