Централізовані закупівлі

Створення плану закупівлі

Покупець створює план. Він повинен вказати себе в списку покупців buyers і вказати на одну з центральних закупівельних організацій у полі procuringEntity:

POST /api/2.5/plans?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1898
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2019-11-01T01:00:00+03:00"
      }
    },
    "items": [
      {
        "deliveryDate": {
          "endDate": "2019-11-09T01:00:00+03:00"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "quantity": 1000,
        "description": "Насіння гірчиці"
      }
    ],
    "classification": {
      "scheme": "ДК021",
      "description": "Seeds",
      "id": "03111000-2"
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "procuringEntity": {
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      },
      "name": "ЦЗО №1"
    },
    "buyers": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС"
      }
    ],
    "budget": {
      "project": {
        "name": "proj_name",
        "id": "123"
      },
      "amount": 10000,
      "amountNet": 12222,
      "currency": "UAH",
      "id": "12303111000-2",
      "description": "budget_description",
      "period": {
        "startDate": "2021-01-01T00:00:00",
        "endDate": "2021-12-31T00:00:00"
      },
      "breakdown": [
        {
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "amount": 1500,
            "currency": "UAH"
          }
        }
      ]
    },
    "status": "draft"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761
X-Content-Type-Options: nosniff
{
  "data": {
    "procuringEntity": {
      "id": "30429c884b234749a850b6bd1e044153",
      "name": "ЦЗО №1",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      }
    },
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2019-11-01T01:00:00+03:00"
      }
    },
    "budget": {
      "id": "12303111000-2",
      "description": "budget_description",
      "amount": 10000.0,
      "currency": "UAH",
      "amountNet": 12222.0,
      "project": {
        "id": "123",
        "name": "proj_name"
      },
      "period": {
        "startDate": "2021-01-01T00:00:00+02:00",
        "endDate": "2021-12-31T00:00:00+02:00"
      },
      "breakdown": [
        {
          "id": "1bf7d60f1ad24027a538784c5b6c9bc2",
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "amount": 1500.0,
            "currency": "UAH"
          }
        }
      ]
    },
    "classification": {
      "description": "Seeds",
      "scheme": "ДК021",
      "id": "03111000-2"
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "planID": "UA-P-2019-05-02-000001",
    "items": [
      {
        "id": "17c0df4205d34d73b32c735a06a6b533",
        "classification": {
          "description": "Mustard seeds",
          "scheme": "ДК021",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "unit": {
          "name": "кг",
          "code": "KGM"
        },
        "quantity": 1000.0,
        "deliveryDate": {
          "endDate": "2019-11-09T01:00:00+03:00"
        },
        "description": "Насіння гірчиці"
      }
    ],
    "buyers": [
      {
        "id": "422e3fac1aa846bdb451aff9f215009e",
        "name": "ДУС",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        }
      }
    ],
    "status": "draft",
    "dateModified": "2019-05-02T04:00:00+03:00",
    "datePublished": "2019-05-02T04:00:00+03:00",
    "owner": "broker",
    "id": "6cb30e0a8f2d4487946a40c0b043c761"
  },
  "access": {
    "token": "68c63f3cbac242fbb15c334a84fb2fcf",
    "transfer": "5765c54af6b5450aaabaa146c2861dd3"
  }
}

Створення об’єкту відповіді

Коли центральна організація є procuringEntity плану, вона може додати відповідь до цього плану:

POST /api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones HTTP/1.0
Authorization: Bearer broker
Content-Length: 1334
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "Підготовка до проведення процедури",
    "description": "Узагальнення та аналіз отриманної інформації щодо проведення закупівель товарів, послуг (крім поточного ремонту) в інтересах замовників",
    "type": "approval",
    "author": {
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      },
      "name": "ЦЗО №1"
    },
    "dueDate": "2019-05-15T13:00:00.000000+02:00"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones/bcd0fdcf5036434881da407a855782c1
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "bcd0fdcf5036434881da407a855782c1",
    "title": "Підготовка до проведення процедури",
    "description": "Узагальнення та аналіз отриманної інформації щодо проведення закупівель товарів, послуг (крім поточного ремонту) в інтересах замовників",
    "type": "approval",
    "dueDate": "2019-05-15T13:00:00+02:00",
    "status": "scheduled",
    "author": {
      "id": "a256ff206dcf4884a5631a283ce6bb7d",
      "name": "ЦЗО №1",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      }
    },
    "dateModified": "2019-05-02T05:00:00+03:00",
    "owner": "broker"
  },
  "access": {
    "token": "4771af7ff4b24a448b71c2ee3cb688ee"
  }
}

Тільки якщо надається токен доступу, відповідь можна змінити:

PATCH /api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones/bcd0fdcf5036434881da407a855782c1?acc_token=4771af7ff4b24a448b71c2ee3cb688ee HTTP/1.0
Authorization: Bearer broker
Content-Length: 233
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "met",
    "description": "Доповнений опис відповіді",
    "dueDate": "2019-05-30T18:00:00.000000+02:00"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "bcd0fdcf5036434881da407a855782c1",
    "title": "Підготовка до проведення процедури",
    "description": "Доповнений опис відповіді",
    "type": "approval",
    "dueDate": "2019-05-30T18:00:00+02:00",
    "status": "met",
    "author": {
      "id": "a256ff206dcf4884a5631a283ce6bb7d",
      "name": "ЦЗО №1",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      }
    },
    "dateModified": "2019-05-02T06:00:00+03:00",
    "dateMet": "2019-05-02T06:00:00+03:00",
    "owner": "broker"
  }
}

Примітка

Поля, які можна оновити, залежать від поточного статусу об’єкту:

• dueDate можна оновити лише у статусі scheduled
• description - у scheduled та met

Публікація документів також вимагає токен доступу (як і зміна документів за допомогою методів PATCH / PUT):

POST /api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones/bcd0fdcf5036434881da407a855782c1/documents?acc_token=4771af7ff4b24a448b71c2ee3cb688ee HTTP/1.0
Authorization: Bearer broker
Content-Length: 318
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "Notice.pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e02eb47c177f4e078fd10eb781a99616?Signature=psSyxQ3Vn14knOgHhFLe6TVEXj7Yi87lBPBrVkLSxaWa6sEJGmis1n79SzYZFPntiZ21NiGzXWdQPrQkdDEgBw%3D%3D&KeyID=a8968c46",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761/milestones/bcd0fdcf5036434881da407a855782c1/documents/e4ec0c0e29d74a5e868f8e53b79bd05c
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "e4ec0c0e29d74a5e868f8e53b79bd05c",
    "hash": "md5:00000000000000000000000000000000",
    "title": "Notice.pdf",
    "format": "application/pdf",
    "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e02eb47c177f4e078fd10eb781a99616?Signature=rN9%2BwQqp%2FjcIsh194eH4myfxHp7SzO3wXo9uAwzsF8ktudixiljJfdi7VP8qVHaRw4IhD6zi%2BmVMWZpLDOO0AA%3D%3D&KeyID=a8968c46",
    "datePublished": "2019-05-02T06:00:00+03:00",
    "dateModified": "2019-05-02T06:00:00+03:00"
  }
}

Створення закупівлі

Центральна закупівельна організація створює агрегований тендер у статусі draft і вказує всіх покупців, використовуючи buyers список об’єктів PlanOrganization:

POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 4158
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "футляри до державних нагород",
    "mainProcurementCategory": "goods",
    "procuringEntity": {
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      },
      "name": "ЦЗО №1",
      "contactPoint": {
        "name": "Довідкова",
        "telephone": "+0440000000"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "locality": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1"
      },
      "kind": "central"
    },
    "value": {
      "amount": 500,
      "currency": "UAH"
    },
    "minimalStep": {
      "amount": 15,
      "currency": "UAH"
    },
    "items": [
      {
        "deliveryDate": {
          "endDate": "2021-03-31T00:00:00+02:00"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "classification": {
          "scheme": "ДК021",
          "description": "Mustard seeds",
          "id": "03111600-8"
        },
        "quantity": 1000,
        "description": "Насіння гірчиці",
        "relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86"
      },
      {
        "deliveryDate": {
          "endDate": "2021-04-01T00:00:00+02:00"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.95",
            "description": "Насіння соняшнику"
          }
        ],
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "classification": {
          "scheme": "ДК021",
          "description": "Sunflower seeds",
          "id": "03111300-5"
        },
        "quantity": 2000,
        "description": "Насіння соняшнику",
        "relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86"
      },
      {
        "deliveryDate": {
          "endDate": "2021-04-02T00:00:00+02:00"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.84",
            "description": "Насіння бавовнику"
          }
        ],
        "unit": {
          "code": "KGM",
          "name": "кг"
        },
        "classification": {
          "scheme": "ДК021",
          "description": "Cotton seeds",
          "id": "03111400-6"
        },
        "quantity": 3000,
        "description": "Насіння бавовнику",
        "relatedBuyer": "88c051728aae432ca2d39a0215d63fcd"
      }
    ],
    "enquiryPeriod": {
      "startDate": "2019-10-01T01:00:00+03:00",
      "endDate": "2019-10-30T01:00:00+03:00"
    },
    "tenderPeriod": {
      "startDate": "2019-11-01T01:00:00+03:00",
      "endDate": "2019-11-11T01:00:00+03:00"
    },
    "procurementMethodType": "belowThreshold",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "code": "prepayment",
        "type": "financing",
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0,
        "percentage": 45.55
      },
      {
        "title": "deliveryOfGoods",
        "code": "postpayment",
        "type": "financing",
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0,
        "percentage": 54.45
      }
    ],
    "buyers": [
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС",
        "id": "3e32f23699ea4ac0b8e105e7babd2c86"
      },
      {
        "identifier": {
          "scheme": "UA-EDR",
          "id": "222983",
          "legalName": "ДП Державне Управління Справами"
        },
        "name": "ДУС",
        "id": "88c051728aae432ca2d39a0215d63fcd"
      }
    ],
    "status": "draft"
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2d3b9e1f38c34125b1d2f7a164f871ba
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "футляри до державних нагород",
    "date": "2019-05-12T12:00:00+03:00",
    "dateModified": "2019-05-12T12:00:00+03:00",
    "tenderID": "UA-2019-05-12-000001",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0
      },
      {
        "id": "bc6cce300c9941c4a5df776d1cf7a062",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0
      }
    ],
    "buyers": [
      {
        "id": "3e32f23699ea4ac0b8e105e7babd2c86",
        "name": "ДУС",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        }
      },
      {
        "id": "88c051728aae432ca2d39a0215d63fcd",
        "name": "ДУС",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "222983",
          "legalName": "ДП Державне Управління Справами"
        }
      }
    ],
    "procurementMethod": "open",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "draft",
    "items": [
      {
        "id": "95fea057d382491fb93778d67d3c70f3",
        "description": "Насіння гірчиці",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "quantity": 1000.0,
        "deliveryDate": {
          "endDate": "2021-03-31T00:00:00+02:00"
        },
        "relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86",
        "classification": {
          "description": "Mustard seeds",
          "scheme": "ДК021",
          "id": "03111600-8"
        },
        "unit": {
          "name": "кг",
          "code": "KGM"
        }
      },
      {
        "id": "8538be924cff4012b27f1fbb7246f7d3",
        "description": "Насіння соняшнику",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.95",
            "description": "Насіння соняшнику"
          }
        ],
        "quantity": 2000.0,
        "deliveryDate": {
          "endDate": "2021-04-01T00:00:00+02:00"
        },
        "relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86",
        "classification": {
          "description": "Sunflower seeds",
          "scheme": "ДК021",
          "id": "03111300-5"
        },
        "unit": {
          "name": "кг",
          "code": "KGM"
        }
      },
      {
        "id": "2e0736c2008c4ef4a4a734950ec4c9b8",
        "description": "Насіння бавовнику",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.84",
            "description": "Насіння бавовнику"
          }
        ],
        "quantity": 3000.0,
        "deliveryDate": {
          "endDate": "2021-04-02T00:00:00+02:00"
        },
        "relatedBuyer": "88c051728aae432ca2d39a0215d63fcd",
        "classification": {
          "description": "Cotton seeds",
          "scheme": "ДК021",
          "id": "03111400-6"
        },
        "unit": {
          "name": "кг",
          "code": "KGM"
        }
      }
    ],
    "value": {
      "amount": 500.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "enquiryPeriod": {
      "startDate": "2019-10-01T01:00:00+03:00",
      "endDate": "2019-10-30T01:00:00+03:00"
    },
    "tenderPeriod": {
      "startDate": "2019-11-01T01:00:00+03:00",
      "endDate": "2019-11-11T01:00:00+03:00"
    },
    "procuringEntity": {
      "name": "ЦЗО №1",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Довідкова",
        "telephone": "+0440000000"
      },
      "kind": "central"
    },
    "minimalStep": {
      "amount": 15.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "procurementMethodType": "belowThreshold",
    "id": "2d3b9e1f38c34125b1d2f7a164f871ba"
  },
  "access": {
    "token": "10dc4c83ec444b9b9c38aad1cc00d390",
    "transfer": "425ac43ccdc8457f84482d747bf7f76c"
  }
}

Зв’язування планів з тендером

Центральна організація закупівель зв’язує план з тендером. Якщо є більш ніж один план, вони повинні бути з’єднані один за одним.

POST /api/2.5/tenders/2d3b9e1f38c34125b1d2f7a164f871ba/plans?acc_token=10dc4c83ec444b9b9c38aad1cc00d390 HTTP/1.0
Authorization: Bearer broker
Content-Length: 52
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "id": "6cb30e0a8f2d4487946a40c0b043c761"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "6cb30e0a8f2d4487946a40c0b043c761"
    }
  ]
}

У результаті план переміщається у статус “complete”

GET /api/2.5/plans/6cb30e0a8f2d4487946a40c0b043c761 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "procuringEntity": {
      "id": "30429c884b234749a850b6bd1e044153",
      "name": "ЦЗО №1",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      }
    },
    "tender": {
      "procurementMethod": "open",
      "procurementMethodType": "belowThreshold",
      "tenderPeriod": {
        "startDate": "2019-11-01T01:00:00+03:00"
      }
    },
    "budget": {
      "id": "12303111000-2",
      "description": "budget_description",
      "amount": 10000.0,
      "currency": "UAH",
      "amountNet": 12222.0,
      "project": {
        "id": "123",
        "name": "proj_name"
      },
      "period": {
        "startDate": "2021-01-01T00:00:00+02:00",
        "endDate": "2021-12-31T00:00:00+02:00"
      },
      "breakdown": [
        {
          "id": "1bf7d60f1ad24027a538784c5b6c9bc2",
          "title": "other",
          "description": "Breakdown other description.",
          "value": {
            "amount": 1500.0,
            "currency": "UAH"
          }
        }
      ]
    },
    "classification": {
      "description": "Seeds",
      "scheme": "ДК021",
      "id": "03111000-2"
    },
    "additionalClassifications": [
      {
        "scheme": "КЕКВ",
        "id": "1",
        "description": "-"
      }
    ],
    "tender_id": "2d3b9e1f38c34125b1d2f7a164f871ba",
    "planID": "UA-P-2019-05-02-000001",
    "items": [
      {
        "id": "17c0df4205d34d73b32c735a06a6b533",
        "classification": {
          "description": "Mustard seeds",
          "scheme": "ДК021",
          "id": "03111600-8"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "unit": {
          "name": "кг",
          "code": "KGM"
        },
        "quantity": 1000.0,
        "deliveryDate": {
          "endDate": "2019-11-09T01:00:00+03:00"
        },
        "description": "Насіння гірчиці"
      }
    ],
    "buyers": [
      {
        "id": "422e3fac1aa846bdb451aff9f215009e",
        "name": "ДУС",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        }
      }
    ],
    "status": "complete",
    "milestones": [
      {
        "id": "bcd0fdcf5036434881da407a855782c1",
        "title": "Підготовка до проведення процедури",
        "description": "Доповнений опис відповіді",
        "type": "approval",
        "dueDate": "2019-05-30T18:00:00+02:00",
        "status": "met",
        "documents": [
          {
            "id": "e4ec0c0e29d74a5e868f8e53b79bd05c",
            "hash": "md5:00000000000000000000000000000000",
            "title": "Notice.pdf",
            "format": "application/pdf",
            "url": "http://public-docs-sandbox.prozorro.gov.ua/get/e02eb47c177f4e078fd10eb781a99616?Signature=rN9%2BwQqp%2FjcIsh194eH4myfxHp7SzO3wXo9uAwzsF8ktudixiljJfdi7VP8qVHaRw4IhD6zi%2BmVMWZpLDOO0AA%3D%3D&KeyID=a8968c46",
            "datePublished": "2019-05-02T06:00:00+03:00",
            "dateModified": "2019-05-02T06:00:00+03:00"
          }
        ],
        "author": {
          "id": "a256ff206dcf4884a5631a283ce6bb7d",
          "name": "ЦЗО №1",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "111111",
            "legalName": "ДП Центральний закупівельний орган №1"
          }
        },
        "dateModified": "2019-05-02T06:00:00+03:00",
        "dateMet": "2019-05-02T06:00:00+03:00",
        "owner": "broker"
      }
    ],
    "dateModified": "2019-05-12T12:01:00+03:00",
    "datePublished": "2019-05-02T04:00:00+03:00",
    "owner": "broker",
    "id": "6cb30e0a8f2d4487946a40c0b043c761"
  }
}

Поле plans тендеру містить всі ідентифікатори планів

GET /api/2.5/tenders/2d3b9e1f38c34125b1d2f7a164f871ba HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "футляри до державних нагород",
    "date": "2019-05-12T12:00:00+03:00",
    "dateModified": "2019-05-12T12:01:00+03:00",
    "tenderID": "UA-2019-05-12-000001",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0
      },
      {
        "id": "bc6cce300c9941c4a5df776d1cf7a062",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0
      }
    ],
    "buyers": [
      {
        "id": "3e32f23699ea4ac0b8e105e7babd2c86",
        "name": "ДУС",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "111983",
          "legalName": "ДП Державне Управління Справами"
        }
      },
      {
        "id": "88c051728aae432ca2d39a0215d63fcd",
        "name": "ДУС",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "222983",
          "legalName": "ДП Державне Управління Справами"
        }
      }
    ],
    "plans": [
      {
        "id": "6cb30e0a8f2d4487946a40c0b043c761"
      }
    ],
    "procurementMethod": "open",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "draft",
    "items": [
      {
        "id": "95fea057d382491fb93778d67d3c70f3",
        "description": "Насіння гірчиці",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.92",
            "description": "Насіння гірчиці"
          }
        ],
        "quantity": 1000.0,
        "deliveryDate": {
          "endDate": "2021-03-31T00:00:00+02:00"
        },
        "relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86",
        "classification": {
          "description": "Mustard seeds",
          "scheme": "ДК021",
          "id": "03111600-8"
        },
        "unit": {
          "name": "кг",
          "code": "KGM"
        }
      },
      {
        "id": "8538be924cff4012b27f1fbb7246f7d3",
        "description": "Насіння соняшнику",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.95",
            "description": "Насіння соняшнику"
          }
        ],
        "quantity": 2000.0,
        "deliveryDate": {
          "endDate": "2021-04-01T00:00:00+02:00"
        },
        "relatedBuyer": "3e32f23699ea4ac0b8e105e7babd2c86",
        "classification": {
          "description": "Sunflower seeds",
          "scheme": "ДК021",
          "id": "03111300-5"
        },
        "unit": {
          "name": "кг",
          "code": "KGM"
        }
      },
      {
        "id": "2e0736c2008c4ef4a4a734950ec4c9b8",
        "description": "Насіння бавовнику",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "01.11.84",
            "description": "Насіння бавовнику"
          }
        ],
        "quantity": 3000.0,
        "deliveryDate": {
          "endDate": "2021-04-02T00:00:00+02:00"
        },
        "relatedBuyer": "88c051728aae432ca2d39a0215d63fcd",
        "classification": {
          "description": "Cotton seeds",
          "scheme": "ДК021",
          "id": "03111400-6"
        },
        "unit": {
          "name": "кг",
          "code": "KGM"
        }
      }
    ],
    "value": {
      "amount": 500.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "enquiryPeriod": {
      "startDate": "2019-10-01T01:00:00+03:00",
      "endDate": "2019-10-30T01:00:00+03:00"
    },
    "tenderPeriod": {
      "startDate": "2019-11-01T01:00:00+03:00",
      "endDate": "2019-11-11T01:00:00+03:00"
    },
    "procuringEntity": {
      "name": "ЦЗО №1",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "111111",
        "legalName": "ДП Центральний закупівельний орган №1"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Довідкова",
        "telephone": "+0440000000"
      },
      "kind": "central"
    },
    "minimalStep": {
      "amount": 15.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "procurementMethodType": "belowThreshold",
    "id": "2d3b9e1f38c34125b1d2f7a164f871ba"
  }
}

Створення агрегованих контрактів

Для кожного об’єктку buyer в тендері система створює окремий contract відповідно, в той момент коли award стає активним.

Створюємо тендер з декількома buyers, кожен item повинен бути прив’язаний до відповідного buyer, використовючи поле relatedBuyer:

POST /api/2.5/tenders HTTP/1.0
Authorization: Bearer broker
Content-Length: 6008
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "title": "футляри до державних нагород",
    "mainProcurementCategory": "goods",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/",
        "legalName": "Державне управління справами"
      },
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "locality": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "value": {
      "amount": 500,
      "currency": "UAH"
    },
    "minimalStep": {
      "amount": 15,
      "currency": "UAH"
    },
    "items": [
      {
        "description": "телевізори",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6
          }
        },
        "quantity": 5,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "locality": "м. Київ",
          "streetAddress": "вул. Банкова 1"
        },
        "relatedBuyer": "11111111111111111111111111111111"
      },
      {
        "description": "портфелі",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6
          }
        },
        "quantity": 5,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "locality": "м. Київ",
          "streetAddress": "вул. Банкова 1"
        },
        "relatedBuyer": "22222222222222222222222222222222"
      },
      {
        "description": "портфелі",
        "classification": {
          "scheme": "ДК021",
          "id": "44617100-9",
          "description": "Cartons"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6
          }
        },
        "quantity": 5,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "locality": "м. Київ",
          "streetAddress": "вул. Банкова 1"
        },
        "relatedBuyer": "22222222222222222222222222222222"
      }
    ],
    "enquiryPeriod": {
      "endDate": "2021-03-23T00:00:00+02:00"
    },
    "tenderPeriod": {
      "endDate": "2021-03-30T00:00:00+02:00"
    },
    "procurementMethodType": "belowThreshold",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "code": "prepayment",
        "type": "financing",
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0,
        "percentage": 45.55
      },
      {
        "title": "deliveryOfGoods",
        "code": "postpayment",
        "type": "financing",
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0,
        "percentage": 54.45
      }
    ],
    "buyers": [
      {
        "id": "11111111111111111111111111111111",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/",
          "legalName": "Державне управління справами"
        }
      },
      {
        "id": "22222222222222222222222222222222",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037254",
          "uri": "http://www.dus.gov.ua/",
          "legalName": "Державне управління справами"
        }
      }
    ]
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/27449ba567ee4755b723fd5d2248425f
X-Content-Type-Options: nosniff
{
  "data": {
    "title": "футляри до державних нагород",
    "date": "2021-03-16T00:00:00+02:00",
    "dateModified": "2021-03-16T00:00:00+02:00",
    "tenderID": "UA-2021-03-16-000001",
    "owner": "broker",
    "mainProcurementCategory": "goods",
    "milestones": [
      {
        "id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "title": "signingTheContract",
        "type": "financing",
        "code": "prepayment",
        "percentage": 45.55,
        "duration": {
          "days": 2,
          "type": "banking"
        },
        "sequenceNumber": 0
      },
      {
        "id": "019d2cdc9d114a1c8ef3f81f715708fe",
        "title": "deliveryOfGoods",
        "type": "financing",
        "code": "postpayment",
        "percentage": 54.45,
        "duration": {
          "days": 900,
          "type": "calendar"
        },
        "sequenceNumber": 0
      }
    ],
    "buyers": [
      {
        "id": "11111111111111111111111111111111",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        }
      },
      {
        "id": "22222222222222222222222222222222",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037254",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        }
      }
    ],
    "procurementMethod": "open",
    "awardCriteria": "lowestCost",
    "submissionMethod": "electronicAuction",
    "status": "draft",
    "items": [
      {
        "id": "dccbebb04f7945a5a9913d5017709e45",
        "description": "телевізори",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedBuyer": "11111111111111111111111111111111",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      },
      {
        "id": "b9b66ae4b1a7448a97568af3da6f7fa1",
        "description": "портфелі",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedBuyer": "22222222222222222222222222222222",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      },
      {
        "id": "e9dca19434704b918b98142aae75a8bd",
        "description": "портфелі",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedBuyer": "22222222222222222222222222222222",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ],
    "value": {
      "amount": 500.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "enquiryPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-23T00:00:00+02:00"
    },
    "tenderPeriod": {
      "startDate": "2021-03-23T00:00:00+02:00",
      "endDate": "2021-03-30T00:00:00+02:00"
    },
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Державне управління справами",
        "uri": "http://www.dus.gov.ua/"
      },
      "address": {
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220",
        "countryName": "Україна"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000"
      },
      "kind": "general"
    },
    "minimalStep": {
      "amount": 15.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "procurementMethodType": "belowThreshold",
    "id": "27449ba567ee4755b723fd5d2248425f"
  },
  "access": {
    "token": "09fb3db5c4b0423685f58a6cf7176e7b",
    "transfer": "7f66b0098e074bee96387a7aacbb0408"
  }
}

Йдемо далі, як зазвичай, активуємо авард

PATCH /api/2.5/tenders/27449ba567ee4755b723fd5d2248425f/awards/465daa0e35ef47a48a592b6abdf49562?acc_token=09fb3db5c4b0423685f58a6cf7176e7b 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "465daa0e35ef47a48a592b6abdf49562",
    "status": "active",
    "date": "2021-03-16T00:00:00+02:00",
    "value": {
      "amount": 500.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "bid_id": "add3b8718ccc49938d52728e195afe7f",
    "complaintPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-18T00:00:00+02:00"
    }
  }
}

Після активації аварду система створює таку кількість об’єктів contracts, що відповідає кількості buyers в тендері

GET /api/2.5/tenders/8205792550a1414cbb9eeff86db41600/contracts HTTP/1.0
Authorization: Bearer chronograph
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "bef9a489e2c84fdc82467cb58b860c8b",
      "buyerID": "11111111111111111111111111111111",
      "contractID": "UA-2021-03-16-000001-1",
      "status": "pending",
      "suppliers": [
        {
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037256",
            "legalName": "Державне управління справами",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "01220",
            "countryName": "Україна"
          },
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "+0440000000"
          },
          "scale": "micro"
        }
      ],
      "date": "2021-03-16T00:00:00+02:00",
      "value": {
        "amount": 0.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true,
        "amountNet": 0.0
      },
      "awardID": "422e4d1bd30d4abf86f60d4a8be3eb06",
      "items": [
        {
          "id": "14b543e7ea7f41a4ad204ee51ba55efb",
          "description": "телевізори",
          "additionalClassifications": [
            {
              "scheme": "ДКПП",
              "id": "17.21.1",
              "description": "папір і картон гофровані, паперова й картонна тара"
            }
          ],
          "quantity": 5.0,
          "deliveryDate": {
            "startDate": "2021-03-18T00:00:00+02:00",
            "endDate": "2021-03-21T00:00:00+02:00"
          },
          "deliveryAddress": {
            "streetAddress": "вул. Банкова 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "79000",
            "countryName": "Україна"
          },
          "relatedBuyer": "11111111111111111111111111111111",
          "classification": {
            "description": "Cartons",
            "scheme": "ДК021",
            "id": "44617100-9"
          },
          "unit": {
            "name": "кг",
            "code": "KGM",
            "value": {
              "amount": 6.0,
              "currency": "UAH",
              "valueAddedTaxIncluded": true
            }
          }
        }
      ]
    },
    {
      "id": "b2530a4e7ca146a6805f06fb3b967208",
      "buyerID": "22222222222222222222222222222222",
      "contractID": "UA-2021-03-16-000001-2",
      "status": "pending",
      "suppliers": [
        {
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037256",
            "legalName": "Державне управління справами",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "01220",
            "countryName": "Україна"
          },
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "+0440000000"
          },
          "scale": "micro"
        }
      ],
      "date": "2021-03-16T00:00:00+02:00",
      "value": {
        "amount": 0.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true,
        "amountNet": 0.0
      },
      "awardID": "422e4d1bd30d4abf86f60d4a8be3eb06",
      "items": [
        {
          "id": "02ac9abf9af341c1ae973c6935ca84b2",
          "description": "портфелі",
          "additionalClassifications": [
            {
              "scheme": "ДКПП",
              "id": "17.21.1",
              "description": "папір і картон гофровані, паперова й картонна тара"
            }
          ],
          "quantity": 5.0,
          "deliveryDate": {
            "startDate": "2021-03-18T00:00:00+02:00",
            "endDate": "2021-03-21T00:00:00+02:00"
          },
          "deliveryAddress": {
            "streetAddress": "вул. Банкова 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "79000",
            "countryName": "Україна"
          },
          "relatedBuyer": "22222222222222222222222222222222",
          "classification": {
            "description": "Cartons",
            "scheme": "ДК021",
            "id": "44617100-9"
          },
          "unit": {
            "name": "кг",
            "code": "KGM",
            "value": {
              "amount": 6.0,
              "currency": "UAH",
              "valueAddedTaxIncluded": true
            }
          }
        },
        {
          "id": "67d881f921f9446f9bb04c8ec4aed2f2",
          "description": "портфелі",
          "additionalClassifications": [
            {
              "scheme": "ДКПП",
              "id": "17.21.1",
              "description": "папір і картон гофровані, паперова й картонна тара"
            }
          ],
          "quantity": 5.0,
          "deliveryDate": {
            "startDate": "2021-03-18T00:00:00+02:00",
            "endDate": "2021-03-21T00:00:00+02:00"
          },
          "deliveryAddress": {
            "streetAddress": "вул. Банкова 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "79000",
            "countryName": "Україна"
          },
          "relatedBuyer": "22222222222222222222222222222222",
          "classification": {
            "description": "Cartons",
            "scheme": "ДК021",
            "id": "44617100-9"
          },
          "unit": {
            "name": "кг",
            "code": "KGM",
            "value": {
              "amount": 6.0,
              "currency": "UAH",
              "valueAddedTaxIncluded": true
            }
          }
        }
      ]
    }
  ]
}

Оновлюємо Amount.Value для кожного контракту, враховуючи суму добутків Unit.Value на Quantity для кожного item в контракті:

PATCH /api/2.5/tenders/27449ba567ee4755b723fd5d2248425f/contracts/bc96d4718f344a19ad7cb5e90058a98e?acc_token=09fb3db5c4b0423685f58a6cf7176e7b HTTP/1.0
Authorization: Bearer broker
Content-Length: 53
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "value": {
      "amount": 100,
      "amountNet": 95
    }
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "bc96d4718f344a19ad7cb5e90058a98e",
    "buyerID": "11111111111111111111111111111111",
    "contractID": "UA-2021-03-16-000001-1",
    "status": "pending",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "date": "2021-03-16T00:00:00+02:00",
    "value": {
      "amount": 100.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 95.0
    },
    "awardID": "465daa0e35ef47a48a592b6abdf49562",
    "items": [
      {
        "id": "dccbebb04f7945a5a9913d5017709e45",
        "description": "телевізори",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedBuyer": "11111111111111111111111111111111",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ]
  }
}

PATCH /api/2.5/tenders/27449ba567ee4755b723fd5d2248425f/contracts/12449546a2e54d7fb27ce42b68dcd7d9?acc_token=09fb3db5c4b0423685f58a6cf7176e7b HTTP/1.0
Authorization: Bearer broker
Content-Length: 54
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "value": {
      "amount": 200,
      "amountNet": 190
    }
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "12449546a2e54d7fb27ce42b68dcd7d9",
    "buyerID": "22222222222222222222222222222222",
    "contractID": "UA-2021-03-16-000001-2",
    "status": "pending",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "date": "2021-03-16T00:00:00+02:00",
    "value": {
      "amount": 200.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 190.0
    },
    "awardID": "465daa0e35ef47a48a592b6abdf49562",
    "items": [
      {
        "id": "b9b66ae4b1a7448a97568af3da6f7fa1",
        "description": "портфелі",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedBuyer": "22222222222222222222222222222222",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      },
      {
        "id": "e9dca19434704b918b98142aae75a8bd",
        "description": "портфелі",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedBuyer": "22222222222222222222222222222222",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ]
  }
}

Ви можете активувати або термінувати кожен контракт як зазвичай. Якщо відсутні контракти в стутусі pending та хоча б один котракт знаходиться в статусі active, тендер переходить в статус complete

При скасуванні аварду всі контракти відповідного awardID переходять в статус cancelled.

Відміна агрегованих контрактів

Контракт може бути відмінений:

PATCH /api/2.5/tenders/8205792550a1414cbb9eeff86db41600/contracts/bef9a489e2c84fdc82467cb58b860c8b?acc_token=058351be85014e5db8d4fa00a8b28181 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "cancelled"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "bef9a489e2c84fdc82467cb58b860c8b",
    "buyerID": "11111111111111111111111111111111",
    "contractID": "UA-2021-03-16-000001-1",
    "status": "cancelled",
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "date": "2021-03-16T00:00:01+02:00",
    "value": {
      "amount": 0.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true,
      "amountNet": 0.0
    },
    "awardID": "422e4d1bd30d4abf86f60d4a8be3eb06",
    "items": [
      {
        "id": "14b543e7ea7f41a4ad204ee51ba55efb",
        "description": "телевізори",
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "quantity": 5.0,
        "deliveryDate": {
          "startDate": "2021-03-18T00:00:00+02:00",
          "endDate": "2021-03-21T00:00:00+02:00"
        },
        "deliveryAddress": {
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "79000",
          "countryName": "Україна"
        },
        "relatedBuyer": "11111111111111111111111111111111",
        "classification": {
          "description": "Cartons",
          "scheme": "ДК021",
          "id": "44617100-9"
        },
        "unit": {
          "name": "кг",
          "code": "KGM",
          "value": {
            "amount": 6.0,
            "currency": "UAH",
            "valueAddedTaxIncluded": true
          }
        }
      }
    ]
  }
}

За винятком коли котракт є останнім невідміненим контрактом:

PATCH /api/2.5/tenders/8205792550a1414cbb9eeff86db41600/contracts/b2530a4e7ca146a6805f06fb3b967208?acc_token=058351be85014e5db8d4fa00a8b28181 HTTP/1.0
Authorization: Bearer broker
Content-Length: 33
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "cancelled"
  }
}

Response: 403 Forbidden
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Can't update contract status from pending to cancelled for last not cancelled contract. Cancel award instead."
    }
  ]
}

В цьому випадку повинен бути відмінений відповідний авард:

PATCH /api/2.5/tenders/27449ba567ee4755b723fd5d2248425f/awards/465daa0e35ef47a48a592b6abdf49562?acc_token=09fb3db5c4b0423685f58a6cf7176e7b 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
X-Content-Type-Options: nosniff
{
  "data": {
    "id": "465daa0e35ef47a48a592b6abdf49562",
    "status": "active",
    "date": "2021-03-16T00:00:00+02:00",
    "value": {
      "amount": 500.0,
      "currency": "UAH",
      "valueAddedTaxIncluded": true
    },
    "suppliers": [
      {
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "legalName": "Державне управління справами",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "locality": "м. Київ",
          "region": "м. Київ",
          "postalCode": "01220",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "+0440000000"
        },
        "scale": "micro"
      }
    ],
    "bid_id": "add3b8718ccc49938d52728e195afe7f",
    "complaintPeriod": {
      "startDate": "2021-03-16T00:00:00+02:00",
      "endDate": "2021-03-18T00:00:00+02:00"
    }
  }
}

Перевіримо що всі контракти відмінені:

GET /api/2.5/tenders/8205792550a1414cbb9eeff86db41600/contracts HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": [
    {
      "id": "bef9a489e2c84fdc82467cb58b860c8b",
      "buyerID": "11111111111111111111111111111111",
      "contractID": "UA-2021-03-16-000001-1",
      "status": "cancelled",
      "suppliers": [
        {
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037256",
            "legalName": "Державне управління справами",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "01220",
            "countryName": "Україна"
          },
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "+0440000000"
          },
          "scale": "micro"
        }
      ],
      "date": "2021-03-16T00:00:01+02:00",
      "value": {
        "amount": 0.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true,
        "amountNet": 0.0
      },
      "awardID": "422e4d1bd30d4abf86f60d4a8be3eb06",
      "items": [
        {
          "id": "14b543e7ea7f41a4ad204ee51ba55efb",
          "description": "телевізори",
          "additionalClassifications": [
            {
              "scheme": "ДКПП",
              "id": "17.21.1",
              "description": "папір і картон гофровані, паперова й картонна тара"
            }
          ],
          "quantity": 5.0,
          "deliveryDate": {
            "startDate": "2021-03-18T00:00:00+02:00",
            "endDate": "2021-03-21T00:00:00+02:00"
          },
          "deliveryAddress": {
            "streetAddress": "вул. Банкова 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "79000",
            "countryName": "Україна"
          },
          "relatedBuyer": "11111111111111111111111111111111",
          "classification": {
            "description": "Cartons",
            "scheme": "ДК021",
            "id": "44617100-9"
          },
          "unit": {
            "name": "кг",
            "code": "KGM",
            "value": {
              "amount": 6.0,
              "currency": "UAH",
              "valueAddedTaxIncluded": true
            }
          }
        }
      ]
    },
    {
      "id": "b2530a4e7ca146a6805f06fb3b967208",
      "buyerID": "22222222222222222222222222222222",
      "contractID": "UA-2021-03-16-000001-2",
      "status": "cancelled",
      "suppliers": [
        {
          "name": "Державне управління справами",
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00037256",
            "legalName": "Державне управління справами",
            "uri": "http://www.dus.gov.ua/"
          },
          "address": {
            "streetAddress": "вул. Банкова, 11, корпус 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "01220",
            "countryName": "Україна"
          },
          "contactPoint": {
            "name": "Державне управління справами",
            "telephone": "+0440000000"
          },
          "scale": "micro"
        }
      ],
      "date": "2021-03-16T00:00:01+02:00",
      "value": {
        "amount": 0.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true,
        "amountNet": 0.0
      },
      "awardID": "422e4d1bd30d4abf86f60d4a8be3eb06",
      "items": [
        {
          "id": "02ac9abf9af341c1ae973c6935ca84b2",
          "description": "портфелі",
          "additionalClassifications": [
            {
              "scheme": "ДКПП",
              "id": "17.21.1",
              "description": "папір і картон гофровані, паперова й картонна тара"
            }
          ],
          "quantity": 5.0,
          "deliveryDate": {
            "startDate": "2021-03-18T00:00:00+02:00",
            "endDate": "2021-03-21T00:00:00+02:00"
          },
          "deliveryAddress": {
            "streetAddress": "вул. Банкова 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "79000",
            "countryName": "Україна"
          },
          "relatedBuyer": "22222222222222222222222222222222",
          "classification": {
            "description": "Cartons",
            "scheme": "ДК021",
            "id": "44617100-9"
          },
          "unit": {
            "name": "кг",
            "code": "KGM",
            "value": {
              "amount": 6.0,
              "currency": "UAH",
              "valueAddedTaxIncluded": true
            }
          }
        },
        {
          "id": "67d881f921f9446f9bb04c8ec4aed2f2",
          "description": "портфелі",
          "additionalClassifications": [
            {
              "scheme": "ДКПП",
              "id": "17.21.1",
              "description": "папір і картон гофровані, паперова й картонна тара"
            }
          ],
          "quantity": 5.0,
          "deliveryDate": {
            "startDate": "2021-03-18T00:00:00+02:00",
            "endDate": "2021-03-21T00:00:00+02:00"
          },
          "deliveryAddress": {
            "streetAddress": "вул. Банкова 1",
            "locality": "м. Київ",
            "region": "м. Київ",
            "postalCode": "79000",
            "countryName": "Україна"
          },
          "relatedBuyer": "22222222222222222222222222222222",
          "classification": {
            "description": "Cartons",
            "scheme": "ДК021",
            "id": "44617100-9"
          },
          "unit": {
            "name": "кг",
            "code": "KGM",
            "value": {
              "amount": 6.0,
              "currency": "UAH",
              "valueAddedTaxIncluded": true
            }
          }
        }
      ]
    }
  ]
}