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.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3380
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "services",
    "title": "Послуги шкільних їдалень",
    "procurementMethodType": "reporting",
    "title_en": "Services in school canteens",
    "description_en": "Services in school canteens",
    "procuringEntity": {
      "kind": "special",
      "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"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "quantity": 1
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "description_ru": "Услуги школьных столовых"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce
{
  "access": {
    "transfer": "c96f71ce43434e95bfe40838215d4f21",
    "token": "bc6711b5ba434b92bbba26699dca3104"
  },
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "396dc1616df245518cdfea31d983287c"
      }
    ],
    "mainProcurementCategory": "services",
    "title": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "ca90fedbd6494c9588a959536fe7a354",
        "quantity": 1.0
      }
    ],
    "title_en": "Services in school canteens",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:00+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": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "date": "2019-10-25T01:00:00+03:00",
    "procurementMethodType": "reporting",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "description_ru": "Услуги школьных столовых",
    "id": "5fb29c8fb65c4a12b69dd3531cfe7bce",
    "tenderID": "UA-2019-10-25-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.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=2019-10-25T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2019-10-25T01%3A00%3A00%2B03%3A00",
    "offset": "2019-10-25T01:00:00+03:00"
  },
  "data": [
    {
      "id": "5fb29c8fb65c4a12b69dd3531cfe7bce",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

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.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3927
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "services",
    "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",
    "procuringEntity": {
      "kind": "special",
      "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"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "quantity": 1
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": false
    },
    "description_ru": "Услуги школьных столовых",
    "cause": "twiceUnsuccessful"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976
{
  "access": {
    "transfer": "fefb236552864a109c73337d5b251dce",
    "token": "df3d7d3c62c74918a4905630dbce126b"
  },
  "data": {
    "procurementMethod": "limited",
    "mainProcurementCategory": "services",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "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": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "owner": "broker",
    "id": "26b780552e084bbcb2b53c5383a6e976",
    "title": "Послуги шкільних їдалень",
    "causeDescription_en": "original tender has failed twice",
    "tenderID": "UA-2019-10-25-000001",
    "description_ru": "Услуги школьных столовых",
    "dateModified": "2019-10-25T01:00:00+03:00",
    "status": "active",
    "title_en": "Services in school canteens",
    "procurementMethodType": "negotiation",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2019-10-25T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "fc7ef11ceb9d457298c36812ffabdb92"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "35207e5ce4404a63a76870f2067cd4f4",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": false
    },
    "title_ru": "Услуги школьных столовых",
    "cause": "twiceUnsuccessful"
  }
}

Creating tender for negotiation.quick procedure

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

POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 3932
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing"
      }
    ],
    "mainProcurementCategory": "services",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "title": "Послуги шкільних їдалень",
    "title_en": "Services in school canteens",
    "procurementMethodType": "negotiation.quick",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "causeDescription_en": "original tender has failed twice",
    "procuringEntity": {
      "kind": "special",
      "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"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "quantity": 1
      }
    ],
    "owner": "broker",
    "value": {
      "currency": "UAH",
      "amount": 500000,
      "valueAddedTaxIncluded": true
    },
    "description_ru": "Услуги школьных столовых",
    "cause": "twiceUnsuccessful"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976
{
  "access": {
    "transfer": "fefb236552864a109c73337d5b251dce",
    "token": "df3d7d3c62c74918a4905630dbce126b"
  },
  "data": {
    "procurementMethod": "limited",
    "mainProcurementCategory": "services",
    "causeDescription": "оригінальний тендер не вдався двічі",
    "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": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "owner": "broker",
    "id": "26b780552e084bbcb2b53c5383a6e976",
    "title": "Послуги шкільних їдалень",
    "causeDescription_en": "original tender has failed twice",
    "tenderID": "UA-2019-10-25-000001",
    "description_ru": "Услуги школьных столовых",
    "dateModified": "2019-10-25T01:00:00+03:00",
    "status": "active",
    "title_en": "Services in school canteens",
    "procurementMethodType": "negotiation.quick",
    "description_en": "Services in school canteens",
    "causeDescription_ru": "оригинальный тендер не получился дважды",
    "date": "2019-10-25T01:00:00+03:00",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "fc7ef11ceb9d457298c36812ffabdb92"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "35207e5ce4404a63a76870f2067cd4f4",
        "quantity": 1.0
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "title_ru": "Услуги школьных столовых",
    "cause": "twiceUnsuccessful"
  }
}

Modifying tender

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

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 80
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "procurementMethod": "limited",
    "status": "active",
    "milestones": [
      {
        "code": "prepayment",
        "sequenceNumber": 0,
        "title": "signingTheContract",
        "duration": {
          "type": "banking",
          "days": 2
        },
        "percentage": 45.55,
        "type": "financing",
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      {
        "code": "postpayment",
        "sequenceNumber": 0,
        "title": "deliveryOfGoods",
        "duration": {
          "type": "calendar",
          "days": 900
        },
        "percentage": 54.45,
        "type": "financing",
        "id": "396dc1616df245518cdfea31d983287c"
      }
    ],
    "mainProcurementCategory": "services",
    "title": "Послуги шкільних їдалень",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "ca90fedbd6494c9588a959536fe7a354",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9.0
      }
    ],
    "title_en": "Services in school canteens",
    "value": {
      "currency": "UAH",
      "amount": 500000.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:00+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": "special",
      "address": {
        "postalCode": "21027",
        "countryName": "Україна",
        "streetAddress": "вул. Стахурського. 22",
        "region": "м. Вінниця",
        "locality": "м. Вінниця"
      }
    },
    "date": "2019-10-25T01:00:00+03:00",
    "procurementMethodType": "reporting",
    "description_en": "Services in school canteens",
    "title_ru": "Услуги школьных столовых",
    "owner": "broker",
    "description_ru": "Услуги школьных столовых",
    "id": "5fb29c8fb65c4a12b69dd3531cfe7bce",
    "tenderID": "UA-2019-10-25-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.5/tenders?opt_pretty=1 HTTP/1.0
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "next_page": {
    "path": "/api/2.5/tenders?offset=2019-10-25T01%3A00%3A00%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders?offset=2019-10-25T01%3A00%3A00%2B03%3A00",
    "offset": "2019-10-25T01:00:00+03:00"
  },
  "data": [
    {
      "id": "5fb29c8fb65c4a12b69dd3531cfe7bce",
      "dateModified": "2019-10-25T01:00:00+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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 142
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice.pdf"
Content-Type: application/pdf

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/documents/8f13a8d6f69346d288e0fa0c066d57bc
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/0d57ccf75f8c47e6bfbd8f3e166b47de?KeyID=a8968c46&Signature=Cz%252B%2F6DcaCl%2FgYCctZn1TM4SuTct8avcp3J0TDhQYNbAoYl%2FWrHlvJV3OP0odOIbjBqBMhzpAnnRZiaX6MI92Cg%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "8f13a8d6f69346d288e0fa0c066d57bc",
    "dateModified": "2019-10-25T01:00:00+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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/documents/8f13a8d6f69346d288e0fa0c066d57bc?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 145
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice-2.pdf"
Content-Type: application/pdf

content2
-----BOUNDARY--


Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f59eff37995e4e47aaa0be2d4feef897?KeyID=a8968c46&Signature=2MGxZZTqj%2FC%2F%2FkcDUC99MfhWdYr5OKPyKyPHgLfq6OV4fIKnxZ7Sw8Hw3iGbb4CdrdTVQs76X6pZPEf%252Bk0TRAA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "8f13a8d6f69346d288e0fa0c066d57bc",
    "dateModified": "2019-10-25T01:00:00+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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 830
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": true
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/68ea182233e3452d9017623a786375bf
{
  "data": {
    "status": "pending",
    "date": "2019-10-25T01:00:00+03:00",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "id": "68ea182233e3452d9017623a786375bf",
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    }
  }
}

Procuring entity registers supplier information for negotiation procedure:

POST /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 831
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": false
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards/3d3e484cb2eb4d3386377ed2c400d926
{
  "data": {
    "status": "pending",
    "complaintPeriod": {
      "startDate": "2019-10-25T01:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "date": "2019-10-25T01:00:00+03:00",
    "id": "3d3e484cb2eb4d3386377ed2c400d926"
  }
}

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

Procuring entity registers supplier information for negotiation.quick procedure:

POST /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 831
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "pending",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000,
      "valueAddedTaxIncluded": false
    }
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards/3d3e484cb2eb4d3386377ed2c400d926
{
  "data": {
    "status": "pending",
    "complaintPeriod": {
      "startDate": "2019-10-25T01:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "date": "2019-10-25T01:00:00+03:00",
    "id": "3d3e484cb2eb4d3386377ed2c400d926"
  }
}

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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/68ea182233e3452d9017623a786375bf/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 159
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="award_first_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/68ea182233e3452d9017623a786375bf/documents/bc1b9ded857f484dba843e9e56fde4ff
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "award_first_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8c8d8ecd2605476c8c80ac3c7f2ed030?KeyID=a8968c46&Signature=PwpB%252Bx1D9CUUV9JX9j3tTebtGVUCOGvnROF7m2Mp6iNqmMdBjKa6lO43%2FnJYyiqbtLxoW4sfNEXePqkR699IAw%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "bc1b9ded857f484dba843e9e56fde4ff",
    "dateModified": "2019-10-25T01:00:00+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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/68ea182233e3452d9017623a786375bf/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "award_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8c8d8ecd2605476c8c80ac3c7f2ed030?KeyID=a8968c46&Signature=PwpB%252Bx1D9CUUV9JX9j3tTebtGVUCOGvnROF7m2Mp6iNqmMdBjKa6lO43%2FnJYyiqbtLxoW4sfNEXePqkR699IAw%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "bc1b9ded857f484dba843e9e56fde4ff",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

We can add another award document:

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/68ea182233e3452d9017623a786375bf/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 160
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="award_second_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/68ea182233e3452d9017623a786375bf/documents/e3df98e85ec74550bde73df99950323b
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "award_second_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3c8115cb8c344150bed5c7401f22cf78?KeyID=a8968c46&Signature=%252BDkRaRbOsmkU0YOyey7YGMPqTIIxcuKHx5MswPiGATKOvC6ATU3Uasab73bV8uTFY8olFq5J2hlvOBQ4BtN%2FAA%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "e3df98e85ec74550bde73df99950323b",
    "dateModified": "2019-10-25T01:00:00+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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/68ea182233e3452d9017623a786375bf/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "award_second_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3c8115cb8c344150bed5c7401f22cf78?KeyID=a8968c46&Signature=%252BDkRaRbOsmkU0YOyey7YGMPqTIIxcuKHx5MswPiGATKOvC6ATU3Uasab73bV8uTFY8olFq5J2hlvOBQ4BtN%2FAA%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "e3df98e85ec74550bde73df99950323b",
      "dateModified": "2019-10-25T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "award_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8c8d8ecd2605476c8c80ac3c7f2ed030?KeyID=a8968c46&Signature=PwpB%252Bx1D9CUUV9JX9j3tTebtGVUCOGvnROF7m2Mp6iNqmMdBjKa6lO43%2FnJYyiqbtLxoW4sfNEXePqkR699IAw%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "bc1b9ded857f484dba843e9e56fde4ff",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

Award confirmation

Procuring entity can confirm awarding decision:

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/awards/68ea182233e3452d9017623a786375bf?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "award_first_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/8c8d8ecd2605476c8c80ac3c7f2ed030?KeyID=a8968c46&Signature=PwpB%252Bx1D9CUUV9JX9j3tTebtGVUCOGvnROF7m2Mp6iNqmMdBjKa6lO43%2FnJYyiqbtLxoW4sfNEXePqkR699IAw%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "bc1b9ded857f484dba843e9e56fde4ff",
        "dateModified": "2019-10-25T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "award_second_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3c8115cb8c344150bed5c7401f22cf78?KeyID=a8968c46&Signature=%252BDkRaRbOsmkU0YOyey7YGMPqTIIxcuKHx5MswPiGATKOvC6ATU3Uasab73bV8uTFY8olFq5J2hlvOBQ4BtN%2FAA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "e3df98e85ec74550bde73df99950323b",
        "dateModified": "2019-10-25T01:00:00+03:00"
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "id": "68ea182233e3452d9017623a786375bf"
  }
}

Award confirmation for negotiation procedure:

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards/3d3e484cb2eb4d3386377ed2c400d926?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 49
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active",
    "qualified": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "complaintPeriod": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2019-11-05T00:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "qualified": true,
    "date": "2019-10-25T01:00:00+03:00",
    "id": "3d3e484cb2eb4d3386377ed2c400d926"
  }
}

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

Award confirmation for negotiation.quick procedure:

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/awards/3d3e484cb2eb4d3386377ed2c400d926?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 49
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active",
    "qualified": true
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "complaintPeriod": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2019-10-31T00:00:00+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "qualified": true,
    "date": "2019-10-25T01:00:00+03:00",
    "id": "3d3e484cb2eb4d3386377ed2c400d926"
  }
}

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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 54
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "value": {
      "amount": 238,
      "amountNet": 230
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "ca90fedbd6494c9588a959536fe7a354",
        "unit": {
          "code": "MON",
          "name": "month"
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "awardID": "68ea182233e3452d9017623a786375bf",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2019-10-25-000001-1"
  }
}

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

Setting value per item’s unit

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 58
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "unit": {
          "value": {
            "amount": 12
          }
        }
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "ca90fedbd6494c9588a959536fe7a354",
        "unit": {
          "code": "MON",
          "name": "month",
          "value": {
            "currency": "UAH",
            "amount": 12.0,
            "valueAddedTaxIncluded": true
          }
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:00+03:00",
    "awardID": "68ea182233e3452d9017623a786375bf",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2019-10-25-000001-1"
  }
}

200 OK response was returned with successfully set item.unit.value structure.

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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "dateSigned": "2019-10-25T01:00:00+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "ca90fedbd6494c9588a959536fe7a354",
        "unit": {
          "code": "MON",
          "name": "month",
          "value": {
            "currency": "UAH",
            "amount": 12.0,
            "valueAddedTaxIncluded": true
          }
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2019-10-25T01:00:00+03:00",
    "date": "2019-10-25T01:00:00+03:00",
    "awardID": "68ea182233e3452d9017623a786375bf",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2019-10-25-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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 104
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "period": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2020-10-24T01:00:00+03:00"
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "ca90fedbd6494c9588a959536fe7a354",
        "unit": {
          "code": "MON",
          "name": "month",
          "value": {
            "currency": "UAH",
            "amount": 12.0,
            "valueAddedTaxIncluded": true
          }
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "period": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2020-10-24T01:00:00+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2019-10-25T01:00:00+03:00",
    "date": "2019-10-25T01:00:00+03:00",
    "awardID": "68ea182233e3452d9017623a786375bf",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2019-10-25-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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 162
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_first_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents/5b4bf70c7bbf4c42b9f2f9e5078c2244
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_first_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3062b577f0bd41aeb70990e8500c20c0?KeyID=a8968c46&Signature=Si3%2FyBiCdCoNEcYeF01MWpUNYzB6HeCKBZNbRQ1NFP83ikmrt1fiIr%252BijgEHyjuqw5CCXKk%2F7cZzBFtD%252BEXtDQ%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "5b4bf70c7bbf4c42b9f2f9e5078c2244",
    "dateModified": "2019-10-25T01:00:00+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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3062b577f0bd41aeb70990e8500c20c0?KeyID=a8968c46&Signature=Si3%2FyBiCdCoNEcYeF01MWpUNYzB6HeCKBZNbRQ1NFP83ikmrt1fiIr%252BijgEHyjuqw5CCXKk%2F7cZzBFtD%252BEXtDQ%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "5b4bf70c7bbf4c42b9f2f9e5078c2244",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

We can add another contract document:

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 163
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_second_document.doc"
Content-Type: application/msword

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents/07538d9599d148f3933b7fc55d682a69
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "contract_second_document.doc",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/31b100f444a843b39e370557224ad9d3?KeyID=a8968c46&Signature=cwW9rXu0GKHBbhRxIRzS8iWjQOYYqc%252BPWdkJPi0G93FVip96AICUOnx0mtaHHw1A6IJrM3%2Fhx6wF6QgRCmfuBA%253D%253D",
    "format": "application/msword",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:00+03:00",
    "id": "07538d9599d148f3933b7fc55d682a69",
    "dateModified": "2019-10-25T01:00:00+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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_first_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3062b577f0bd41aeb70990e8500c20c0?KeyID=a8968c46&Signature=Si3%2FyBiCdCoNEcYeF01MWpUNYzB6HeCKBZNbRQ1NFP83ikmrt1fiIr%252BijgEHyjuqw5CCXKk%2F7cZzBFtD%252BEXtDQ%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "5b4bf70c7bbf4c42b9f2f9e5078c2244",
      "dateModified": "2019-10-25T01:00:00+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "title": "contract_second_document.doc",
      "url": "http://public-docs-sandbox.prozorro.gov.ua/get/31b100f444a843b39e370557224ad9d3?KeyID=a8968c46&Signature=cwW9rXu0GKHBbhRxIRzS8iWjQOYYqc%252BPWdkJPi0G93FVip96AICUOnx0mtaHHw1A6IJrM3%2Fhx6wF6QgRCmfuBA%253D%253D",
      "format": "application/msword",
      "documentOf": "tender",
      "datePublished": "2019-10-25T01:00:00+03:00",
      "id": "07538d9599d148f3933b7fc55d682a69",
      "dateModified": "2019-10-25T01:00:00+03:00"
    }
  ]
}

Contract registration

Reporting tender contract can be registered immediately after award confirmation:

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/contracts/ec50d5084bd940d68482479c4834cdf4?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_first_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/3062b577f0bd41aeb70990e8500c20c0?KeyID=a8968c46&Signature=Si3%2FyBiCdCoNEcYeF01MWpUNYzB6HeCKBZNbRQ1NFP83ikmrt1fiIr%252BijgEHyjuqw5CCXKk%2F7cZzBFtD%252BEXtDQ%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "5b4bf70c7bbf4c42b9f2f9e5078c2244",
        "dateModified": "2019-10-25T01:00:00+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "title": "contract_second_document.doc",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/31b100f444a843b39e370557224ad9d3?KeyID=a8968c46&Signature=cwW9rXu0GKHBbhRxIRzS8iWjQOYYqc%252BPWdkJPi0G93FVip96AICUOnx0mtaHHw1A6IJrM3%2Fhx6wF6QgRCmfuBA%253D%253D",
        "format": "application/msword",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:00+03:00",
        "id": "07538d9599d148f3933b7fc55d682a69",
        "dateModified": "2019-10-25T01:00:00+03:00"
      }
    ],
    "items": [
      {
        "description": "Послуги шкільних їдалень",
        "classification": {
          "scheme": "ДК021",
          "description": "Послуги з харчування у школах",
          "id": "55523100-3"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "ca90fedbd6494c9588a959536fe7a354",
        "unit": {
          "code": "MON",
          "name": "month",
          "value": {
            "currency": "UAH",
            "amount": 12.0,
            "valueAddedTaxIncluded": true
          }
        },
        "quantity": 9.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "period": {
      "startDate": "2019-10-25T01:00:00+03:00",
      "endDate": "2020-10-24T01:00:00+03:00"
    },
    "dateSigned": "2019-10-25T01:00:00+03:00",
    "value": {
      "currency": "UAH",
      "amount": 238.0,
      "amountNet": 230.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2019-10-25T01:00:01+03:00",
    "awardID": "68ea182233e3452d9017623a786375bf",
    "id": "ec50d5084bd940d68482479c4834cdf4",
    "contractID": "UA-2019-10-25-000001-1"
  }
}

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

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/contracts/961703907d164d1185e860612c0a8fc8?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "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"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "35207e5ce4404a63a76870f2067cd4f4",
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "amountNet": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "date": "2019-10-25T01:00:01+03:00",
    "awardID": "3d3e484cb2eb4d3386377ed2c400d926",
    "id": "961703907d164d1185e860612c0a8fc8",
    "contractID": "UA-2019-10-25-000001-1"
  }
}

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

PATCH /api/2.5/tenders/26b780552e084bbcb2b53c5383a6e976/contracts/0b3c1a9fcf054fa98d15801d166c4c87?acc_token=df3d7d3c62c74918a4905630dbce126b HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "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"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "Послуги шкільних їдалень"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-11-14T00:00:00+02:00",
          "endDate": "2019-12-14T00:00:00+02:00"
        },
        "id": "35207e5ce4404a63a76870f2067cd4f4",
        "quantity": 1.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "scale": "micro",
        "name": "ДКП «Школяр»",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 475000.0,
      "amountNet": 475000.0,
      "valueAddedTaxIncluded": false
    },
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "date": "2019-10-25T01:00:01+03:00",
    "awardID": "3d3e484cb2eb4d3386377ed2c400d926",
    "id": "0b3c1a9fcf054fa98d15801d166c4c87",
    "contractID": "UA-2019-10-25-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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/cancellations?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 43
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reason": "cancellation reason"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/cancellations/c2fe88ca199049f3a53d3837f721bd1b
{
  "data": {
    "status": "pending",
    "reason": "cancellation reason",
    "reasonType": "cancelled",
    "date": "2019-10-25T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "c2fe88ca199049f3a53d3837f721bd1b"
  }
}

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.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/cancellations/c2fe88ca199049f3a53d3837f721bd1b?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 40
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "reasonType": "unsuccessful"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "reason": "cancellation reason",
    "reasonType": "unsuccessful",
    "date": "2019-10-25T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "c2fe88ca199049f3a53d3837f721bd1b"
  }
}

Filling cancellation with protocol and supplementary documentation

Upload the file contents

POST /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/cancellations/c2fe88ca199049f3a53d3837f721bd1b/documents?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 142
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice.pdf"
Content-Type: application/pdf

content
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/cancellations/c2fe88ca199049f3a53d3837f721bd1b/documents/7ce706c799a7481990ed0e68090d431d
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7673f6d0f7e4738bdc6dba22b565ff4?KeyID=a8968c46&Signature=21W%252B2LEqYOX%2FHJMrB%252Bb6I2M31ms6J3bUKiEq5vndvP4NMgy5tE2SnhcqqS3FMvkemWAlvqbW8JDkw9UfGn5yDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "id": "7ce706c799a7481990ed0e68090d431d",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}

Change the document description and other properties

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/cancellations/c2fe88ca199049f3a53d3837f721bd1b/documents/7ce706c799a7481990ed0e68090d431d?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 48
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "description": "Changed description"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7673f6d0f7e4738bdc6dba22b565ff4?KeyID=a8968c46&Signature=21W%252B2LEqYOX%2FHJMrB%252Bb6I2M31ms6J3bUKiEq5vndvP4NMgy5tE2SnhcqqS3FMvkemWAlvqbW8JDkw9UfGn5yDQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "id": "7ce706c799a7481990ed0e68090d431d",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}

Upload new version of the document

PUT /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/cancellations/c2fe88ca199049f3a53d3837f721bd1b/documents/7ce706c799a7481990ed0e68090d431d?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 145
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="Notice-2.pdf"
Content-Type: application/pdf

content2
-----BOUNDARY--


Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "title": "Notice-2.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1d6a86e5eaf9475f82f9ba263f30390c?KeyID=a8968c46&Signature=8JoY534LWjk682eHLVzgIw9QaTN3HvvLEvxU8ui52Uv%252Bg7IKxfGaneHWv%252Bkm9Xvg6j7Yjwv5%2FTej2bF7d6%252BQBA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "id": "7ce706c799a7481990ed0e68090d431d",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}

Activating the request and cancelling tender

PATCH /api/2.5/tenders/5fb29c8fb65c4a12b69dd3531cfe7bce/cancellations/c2fe88ca199049f3a53d3837f721bd1b?acc_token=bc6711b5ba434b92bbba26699dca3104 HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/f7673f6d0f7e4738bdc6dba22b565ff4?KeyID=a8968c46&Signature=21W%252B2LEqYOX%2FHJMrB%252Bb6I2M31ms6J3bUKiEq5vndvP4NMgy5tE2SnhcqqS3FMvkemWAlvqbW8JDkw9UfGn5yDQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "7ce706c799a7481990ed0e68090d431d",
        "dateModified": "2019-10-25T01:00:01+03:00"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "title": "Notice-2.pdf",
        "url": "http://public-docs-sandbox.prozorro.gov.ua/get/1d6a86e5eaf9475f82f9ba263f30390c?KeyID=a8968c46&Signature=8JoY534LWjk682eHLVzgIw9QaTN3HvvLEvxU8ui52Uv%252Bg7IKxfGaneHWv%252Bkm9Xvg6j7Yjwv5%2FTej2bF7d6%252BQBA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "7ce706c799a7481990ed0e68090d431d",
        "dateModified": "2019-10-25T01:00:01+03:00"
      }
    ],
    "reason": "cancellation reason",
    "reasonType": "unsuccessful",
    "date": "2019-10-25T01:00:01+03:00",
    "cancellationOf": "tender",
    "id": "c2fe88ca199049f3a53d3837f721bd1b"
  }
}