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 three procedures:

  • reporting - reporting with no stand-still period
  • negotiation - negotiation procedure with 10 day stand-still before contract registration
  • negotiation.quick - quick negotiation procedure with 5 day stand-still before contract registration

Negotiation procedure

Negotiation procurement procedure is a procedure according to which Procuring entity concludes a purchase agreement with a participant after negotiations with one or more participants.

Negotiation procedure stages:

  1. Publication of the decision of intent to conduct negotiation procedure.

The procuring entity places the announcement of intention to conduct negotiation procedure, describing the following procurement details: procurement subject, expected value, expected delivery time.

Interested suppliers can contact the Procuring entity if they want to participate in the negotiation procedure. The decision about negotiation participants is made by the Procuring entity.

  1. Awarding

According to the results of conducted negotiations with participant(s) Procuring entity publishes the announcement of intention to conclude an agreement with the winner of the procedure chosen in the course of negotiations.

  1. Conclusion of the Agreement

The Procuring entity publishes purchase agreement and accompanying documents.

Tutorial

Tender creation

You can create three procedures:
  • reporting - reporting with no stand-still period
  • negotiation - negotiation procedure with 10 day stand-still before contract registration
  • negotiation.quick - quick negotiation procedure with 5 day stand-still before contract registration

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: 3197
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "title": "Послуги шкільних їдалень",
    "procurementMethodType": "reporting",
    "title_en": "Services in school canteens",
    "description_en": "Services in school canteens",
    "procuringEntity": {
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "м. Вінниця",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      },
      "name": "ЗОСШ #10 м.Вінниці"
    },
    "title_ru": "Услуги школьных столовых",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "description": "Послуги шкільних їдалень",
            "id": "55.51.10.300"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286",
          "endDate": "2017-06-24T20:02:22.515286"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "description_ru": "Услуги школьных столовых"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83
{
  "access": {
    "token": "a4b7ef7e4b1248eeb4856ef095f8e657"
  },
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "title": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "title_en": "Services in school canteens",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2017-06-19T20:02:26.850123+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "general",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "date": "2017-06-19T20:02:26.846364+03:00",
    "procurementMethodType": "reporting",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "description_ru": "Услуги школьных столовых",
    "id": "7d7cb83ee1384fb78ca8aaf919990c83",
    "tenderID": "UA-2017-06-19-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.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.3/tenders?offset=",
    "uri": "http://api-sandbox.openprocurement.org/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 http://api-sandbox.openprocurement.org/api/0/tenders/) and its dateModified datestamp.

Creating tender for negotiation procedure

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

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

{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "title_en": "Services in school canteens",
    "procurementMethodType": "negotiation",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "causeDescription_en": "original tender has failed twice",
    "description_ru": "Услуги школьных столовых",
    "procuringEntity": {
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "м. Вінниця",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      }
    },
    "title_ru": "Услуги школьных столовых",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "description": "Послуги шкільних їдалень",
            "id": "55.51.10.300"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286",
          "endDate": "2017-06-24T20:02:22.515286"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "cause": "twiceUnsuccessful"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a
{
  "access": {
    "token": "62e6766aacb942c481ff5833e5f1274a"
  },
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "procurementMethodType": "negotiation",
    "causeDescription_en": "original tender has failed twice",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2017-06-19T20:02:33.538428+03:00",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2017-06-19T20:02:33.534492+03:00",
    "title_en": "Services in school canteens",
    "description_ru": "Услуги школьных столовых",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "general",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "cause": "twiceUnsuccessful",
    "id": "0f67d0af4cdb47f2bab36b37e33bd84a",
    "tenderID": "UA-2017-06-19-000001"
  }
}

Creating tender for negotiation.quick procedure

To create tender for negotiation.quick procedure you should set negotiation.quick value for procurementMethodType.

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

{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "procurementMethodType": "negotiation.quick",
    "title_en": "Services in school canteens",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "causeDescription_en": "original tender has failed twice",
    "procuringEntity": {
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "м. Вінниця",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      }
    },
    "title_ru": "Услуги школьных столовых",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "description": "Послуги шкільних їдалень",
            "id": "55.51.10.300"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286",
          "endDate": "2017-06-24T20:02:22.515286"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "description_ru": "Услуги школьных столовых"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61
{
  "access": {
    "token": "e3475b5af2ce460895020a2db1c9926d"
  },
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "procurementMethodType": "negotiation.quick",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2017-06-19T20:02:48.214465+03:00",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2017-06-19T20:02:48.211248+03:00",
    "causeDescription_en": "original tender has failed twice",
    "description_ru": "Услуги школьных столовых",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "general",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title_en": "Services in school canteens",
    "id": "ed2bd8393c4a422786a49846f1a5eb61",
    "tenderID": "UA-2017-06-19-000001"
  }
}

Modifying tender

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

PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "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": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "title_en": "Services in school canteens",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2017-06-19T20:02:26.971415+03:00",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "general",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "date": "2017-06-19T20:02:26.846364+03:00",
    "procurementMethodType": "reporting",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "description_ru": "Услуги школьных столовых",
    "id": "7d7cb83ee1384fb78ca8aaf919990c83",
    "tenderID": "UA-2017-06-19-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.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.3/tenders?offset=2017-06-19T20%3A02%3A26.850123%2B03%3A00",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-06-19T20%3A02%3A26.850123%2B03%3A00",
    "offset": "2017-06-19T20:02:26.850123+03:00"
  },
  "data": [
    {
      "id": "7d7cb83ee1384fb78ca8aaf919990c83",
      "dateModified": "2017-06-19T20:02:26.850123+03: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/7d7cb83ee1384fb78ca8aaf919990c83/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy270263345618$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/documents/90a857730bc54c21a77f93875b9e4b4a
{
  "data": {
    "title": "Notice.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/documents/90a857730bc54c21a77f93875b9e4b4a?download=b37decf945354cdda8c1fd1ca9494913",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:27.268883+03:00",
    "id": "90a857730bc54c21a77f93875b9e4b4a",
    "dateModified": "2017-06-19T20:02:27.268925+03: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/7d7cb83ee1384fb78ca8aaf919990c83/documents/90a857730bc54c21a77f93875b9e4b4a?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 189
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy396991568191$
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "Notice-2.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/documents/90a857730bc54c21a77f93875b9e4b4a?download=aad933d6edac492c883fd4ce020fecc8",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:27.268883+03:00",
    "id": "90a857730bc54c21a77f93875b9e4b4a",
    "dateModified": "2017-06-19T20:02:27.328930+03:00"
  }
}

Awarding

Adding supplier information

Addition of supplier information is the same for all procedures.

Procuring entity registers supplier information for reporting procedure:

POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1284
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "date": "2016-01-14T18:07:00.628073+02:00",
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "d373338bc3324f14b8b3d4af68922773",
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": "true"
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557
{
  "data": {
    "status": "pending",
    "date": "2017-06-19T20:02:27.381100+03:00",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "f73383149db344199699e1a8f587d557",
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    }
  }
}

Procuring entity registers supplier information for negotiation procedure:

POST /api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a/awards?acc_token=62e6766aacb942c481ff5833e5f1274a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1284
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "date": "2016-01-14T18:07:00.628073+02:00",
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "d373338bc3324f14b8b3d4af68922773",
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": "true"
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a/awards/13926fdfd30c4e2e939e9b7529fb0edd
{
  "data": {
    "status": "pending",
    "complaintPeriod": {
      "startDate": "2017-06-19T20:02:33.589328+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:33.587469+03:00",
    "id": "13926fdfd30c4e2e939e9b7529fb0edd"
  }
}

You can notice that there is complaintPeriod record with startDate value generated.

Procuring entity registers supplier information for negotiation.quick procedure:

POST /api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61/awards?acc_token=e3475b5af2ce460895020a2db1c9926d HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1284
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "date": "2016-01-14T18:07:00.628073+02:00",
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "d373338bc3324f14b8b3d4af68922773",
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": "true"
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61/awards/cfcac0dba40547d3b128a94a2b0ffad1
{
  "data": {
    "status": "pending",
    "complaintPeriod": {
      "startDate": "2017-06-19T20:02:48.270327+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:48.268153+03:00",
    "id": "cfcac0dba40547d3b128a94a2b0ffad1"
  }
}

Award for negotiation.quick procedure also has complaintPeriod record with startDate value.

Uploading award documentation

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

POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 203
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy334667136548$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac
{
  "data": {
    "title": "award_first_document.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac?download=c6116315f7ae4f1e9b4758092f64f488",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:27.462126+03:00",
    "id": "31b77702354749ac9a50d5e0f0bc7bac",
    "dateModified": "2017-06-19T20:02:27.462169+03: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/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "award_first_document.doc",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac?download=c6116315f7ae4f1e9b4758092f64f488",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-06-19T20:02:27.462126+03:00",
      "id": "31b77702354749ac9a50d5e0f0bc7bac",
      "dateModified": "2017-06-19T20:02:27.462169+03:00"
    }
  ]
}

We can add another award document:

POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 204
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy890262879158$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/aa227933366a45f58e9fd3755163cdc3
{
  "data": {
    "title": "award_second_document.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/aa227933366a45f58e9fd3755163cdc3?download=b1f910c14523425eaf6104d74787ed4e",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:27.568107+03:00",
    "id": "aa227933366a45f58e9fd3755163cdc3",
    "dateModified": "2017-06-19T20:02:27.568153+03: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/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "award_first_document.doc",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac?download=c6116315f7ae4f1e9b4758092f64f488",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-06-19T20:02:27.462126+03:00",
      "id": "31b77702354749ac9a50d5e0f0bc7bac",
      "dateModified": "2017-06-19T20:02:27.462169+03:00"
    },
    {
      "title": "award_second_document.doc",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/aa227933366a45f58e9fd3755163cdc3?download=b1f910c14523425eaf6104d74787ed4e",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-06-19T20:02:27.568107+03:00",
      "id": "aa227933366a45f58e9fd3755163cdc3",
      "dateModified": "2017-06-19T20:02:27.568153+03:00"
    }
  ]
}

Award confirmation

Procuring entity can confirm awarding decision:

PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "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.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/31b77702354749ac9a50d5e0f0bc7bac?download=c6116315f7ae4f1e9b4758092f64f488",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:27.462126+03:00",
        "id": "31b77702354749ac9a50d5e0f0bc7bac",
        "dateModified": "2017-06-19T20:02:27.462169+03:00"
      },
      {
        "title": "award_second_document.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/awards/f73383149db344199699e1a8f587d557/documents/aa227933366a45f58e9fd3755163cdc3?download=b1f910c14523425eaf6104d74787ed4e",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:27.568107+03:00",
        "id": "aa227933366a45f58e9fd3755163cdc3",
        "dateModified": "2017-06-19T20:02:27.568153+03:00"
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:27.690287+03:00",
    "id": "f73383149db344199699e1a8f587d557"
  }
}

Award confirmation for negotiation procedure:

PATCH /api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a/awards/13926fdfd30c4e2e939e9b7529fb0edd?acc_token=62e6766aacb942c481ff5833e5f1274a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 49
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "active",
    "qualified": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "complaintPeriod": {
      "startDate": "2017-06-19T20:02:33.589328+03:00",
      "endDate": "2017-06-30T00:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "qualified": true,
    "date": "2017-06-19T20:02:33.656887+03:00",
    "id": "13926fdfd30c4e2e939e9b7529fb0edd"
  }
}

The difference between startDate and endDate in complaintPeriod record for negotiation is 10 days.

Award confirmation for negotiation.quick procedure:

PATCH /api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61/awards/cfcac0dba40547d3b128a94a2b0ffad1?acc_token=e3475b5af2ce460895020a2db1c9926d HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 49
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "active",
    "qualified": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "complaintPeriod": {
      "startDate": "2017-06-19T20:02:48.270327+03:00",
      "endDate": "2017-06-25T00:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "qualified": true,
    "date": "2017-06-19T20:02:48.345348+03:00",
    "id": "cfcac0dba40547d3b128a94a2b0ffad1"
  }
}

The difference between startDate and endDate in complaintPeriod record for negotiation.quick is 5 days.

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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:27.834848+03:00",
    "awardID": "f73383149db344199699e1a8f587d557",
    "id": "8da00d38b52248c8a87fe8b3ef0b0159",
    "contractID": "UA-2017-06-19-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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 54
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "dateSigned": "2017-06-19T20:02:22.515286"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-06-19T20:02:22.515286+03:00",
    "date": "2017-06-19T20:02:27.952492+03:00",
    "awardID": "f73383149db344199699e1a8f587d557",
    "id": "8da00d38b52248c8a87fe8b3ef0b0159",
    "contractID": "UA-2017-06-19-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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 106
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "period": {
      "startDate": "2017-06-19T20:02:22.515286",
      "endDate": "2018-06-19T20:02:22.515286"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-19T20:02:22.515286+03:00",
      "endDate": "2018-06-19T20:02:22.515286+03:00"
    },
    "dateSigned": "2017-06-19T20:02:22.515286+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:28.073268+03:00",
    "awardID": "f73383149db344199699e1a8f587d557",
    "id": "8da00d38b52248c8a87fe8b3ef0b0159",
    "contractID": "UA-2017-06-19-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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 206
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy942597007192$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550
{
  "data": {
    "title": "contract_first_document.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550?download=ac838736f7ef4831a00e00ecb6a2c5df",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:28.190661+03:00",
    "id": "771ef06d25c34c2d8e40ba275bc12550",
    "dateModified": "2017-06-19T20:02:28.190709+03: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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "contract_first_document.doc",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550?download=ac838736f7ef4831a00e00ecb6a2c5df",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-06-19T20:02:28.190661+03:00",
      "id": "771ef06d25c34c2d8e40ba275bc12550",
      "dateModified": "2017-06-19T20:02:28.190709+03:00"
    }
  ]
}

We can add another contract document:

POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 207
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy206947069328$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/49459ab3d7f84c04a319c95f8cc78dc2
{
  "data": {
    "title": "contract_second_document.doc",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/49459ab3d7f84c04a319c95f8cc78dc2?download=ee07c83dc2de4b2c82b617ad5c4d3d07",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:28.342656+03:00",
    "id": "49459ab3d7f84c04a319c95f8cc78dc2",
    "dateModified": "2017-06-19T20:02:28.342704+03: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/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "contract_first_document.doc",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550?download=ac838736f7ef4831a00e00ecb6a2c5df",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-06-19T20:02:28.190661+03:00",
      "id": "771ef06d25c34c2d8e40ba275bc12550",
      "dateModified": "2017-06-19T20:02:28.190709+03:00"
    },
    {
      "title": "contract_second_document.doc",
      "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/49459ab3d7f84c04a319c95f8cc78dc2?download=ee07c83dc2de4b2c82b617ad5c4d3d07",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2017-06-19T20:02:28.342656+03:00",
      "id": "49459ab3d7f84c04a319c95f8cc78dc2",
      "dateModified": "2017-06-19T20:02:28.342704+03:00"
    }
  ]
}

Contract registration

Reporting tender contract can be registered immediately after award confirmation:

PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "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.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/771ef06d25c34c2d8e40ba275bc12550?download=ac838736f7ef4831a00e00ecb6a2c5df",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:28.190661+03:00",
        "id": "771ef06d25c34c2d8e40ba275bc12550",
        "dateModified": "2017-06-19T20:02:28.190709+03:00"
      },
      {
        "title": "contract_second_document.doc",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/contracts/8da00d38b52248c8a87fe8b3ef0b0159/documents/49459ab3d7f84c04a319c95f8cc78dc2?download=ee07c83dc2de4b2c82b617ad5c4d3d07",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:28.342656+03:00",
        "id": "49459ab3d7f84c04a319c95f8cc78dc2",
        "dateModified": "2017-06-19T20:02:28.342704+03:00"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "period": {
      "startDate": "2017-06-19T20:02:22.515286+03:00",
      "endDate": "2018-06-19T20:02:22.515286+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-06-19T20:02:22.515286+03:00",
    "date": "2017-06-19T20:02:28.532103+03:00",
    "awardID": "f73383149db344199699e1a8f587d557",
    "id": "8da00d38b52248c8a87fe8b3ef0b0159",
    "contractID": "UA-2017-06-19-000001-1"
  }
}

Negotiation tender contract can be registered only after the stand-still (10 day period after the award confirmation):

PATCH /api/2.3/tenders/0f67d0af4cdb47f2bab36b37e33bd84a/contracts/a082f0d8c9e0467799042ce231c43c98?acc_token=62e6766aacb942c481ff5833e5f1274a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-06-19T20:02:33.798112+03:00",
    "date": "2017-06-19T20:02:33.801458+03:00",
    "awardID": "13926fdfd30c4e2e939e9b7529fb0edd",
    "id": "a082f0d8c9e0467799042ce231c43c98",
    "contractID": "UA-2017-06-19-000001-1"
  }
}

Negotiation.quick tender contract can be registered after the stand-still (5 day period after the award confirmation):

PATCH /api/2.3/tenders/ed2bd8393c4a422786a49846f1a5eb61/contracts/036242a9296148228146e8e1fae0421a?acc_token=e3475b5af2ce460895020a2db1c9926d HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-06-19T20:02:48.472611+03:00",
    "date": "2017-06-19T20:02:48.476008+03:00",
    "awardID": "cfcac0dba40547d3b128a94a2b0ffad1",
    "id": "036242a9296148228146e8e1fae0421a",
    "contractID": "UA-2017-06-19-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/7d7cb83ee1384fb78ca8aaf919990c83/cancellations?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430
{
  "data": {
    "status": "pending",
    "reason": "cancellation reason",
    "reasonType": "cancelled",
    "date": "2017-06-19T20:02:28.702391+03:00",
    "cancellationOf": "tender",
    "id": "bc29eeeaf99743f986c6c3950e562430"
  }
}

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/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 40
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "reason": "cancellation reason",
    "reasonType": "unsuccessful",
    "date": "2017-06-19T20:02:28.702391+03:00",
    "cancellationOf": "tender",
    "id": "bc29eeeaf99743f986c6c3950e562430"
  }
}

Filling cancellation with protocol and supplementary documentation

Upload the file contents

POST /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 186
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy508746614462$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb
{
  "data": {
    "title": "Notice.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=472724ab0ed74ce2bb1bd1b68bd8294b",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:28.930888+03:00",
    "id": "781cbd490bbd4c5eb23c40349514d8fb",
    "dateModified": "2017-06-19T20:02:28.930940+03:00"
  }
}

Change the document description and other properties

PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "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.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=472724ab0ed74ce2bb1bd1b68bd8294b",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:28.930888+03:00",
    "id": "781cbd490bbd4c5eb23c40349514d8fb",
    "dateModified": "2017-06-19T20:02:28.930940+03:00"
  }
}

Upload new version of the document

PUT /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 189
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy516532578802$
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "description": "Changed description",
    "title": "Notice-2.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=8418c20c071d47bdbd3769a0b1200fe6",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:28.930888+03:00",
    "id": "781cbd490bbd4c5eb23c40349514d8fb",
    "dateModified": "2017-06-19T20:02:29.171645+03:00"
  }
}

Activating the request and cancelling tender

PATCH /api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430?acc_token=a4b7ef7e4b1248eeb4856ef095f8e657 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "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.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=472724ab0ed74ce2bb1bd1b68bd8294b",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:28.930888+03:00",
        "id": "781cbd490bbd4c5eb23c40349514d8fb",
        "dateModified": "2017-06-19T20:02:28.930940+03:00"
      },
      {
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/7d7cb83ee1384fb78ca8aaf919990c83/cancellations/bc29eeeaf99743f986c6c3950e562430/documents/781cbd490bbd4c5eb23c40349514d8fb?download=8418c20c071d47bdbd3769a0b1200fe6",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:28.930888+03:00",
        "id": "781cbd490bbd4c5eb23c40349514d8fb",
        "dateModified": "2017-06-19T20:02:29.171645+03:00"
      }
    ],
    "reason": "cancellation reason",
    "reasonType": "unsuccessful",
    "date": "2017-06-19T20:02:29.310210+03:00",
    "cancellationOf": "tender",
    "id": "bc29eeeaf99743f986c6c3950e562430"
  }
}

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.
  • 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 when 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]

  • negotiation/negotiation.quick procedure:

    [complaint period end - now]

date:

string, Date

The date when the contract was changed or activated.

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"]
     A -> B;
     A -> C;
}

* marks initial state

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.

It is mandatory to have at least one item with ДКПП as 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.

relatedLot:

string

Id of related Lot.

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

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

Possible values for Bid

  • commercialProposal - Сommercial proposal
  • qualificationDocuments - Qualification documents
  • eligibilityDocuments - Eligibility documents
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
  • lot
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.

If procurementMethodType is negotiation or negotiation.quick, then possible values of ProcuringEntity.kind are limited to ['general', 'special', 'defense'].

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
negotiation:negotiation procedure indentifier
negotiation.quick:
 negotiation.quick procedure indentifier
dateModified:

string, Date

owner:

string, auto-generated

cause:

string, required for negotiation procedure/ optional for negotiation.quick procedure

Causes for using negotiation or negotiation.quick procedures. For more details see Article 35 of the Law of Ukraine “On Public Procurement”.

Possible values for negotiation and negotiation.quick procedures:

  • artContestIP

Purchase of art or intellectual property

  • noCompetition

Lack of competition

  • twiceUnsuccessful

Two tenders have already been cancelled due to lack of participants

  • additionalPurchase

Need to use the same supplier for unification, standardization, etc.

  • additionalConstruction

Need of additional construction works

  • stateLegalServices

Purchase of legal services connected with protection of rights and interests of Ukraine

Possible values for negotiation.quick procedure:

  • quick

Procurement is urgent

causeDescription:
 

string, multilingual, required for negotiation and negotiation.quick procedures

Reasoning behind usage of negotiation or negotiation.quick procedures.

lots:

List of Lot objects.

Contains all tender lots. Only if tender.procurementMethodType is negotiation or negotiation.quick.

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

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 that contains information about subcontractor.

qualified:

bool

Confirms that Procuring entity has no grounds to reject a participant in accordance with Article 17 of the Law of Ukraine “On Public Procurement”.

lotID:

string

Id of related Lot. Only if tender.procurementMethodType is negotiation or negotiation.quick.

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

Lot

Schema

id:

string, auto-generated

title:

string, multilingual

The name of the tender lot.

description:

string, multilingual

Detailed description of tender lot.

value:

Value, required

Total available tender lot budget. Bids greater then value will be rejected.

status:

string

active:Active tender lot
unsuccessful:Unsuccessful tender lot
complete:Completed tender lot
cancelled:Cancelled tender lot

Status of the Lot.

Workflow

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

* marks initial state

Multiple Lots Tutorial

Creating tender

Let’s create tender:

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

{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "procurementMethodType": "negotiation.quick",
    "title_en": "Services in school canteens",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "causeDescription_en": "original tender has failed twice",
    "procuringEntity": {
      "kind": "general",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "address": {
        "countryName": "Україна",
        "postalCode": "21027",
        "region": "м. Вінниця",
        "streetAddress": "вул. Стахурського. 22",
        "locality": "м. Вінниця"
      }
    },
    "title_ru": "Услуги школьных столовых",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "description": "Послуги шкільних їдалень",
            "id": "55.51.10.300"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286",
          "endDate": "2017-06-24T20:02:22.515286"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "description_ru": "Услуги школьных столовых"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b
{
  "access": {
    "token": "56bff70fcb174649879a0f9d83055a8c"
  },
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "procurementMethodType": "negotiation.quick",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2017-06-19T20:02:50.485614+03:00",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2017-06-19T20:02:50.482399+03:00",
    "causeDescription_en": "original tender has failed twice",
    "description_ru": "Услуги школьных столовых",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "general",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title_en": "Services in school canteens",
    "id": "e2f60567d1d8406e8bc9f40931e1132b",
    "tenderID": "UA-2017-06-19-000001"
  }
}

Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created tender: its internal id (that matches the Location segment), its official tenderID and dateModified datestamp stating the moment in time when tender was last modified. Note that tender is created with active.tendering status.

Tender can contain several different lots. We can add lot using the following way:

POST /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/lots?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 198
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "description": "Опис Лот №1",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "title": "Лот №1"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/lots/132b472e0b564c2a9151fb10fa7abb08
{
  "data": {
    "status": "active",
    "description": "Опис Лот №1",
    "title": "Лот №1",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:50.533976+03:00",
    "id": "132b472e0b564c2a9151fb10fa7abb08"
  }
}

Also you will need to update data about item’s related lots:

PATCH /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 73
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "items": [
      {
        "relatedLot": "132b472e0b564c2a9151fb10fa7abb08"
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "title": "Лот №1",
        "value": {
          "currency": "UAH",
          "amount": 500000.0,
          "valueAddedTaxIncluded": true
        },
        "date": "2017-06-19T20:02:50.533976+03:00",
        "id": "132b472e0b564c2a9151fb10fa7abb08"
      }
    ],
    "items": [
      {
        "relatedLot": "132b472e0b564c2a9151fb10fa7abb08",
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "procurementMethodType": "negotiation.quick",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2017-06-19T20:02:50.619378+03:00",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2017-06-19T20:02:50.482399+03:00",
    "causeDescription_en": "original tender has failed twice",
    "description_ru": "Услуги школьных столовых",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "general",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title_en": "Services in school canteens",
    "id": "e2f60567d1d8406e8bc9f40931e1132b",
    "tenderID": "UA-2017-06-19-000001"
  }
}

View tender listing:

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.3/tenders?offset=2017-06-19T20%3A02%3A50.619378%2B03%3A00",
    "uri": "http://api-sandbox.openprocurement.org/api/2.3/tenders?offset=2017-06-19T20%3A02%3A50.619378%2B03%3A00",
    "offset": "2017-06-19T20:02:50.619378+03:00"
  },
  "data": [
    {
      "id": "e2f60567d1d8406e8bc9f40931e1132b",
      "dateModified": "2017-06-19T20:02:50.619378+03:00"
    }
  ]
}

or view tender:

GET /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b HTTP/1.0
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "lots": [
      {
        "status": "active",
        "description": "Опис Лот №1",
        "title": "Лот №1",
        "value": {
          "currency": "UAH",
          "amount": 500000.0,
          "valueAddedTaxIncluded": true
        },
        "date": "2017-06-19T20:02:50.533976+03:00",
        "id": "132b472e0b564c2a9151fb10fa7abb08"
      }
    ],
    "items": [
      {
        "relatedLot": "132b472e0b564c2a9151fb10fa7abb08",
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "procurementMethodType": "negotiation.quick",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2017-06-19T20:02:50.619378+03:00",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2017-06-19T20:02:50.482399+03:00",
    "causeDescription_en": "original tender has failed twice",
    "description_ru": "Услуги школьных столовых",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "procuringEntity": {
      "contactPoint": {
        "url": "http://sch10.edu.vn.ua/",
        "name": "Куца Світлана Валентинівна",
        "telephone": "+380 (432) 46-53-02"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "21725150",
        "legalName": "Заклад \"Загальноосвітня школа І-ІІІ ступенів № 10 Вінницької міської ради\""
      },
      "name": "ЗОСШ #10 м.Вінниці",
      "kind": "general",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title_en": "Services in school canteens",
    "id": "e2f60567d1d8406e8bc9f40931e1132b",
    "tenderID": "UA-2017-06-19-000001"
  }
}

Awarding

Addition of supplier information is the same for all procedures.

Add award for lot №1:

POST /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/awards?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1329
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "pending",
    "lotID": "132b472e0b564c2a9151fb10fa7abb08",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": "true"
    },
    "date": "2016-01-14T18:07:00.628073+02:00",
    "id": "d373338bc3324f14b8b3d4af68922773"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/awards/d113ca3649e1455a8f839a496ed2ad36
{
  "data": {
    "status": "pending",
    "lotID": "132b472e0b564c2a9151fb10fa7abb08",
    "complaintPeriod": {
      "startDate": "2017-06-19T20:02:50.795217+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:50.793061+03:00",
    "id": "d113ca3649e1455a8f839a496ed2ad36"
  }
}

Award confirmation:

PATCH /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/awards/d113ca3649e1455a8f839a496ed2ad36?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 49
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "active",
    "qualified": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "lotID": "132b472e0b564c2a9151fb10fa7abb08",
    "complaintPeriod": {
      "startDate": "2017-06-19T20:02:50.795217+03:00",
      "endDate": "2017-06-25T00:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "qualified": true,
    "date": "2017-06-19T20:02:50.883003+03:00",
    "id": "d113ca3649e1455a8f839a496ed2ad36"
  }
}

The difference between startDate and endDate in complaintPeriod record for negotiation is 10 days and for negotiation.quick is 5 days.

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/e2f60567d1d8406e8bc9f40931e1132b/contracts/3a0caa5770a54815bdd48cd2e07a8a20?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 36
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "relatedLot": "132b472e0b564c2a9151fb10fa7abb08",
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:51.033377+03:00",
    "awardID": "d113ca3649e1455a8f839a496ed2ad36",
    "id": "3a0caa5770a54815bdd48cd2e07a8a20",
    "contractID": "UA-2017-06-19-000001-1"
  }
}

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

Contract registration

Negotiation and Negotiation.quick tender contract can be registered only after the stand-still (10 and 5 days period after the award confirmation).

PATCH /api/2.3/tenders/e2f60567d1d8406e8bc9f40931e1132b/contracts/3a0caa5770a54815bdd48cd2e07a8a20?acc_token=56bff70fcb174649879a0f9d83055a8c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.openprocurement.org

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "relatedLot": "132b472e0b564c2a9151fb10fa7abb08",
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "description_en": "Services in school canteens",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "55.51.10.300",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2017-06-21T20:02:22.515286+03:00",
          "endDate": "2017-06-24T20:02:22.515286+03:00"
        },
        "description_ru": "Услуги школьных столовых",
        "id": "2dc54675d6364e2baffbc0f8e74432ac"
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2017-06-19T20:02:51.155028+03:00",
    "date": "2017-06-19T20:02:51.158920+03:00",
    "awardID": "d113ca3649e1455a8f839a496ed2ad36",
    "id": "3a0caa5770a54815bdd48cd2e07a8a20",
    "contractID": "UA-2017-06-19-000001-1"
  }
}

Complaint Workflow

For more detailed information read Complaints.

Tender Award Complaints

digraph G {
    rankdir=LR;
    {rank=same; mistaken; invalid; resolved; declined; stopped; cancelled;}
    subgraph cluster_complaint {
        label = "complaint";
        pending; accepted; stopping; satisfied;
    }
    satisfied -> resolved;
    edge[style=dashed];
    draft -> {pending,cancelled};
    {pending,accepted} -> stopping;
    edge[style=bold];
    pending -> {accepted,invalid};
    stopping -> {stopped,invalid,declined};
    accepted -> {declined,satisfied,stopped};
    {pending;stopping} -> mistaken;
}

Complaint Retrieval

Tender Award Complaint Retrieval

You can list all Tender Award Complaints:

GET /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints HTTP/1.0
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "status": "satisfied",
      "dateDecision": "2017-06-19T20:02:43.043216+03:00",
      "documents": [
        {
          "author": "complaint_owner",
          "title": "Complaint_Attachement.pdf",
          "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-06-19T20:02:41.325550+03:00",
          "id": "3aeda15b69c74c3a82571eba2ff01577",
          "dateModified": "2017-06-19T20:02:41.325597+03:00"
        },
        {
          "author": "aboveThresholdReviewers",
          "title": "ComplaintResolution.pdf",
          "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
          "format": "application/pdf",
          "documentOf": "tender",
          "datePublished": "2017-06-19T20:02:42.850136+03:00",
          "id": "9799ddf93e664cf49abcc7b325e95198",
          "dateModified": "2017-06-19T20:02:42.850182+03:00"
        }
      ],
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "title": "Недостатньо інформації",
      "author": {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      },
      "dateAccepted": "2017-06-19T20:02:42.216517+03:00",
      "dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
      "complaintID": "UA-2017-06-19-000001.1",
      "date": "2017-06-19T20:02:43.050448+03:00",
      "acceptance": true,
      "type": "complaint",
      "id": "bd672abf667d4966974d2f6d6ae07310"
    },
    {
      "status": "invalid",
      "dateDecision": "2017-06-19T20:02:42.056253+03:00",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "author": {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      },
      "acceptance": false,
      "dateSubmitted": "2017-06-19T20:02:41.530724+03:00",
      "complaintID": "UA-2017-06-19-000001.2",
      "date": "2017-06-19T20:02:42.063253+03:00",
      "title": "Недостатньо інформації",
      "type": "complaint",
      "id": "e80a7ee0db444c279b368deae7ead938"
    },
    {
      "status": "declined",
      "dateDecision": "2017-06-19T20:02:43.212370+03:00",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "author": {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      },
      "acceptance": true,
      "dateAccepted": "2017-06-19T20:02:42.370801+03:00",
      "dateSubmitted": "2017-06-19T20:02:41.643973+03:00",
      "complaintID": "UA-2017-06-19-000001.3",
      "date": "2017-06-19T20:02:43.219571+03:00",
      "title": "Недостатньо інформації",
      "type": "complaint",
      "id": "15d1eaca9c8443278c3ce4834228b306"
    },
    {
      "status": "accepted",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "author": {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      },
      "acceptance": true,
      "dateAccepted": "2017-06-19T20:02:42.526127+03:00",
      "dateSubmitted": "2017-06-19T20:02:41.765389+03:00",
      "complaintID": "UA-2017-06-19-000001.4",
      "date": "2017-06-19T20:02:42.533124+03:00",
      "title": "Недостатньо інформації",
      "type": "complaint",
      "id": "54480f965268476a98b2aabef16d254b"
    },
    {
      "status": "stopped",
      "dateDecision": "2017-06-19T20:02:43.381162+03:00",
      "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
      "title": "Недостатньо інформації",
      "decision": "Тендер скасовується замовником",
      "acceptance": true,
      "dateCanceled": "2017-06-19T20:02:43.381188+03:00",
      "dateAccepted": "2017-06-19T20:02:42.683801+03:00",
      "author": {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      },
      "dateSubmitted": "2017-06-19T20:02:41.900477+03:00",
      "complaintID": "UA-2017-06-19-000001.5",
      "date": "2017-06-19T20:02:43.388563+03:00",
      "type": "complaint",
      "id": "835aeb389f5b4fe19dc0854a4834e24d"
    }
  ]
}

And check individual complaint:

GET /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310 HTTP/1.0
Host: api-sandbox.openprocurement.org

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "satisfied",
    "dateDecision": "2017-06-19T20:02:43.043216+03:00",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:41.325550+03:00",
        "id": "3aeda15b69c74c3a82571eba2ff01577",
        "dateModified": "2017-06-19T20:02:41.325597+03:00"
      },
      {
        "author": "aboveThresholdReviewers",
        "title": "ComplaintResolution.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:42.850136+03:00",
        "id": "9799ddf93e664cf49abcc7b325e95198",
        "dateModified": "2017-06-19T20:02:42.850182+03:00"
      }
    ],
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "dateAccepted": "2017-06-19T20:02:42.216517+03:00",
    "dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
    "complaintID": "UA-2017-06-19-000001.1",
    "date": "2017-06-19T20:02:43.050448+03:00",
    "acceptance": true,
    "type": "complaint",
    "id": "bd672abf667d4966974d2f6d6ae07310"
  }
}

Complaint Submission

If tender award is favoriting certain supplier, or in any other viable case, any registered user can submit Tender Award Complaint.

Tender Award Complaint Submission (with documents)

At first create a complaint.

POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1682
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "author": {
      "contactPoint": {
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "countryName": "Україна",
        "postalCode": "21100",
        "region": "м. Вінниця",
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця"
      }
    },
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310
{
  "access": {
    "token": "f79c1cb574c848a4b7c56115c0b15c78"
  },
  "data": {
    "status": "draft",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title": "Недостатньо інформації",
    "complaintID": "UA-2017-06-19-000001.1",
    "date": "2017-06-19T20:02:41.220238+03:00",
    "type": "complaint",
    "id": "bd672abf667d4966974d2f6d6ae07310"
  }
}

Then upload necessary documents:

POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents?acc_token=f79c1cb574c848a4b7c56115c0b15c78 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 201
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy419159797722$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577
{
  "data": {
    "author": "complaint_owner",
    "title": "Complaint_Attachement.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:41.325550+03:00",
    "id": "3aeda15b69c74c3a82571eba2ff01577",
    "dateModified": "2017-06-19T20:02:41.325597+03:00"
  }
}

Submit tender award complaint:

PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310?acc_token=f79c1cb574c848a4b7c56115c0b15c78 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "pending"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:41.325550+03:00",
        "id": "3aeda15b69c74c3a82571eba2ff01577",
        "dateModified": "2017-06-19T20:02:41.325597+03:00"
      }
    ],
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
    "complaintID": "UA-2017-06-19-000001.1",
    "date": "2017-06-19T20:02:41.435687+03:00",
    "type": "complaint",
    "id": "bd672abf667d4966974d2f6d6ae07310"
  }
}
Tender Award Complaint Submission (without documents)

You can submit complaint that does not need additional documents:

POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1703
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "pending",
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "countryName": "Україна",
        "postalCode": "21100",
        "region": "м. Вінниця",
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця"
      }
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/e80a7ee0db444c279b368deae7ead938
{
  "access": {
    "token": "1a833276567d4fccae7ac2d7fe187488"
  },
  "data": {
    "status": "pending",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title": "Недостатньо інформації",
    "dateSubmitted": "2017-06-19T20:02:41.530724+03:00",
    "complaintID": "UA-2017-06-19-000001.2",
    "date": "2017-06-19T20:02:41.530698+03:00",
    "type": "complaint",
    "id": "e80a7ee0db444c279b368deae7ead938"
  }
}

Complaint Resolution

Rejecting Tender Award Complaint
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/e80a7ee0db444c279b368deae7ead938 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 31
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "invalid"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "invalid",
    "dateDecision": "2017-06-19T20:02:42.056253+03:00",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "acceptance": false,
    "dateSubmitted": "2017-06-19T20:02:41.530724+03:00",
    "complaintID": "UA-2017-06-19-000001.2",
    "date": "2017-06-19T20:02:42.063253+03:00",
    "title": "Недостатньо інформації",
    "type": "complaint",
    "id": "e80a7ee0db444c279b368deae7ead938"
  }
}
Accepting Tender Award Complaint
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 32
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "accepted"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "accepted",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:41.325550+03:00",
        "id": "3aeda15b69c74c3a82571eba2ff01577",
        "dateModified": "2017-06-19T20:02:41.325597+03:00"
      }
    ],
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "dateAccepted": "2017-06-19T20:02:42.216517+03:00",
    "dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
    "complaintID": "UA-2017-06-19-000001.1",
    "date": "2017-06-19T20:02:42.223397+03:00",
    "acceptance": true,
    "type": "complaint",
    "id": "bd672abf667d4966974d2f6d6ae07310"
  }
}
Submitting Tender Award Complaint Resolution

The Complaint Review Body uploads the resolution document:

POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 197
Content-Type: multipart/form-data; boundary=----------a_BoUnDaRy22229671021$
Host: api-sandbox.openprocurement.org

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198
{
  "data": {
    "author": "aboveThresholdReviewers",
    "title": "ComplaintResolution.pdf",
    "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-06-19T20:02:42.850136+03:00",
    "id": "9799ddf93e664cf49abcc7b325e95198",
    "dateModified": "2017-06-19T20:02:42.850182+03:00"
  }
}

And either resolves complaint:

PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "satisfied"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "satisfied",
    "dateDecision": "2017-06-19T20:02:43.043216+03:00",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:41.325550+03:00",
        "id": "3aeda15b69c74c3a82571eba2ff01577",
        "dateModified": "2017-06-19T20:02:41.325597+03:00"
      },
      {
        "author": "aboveThresholdReviewers",
        "title": "ComplaintResolution.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:42.850136+03:00",
        "id": "9799ddf93e664cf49abcc7b325e95198",
        "dateModified": "2017-06-19T20:02:42.850182+03:00"
      }
    ],
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "dateAccepted": "2017-06-19T20:02:42.216517+03:00",
    "dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
    "complaintID": "UA-2017-06-19-000001.1",
    "date": "2017-06-19T20:02:43.050448+03:00",
    "acceptance": true,
    "type": "complaint",
    "id": "bd672abf667d4966974d2f6d6ae07310"
  }
}

Or declines it:

PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/15d1eaca9c8443278c3ce4834228b306 HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 32
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "declined"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "declined",
    "dateDecision": "2017-06-19T20:02:43.212370+03:00",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "acceptance": true,
    "dateAccepted": "2017-06-19T20:02:42.370801+03:00",
    "dateSubmitted": "2017-06-19T20:02:41.643973+03:00",
    "complaintID": "UA-2017-06-19-000001.3",
    "date": "2017-06-19T20:02:43.219571+03:00",
    "title": "Недостатньо інформації",
    "type": "complaint",
    "id": "15d1eaca9c8443278c3ce4834228b306"
  }
}
Correcting problems

If tender award complaint was satisfied by the Complaint Review Body, then procuring entity has to correct problems.

One of the possible solutions is award cancellation:

PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c?acc_token=d2ede8f9af2745f3a3638745304d52ad HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "cancelled"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "cancelled",
    "complaintPeriod": {
      "startDate": "2017-06-19T20:02:41.073980+03:00",
      "endDate": "2017-06-19T20:02:43.738718+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:43.746020+03:00",
    "qualified": true,
    "complaints": [
      {
        "status": "satisfied",
        "dateDecision": "2017-06-19T20:02:43.043216+03:00",
        "documents": [
          {
            "author": "complaint_owner",
            "title": "Complaint_Attachement.pdf",
            "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-19T20:02:41.325550+03:00",
            "id": "3aeda15b69c74c3a82571eba2ff01577",
            "dateModified": "2017-06-19T20:02:41.325597+03:00"
          },
          {
            "author": "aboveThresholdReviewers",
            "title": "ComplaintResolution.pdf",
            "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
            "format": "application/pdf",
            "documentOf": "tender",
            "datePublished": "2017-06-19T20:02:42.850136+03:00",
            "id": "9799ddf93e664cf49abcc7b325e95198",
            "dateModified": "2017-06-19T20:02:42.850182+03:00"
          }
        ],
        "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
        "title": "Недостатньо інформації",
        "author": {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
            "id": "13313462",
            "uri": "http://sch10.edu.vn.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        },
        "dateAccepted": "2017-06-19T20:02:42.216517+03:00",
        "dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
        "complaintID": "UA-2017-06-19-000001.1",
        "date": "2017-06-19T20:02:43.050448+03:00",
        "acceptance": true,
        "type": "complaint",
        "id": "bd672abf667d4966974d2f6d6ae07310"
      },
      {
        "status": "invalid",
        "dateDecision": "2017-06-19T20:02:42.056253+03:00",
        "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
        "author": {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
            "id": "13313462",
            "uri": "http://sch10.edu.vn.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        },
        "acceptance": false,
        "dateSubmitted": "2017-06-19T20:02:41.530724+03:00",
        "complaintID": "UA-2017-06-19-000001.2",
        "date": "2017-06-19T20:02:42.063253+03:00",
        "title": "Недостатньо інформації",
        "type": "complaint",
        "id": "e80a7ee0db444c279b368deae7ead938"
      },
      {
        "status": "declined",
        "dateDecision": "2017-06-19T20:02:43.212370+03:00",
        "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
        "author": {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
            "id": "13313462",
            "uri": "http://sch10.edu.vn.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        },
        "acceptance": true,
        "dateAccepted": "2017-06-19T20:02:42.370801+03:00",
        "dateSubmitted": "2017-06-19T20:02:41.643973+03:00",
        "complaintID": "UA-2017-06-19-000001.3",
        "date": "2017-06-19T20:02:43.219571+03:00",
        "title": "Недостатньо інформації",
        "type": "complaint",
        "id": "15d1eaca9c8443278c3ce4834228b306"
      },
      {
        "status": "accepted",
        "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
        "author": {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
            "id": "13313462",
            "uri": "http://sch10.edu.vn.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        },
        "acceptance": true,
        "dateAccepted": "2017-06-19T20:02:42.526127+03:00",
        "dateSubmitted": "2017-06-19T20:02:41.765389+03:00",
        "complaintID": "UA-2017-06-19-000001.4",
        "date": "2017-06-19T20:02:42.533124+03:00",
        "title": "Недостатньо інформації",
        "type": "complaint",
        "id": "54480f965268476a98b2aabef16d254b"
      },
      {
        "status": "stopped",
        "dateDecision": "2017-06-19T20:02:43.381162+03:00",
        "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
        "title": "Недостатньо інформації",
        "decision": "Тендер скасовується замовником",
        "acceptance": true,
        "dateCanceled": "2017-06-19T20:02:43.381188+03:00",
        "dateAccepted": "2017-06-19T20:02:42.683801+03:00",
        "author": {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
            "id": "13313462",
            "uri": "http://sch10.edu.vn.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        },
        "dateSubmitted": "2017-06-19T20:02:41.900477+03:00",
        "complaintID": "UA-2017-06-19-000001.5",
        "date": "2017-06-19T20:02:43.388563+03:00",
        "type": "complaint",
        "id": "835aeb389f5b4fe19dc0854a4834e24d"
      }
    ],
    "id": "e2e972fd12194b69acdc11f085ee2d3c"
  }
}

Creating new award:

POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards?acc_token=d2ede8f9af2745f3a3638745304d52ad HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1284
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "date": "2016-01-14T18:07:00.628073+02:00",
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "d373338bc3324f14b8b3d4af68922773",
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": "true"
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/06e2b40410f7418aa4b3d45eb33c90a7
{
  "data": {
    "status": "pending",
    "complaintPeriod": {
      "startDate": "2017-06-19T20:02:43.920891+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "13313462",
          "uri": "http://sch10.edu.vn.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-06-19T20:02:43.919234+03:00",
    "id": "06e2b40410f7418aa4b3d45eb33c90a7"
  }
}
Submitting Resolution Confirmation

When complaint has been successfully resolved, procuring entity submits resolution confirmation.

PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310?acc_token=d2ede8f9af2745f3a3638745304d52ad HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 361
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "resolved",
    "tendererAction": "Умови виправлено, вибір переможня буде розгянуто повторно"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "resolved",
    "dateDecision": "2017-06-19T20:02:43.043216+03:00",
    "documents": [
      {
        "author": "complaint_owner",
        "title": "Complaint_Attachement.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/3aeda15b69c74c3a82571eba2ff01577?download=1beca2e4f3aa44f3b0c738273943d2df",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:41.325550+03:00",
        "id": "3aeda15b69c74c3a82571eba2ff01577",
        "dateModified": "2017-06-19T20:02:41.325597+03:00"
      },
      {
        "author": "aboveThresholdReviewers",
        "title": "ComplaintResolution.pdf",
        "url": "http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/bd672abf667d4966974d2f6d6ae07310/documents/9799ddf93e664cf49abcc7b325e95198?download=291e0ab939784ea4a1d00089aaaa9905",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-06-19T20:02:42.850136+03:00",
        "id": "9799ddf93e664cf49abcc7b325e95198",
        "dateModified": "2017-06-19T20:02:42.850182+03:00"
      }
    ],
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title": "Недостатньо інформації",
    "tendererAction": "Умови виправлено, вибір переможня буде розгянуто повторно",
    "tendererActionDate": "2017-06-19T20:02:44.117092+03:00",
    "dateSubmitted": "2017-06-19T20:02:41.431312+03:00",
    "complaintID": "UA-2017-06-19-000001.1",
    "date": "2017-06-19T20:02:44.124875+03:00",
    "acceptance": true,
    "type": "complaint",
    "id": "bd672abf667d4966974d2f6d6ae07310",
    "dateAccepted": "2017-06-19T20:02:42.216517+03:00"
  }
}
Submitting complaint to new award
POST /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/06e2b40410f7418aa4b3d45eb33c90a7/complaints HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1703
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "pending",
    "title": "Недостатньо інформації",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк",
        "email": "soleksuk@gmail.com"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "countryName": "Україна",
        "postalCode": "21100",
        "region": "м. Вінниця",
        "streetAddress": "вул. Островського, 33",
        "locality": "м. Вінниця"
      }
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.openprocurement.org/api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/06e2b40410f7418aa4b3d45eb33c90a7/complaints/a8e1e227638d4950b55dbe39bb15803b
{
  "access": {
    "token": "d8b48e544d2841f595e92b4c4019d2df"
  },
  "data": {
    "status": "pending",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title": "Недостатньо інформації",
    "dateSubmitted": "2017-06-19T20:02:44.903323+03:00",
    "complaintID": "UA-2017-06-19-000001.6",
    "date": "2017-06-19T20:02:44.903296+03:00",
    "type": "complaint",
    "id": "a8e1e227638d4950b55dbe39bb15803b"
  }
}

Cancelling Tender Award Complaint

Cancelling not accepted complaint
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/06e2b40410f7418aa4b3d45eb33c90a7/complaints/ac8a06506c444a8c8e775d9f72c02be1?acc_token=b149c055bdfe4c38b11913e0691f1c36 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 150
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "cancelled",
    "cancellationReason": "Умови виправлено"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "cancelled",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "title": "Недостатньо інформації",
    "cancellationReason": "Умови виправлено",
    "dateCanceled": "2017-06-19T20:02:45.460475+03:00",
    "complaintID": "UA-2017-06-19-000001.7",
    "date": "2017-06-19T20:02:45.472775+03:00",
    "type": "complaint",
    "id": "ac8a06506c444a8c8e775d9f72c02be1"
  }
}
Cancelling accepted complaint by Complainant
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/54480f965268476a98b2aabef16d254b?acc_token=17e9db6d3fc74de18324c586921b14e0 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 228
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "stopping",
    "cancellationReason": "Тендер скасовується замовником"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "stopping",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "acceptance": true,
    "cancellationReason": "Тендер скасовується замовником",
    "dateCanceled": "2017-06-19T20:02:44.302245+03:00",
    "dateAccepted": "2017-06-19T20:02:42.526127+03:00",
    "dateSubmitted": "2017-06-19T20:02:41.765389+03:00",
    "complaintID": "UA-2017-06-19-000001.4",
    "date": "2017-06-19T20:02:44.310202+03:00",
    "title": "Недостатньо інформації",
    "type": "complaint",
    "id": "54480f965268476a98b2aabef16d254b"
  }
}
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/54480f965268476a98b2aabef16d254b HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 217
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "stopped",
    "decision": "Тендер скасовується замовником"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "stopped",
    "dateDecision": "2017-06-19T20:02:44.503176+03:00",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "decision": "Тендер скасовується замовником",
    "acceptance": true,
    "cancellationReason": "Тендер скасовується замовником",
    "dateCanceled": "2017-06-19T20:02:44.302245+03:00",
    "dateAccepted": "2017-06-19T20:02:42.526127+03:00",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "dateSubmitted": "2017-06-19T20:02:41.765389+03:00",
    "complaintID": "UA-2017-06-19-000001.4",
    "date": "2017-06-19T20:02:44.511235+03:00",
    "type": "complaint",
    "id": "54480f965268476a98b2aabef16d254b"
  }
}
Cancelling accepted complaint by Reviewer
PATCH /api/2.3/tenders/c58da022b8d04704bd0e9036a79e14e7/awards/e2e972fd12194b69acdc11f085ee2d3c/complaints/835aeb389f5b4fe19dc0854a4834e24d HTTP/1.0
Authorization: Basic cmV2aWV3ZXI6
Content-Length: 217
Content-Type: application/json
Host: api-sandbox.openprocurement.org

{
  "data": {
    "status": "stopped",
    "decision": "Тендер скасовується замовником"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "stopped",
    "dateDecision": "2017-06-19T20:02:43.381162+03:00",
    "description": "Умови виставлені замовником не містять достатньо інформації, щоб заявка мала сенс.",
    "title": "Недостатньо інформації",
    "decision": "Тендер скасовується замовником",
    "acceptance": true,
    "dateCanceled": "2017-06-19T20:02:43.381188+03:00",
    "dateAccepted": "2017-06-19T20:02:42.683801+03:00",
    "author": {
      "contactPoint": {
        "email": "soleksuk@gmail.com",
        "telephone": "+380 (432) 21-69-30",
        "name": "Сергій Олексюк"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
        "id": "13313462",
        "uri": "http://sch10.edu.vn.ua/"
      },
      "name": "ДКП «Школяр»",
      "address": {
        "postalCode": "21100",
        "countryName": "Україна",
        "streetAddress": "вул. Островського, 33",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "dateSubmitted": "2017-06-19T20:02:41.900477+03:00",
    "complaintID": "UA-2017-06-19-000001.5",
    "date": "2017-06-19T20:02:43.388563+03:00",
    "type": "complaint",
    "id": "835aeb389f5b4fe19dc0854a4834e24d"
  }
}

Roles

Complainant:dashed
Procuring entity:
 plain
Reviewer:bold
Chronograph:dotted

Statuses

draft:

Initial status

Complainant can submit claim, upload documents, cancel claim, and re-submit it.

claim:

Procuring entity can upload documents and answer to claim.

Complainant can cancel claim.

answered:

Complainant can cancel claim, upload documents, accept solution or escalate claim to complaint.

pending:

Reviewer can upload documents and review complaint.

Complainant can cancel claim.

invalid:

Terminal status

Complaint recognized as invalid.

declined:

Terminal status

Complaint recognized as declined.

resolved:

Terminal status

Complaint recognized as resolved.

cancelled:

Terminal status

Complaint cancelled by complainant.

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