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"
  }
}