Tutorial

Exploring basic rules

Let’s try exploring the /contracts endpoint:

GET /api/2.5/contracts 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/contracts?offset=",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=",
    "offset": ""
  },
  "data": []
}

Just invoking it reveals an empty set.

Contract is transferred from the tender system by an automated process.

Creating contract

Let’s say that we have conducted tender and it has complete status. When the tender is completed, contract (that has been created in the tender system) is transferred to the contract system automatically.

Brokers (eMalls) can’t create contracts in the contract system.

Getting contract

Contract in the tender system

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

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "amountNet": 490.0,
      "valueAddedTaxIncluded": true
    },
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "date": "2019-10-25T01:00:01+03:00",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "id": "05870adde49c424db6a2dba280ea90ab",
    "contractID": "UA-2019-10-25-000001-1"
  }
}

Contract id is the same in both tender and contract system.

Let’s access the URL of the created object:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab HTTP/1.0
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "dateModified": "2019-10-25T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "amountNet": 490.0,
      "valueAddedTaxIncluded": true
    },
    "contractID": "UA-2019-10-25-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Getting access

In order to get rights for future contract editing, you need to use this view PATCH: /contracts/{id}/credentials?acc_token={tender_token} with the API key of the eMall (broker), where tender was generated.

In the PATCH: /contracts/{id}/credentials?acc_token={tender_token}:

  • id stands for contract id,
  • tender_token is tender’s token (is used for contract token generation).

Response will contain access.token for the contract that can be used for further contract modification.

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/credentials?acc_token=b9646ca4bdf64fc9a724c708b72a1c38 HTTP/1.0
Authorization: Bearer broker
Content-Length: 0
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "access": {
    "transfer": "46a94f59cf264e9fb4264dd30c38e236",
    "token": "9e4e9f4da0514309b6c79bbafb5b59c3"
  },
  "data": {
    "status": "active",
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "dateModified": "2019-10-25T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "amountNet": 490.0,
      "valueAddedTaxIncluded": true
    },
    "contractID": "UA-2019-10-25-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Let’s view contracts.

GET /api/2.5/contracts 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/contracts?offset=2019-10-25T01%3A00%3A01%2B03%3A00",
    "uri": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts?offset=2019-10-25T01%3A00%3A01%2B03%3A00",
    "offset": "2019-10-25T01:00:01+03:00"
  },
  "data": [
    {
      "id": "05870adde49c424db6a2dba280ea90ab",
      "dateModified": "2019-10-25T01:00:01+03:00"
    }
  ]
}

We do see the internal id of a contract (that can be used to construct full URL by prepending http://api-sandbox.openprocurement.org/api/0/contracts/) and its dateModified datestamp.

Modifying contract

You can make changes to the contract in cases described in the 4th part of Article 36 of the Law “On the Public Procurement”.

Essential contract terms can be modified by the submission of a new Change object to the Contract.changes container.

All changes are processed by the endpoint /contracts/{id}/changes.

Submitting a change

Let’s add new change to the contract:

POST /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 267
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "rationale": "Опис причини змін контракту"
  }
}

Response: 201 Created
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "rationale": "Опис причини змін контракту",
    "date": "2019-10-25T01:00:01+03:00",
    "id": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Note that you can provide more than one value in rationaleTypes field.

You can view the change:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes/f3fe39d5213d4a029212ff4f1151cf40 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "rationale": "Опис причини змін контракту",
    "date": "2019-10-25T01:00:01+03:00",
    "id": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Change can be modified while it is in the pending status:

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes/f3fe39d5213d4a029212ff4f1151cf40?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 255
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "rationale": "Друга і третя поставка має бути розфасована"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "pending",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "rationale": "Друга і третя поставка має бути розфасована",
    "date": "2019-10-25T01:00:01+03:00",
    "id": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Uploading change document

Document can be added only while change is in the pending status.

Document has to be added in two stages:

  • you should upload document
POST /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 155
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_changes.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/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c
{
  "data": {
    "title": "contract_changes.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "id": "de3004e5b9844707bb35405277043c7c",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}
  • you should set document properties "documentOf": "change" and "relatedItem": "{change.id}" in order to bind the uploaded document to the change:
PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 85
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "documentOf": "change",
    "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_changes.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
    "format": "application/msword",
    "documentOf": "change",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "id": "de3004e5b9844707bb35405277043c7c",
    "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}

Updating contract properties

Now you can update contract properties which belong to the change.

You can update value amount and amountNet following next rules:

valueAddedTaxIncluded Validation
true Amount should be greater than amountNet and differ by no more than 20%
false Amount and amountNet should be equal
PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 148
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "period": {
      "startDate": "2019-10-25T01:00:01+03:00",
      "endDate": "2019-11-24T01:00:01+03:00"
    },
    "value": {
      "amount": 438,
      "amountNet": 430
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2019-10-25T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2019-10-25T01:00:01+03:00",
      "endDate": "2019-11-24T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "contractID": "UA-2019-10-25-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2019-10-25T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

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

Fields that can be modified: title, description, status, value.amount, value.amountNet, period, items, amountPaid.amount, amountPaid.amountNet, terminationDetails.

See examples of items customization below. You can:

  • update item:
PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 42
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "quantity": 2
      },
      {}
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2019-10-25T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      },
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "5266f95b8c684790890c7d2923546a9d",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2019-10-25T01:00:01+03:00",
      "endDate": "2019-11-24T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "contractID": "UA-2019-10-25-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2019-10-25T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}
  • delete item:

Request example for cases when contract has several items:

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 1148
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      }
    ]
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2019-10-25T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2019-10-25T01:00:01+03:00",
      "endDate": "2019-11-24T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "contractID": "UA-2019-10-25-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "changes": [
      {
        "status": "pending",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2019-10-25T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Applying the change

Change can be applied by switching to the active status.

In order to apply active status dateSigned field must be set.

After this change can’t be modified anymore.

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes/f3fe39d5213d4a029212ff4f1151cf40?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 73
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "active",
    "dateSigned": "2019-10-25T01:00:01+03:00"
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "rationaleTypes": [
      "volumeCuts",
      "priceReduction"
    ],
    "rationale_en": "Contract change cause",
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "rationale": "Друга і третя поставка має бути розфасована",
    "date": "2019-10-25T01:00:01+03:00",
    "id": "f3fe39d5213d4a029212ff4f1151cf40"
  }
}

dateSigned field validation:

  • for the first contract change date should be after contract.dateSigned;
  • for all next change objects date should be after the previous change.dateSigned.

You can view all changes:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/changes HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "status": "active",
      "rationaleTypes": [
        "volumeCuts",
        "priceReduction"
      ],
      "rationale_en": "Contract change cause",
      "dateSigned": "2019-10-25T01:00:01+03:00",
      "rationale": "Друга і третя поставка має бути розфасована",
      "date": "2019-10-25T01:00:01+03:00",
      "id": "f3fe39d5213d4a029212ff4f1151cf40"
    }
  ]
}

All changes are also listed on the contract view.

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "active",
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2019-10-25T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2019-10-25T01:00:01+03:00",
      "endDate": "2019-11-24T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "contractID": "UA-2019-10-25-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "changes": [
      {
        "status": "active",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "dateSigned": "2019-10-25T01:00:01+03:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2019-10-25T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Uploading documentation

Procuring entity can upload PDF files into the created contract. Uploading should follow the Documents Uploading rules.

POST /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 147
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract.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/contracts/05870adde49c424db6a2dba280ea90ab/documents/e280bc973d5b4ce284dd152f15ae24f4
{
  "data": {
    "title": "contract.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/e280bc973d5b4ce284dd152f15ae24f4?download=5311a5f7a2dc43d68092e08adad8737b",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "id": "e280bc973d5b4ce284dd152f15ae24f4",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}

201 Created response code and Location header confirm document creation. We can additionally query the documents collection API endpoint to confirm the action:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": [
    {
      "title": "contract.doc",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/e280bc973d5b4ce284dd152f15ae24f4?download=5311a5f7a2dc43d68092e08adad8737b",
      "format": "application/msword",
      "documentOf": "contract",
      "datePublished": "2019-10-25T01:00:01+03:00",
      "id": "e280bc973d5b4ce284dd152f15ae24f4",
      "dateModified": "2019-10-25T01:00:01+03:00"
    },
    {
      "title": "contract_changes.doc",
      "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
      "format": "application/msword",
      "documentOf": "change",
      "datePublished": "2019-10-25T01:00:01+03:00",
      "id": "de3004e5b9844707bb35405277043c7c",
      "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
      "dateModified": "2019-10-25T01:00:01+03:00"
    }
  ]
}

And again we can confirm that there are two documents uploaded.

POST /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 171
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_additional_docs.doc"
Content-Type: application/msword

additional info
-----BOUNDARY--


Response: 201 Created
Content-Type: application/json; charset=UTF-8
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=54f475dac20b45d0aefff43fc60f1822",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "id": "884f1aed57d741a7a8011e28edc20860",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}

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

PUT /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 180
Content-Type: multipart/form-data; boundary=---BOUNDARY
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
-----BOUNDARY
Content-Disposition: form-data; name="file"; filename="contract_additional_docs.doc"
Content-Type: application/msword

extended additional info
-----BOUNDARY--


Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=2562188623c64e25967736fbcc3a38d2",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "id": "884f1aed57d741a7a8011e28edc20860",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}

And we can see that it is overriding the original version:

GET /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Host: lb-api-sandbox.prozorro.gov.ua

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "title": "contract_additional_docs.doc",
    "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=2562188623c64e25967736fbcc3a38d2",
    "format": "application/msword",
    "documentOf": "contract",
    "datePublished": "2019-10-25T01:00:01+03:00",
    "previousVersions": [
      {
        "title": "contract_additional_docs.doc",
        "url": "/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=54f475dac20b45d0aefff43fc60f1822",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "884f1aed57d741a7a8011e28edc20860",
        "dateModified": "2019-10-25T01:00:01+03:00"
      }
    ],
    "id": "884f1aed57d741a7a8011e28edc20860",
    "dateModified": "2019-10-25T01:00:01+03:00"
  }
}

Completing contract

Before contract can be completed amountPaid field value should be set (regardless whether the contract was successful or unsuccessful). Contract can be completed by switching to terminated status. Let’s perform these actions in single request:

PATCH /api/2.5/contracts/05870adde49c424db6a2dba280ea90ab?acc_token=9e4e9f4da0514309b6c79bbafb5b59c3 HTTP/1.0
Authorization: Bearer broker
Content-Length: 83
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
DATA:
{
  "data": {
    "status": "terminated",
    "amountPaid": {
      "amount": 430,
      "amountNet": 420
    }
  }
}

Response: 200 OK
Content-Type: application/json; charset=UTF-8
{
  "data": {
    "status": "terminated",
    "changes": [
      {
        "status": "active",
        "rationaleTypes": [
          "volumeCuts",
          "priceReduction"
        ],
        "rationale_en": "Contract change cause",
        "dateSigned": "2019-10-25T01:00:01+03:00",
        "rationale": "Друга і третя поставка має бути розфасована",
        "date": "2019-10-25T01:00:01+03:00",
        "id": "f3fe39d5213d4a029212ff4f1151cf40"
      }
    ],
    "documents": [
      {
        "title": "contract_changes.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/de3004e5b9844707bb35405277043c7c?download=c264f9ae7a754b25badeff4e01b1cb43",
        "format": "application/msword",
        "documentOf": "change",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "de3004e5b9844707bb35405277043c7c",
        "relatedItem": "f3fe39d5213d4a029212ff4f1151cf40",
        "dateModified": "2019-10-25T01:00:01+03:00"
      },
      {
        "title": "contract.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/e280bc973d5b4ce284dd152f15ae24f4?download=5311a5f7a2dc43d68092e08adad8737b",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "e280bc973d5b4ce284dd152f15ae24f4",
        "dateModified": "2019-10-25T01:00:01+03:00"
      },
      {
        "title": "contract_additional_docs.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=54f475dac20b45d0aefff43fc60f1822",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "884f1aed57d741a7a8011e28edc20860",
        "dateModified": "2019-10-25T01:00:01+03:00"
      },
      {
        "title": "contract_additional_docs.doc",
        "url": "http://lb-api-sandbox.prozorro.gov.ua/api/2.5/contracts/05870adde49c424db6a2dba280ea90ab/documents/884f1aed57d741a7a8011e28edc20860?download=2562188623c64e25967736fbcc3a38d2",
        "format": "application/msword",
        "documentOf": "contract",
        "datePublished": "2019-10-25T01:00:01+03:00",
        "id": "884f1aed57d741a7a8011e28edc20860",
        "dateModified": "2019-10-25T01:00:01+03:00"
      }
    ],
    "items": [
      {
        "description": "футляри до державних нагород",
        "classification": {
          "scheme": "ДК021",
          "description": "Cartons",
          "id": "44617100-9"
        },
        "additionalClassifications": [
          {
            "scheme": "ДКПП",
            "id": "17.21.1",
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ],
        "deliveryAddress": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "deliveryDate": {
          "startDate": "2019-10-27T01:00:00+03:00",
          "endDate": "2019-10-30T01:00:00+03:00"
        },
        "id": "f9297f1a5b7148afa736fdb77d9a7d98",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 2.0
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "name": "Державне управління справами",
          "telephone": "0440000000"
        },
        "scale": "micro",
        "name": "Державне управління справами",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00037256",
          "uri": "http://www.dus.gov.ua/"
        },
        "address": {
          "postalCode": "01220",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова, 11, корпус 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        }
      }
    ],
    "period": {
      "startDate": "2019-10-25T01:00:01+03:00",
      "endDate": "2019-11-24T01:00:01+03:00"
    },
    "value": {
      "currency": "UAH",
      "amount": 438.0,
      "amountNet": 430.0,
      "valueAddedTaxIncluded": true
    },
    "dateModified": "2019-10-25T01:00:01+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "kind": "general",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "dateSigned": "2019-10-25T01:00:01+03:00",
    "contractID": "UA-2019-10-25-000001-1",
    "owner": "broker",
    "awardID": "e7fc32a4b2cd473793ff3b53b98c60ae",
    "amountPaid": {
      "currency": "UAH",
      "amount": 430.0,
      "amountNet": 420.0,
      "valueAddedTaxIncluded": true
    },
    "id": "05870adde49c424db6a2dba280ea90ab",
    "tender_id": "ffa3d33ea0004692a4a30af55a8f6a5b"
  }
}

Note that you can set/change only amountPaid.amount value. amountPaid.currency and amountPaid.valueAddedTaxIncluded fields’ values are generated from Contract.value field.

If contract is unsuccessful reasons for termination terminationDetails should be specified.

Any future modification to the contract are not allowed.