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

Tenders with multiple Lots

When having tender with separate items that can be supplied by different providers it is possible to split the tender into :ref:`Lots <lot>`. Each Lot has its own budget (i.e. Lot.value).

For more information read Tender with multiple lots.

{
  "lots": [
    {
      "id": "7d774fbf1e86420484c7d1a005cc283f",
      "title": "Lot #1: Kyiv stationey",
      "description": "Items for Kyiv office",
      "value": {"currency": "UAH", "amount": 8000.0, "valueAddedTaxIncluded": true},
      "minimalStep": {"currency": "UAH", "amount": 30.0, "valueAddedTaxIncluded": true},
      "status": "active"
    }, {
      "id": "563ef5d999f34d36a5a0e4e4d91d7be1",
      "title": "Lot #1: Lviv stationey",
      "description": "Items for Lviv office",
      "value": {"currency": "UAH", "amount": 9000.0, "valueAddedTaxIncluded": true},
      "minimalStep": {"currency": "UAH", "amount": 35.0, "valueAddedTaxIncluded": true},
      "status": "active"
    }
  ]
}

Multilot Tender shares general documentation, and can have lot-specific and even item-specific documentation.

{
  "documents": [
    {
      "format": "application/msword",
      "url": "...",
      "title": "kyiv-specs.doc",
      "datePublished": "2015-10-27T14:01:16.155803+02:00",
      "dateModified": "2015-10-27T14:01:16.155844+02:00",
      "id": "9491647572294c2bb20bf28f16d14dd8",
      "documentOf": "lot",
      "relateLot": "7d774fbf1e86420484c7d1a005cc283f"
    }
  ]
}

The same applies to :ref:`Questions <question>` and answers. Question placed in Tender can be general, lot-specific or item-specific.

When bidding, provider can place bid against single lot, multiple lots or even all lots of the tender.

{
  "lotValues": [
    {
      "value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
      "reatedLot": "7d774fbf1e86420484c7d1a005cc283f",
      "date": "2015-11-01T12:43:12.482645+02:00"
    }, {
      "value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
      "reatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1",
      "date": "2015-11-01T12:43:12.482645+02:00"
    }
  ],
  "..."
}

Each of the :ref:`documents <document>` attached to the :ref:`Bid` can be general, lot-specific or item-specific.

Each Lot has its own auction and awarding process.

Each Lot can be cancelled individually, not affecting processes that take place in other lots.

Announcing Multilot tender

One has to create Multilot tender in several steps. There should be tender created with items.

POST /tenders HTTP/1.1

{"data": {
   "items":[
      {"description": "", ... },
      {"description": "", ... }
     ],
   ...
  }}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1

{"data": {
  "items":[
      {"id": "c25264295db0463ba533fd380756cff1", "description": "", ... },
      {"id": "f94aa51e2af944e08e02a4063121f93c", "description": "", ... }
    ],
  ...
  },
  ...
}

Then all lots have to be added to Tender with separate requests.

POST /tenders/64e93250be76435397e8c992ed4214d1/lots HTTP/1.1

{"data": {..}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/lots/7d774fbf1e86420484c7d1a005cc283f

2nd lot:

POST /tenders/64e93250be76435397e8c992ed4214d1/lots HTTP/1.1

{"data": {..}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/lots/563ef5d999f34d36a5a0e4e4d91d7be1

Items should be distributed among the lots.

PATCH /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1

{"data": {
  "items":[
      {"id": "c25264295db0463ba533fd380756cff1", "relatedLot": "7d774fbf1e86420484c7d1a005cc283f"},
      {"id": "f94aa51e2af944e08e02a4063121f93c", "relatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1"}
    ],
  ...
  },
  ...
}

Bidding in Multilot tender

Bid should have lotValues property consisting of multiple :ref:`LotValue` objects. Each should reference lot the bid is placed against via relatedLot property.

POST /tenders/64e93250be76435397e8c992ed4214d1/bids HTTP/1.1

{"data": {
  "lotValues": [
    {
      "value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
      "reatedLot": "7d774fbf1e86420484c7d1a005cc283f",
      "date": "2015-11-01T12:43:12.482645+02:00"
    }, {
      "value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
      "reatedLot": "563ef5d999f34d36a5a0e4e4d91d7be1",
      "date": "2015-11-01T12:43:12.482645+02:00"
    }
  ],
  ...
}}
HTTP/1.1 201 Created
Location: /tenders/64e93250be76435397e8c992ed4214d1/bids/ae836da01ef749e494427dc591d36062

Auction participation URLs are available for each of the submitted lots.

Qualification in Multilot tender

After Auctions are over each active lot has its own awarding process started. I.e. there are multiple award objects created in :ref:`Tender` each requiring decision (disqualification or acceptance).

GET /tenders/64e93250be76435397e8c992ed4214d1/awards HTTP/1.1
HTTP/1.1 200 OK

{"data": [
    {
        "status": "pending",
        "bid_id": "ae836da01ef749e494427dc591d36062",
        "value": {"currency": "UAH", "amount": 7750.0, "valueAddedTaxIncluded": true},
        "id": "c3179dd8609340a7ba9e5fe91762f564",
        "lotId": "7d774fbf1e86420484c7d1a005cc283f",
        "..."
    }, {
        "status": "pending",
        "bid_id": "ae836da01ef749e494427dc591d36062",
        "value": {"currency": "UAH", "amount": 8125.0, "valueAddedTaxIncluded": true},
        "id": "c99e30174b10418bac026a77d41288d7",
        "lotId": "563ef5d999f34d36a5a0e4e4d91d7be1",
        "..."
    }
  ]
}

When all qualification processes end, and all stand still periods end, the whole tender switch state to either complete or unsuccessful (if awads for all lots are unsuccessful).

You can’t perform that action at this time.