Welcome to openprocurement.tender.limited’s documentation!

Please report any problems or suggestions for improvement either via the mailing list or the issue tracker.

Contents:

Overview

The Open Procurement API is the only interface to Open Procurement database that is core unit of Open Procurement infrastructure.

This documentation covers one procedure:

  • reporting - reporting with no stand-still period

Tutorial

Tender creation

You can create one procedure:
  • reporting - reporting with no stand-still period

Creating tender for reporting procedure

To create tender for reporting procedure you should set reporting value for procurementMethodType.

Let’s create a tender:

POST /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2253
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "title": "Articole de papetărie şi alte articole din hârtie",
    "procurementMethodType": "reporting",
    "title_en": "Stationery and paper",
    "description_en": "Stationery and paper",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://www.edu.gov.md/",
        "email": "svetlana.lucinscaia@edu.md",
        "telephone": "212701",
        "name": "Lucinscaia Svetlana"
      },
      "identifier": {
        "scheme": "MD-IDNO",
        "id": "1003254747454",
        "legalName": "Ministerul Educatiei al Republicii Moldova"
      },
      "name": "Ministerul Educatiei al Republicii Moldova",
      "address": {
        "postalCode": "MD-2033",
        "countryName": "Republica Moldova",
        "streetAddress": "Piața Marii Adunari Naționale, 1",
        "region": "Chisinau",
        "locality": "Chisinau"
      }
    },
    "title_ru": "Канцелярские товары и бумага",
    "items": [
      {
        "description": "Articole de papetărie şi alte articole din hârtie",
        "classification": {
          "scheme": "CPV",
          "description": "Articole de papetărie şi alte articole din hârtie",
          "id": "30199000-0"
        },
        "description_en": "Stationery and paper",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "description": "Послуги шкільних їдалень",
            "id": "55.51.10.300"
          }
        ],
        "deliveryAddress": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Piața Marii Adunari Naționale, 1",
          "region": "Chisinau",
          "locality": "Chisinau"
        },
        "deliveryDate": {
          "startDate": "2017-12-22T13:36:16.048704",
          "endDate": "2017-12-25T13:36:16.048704"
        },
        "description_ru": "Канцелярские товары и бумага",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "MDL",
      "amount": 500000,
      "valueAddedTaxIncluded": false
    },
    "description_ru": "Канцелярские товары и бумага"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb
{
  "access": {
    "transfer": "10dcd967930c45a5859159cefa780d70",
    "token": "d4574ebc11b047ae8b360d43132184d3"
  },
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "title": "Articole de papetărie şi alte articole din hârtie",
    "items": [
      {
        "description": "Articole de papetărie şi alte articole din hârtie",
        "classification": {
          "scheme": "CPV",
          "description": "Articole de papetărie şi alte articole din hârtie",
          "id": "30199000-0"
        },
        "description_en": "Stationery and paper",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Piața Marii Adunari Naționale, 1",
          "region": "Chisinau",
          "locality": "Chisinau"
        },
        "deliveryDate": {
          "startDate": "2017-12-22T13:36:16.048704+02:00",
          "endDate": "2017-12-25T13:36:16.048704+02:00"
        },
        "description_ru": "Канцелярские товары и бумага",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "title_en": "Stationery and paper",
    "value": {
      "currency": "MDL",
      "amount": 500000.0,
      "valueAddedTaxIncluded": false
    },
    "dateModified": "2017-12-20T13:36:17.802034+02:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://www.edu.gov.md/",
        "email": "svetlana.lucinscaia@edu.md",
        "telephone": "212701",
        "name": "Lucinscaia Svetlana"
      },
      "identifier": {
        "scheme": "MD-IDNO",
        "id": "1003254747454",
        "legalName": "Ministerul Educatiei al Republicii Moldova"
      },
      "name": "Ministerul Educatiei al Republicii Moldova",
      "address": {
        "postalCode": "MD-2033",
        "countryName": "Republica Moldova",
        "streetAddress": "Piața Marii Adunari Naționale, 1",
        "region": "Chisinau",
        "locality": "Chisinau"
      }
    },
    "date": "2017-12-20T13:36:17.798391+02:00",
    "procurementMethodType": "reporting",
    "description_en": "Stationery and paper",
    "title_ru": "Канцелярские товары и бумага",
    "owner": "broker",
    "description_ru": "Канцелярские товары и бумага",
    "id": "e880178c4afa45b08d1c9873d61cd6eb",
    "tenderID": "MD-2017-12-20-000001"
  }
}

We have 201 Created response code, Location header and body with extra id, tenderID, and dateModified properties.

Let’s check what tender registry contains:

GET /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.mepps.openprocurement.net

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.3/tenders?offset=",
    "uri": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders?offset=",
    "offset": ""
  },
  "data": []
}

We do see the internal id of a tender (that can be used to construct full URL by prepending https://api-sandbox.mepps.openprocurement.net/0/tenders/) and its dateModified datestamp.

Modifying tender

Let’s update tender by supplementing it with all other essential properties:

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "items": [
      {
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "title": "Articole de papetărie şi alte articole din hârtie",
    "items": [
      {
        "description": "Articole de papetărie şi alte articole din hârtie",
        "classification": {
          "scheme": "CPV",
          "description": "Articole de papetărie şi alte articole din hârtie",
          "id": "30199000-0"
        },
        "description_en": "Stationery and paper",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Piața Marii Adunari Naționale, 1",
          "region": "Chisinau",
          "locality": "Chisinau"
        },
        "deliveryDate": {
          "startDate": "2017-12-22T13:36:16.048704+02:00",
          "endDate": "2017-12-25T13:36:16.048704+02:00"
        },
        "description_ru": "Канцелярские товары и бумага",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "title_en": "Stationery and paper",
    "value": {
      "currency": "MDL",
      "amount": 500000.0,
      "valueAddedTaxIncluded": false
    },
    "dateModified": "2017-12-20T13:36:17.895360+02:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://www.edu.gov.md/",
        "email": "svetlana.lucinscaia@edu.md",
        "telephone": "212701",
        "name": "Lucinscaia Svetlana"
      },
      "identifier": {
        "scheme": "MD-IDNO",
        "id": "1003254747454",
        "legalName": "Ministerul Educatiei al Republicii Moldova"
      },
      "name": "Ministerul Educatiei al Republicii Moldova",
      "address": {
        "postalCode": "MD-2033",
        "countryName": "Republica Moldova",
        "streetAddress": "Piața Marii Adunari Naționale, 1",
        "region": "Chisinau",
        "locality": "Chisinau"
      }
    },
    "date": "2017-12-20T13:36:17.798391+02:00",
    "procurementMethodType": "reporting",
    "description_en": "Stationery and paper",
    "title_ru": "Канцелярские товары и бумага",
    "owner": "broker",
    "description_ru": "Канцелярские товары и бумага",
    "id": "e880178c4afa45b08d1c9873d61cd6eb",
    "tenderID": "MD-2017-12-20-000001"
  }
}

We see the added properies have merged with existing tender data. Additionally, the dateModified property was updated to reflect the last modification datestamp.

Checking the listing again reflects the new modification date:

GET /api/2.3/tenders?opt_pretty=1 HTTP/1.0
Host: api-sandbox.mepps.openprocurement.net

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.3/tenders?offset=2017-12-20T13%3A36%3A17.802034%2B02%3A00",
    "uri": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders?offset=2017-12-20T13%3A36%3A17.802034%2B02%3A00",
    "offset": "2017-12-20T13:36:17.802034+02:00"
  },
  "data": [
    {
      "id": "e880178c4afa45b08d1c9873d61cd6eb",
      "dateModified": "2017-12-20T13:36:17.802034+02:00"
    }
  ]
}

Uploading documentation

Procuring entity can upload documents and files into the created tender. Uploading should follow the Documents Uploading rules.

POST /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy754052861794$
Host: api-sandbox.mepps.openprocurement.net

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/documents/38438cdd1fba43c69b6882000c9a1a78
{
  "data": {
    "title": "Notice.pdf",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/documents/38438cdd1fba43c69b6882000c9a1a78?download=bad2509ea44241749896821dc1c7fb9b",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:18.104622+02:00",
    "id": "38438cdd1fba43c69b6882000c9a1a78",
    "dateModified": "2017-12-20T13:36:18.104645+02:00"
  }
}

201 Created response code and Location header confirm document creation.

In case we made an error, we can reupload the document over the older version:

PUT /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/documents/38438cdd1fba43c69b6882000c9a1a78?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 191
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy0661393961028$
Host: api-sandbox.mepps.openprocurement.net

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "Notice-2.pdf",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/documents/38438cdd1fba43c69b6882000c9a1a78?download=0f9276a7b5844c788852b0429e5095eb",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:18.104622+02:00",
    "id": "38438cdd1fba43c69b6882000c9a1a78",
    "dateModified": "2017-12-20T13:36:18.139600+02:00"
  }
}

Awarding

Adding supplier information

Procuring entity registers supplier information for reporting procedure:

POST /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 697
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "date": "2016-01-14T18:07:00.628073+02:00",
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "telephone": "212449",
          "name": "Vitalie Zlatan",
          "email": "soleksuk@gmail.com"
        },
        "identifier": {
          "scheme": "MD-IDNO",
          "legalName": "Întreprinderea de stat comunală de catering",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.md/"
        },
        "name": "Întreprinderea de stat comunală de catering",
        "address": {
          "countryName": "Republica Moldova",
          "postalCode": "MD-2033",
          "region": "Chisinau",
          "streetAddress": "Strada Miorita, 33",
          "locality": "Chisinau"
        }
      }
    ],
    "id": "d373338bc3324f14b8b3d4af68922773",
    "value": {
      "currency": "MDL",
      "amount": 475000,
      "valueAddedTaxIncluded": "false"
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5
{
  "data": {
    "status": "pending",
    "date": "2017-12-20T13:36:18.171434+02:00",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "212449",
          "name": "Vitalie Zlatan"
        },
        "identifier": {
          "scheme": "MD-IDNO",
          "legalName": "Întreprinderea de stat comunală de catering",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.md/"
        },
        "name": "Întreprinderea de stat comunală de catering",
        "address": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Strada Miorita, 33",
          "region": "Chisinau",
          "locality": "Chisinau"
        }
      }
    ],
    "id": "89e507f4b41446f29e9ada88300773f5",
    "value": {
      "currency": "MDL",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    }
  }
}

Uploading award documentation

You can upload award documents only before awarding decision is confirmed. Let’s add award document:

POST /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 203
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy733140135687$
Host: api-sandbox.mepps.openprocurement.net

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/ae2f7a9f68254ca4a743c9c41daa26d3
{
  "data": {
    "title": "award_first_document.doc",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/ae2f7a9f68254ca4a743c9c41daa26d3?download=76edc40a6b3043f5a1afb20524b2cfb8",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:18.218618+02:00",
    "id": "ae2f7a9f68254ca4a743c9c41daa26d3",
    "dateModified": "2017-12-20T13:36:18.218642+02:00"
  }
}

201 Created response code and Location header confirm that document has been added.

Let’s see the list of award documents:

GET /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.mepps.openprocurement.net

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "award_first_document.doc",
      "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/ae2f7a9f68254ca4a743c9c41daa26d3?download=76edc40a6b3043f5a1afb20524b2cfb8",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-12-20T13:36:18.218618+02:00",
      "id": "ae2f7a9f68254ca4a743c9c41daa26d3",
      "dateModified": "2017-12-20T13:36:18.218642+02:00"
    }
  ]
}

We can add another award document:

POST /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 204
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy657013474043$
Host: api-sandbox.mepps.openprocurement.net

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/8a377bb593e7479bbd16653b3e585fbe
{
  "data": {
    "title": "award_second_document.doc",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/8a377bb593e7479bbd16653b3e585fbe?download=96281314e08f43549abbc667fb55b279",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:18.280084+02:00",
    "id": "8a377bb593e7479bbd16653b3e585fbe",
    "dateModified": "2017-12-20T13:36:18.280106+02:00"
  }
}

201 Created response code and Location header confirm second document has been added.

Let’s see the list of all uploaded award documents:

GET /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.mepps.openprocurement.net

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "award_first_document.doc",
      "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/ae2f7a9f68254ca4a743c9c41daa26d3?download=76edc40a6b3043f5a1afb20524b2cfb8",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-12-20T13:36:18.218618+02:00",
      "id": "ae2f7a9f68254ca4a743c9c41daa26d3",
      "dateModified": "2017-12-20T13:36:18.218642+02:00"
    },
    {
      "title": "award_second_document.doc",
      "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/8a377bb593e7479bbd16653b3e585fbe?download=96281314e08f43549abbc667fb55b279",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-12-20T13:36:18.280084+02:00",
      "id": "8a377bb593e7479bbd16653b3e585fbe",
      "dateModified": "2017-12-20T13:36:18.280106+02:00"
    }
  ]
}

Award confirmation

Procuring entity can confirm awarding decision:

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "award_first_document.doc",
        "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/ae2f7a9f68254ca4a743c9c41daa26d3?download=76edc40a6b3043f5a1afb20524b2cfb8",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-12-20T13:36:18.218618+02:00",
        "id": "ae2f7a9f68254ca4a743c9c41daa26d3",
        "dateModified": "2017-12-20T13:36:18.218642+02:00"
      },
      {
        "title": "award_second_document.doc",
        "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/awards/89e507f4b41446f29e9ada88300773f5/documents/8a377bb593e7479bbd16653b3e585fbe?download=96281314e08f43549abbc667fb55b279",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-12-20T13:36:18.280084+02:00",
        "id": "8a377bb593e7479bbd16653b3e585fbe",
        "dateModified": "2017-12-20T13:36:18.280106+02:00"
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "212449",
          "name": "Vitalie Zlatan"
        },
        "identifier": {
          "scheme": "MD-IDNO",
          "legalName": "Întreprinderea de stat comunală de catering",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.md/"
        },
        "name": "Întreprinderea de stat comunală de catering",
        "address": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Strada Miorita, 33",
          "region": "Chisinau",
          "locality": "Chisinau"
        }
      }
    ],
    "value": {
      "currency": "MDL",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "date": "2017-12-20T13:36:18.353473+02:00",
    "id": "89e507f4b41446f29e9ada88300773f5"
  }
}

Setting contract value

By default contract value is set based on the award, but there is a possibility to set custom contract value.

If you want to lower contract value, you can insert new one into the amount field.

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "value": {
      "amount": 238
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Articole de papetărie şi alte articole din hârtie",
        "classification": {
          "scheme": "CPV",
          "description": "Articole de papetărie şi alte articole din hârtie",
          "id": "30199000-0"
        },
        "description_en": "Stationery and paper",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Piața Marii Adunari Naționale, 1",
          "region": "Chisinau",
          "locality": "Chisinau"
        },
        "deliveryDate": {
          "startDate": "2017-12-22T13:36:16.048704+02:00",
          "endDate": "2017-12-25T13:36:16.048704+02:00"
        },
        "description_ru": "Канцелярские товары и бумага",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "212449",
          "name": "Vitalie Zlatan"
        },
        "identifier": {
          "scheme": "MD-IDNO",
          "legalName": "Întreprinderea de stat comunală de catering",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.md/"
        },
        "name": "Întreprinderea de stat comunală de catering",
        "address": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Strada Miorita, 33",
          "region": "Chisinau",
          "locality": "Chisinau"
        }
      }
    ],
    "value": {
      "currency": "MDL",
      "amount": 238.0,
      "valueAddedTaxIncluded": false
    },
    "date": "2017-12-20T13:36:18.441644+02:00",
    "awardID": "89e507f4b41446f29e9ada88300773f5",
    "id": "06db0c6b14d746989b39fd7f7b8d57e3",
    "contractID": "MD-2017-12-20-000001-1"
  }
}

200 OK response was returned. The value was modified successfully.

Setting contract signature date

There is a possibility to set custom contract signature date. You can insert appropriate date into the dateSigned field.

If this date is not set, it will be auto-generated on the date of contract registration.

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 54
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "dateSigned": "2017-12-20T13:36:16.048704"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Articole de papetărie şi alte articole din hârtie",
        "classification": {
          "scheme": "CPV",
          "description": "Articole de papetărie şi alte articole din hârtie",
          "id": "30199000-0"
        },
        "description_en": "Stationery and paper",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Piața Marii Adunari Naționale, 1",
          "region": "Chisinau",
          "locality": "Chisinau"
        },
        "deliveryDate": {
          "startDate": "2017-12-22T13:36:16.048704+02:00",
          "endDate": "2017-12-25T13:36:16.048704+02:00"
        },
        "description_ru": "Канцелярские товары и бумага",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "212449",
          "name": "Vitalie Zlatan"
        },
        "identifier": {
          "scheme": "MD-IDNO",
          "legalName": "Întreprinderea de stat comunală de catering",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.md/"
        },
        "name": "Întreprinderea de stat comunală de catering",
        "address": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Strada Miorita, 33",
          "region": "Chisinau",
          "locality": "Chisinau"
        }
      }
    ],
    "value": {
      "currency": "MDL",
      "amount": 238.0,
      "valueAddedTaxIncluded": false
    },
    "dateSigned": "2017-12-20T13:36:16.048704+02:00",
    "date": "2017-12-20T13:36:18.511703+02:00",
    "awardID": "89e507f4b41446f29e9ada88300773f5",
    "id": "06db0c6b14d746989b39fd7f7b8d57e3",
    "contractID": "MD-2017-12-20-000001-1"
  }
}

Setting contract validity period

Setting contract validity period is optional, but if it is needed, you can set appropriate startDate and endDate.

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 106
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "period": {
      "startDate": "2017-12-20T13:36:16.048704",
      "endDate": "2018-12-20T13:36:16.048704"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Articole de papetărie şi alte articole din hârtie",
        "classification": {
          "scheme": "CPV",
          "description": "Articole de papetărie şi alte articole din hârtie",
          "id": "30199000-0"
        },
        "description_en": "Stationery and paper",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Piața Marii Adunari Naționale, 1",
          "region": "Chisinau",
          "locality": "Chisinau"
        },
        "deliveryDate": {
          "startDate": "2017-12-22T13:36:16.048704+02:00",
          "endDate": "2017-12-25T13:36:16.048704+02:00"
        },
        "description_ru": "Канцелярские товары и бумага",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "212449",
          "name": "Vitalie Zlatan"
        },
        "identifier": {
          "scheme": "MD-IDNO",
          "legalName": "Întreprinderea de stat comunală de catering",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.md/"
        },
        "name": "Întreprinderea de stat comunală de catering",
        "address": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Strada Miorita, 33",
          "region": "Chisinau",
          "locality": "Chisinau"
        }
      }
    ],
    "period": {
      "startDate": "2017-12-20T13:36:16.048704+02:00",
      "endDate": "2018-12-20T13:36:16.048704+02:00"
    },
    "dateSigned": "2017-12-20T13:36:16.048704+02:00",
    "value": {
      "currency": "MDL",
      "amount": 238.0,
      "valueAddedTaxIncluded": false
    },
    "date": "2017-12-20T13:36:18.583411+02:00",
    "awardID": "89e507f4b41446f29e9ada88300773f5",
    "id": "06db0c6b14d746989b39fd7f7b8d57e3",
    "contractID": "MD-2017-12-20-000001-1"
  }
}

Uploading contract documentation

Contract documents can be uploaded only up until conclusion of the agreement. Let’s add contract document:

POST /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 206
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy492746560877$
Host: api-sandbox.mepps.openprocurement.net

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/1a13080f65ca48a29f21c56bcfbd6e85
{
  "data": {
    "title": "contract_first_document.doc",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/1a13080f65ca48a29f21c56bcfbd6e85?download=9ca1a815445742a1bd57e7a555dfaae8",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:18.655345+02:00",
    "id": "1a13080f65ca48a29f21c56bcfbd6e85",
    "dateModified": "2017-12-20T13:36:18.655376+02:00"
  }
}

201 Created response code and Location header confirm that document has been added.

Let’s see the list of contract documents:

GET /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.mepps.openprocurement.net

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "contract_first_document.doc",
      "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/1a13080f65ca48a29f21c56bcfbd6e85?download=9ca1a815445742a1bd57e7a555dfaae8",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-12-20T13:36:18.655345+02:00",
      "id": "1a13080f65ca48a29f21c56bcfbd6e85",
      "dateModified": "2017-12-20T13:36:18.655376+02:00"
    }
  ]
}

We can add another contract document:

POST /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 209
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy0337551132361$
Host: api-sandbox.mepps.openprocurement.net

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/322774f2f9924989ad45f3ac40aaeb0f
{
  "data": {
    "title": "contract_second_document.doc",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/322774f2f9924989ad45f3ac40aaeb0f?download=0a73a16d9bd04b1d882a82a8e0fdd194",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:18.778921+02:00",
    "id": "322774f2f9924989ad45f3ac40aaeb0f",
    "dateModified": "2017-12-20T13:36:18.778949+02:00"
  }
}

201 Created response code and Location header confirm second document has been added.

Let’s see the list of all uploaded contract documents:

GET /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.mepps.openprocurement.net

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "contract_first_document.doc",
      "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/1a13080f65ca48a29f21c56bcfbd6e85?download=9ca1a815445742a1bd57e7a555dfaae8",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-12-20T13:36:18.655345+02:00",
      "id": "1a13080f65ca48a29f21c56bcfbd6e85",
      "dateModified": "2017-12-20T13:36:18.655376+02:00"
    },
    {
      "title": "contract_second_document.doc",
      "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/322774f2f9924989ad45f3ac40aaeb0f?download=0a73a16d9bd04b1d882a82a8e0fdd194",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-12-20T13:36:18.778921+02:00",
      "id": "322774f2f9924989ad45f3ac40aaeb0f",
      "dateModified": "2017-12-20T13:36:18.778949+02:00"
    }
  ]
}

Contract registration

To ensure contract is fetched and sent to Treasury for validation, upon confirming award qualification, contract is to be switched into pending.signed status:

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 38
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "status": "pending.signed"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending.signed",
    "documents": [
      {
        "title": "contract_first_document.doc",
        "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/1a13080f65ca48a29f21c56bcfbd6e85?download=9ca1a815445742a1bd57e7a555dfaae8",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-12-20T13:36:18.655345+02:00",
        "id": "1a13080f65ca48a29f21c56bcfbd6e85",
        "dateModified": "2017-12-20T13:36:18.655376+02:00"
      },
      {
        "title": "contract_second_document.doc",
        "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/322774f2f9924989ad45f3ac40aaeb0f?download=0a73a16d9bd04b1d882a82a8e0fdd194",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-12-20T13:36:18.778921+02:00",
        "id": "322774f2f9924989ad45f3ac40aaeb0f",
        "dateModified": "2017-12-20T13:36:18.778949+02:00"
      }
    ],
    "items": [
      {
        "description": "Articole de papetărie şi alte articole din hârtie",
        "classification": {
          "scheme": "CPV",
          "description": "Articole de papetărie şi alte articole din hârtie",
          "id": "30199000-0"
        },
        "description_en": "Stationery and paper",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Piața Marii Adunari Naționale, 1",
          "region": "Chisinau",
          "locality": "Chisinau"
        },
        "deliveryDate": {
          "startDate": "2017-12-22T13:36:16.048704+02:00",
          "endDate": "2017-12-25T13:36:16.048704+02:00"
        },
        "description_ru": "Канцелярские товары и бумага",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "212449",
          "name": "Vitalie Zlatan"
        },
        "identifier": {
          "scheme": "MD-IDNO",
          "legalName": "Întreprinderea de stat comunală de catering",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.md/"
        },
        "name": "Întreprinderea de stat comunală de catering",
        "address": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Strada Miorita, 33",
          "region": "Chisinau",
          "locality": "Chisinau"
        }
      }
    ],
    "period": {
      "startDate": "2017-12-20T13:36:16.048704+02:00",
      "endDate": "2018-12-20T13:36:16.048704+02:00"
    },
    "value": {
      "currency": "MDL",
      "amount": 238.0,
      "valueAddedTaxIncluded": false
    },
    "dateSigned": "2017-12-20T13:36:16.048704+02:00",
    "date": "2017-12-20T13:36:18.926075+02:00",
    "awardID": "89e507f4b41446f29e9ada88300773f5",
    "id": "06db0c6b14d746989b39fd7f7b8d57e3",
    "contractID": "MD-2017-12-20-000001-1"
  }
}

Tender contract can be registered by changing it’s status to active:

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_first_document.doc",
        "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/1a13080f65ca48a29f21c56bcfbd6e85?download=9ca1a815445742a1bd57e7a555dfaae8",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-12-20T13:36:18.655345+02:00",
        "id": "1a13080f65ca48a29f21c56bcfbd6e85",
        "dateModified": "2017-12-20T13:36:18.655376+02:00"
      },
      {
        "title": "contract_second_document.doc",
        "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/contracts/06db0c6b14d746989b39fd7f7b8d57e3/documents/322774f2f9924989ad45f3ac40aaeb0f?download=0a73a16d9bd04b1d882a82a8e0fdd194",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-12-20T13:36:18.778921+02:00",
        "id": "322774f2f9924989ad45f3ac40aaeb0f",
        "dateModified": "2017-12-20T13:36:18.778949+02:00"
      }
    ],
    "items": [
      {
        "description": "Articole de papetărie şi alte articole din hârtie",
        "classification": {
          "scheme": "CPV",
          "description": "Articole de papetărie şi alte articole din hârtie",
          "id": "30199000-0"
        },
        "description_en": "Stationery and paper",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Piața Marii Adunari Naționale, 1",
          "region": "Chisinau",
          "locality": "Chisinau"
        },
        "deliveryDate": {
          "startDate": "2017-12-22T13:36:16.048704+02:00",
          "endDate": "2017-12-25T13:36:16.048704+02:00"
        },
        "description_ru": "Канцелярские товары и бумага",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "212449",
          "name": "Vitalie Zlatan"
        },
        "identifier": {
          "scheme": "MD-IDNO",
          "legalName": "Întreprinderea de stat comunală de catering",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.md/"
        },
        "name": "Întreprinderea de stat comunală de catering",
        "address": {
          "postalCode": "MD-2033",
          "countryName": "Republica Moldova",
          "streetAddress": "Strada Miorita, 33",
          "region": "Chisinau",
          "locality": "Chisinau"
        }
      }
    ],
    "period": {
      "startDate": "2017-12-20T13:36:16.048704+02:00",
      "endDate": "2018-12-20T13:36:16.048704+02:00"
    },
    "value": {
      "currency": "MDL",
      "amount": 238.0,
      "valueAddedTaxIncluded": false
    },
    "dateSigned": "2017-12-20T13:36:16.048704+02:00",
    "date": "2017-12-20T13:36:19.015778+02:00",
    "awardID": "89e507f4b41446f29e9ada88300773f5",
    "id": "06db0c6b14d746989b39fd7f7b8d57e3",
    "contractID": "MD-2017-12-20-000001-1"
  }
}

Cancelling tender

Procuring entity can cancel tender anytime. The following steps should be applied:

  1. Prepare cancellation request
  2. Fill it with the protocol describing the cancellation reasons
  3. Cancel the tender with the reasons prepared.

Only the request that has been activated (3rd step above) has power to cancel tender. I.e. you have to not only prepare cancellation request but to activate it as well.

See Cancellation data structure for details.

Preparing the cancellation request

You should pass reason, status defaults to pending.

id is autogenerated and passed in the Location header of response.

POST /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "reason": "cancellation reason"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2
{
  "data": {
    "status": "pending",
    "reason": "cancellation reason",
    "reasonType": "cancelled",
    "date": "2017-12-20T13:36:19.115451+02:00",
    "cancellationOf": "tender",
    "id": "3d17afdd89504a42b8b51934f37b2dc2"
  }
}

There are two possible types of cancellation reason - tender was cancelled or unsuccessful. By default reasonType value is cancelled.

You can change reasonType value to unsuccessful.

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "reasonType": "unsuccessful"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "reason": "cancellation reason",
    "reasonType": "unsuccessful",
    "date": "2017-12-20T13:36:19.115451+02:00",
    "cancellationOf": "tender",
    "id": "3d17afdd89504a42b8b51934f37b2dc2"
  }
}

Filling cancellation with protocol and supplementary documentation

Upload the file contents

POST /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy834375886455$
Host: api-sandbox.mepps.openprocurement.net

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents/4366e9df64f64393adf422faca3f7952
{
  "data": {
    "title": "Notice.pdf",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents/4366e9df64f64393adf422faca3f7952?download=22ae929d95fd4f62ba23cd8d4839b52c",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:19.252466+02:00",
    "id": "4366e9df64f64393adf422faca3f7952",
    "dateModified": "2017-12-20T13:36:19.252490+02:00"
  }
}

Change the document description and other properties

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents/4366e9df64f64393adf422faca3f7952?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "description": "Changed description"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Changed description",
    "title": "Notice.pdf",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents/4366e9df64f64393adf422faca3f7952?download=22ae929d95fd4f62ba23cd8d4839b52c",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:19.252466+02:00",
    "id": "4366e9df64f64393adf422faca3f7952",
    "dateModified": "2017-12-20T13:36:19.252490+02:00"
  }
}

Upload new version of the document

PUT /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents/4366e9df64f64393adf422faca3f7952?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 189
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy270542933699$
Host: api-sandbox.mepps.openprocurement.net

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Changed description",
    "title": "Notice-2.pdf",
    "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents/4366e9df64f64393adf422faca3f7952?download=7cd79fe0702b44f994f1edc3e79064a2",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-12-20T13:36:19.252466+02:00",
    "id": "4366e9df64f64393adf422faca3f7952",
    "dateModified": "2017-12-20T13:36:19.402794+02:00"
  }
}

Activating the request and cancelling tender

PATCH /api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2?acc_token=d4574ebc11b047ae8b360d43132184d3 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.mepps.openprocurement.net

{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "description": "Changed description",
        "title": "Notice.pdf",
        "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents/4366e9df64f64393adf422faca3f7952?download=22ae929d95fd4f62ba23cd8d4839b52c",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-12-20T13:36:19.252466+02:00",
        "id": "4366e9df64f64393adf422faca3f7952",
        "dateModified": "2017-12-20T13:36:19.252490+02:00"
      },
      {
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://api-sandbox.mepps.openprocurement.net/api/2.3/tenders/e880178c4afa45b08d1c9873d61cd6eb/cancellations/3d17afdd89504a42b8b51934f37b2dc2/documents/4366e9df64f64393adf422faca3f7952?download=7cd79fe0702b44f994f1edc3e79064a2",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-12-20T13:36:19.252466+02:00",
        "id": "4366e9df64f64393adf422faca3f7952",
        "dateModified": "2017-12-20T13:36:19.402794+02:00"
      }
    ],
    "reason": "cancellation reason",
    "reasonType": "unsuccessful",
    "date": "2017-12-20T13:36:19.494945+02:00",
    "cancellationOf": "tender",
    "id": "3d17afdd89504a42b8b51934f37b2dc2"
  }
}

Data Standard

Data standard is modelled along the Open Contracting Standard with extensions in areas that were not covered by it.

ProcuringEntity

Schema

name:

string, multilingual

OpenContracting Description: The common name of the organization.

identifier:

Identifier

OpenContracting Description: The primary identifier for this organization.

additionalIdentifiers:
 

List of Identifier objects

address:

Address, required

contactPoint:

ContactPoint, required

kind:

string

Type of procuring entity

Possible values:
  • general - Procuring entity (general)
  • special - Procuring entity that operates in certain spheres of economic activity
  • defense - Procuring entity that conducts procurement for the defense needs
  • other - Legal persons that are not procuring entities in the sense of the Law, but are state, utility, public enterprises, economic partnerships or associations of enterprises in which state or public utility share is 50 percent or more

Contract

Schema

id:

uid, auto-generated

OpenContracting Description: The identifier for this contract.

awardID:

string, required

OpenContracting Description: The Award.id against which this contract is being issued.

contractID:

string, auto-generated, read-only

title:

string, required

OpenContracting Description: Contract title

description:

string

OpenContracting Description: Contract description

items:

List of Item objects, auto-generated, read-only

OpenContracting Description: The goods, services, and any intangible outcomes in this contract. Note: If the items are the same as the award do not repeat.

suppliers:

List of Organization objects, auto-generated, read-only

status:

string, required

OpenContracting Description: The current status of the contract.

Possible values are:

  • pending - this contract has been proposed, but is not yet in force. It may be awaiting signature.
  • pending.signed - this contract can be sent for validation to the Treasury. Returning to pending status can be performed only after 15 minutes.
  • active - this contract has been signed by all the parties, and is now legally in force.
  • cancelled - this contract has been cancelled prior to being signed.
  • terminated - this contract was signed and in force, and has now come to a close. This may be due to a successful completion of the contract, or may be early termination due to some non-completion issue.
period:

Period

OpenContracting Description: The start and end date for the contract.

value:

Value object, auto-generated, read-only

OpenContracting Description: The total value of this contract.

dateSigned:

string, Date, auto-generated

OpenContracting Description: The date the contract was signed. In the case of multiple signatures, the date of the last signature.

Time frame for dateSigned:

  • reporting procedure:

    [24 hours ago - now]

documents:

List of Document objects

OpenContracting Description: All documents and attachments related to the contract, including any notices.

Contract workflow

digraph G {
    A [ label="pending*" ]
    B [ label="active"]
    C [ label="cancelled"]
    D [ label="pending.signed"]
     A -> B;
     A -> D;
     D -> B;
     D -> A;
     edge[style=dashed];
     A -> C;
}

* marks initial state. Dashed line marks auto-trasition on award cancellation

Item

Schema

id:

string, auto-generated

description:

string, multilingual, required

OpenContracting Description: A description of the goods, services to be provided.

classification:

Classification

OpenContracting Description: The primary classification for the item. See the itemClassificationScheme to identify preferred classification lists, including CPV and GSIN.

It is mandatory for classification.scheme to be CPV. The classification.id should be valid CPV code.

additionalClassifications:
 

List of Classification objects

OpenContracting Description: An array of additional classifications for the item. See the itemClassificationScheme codelist for common options to use in OCDS. This may also be used to present codes from an internal classification scheme.

unit:

Unit

OpenContracting Description: Description of the unit which the good comes in e.g. hours, kilograms. Made up of a unit name, and the value of a single unit.

quantity:

integer

OpenContracting Description: The number of units required

deliveryDate:

Period, requred

Period during which the item should be delivered.

deliveryAddress:
 

Address, required

Address, where the item should be delivered.

deliveryLocation:
 

dictionary

Geographical coordinates of delivery location. Element consist of the following items:

latitude:string, required
longitude:string, required
elevation:string, optional, usually not used

deliveryLocation usually takes precedence over deliveryAddress if both are present.

Classification

Schema

scheme:

string

OpenContracting Description: A classification should be drawn from an existing scheme or list of codes. This field is used to indicate the scheme/codelist from which the classification is drawn. For line item classifications, this value should represent a known Item Classification Scheme wherever possible.

id:

string

OpenContracting Description: The classification code drawn from the selected scheme.

description:

string

OpenContracting Description: A textual description or title for the code.

uri:

uri

OpenContracting Description: A URI to identify the code. In the event individual URIs are not available for items in the identifier scheme this value should be left blank.

Unit

Schema

code:

string, required

UN/CEFACT Recommendation 20 unit code.

name:

string

OpenContracting Description: Name of the unit

value:

Value

Document

Schema

id:

string, autogenerated

documentType:

string

Possible values for Tender

  • notice - Tender notice

    The formal notice that gives details of a tender. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.

  • technicalSpecifications - Technical Specifications

    Detailed technical information about goods or services to be provided.

  • shortlistedFirms - Shortlisted Firms

  • riskProvisions - Provisions for management of risks and liabilities

  • billOfQuantity - Bill Of Quantity

  • conflictOfInterest - Conflicts of interest uncovered

  • debarments - Debarments issued

  • contractProforma - Draft contract

  • technicalProposal - Technical proposal

Possible values for Award

  • notice - Award Notice

    The formal notice that gives details of the contract award. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.

  • evaluationReports - Evaluation report

    Report on the evaluation of the proposals and the application of the evaluation criteria, including the justification fo the award.

  • complaints - Complaints and decisions

Possible values for Contract

  • notice - Contract notice

    The formal notice that gives details of a contract being signed and valid to start implementation. This may be a link to a downloadable document, to a web page, or to an official gazette in which the notice is contained.

  • contractSigned - Signed Contract

  • contractArrangements - Arrangements for ending contract

  • contractSchedule - Schedules and milestones

  • contractAnnexe - Annexes to the Contract

  • contractGuarantees - Guarantees

  • subContract - Subcontracts

title:

string, multilingual

OpenContracting Description: The document title.

description:

string, multilingual

OpenContracting Description: A short description of the document. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

format:

string

OpenContracting Description: The format of the document taken from the IANA Media Types code list, with the addition of one extra value for ‘offline/print’, used when this document entry is being used to describe the offline publication of a document.

url:

string, autogenerated

OpenContracting Description: Direct link to the document or attachment.

datePublished:

string, Date

OpenContracting Description: The date on which the document was first published.

dateModified:

string, Date

OpenContracting Description: Date that the document was last modified

language:

string

OpenContracting Description: Specifies the language of the linked document using either two-digit ISO 639-1, or extended BCP47 language tags.

documentOf:

string

Possible values are:

  • tender
  • item
relatedItem:

string

Id of related Lot or Item.

Tender

Schema

title:

string, multilingual

The name of the tender, displayed in listings. You can include the following items:

  • tender code (in procuring organization management system)
  • periodicity of the tender (annual, quarterly, etc.)
  • item being procured
  • some other info
description:

string, multilingual

Detailed description of tender.

tenderID:

string, auto-generated, read-only

The tender identifier that can be used to find tender in “paper” documentation.

OpenContracting Description: TenderID should always be the same as the OCID. It is included to make the flattened data structure more convenient.

procuringEntity:
 

ProcuringEntity, required

Organization conducting the tender.

OpenContracting Description: The entity managing the procurement, which may be different from the buyer who is paying / using the items being procured.

value:

Value, required

Total available tender budget.

OpenContracting Description: The total estimated value of the procurement.

items:

list of Item objects, required

List that contains single item being procured.

OpenContracting Description: The goods and services to be purchased, broken into line items wherever possible. Items should not be duplicated, but a quantity of 2 specified instead.

documents:

List of Document objects

OpenContracting Description: All documents and attachments related to the tender.

awards:

List of Award objects

All qualifications (disqualifications and awards).

contracts:

List of Contract objects

OpenContracting Description: The date or period on which an award is anticipated to be made.

status:

string

active:Active tender (default)
complete:Completed tender
cancelled:Cancelled tender
unsuccessful:Unsuccessful tender

Status of the Tender.

cancellations:

List of Cancellation objects.

Contains 1 object with active status in case of cancelled Tender.

The Cancellation object describes the reason of tender cancellation contains accompanying documents if any.

procurementMethod:
 

string, auto-generated

limited:Default.

Procurement Method of the Tender.

procurementMethodRationale:
 

string, multilingual

Procurement Method Rationale of tender.

procurementMethodType:
 

string

reporting:reporting procedure indentifier
dateModified:

string, Date

owner:

string, auto-generated

Tender workflow

digraph G {
    A [ label="active*" ]
    B [ label="complete"]
    C [ label="cancelled"]
     A -> B;
     A -> C;
}

* marks initial state

Award

Schema

id:

string, auto-generated, read-only

OpenContracting Description: The identifier for this award.

title:

string, multilingual

OpenContracting Description: Award title.

description:

string, multilingual

OpenContracting Description: Award description.

status:

string

OpenContracting Description: The current status of the award drawn from the awardStatus codelist.

Possible values are:

  • pending - the award is under review of qualification committee
  • unsuccessful - the award has been rejected by qualification comittee
  • active - default status
  • cancelled - the award has been cancelled by complaint review body
date:

string, Date, auto-generated, read-only

OpenContracting Description: The date of the contract award.

value:

Value object, required

OpenContracting Description: The total value of this award.

suppliers:

List of Organization objects

OpenContracting Description: The suppliers awarded with this award.

items:

List of Item objects, auto-generated, read-only

OpenContracting Description: The goods and services awarded in this award, broken into line items wherever possible. Items should not be duplicated, but the quantity specified instead.

documents:

List of Document objects

OpenContracting Description: All documents and attachments related to the award, including any notices.

subcontractingDetails:
 

string

The text field of any length about subcontractor.

qualified:

bool

Confirms the absence of grounds for refusal to participate in accordance with Article 17 of the Law of Ukraine “On Public Procurement”.

Award workflow

digraph G {
    A [ label="pending*" ]
    B [ label="active"]
    C [ label="cancelled"]
    D [ label="unsuccessful"]
     A -> B;
     A -> D;
     B -> C;
}

* marks initial state

Cancellation

Schema

id:

uid, auto-generated

reason:

string, multilingual, required

The reason, why Tender is being cancelled.

status:

string

Possible values are:
pending:Default. The request is being prepared.
active:Cancellation activated.
documents:

List of Document objects

Documents accompanying the Cancellation: Protocol of Tender Committee with decision to cancel the Tender.

date:

string, Date

Cancellation date.

cancellationOf:

string, required

Possible and default values are:

  • tender
relatedLot:

string

Id of related Lot.

Cancellation workflow

digraph G {
    A [ label="pending*" ]
    B [ label="active"]
     A -> B;
}

* marks initial state

Acceleration mode for sandbox

Acceleration mode was developed to enable Negotiation and Negotiation.quick procedures testing in the sandbox and to reduce time frames of these procedures.

In order to use acceleration mode you should set quick, accelerator=1440 as text value for procurementMethodDetails during tender creation. The number 1440 shows that restrictions and time frames will be reduced in 1440 times. For example, complaintPeriod for the Negotiation procedure should be at least 10 days. When using the acceleration mode with 1440 value, tenderingPeriod can be as short as 10 minutes (10 days = 14400 min; 14400/1440 = 10 min). This mode will work only in the sandbox.

API Reference

Indices and tables