Туторіал

Базові правила

Подивимось як працює точка входу /auctions:

GET /api/2.4/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.4/auctions?offset=",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=",
    "offset": ""
  },
  "data": []
}

При виклику видає пустий набір.

Спробуймо створити новий аукціон:

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: api-sandbox.ea.openprocurement.org


415 Unsupported Media Type
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']",
      "location": "header",
      "name": "Content-Type"
    }
  ]
}

Помилка вказує, що єдиний прийнятний тип вмісту це application/json.

Задовільнимо вимогу типу вмісту:

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org


422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": "Expecting value: line 1 column 1 (char 0)",
      "location": "body",
      "name": "data"
    }
  ]
}

Помилка вказує, що data не знайдено у тілі JSON.

Створення аукціону

PropertyLease procedure has a specific data structure called contractTerms.

The structure must have mandatory fields:

  • type containing the only possible value lease.
  • leaseTerms.

leaseTerms has one mandatory and two optional fields:

  • leaseDuration must contain the duration of the lease specified in ISO8601 duration [1] format.
  • In the taxHolidays field Organizer may optionally specify the tax concessions period, if granted.
  • escalationClauses define the rules for periodic monthly payment changes.

Minimal contractTerms section should look like this:

"contractTerms": {
  "type": "lease",
  "leaseTerms": {
      "leaseDuration": "P10Y",
  }
},

The other specific feature for the propertyLease procedure is an option to set tenderPeriod.endDate.

For some reason Organizer may need to have 3 working days pause between tenderPeriod.endDate and auctionPeriod.startDate.

When tenderPeriod.endDate is passed it must be set exactly 3 working days before auctionPeriod.startDate.

For any other tenderPeriod.endDate ValidationError will be raised:

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2601
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "tenderPeriod": {
      "endDate": "2018-07-26T15:23:39.864267+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-08-05T15:23:39.864267+03:00"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2018-07-08T15:23:39.611994",
          "endDate": "2018-07-11T15:23:39.611994"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ]
  }
}


422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": "The only possible value for tenderPeriod.endDate is 2018-07-31 20:00:00+03:00",
      "location": "body",
      "name": "data"
    }
  ]
}

If tenderPeriod.endDate is not passed it will be calculated automatically as 8PM day before auctionPeriod.startDate.

Створимо аукціон з мінімально допустимим набором даних (тільки параметри обовязкові для заповнення) :

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2514
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-19"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991",
          "endDate": "2018-07-10T15:44:36.881991"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "cdfb5f6d59f74153b70113720adaba2e",
    "token": "686740317fd249638e3ee0420d268ebf"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "bf6575a30f2c4465ae43e06981df3b5a",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:43.541215+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:43.531351+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-13T20:00:00+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "2ca4bc6c445e46459bda9c85019dcd33"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "d235e459369d465da4e7771e6573239b",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

Успіх! Тепер ми бачимо, що новий об’єкт було створено. Код відповіді 201 та заголовок відповіді Location вказує місцерозташування створеного об’єкта. Тіло відповіді показує інформацію про створений аукціон, його внутрішнє id (яке співпадає з сегментом Location), його офіційне auctionID та dateModified дату, що показує час, коли аукціон востаннє модифікувався. Зверніть увагу на procurementMethodType, а також на те, що аукціон створюється зі статусом active.tendering.

Пам’ятайте, що tenderPeriod має складати щонайменше 7 календарних днів.

Якщо у auctionPeriod.startDate передано некоректну дату, генерується помилка 422 Unprocessable Entity та у JSON відповіді повертається повідомлення “tenderPeriod should be greater than 6 days”.

Встановимо auctionPeriod.startDate у значення now + timedelta(days=6) - у відповідь ми отримаємо помилку ValidationError.

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2536
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-11T15:44:37.150620+03:00"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991",
          "endDate": "2018-07-10T15:44:36.881991"
        },
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "quantity": 5.001
      }
    ]
  }
}


422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "status": "error",
  "errors": [
    {
      "description": [
        "tenderPeriod should be greater than 6 days"
      ],
      "location": "body",
      "name": "tenderPeriod"
    }
  ]
}

Organizer can set rectificationPeriod.endDate. The gap between the given date and tenderPeriod.endDate should not be less than 5 working days.

If the gap between rectificationPeriod.endDate provided by Organizer and tenderPeriod.endDate is less than 5 days 422 Unprocessable Entity response will be returned with the error message ‘rectificationPeriod.endDate should be set at least 5 working days earlier than tenderPeriod.endDate.’

If Organizer does not set rectificationPeriod.endDate it will be calculated automatically as tenderPeriod.endDate minus 5 working days.

Використаємо URL створеного об’єкта (заголовок відповіді Location):

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "bf6575a30f2c4465ae43e06981df3b5a",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:43.541215+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:43.531351+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-13T20:00:00+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "2ca4bc6c445e46459bda9c85019dcd33"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "d235e459369d465da4e7771e6573239b",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

Ми бачимо ту ж відповідь, що і після створення аукціону.

Подивимось, що показує список аукціонів:

GET /api/2.4/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.4/auctions?offset=",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=",
    "offset": ""
  },
  "data": []
}

Ми бачимо внутрішнє id аукціону (що може бути використано для побудови повної URL-адреси, якщо додати http://api-sandbox.openprocurement.org/api/0/auctions/) та його dateModified дату.

Попередній аукціон був створений лише з обов’язковими полями. Тепер додамо аукціон з максимально допустимим набором даних при створенні (аукціон повинен бути у статусі created).

POST /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3442
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "lotIdentifier": "219560",
    "description_en": "Cases with state awards",
    "description": "футляри до державних нагород",
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "conditions": "conditions description",
            "escalationPeriodicity": "P5M",
            "escalationStepPercentage": 0.1
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "title": "футляри до державних нагород",
    "minimalStep": {
      "currency": "UAH",
      "amount": 35
    },
    "auctionPeriod": {
      "startDate": "2018-07-19"
    },
    "tenderAttempts": 1,
    "procurementMethodType": "propertyLease",
    "value": {
      "currency": "UAH",
      "amount": 100
    },
    "description_ru": "футляры к государственным наградам",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ"
      }
    },
    "title_ru": "футляры к государственным наградам",
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "id": "04121000-2",
          "description": "Земельні ділянки"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "countryName": "Україна",
          "postalCode": "79000",
          "region": "м. Київ",
          "streetAddress": "вул. Банкова 1",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "description_ru": "футляры к государственным наградам",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991",
          "endDate": "2018-07-10T15:44:36.881991"
        }
      }
    ],
    "title_en": "Cases with state awards"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/995eb51dc28c4aeaa4624b658593b117
X-Content-Type-Options: nosniff

{
  "access": {
    "transfer": "e7b243a833c841c3baabe436dc79c772",
    "token": "0259f966168e46109b773d77072102db"
  },
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000003",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:43.654641+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "awardCriteria": "highestCost",
    "owner": "broker",
    "id": "995eb51dc28c4aeaa4624b658593b117",
    "description": "футляри до державних нагород",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "description_ru": "футляры к государственным наградам",
    "dateModified": "2018-07-05T15:44:43.667419+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:43.654641+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "title_en": "Cases with state awards",
    "procurementMethodType": "propertyLease",
    "description_en": "Cases with state awards",
    "date": "2018-07-05T15:44:43.654641+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:43.654641+03:00",
      "endDate": "2018-07-13T20:00:00+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "32138c866af04bc89790cc499745b77a"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "5cc8c1ab568b4390b5c4d3505e13fa20",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "description_en": "Cases with state awards",
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "description_ru": "футляры к государственным наградам",
        "id": "c6d02d15489f406ea4214aeec4a3d374",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "title_ru": "футляры к государственным наградам",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    }
  }
}

І знову код відповіді 201 Created, заголовок Location і тіло з додатковим id, auctionID, та властивість dateModified.

Перевіримо, що містить реєстр аукціонів:

GET /api/2.4/auctions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.4/auctions?offset=2018-07-05T15%3A44%3A43.541215%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=2018-07-05T15%3A44%3A43.541215%2B03%3A00",
    "offset": "2018-07-05T15:44:43.541215+03:00"
  },
  "data": [
    {
      "id": "bf6575a30f2c4465ae43e06981df3b5a",
      "dateModified": "2018-07-05T15:44:43.541215+03:00"
    }
  ]
}

Дійсно, в нас зараз є дві аукціони.

Модифікація аукціону

As it has been mentioned before the propertyLease procedure has a specific data structure called contractTerms.

Organizer can edit or add these optional fields for the structure after auction is created:

"taxHolidays": [
  {
      "taxHolidaysDuration": "P5M",
      "conditions": "conditions description",
      "value": {
        "amount": 100.0,
        "currency": "UAH",
        "valueAddedTaxIncluded": true
      }
  }
],
"escalationClauses": [
  {
      "escalationPeriodicity": "P5M",
      "escalationStepPercentage": 0.55,
      "conditions": "conditions description"
  }
]

Оновимо аукціон шляхом надання йому усіх інших важливих властивостей:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 75
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "tenderPeriod": {
      "endDate": "2018-07-20T15:44:53.747012+03:00"
    }
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "enquiryPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-18T20:00:00+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "owner": "broker",
    "id": "bf6575a30f2c4465ae43e06981df3b5a",
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:43.800011+03:00",
    "status": "active.tendering",
    "tenderPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-18T20:00:00+03:00"
    },
    "auctionPeriod": {
      "shouldStartAfter": "2018-07-19T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:43.531351+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-07-05T15:44:43.531351+03:00",
      "endDate": "2018-07-13T20:00:00+03:00",
      "invalidationDate": "2018-07-05T15:44:43.798279+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "2ca4bc6c445e46459bda9c85019dcd33"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "d235e459369d465da4e7771e6573239b",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

Ми бачимо, що додаткові властивості об’єднані з існуючими даними аукціону. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.

Ще одна перевірка списку відображає нову дату модифікації:

GET /api/2.4/auctions?opt_pretty=1 HTTP/1.0
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "next_page": {
    "path": "/api/2.4/auctions?offset=2018-07-05T15%3A44%3A43.718803%2B03%3A00",
    "uri": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions?offset=2018-07-05T15%3A44%3A43.718803%2B03%3A00",
    "offset": "2018-07-05T15:44:43.718803+03:00"
  },
  "data": [
    {
      "id": "bf6575a30f2c4465ae43e06981df3b5a",
      "dateModified": "2018-07-05T15:44:43.541215+03:00"
    },
    {
      "id": "995eb51dc28c4aeaa4624b658593b117",
      "dateModified": "2018-07-05T15:44:43.667419+03:00"
    },
    {
      "id": "16a15a1f4fc74bc5b37a9e2cb9669a31",
      "dateModified": "2018-07-05T15:44:43.718803+03:00"
    }
  ]
}

Пам’ятайте, що кожного разу, коли Організатор редагує аукціон, статус всіх ставок перемикається на invalid.

Після цього учасники можуть наново активувати власні ставки.

Organizer can edit a procedure only during rectificationPeriod.

Після закінчення цього періоду на спробу редагування буде повернуто помилку 403:

Завантаження документації

Замовник може завантажити PDF файл у створений аукціон. Завантаження повинно відбуватись згідно правил Завантаження документа.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 419
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "title": "Notice.pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=TdmyfoIiQi%2Bj2E%2B54IBcPh3YMjjAxnYE%2BWaiMKNKMdp%2Bl%2B2pLQ%2FXXdax9TBqMlUEU584ld3hjHRmYSQqiuKeDg%3D%3D",
    "format": "application/pdf",
    "documentType": "technicalSpecifications"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/806548dfbbbd4c64a320cd6a2493c942
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:43.962162+03:00",
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-05T15:44:43.962214+03:00",
    "id": "806548dfbbbd4c64a320cd6a2493c942"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ було створено. Додатково можна зробити запит точки входу API колекції документів, щоб підтвердити дію:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/806548dfbbbd4c64a320cd6a2493c942 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "document description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:43.962162+03:00",
    "previousVersions": [],
    "documentType": "technicalSpecifications",
    "dateModified": "2018-07-05T15:44:43.962214+03:00",
    "id": "806548dfbbbd4c64a320cd6a2493c942"
  }
}

Один елемент масиву описує завантажений документ. Ми можемо завантажити більше документів:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 336
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c62be1575beb463786d360a782b04a07?KeyID=172d32c8&Signature=laHrKHkqys3U5SL%2BkDcmHV17ZerGCFpHrnds%2FOHYIHu1UPHq855BauPd69w46aqvgmmN50wJ9cphwi9TRT3FBw%3D%3D",
    "title": "AwardCriteria.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/1ee1b150bb7c4d4197379afa2e86f40a
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c62be1575beb463786d360a782b04a07?KeyID=172d32c8&Signature=dq9l6ox%252B9bq5wtran%2FzRS74f6mVwD%252Bmw3iST96fFDO7OkbCnzDM2GeAK%2FbePequlPdkoHeILvxVjDyjauAhdCg%253D%253D",
    "title": "AwardCriteria.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.029815+03:00",
    "dateModified": "2018-07-05T15:44:44.029835+03:00",
    "id": "1ee1b150bb7c4d4197379afa2e86f40a"
  }
}

І знову можна перевірити, що є два завантажених документа.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c62be1575beb463786d360a782b04a07?KeyID=172d32c8&Signature=dq9l6ox%252B9bq5wtran%2FzRS74f6mVwD%252Bmw3iST96fFDO7OkbCnzDM2GeAK%2FbePequlPdkoHeILvxVjDyjauAhdCg%253D%253D",
      "title": "AwardCriteria.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.029835+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    }
  ]
}

Якщо сталась помилка, ми можемо ще раз завантажити документ поверх старої версії:

PUT /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/1ee1b150bb7c4d4197379afa2e86f40a?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 340
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=mUW9IV0tpvgHdF5RwppGUXfHGhmBxAXx76HSQMIbmjy0cFpgFcMdE5dIz%2B8%2BYHWO1Cz4OExhfcQiKR4qKIT%2FBA%3D%3D",
    "title": "AwardCriteria-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
    "title": "AwardCriteria-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.029815+03:00",
    "dateModified": "2018-07-05T15:44:44.085971+03:00",
    "id": "1ee1b150bb7c4d4197379afa2e86f40a"
  }
}

І ми бачимо, що вона перекриває оригінальну версію:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.085971+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    }
  ]
}

Завантаження ілюстрації

Організатор може завантажити файли з ілюстраціями у створений аукціон. Завантаження повинно відповідати правилам Завантаження документа.

In order to specify illustration display order, index field can be used (for details see Document). Since this illustration should be displayed first, it has "index": 1.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 428
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "title": "first_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=7BS8Nz2Usg5ZsX12Zd442%2BWh89B1vs6tCEc36tApSLyAv7k6xnhVWXsfQj4mIgpPdgA7Ze9CEv1ESDdYtEMOCg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/031929ac55d141b083d831f16cc9fecd
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 1,
    "hash": "md5:00000000000000000000000000000000",
    "description": "First illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
    "title": "first_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.148863+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-05T15:44:44.148896+03:00",
    "id": "031929ac55d141b083d831f16cc9fecd"
  }
}

Ми можемо перевірити, чи завантажилась ілюстрація.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.085971+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.148863+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.148896+03:00",
      "id": "031929ac55d141b083d831f16cc9fecd"
    }
  ]
}

Організатор може завантажити ще одну ілюстрацію. Ця ілюстрація повинна бути відображена другою, тому має параметр "index": 2.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 432
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "title": "second_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=n1wwvsam8m3UpY4IJQkadbUiud4rTmawTsi%2Bz6bpWJmeNclML2hDHM2vi9bpUjclY4qMGsWJ6RkLo%2FKWtDFjDg%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/dc25aac992074754a54e622b75ccf552
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Second illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=FAkPz4qiw3ChZWW53oZeSn9ukX6GzYrNI4fClQEmgJVhGyjOqjvw0rKs3zgGYAwRg%2FpOC13F%2F6vUYQw2DAhxCw%253D%253D",
    "title": "second_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.217182+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-05T15:44:44.217203+03:00",
    "id": "dc25aac992074754a54e622b75ccf552"
  }
}

Додаємо третю ілюстрацію:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 436
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "title": "third_illustration.jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=McsENObOi5%2F%2Fr4VpcyF7Le1idsJxVyhb%2By2w7h%2Bnlrqn5M0VNACab5R5sM1bJtGjY6cnoL8iM2PmC87t%2FYCzDA%3D%3D",
    "format": "image/jpeg",
    "documentType": "illustration"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/fbf05d710f3d4c19acd84b0f17017eea
X-Content-Type-Options: nosniff

{
  "data": {
    "index": 2,
    "hash": "md5:00000000000000000000000000000000",
    "description": "Third illustration description",
    "format": "image/jpeg",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=iY06XmBxdm5LarAm6R6Z8ggoBnSqJE0dzJ03C9WO70NZ7Yj9nibjk4RfdxC%2FKrvTfCD59I1mxLLXqFYCryXvDA%253D%253D",
    "title": "third_illustration.jpeg",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.264917+03:00",
    "documentType": "illustration",
    "dateModified": "2018-07-05T15:44:44.264939+03:00",
    "id": "fbf05d710f3d4c19acd84b0f17017eea"
  }
}

Зверніть увагу, що параметр index третьої ілюстрації такий же як і у другої: "index": 2. У таких випадках спочатку відображатиметься ілюстрація з ранішою датою публікації.

Можемо перевірити, що є три завантажені ілюстрації.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.085971+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.148863+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.148896+03:00",
      "id": "031929ac55d141b083d831f16cc9fecd"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=FAkPz4qiw3ChZWW53oZeSn9ukX6GzYrNI4fClQEmgJVhGyjOqjvw0rKs3zgGYAwRg%2FpOC13F%2F6vUYQw2DAhxCw%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.217182+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.217203+03:00",
      "id": "dc25aac992074754a54e622b75ccf552"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=iY06XmBxdm5LarAm6R6Z8ggoBnSqJE0dzJ03C9WO70NZ7Yj9nibjk4RfdxC%2FKrvTfCD59I1mxLLXqFYCryXvDA%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.264917+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.264939+03:00",
      "id": "fbf05d710f3d4c19acd84b0f17017eea"
    }
  ]
}

Add Asset Familiarization

Organizer can upload asset familiarization document into the created auction.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 160
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "title": "Familiarization with bank asset",
    "accessDetails": "Familiar with asset: days, time, address",
    "documentType": "x_dgfAssetFamiliarization"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents/f322908bc35041ca898fddc2f640e5d1
X-Content-Type-Options: nosniff

{
  "data": {
    "title": "Familiarization with bank asset",
    "format": "offline/on-site-examination",
    "accessDetails": "Familiar with asset: days, time, address",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.337012+03:00",
    "documentType": "x_dgfAssetFamiliarization",
    "dateModified": "2018-07-05T15:44:44.337032+03:00",
    "id": "f322908bc35041ca898fddc2f640e5d1"
  }
}

We can check whether asset familiarization document is added.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
      "title": "Notice.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:43.962162+03:00",
      "documentType": "technicalSpecifications",
      "dateModified": "2018-07-05T15:44:43.962214+03:00",
      "id": "806548dfbbbd4c64a320cd6a2493c942"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
      "title": "AwardCriteria-2.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.029815+03:00",
      "dateModified": "2018-07-05T15:44:44.085971+03:00",
      "id": "1ee1b150bb7c4d4197379afa2e86f40a"
    },
    {
      "index": 1,
      "hash": "md5:00000000000000000000000000000000",
      "description": "First illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
      "title": "first_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.148863+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.148896+03:00",
      "id": "031929ac55d141b083d831f16cc9fecd"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Second illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=FAkPz4qiw3ChZWW53oZeSn9ukX6GzYrNI4fClQEmgJVhGyjOqjvw0rKs3zgGYAwRg%2FpOC13F%2F6vUYQw2DAhxCw%253D%253D",
      "title": "second_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.217182+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.217203+03:00",
      "id": "dc25aac992074754a54e622b75ccf552"
    },
    {
      "index": 2,
      "hash": "md5:00000000000000000000000000000000",
      "description": "Third illustration description",
      "format": "image/jpeg",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=iY06XmBxdm5LarAm6R6Z8ggoBnSqJE0dzJ03C9WO70NZ7Yj9nibjk4RfdxC%2FKrvTfCD59I1mxLLXqFYCryXvDA%253D%253D",
      "title": "third_illustration.jpeg",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.264917+03:00",
      "documentType": "illustration",
      "dateModified": "2018-07-05T15:44:44.264939+03:00",
      "id": "fbf05d710f3d4c19acd84b0f17017eea"
    },
    {
      "title": "Familiarization with bank asset",
      "format": "offline/on-site-examination",
      "accessDetails": "Familiar with asset: days, time, address",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.337012+03:00",
      "documentType": "x_dgfAssetFamiliarization",
      "dateModified": "2018-07-05T15:44:44.337032+03:00",
      "id": "f322908bc35041ca898fddc2f640e5d1"
    }
  ]
}

Уточнення (питання)

Коли закупівля має статус active.tendering, зацікавлені сторони можуть задавати питання:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 1506
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions/7a8ea78f01b9408b9c4700de5409f22c
X-Content-Type-Options: nosniff

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

Організатор може на них відповісти:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions/7a8ea78f01b9408b9c4700de5409f22c?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 162
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\""
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "date": "2018-07-05T15:44:44.418932+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "7a8ea78f01b9408b9c4700de5409f22c",
    "questionOf": "tender"
  }
}

Можна отримати список запитань:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "description": "Просимо додати таблицю потрібної калорійності харчування",
      "title": "Калорійність",
      "date": "2018-07-05T15:44:44.418932+03:00",
      "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
      "id": "7a8ea78f01b9408b9c4700de5409f22c",
      "questionOf": "tender"
    }
  ]
}

або окрему відповідь:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/questions/7a8ea78f01b9408b9c4700de5409f22c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "description": "Просимо додати таблицю потрібної калорійності харчування",
    "title": "Калорійність",
    "date": "2018-07-05T15:44:44.418932+03:00",
    "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
    "id": "7a8ea78f01b9408b9c4700de5409f22c",
    "questionOf": "tender"
  }
}

Реєстрація пропозиції

Учасник може зареєструвати пропозицію у статусі draft (чернетка):

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 776
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "draft",
    "qualified": true,
    "value": {
      "amount": 500
    },
    "tenderers": [
      {
        "contactPoint": {
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "countryName": "Україна",
          "postalCode": "21100",
          "region": "м. Вінниця",
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця"
        }
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a
X-Content-Type-Options: nosniff

{
  "access": {
    "token": "3d0951140fc2460d89bb86cf5134b2a2"
  },
  "data": {
    "status": "draft",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:44.764641+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "192d6412b08e4743b9cf6d267538c72a"
  }
}

І активувати пропозицію:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a?acc_token=3d0951140fc2460d89bb86cf5134b2a2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:44.764641+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "192d6412b08e4743b9cf6d267538c72a"
  }
}

І завантажити документ пропозиції:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents?acc_token=3d0951140fc2460d89bb86cf5134b2a2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 329
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9133e028fcaa49c2a1a0a6f8ab88e680?KeyID=172d32c8&Signature=Q4dARTmLBpleWWIFhe6dJ5XBHi6c8Kvrg0Wq8RJ2s24OGHFMBz1dQp1SuswbNTBJBuozFBQN%2FX3ckDjg9NANAg%3D%3D",
    "title": "Proposal.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents/e6c52d6a2e19412a80e7f82233a891b3
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents/e6c52d6a2e19412a80e7f82233a891b3?download=9133e028fcaa49c2a1a0a6f8ab88e680",
    "title": "Proposal.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:44.918925+03:00",
    "dateModified": "2018-07-05T15:44:44.918952+03:00",
    "id": "e6c52d6a2e19412a80e7f82233a891b3"
  }
}

Можна перевірити завантажені документи:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents?acc_token=3d0951140fc2460d89bb86cf5134b2a2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/pdf",
      "url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents/e6c52d6a2e19412a80e7f82233a891b3?download=9133e028fcaa49c2a1a0a6f8ab88e680",
      "title": "Proposal.pdf",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:44.918925+03:00",
      "dateModified": "2018-07-05T15:44:44.918952+03:00",
      "id": "e6c52d6a2e19412a80e7f82233a891b3"
    }
  ]
}

Для найкращого результату (найбільшої економії) аукціон повинен мати багато зареєстрованих учасників.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 723
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "qualified": true,
    "value": {
      "amount": 501
    },
    "tenderers": [
      {
        "contactPoint": {
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "countryName": "Україна",
          "postalCode": "79013",
          "region": "м. Львів",
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів"
        }
      }
    ]
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/19d92b47538f4bcfb7d087eaabb84afa
X-Content-Type-Options: nosniff

{
  "access": {
    "token": "beb5b717e1644629b197f91fc2473d2a"
  },
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:45.018848+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "owner": "broker",
    "id": "19d92b47538f4bcfb7d087eaabb84afa"
  }
}

Аукціон

Після того, як аукціон заплановано, будь-хто може його відвідати для перегляду. Аукціон можна подивитись за допомогою Auction.auctionUrl:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "procurementMethod": "open",
    "auctionID": "UA-EA-2018-07-05-000001",
    "auctionUrl": "http://auction-sandbox.openprocurement.org/auctions/bf6575a30f2c4465ae43e06981df3b5a",
    "enquiryPeriod": {
      "startDate": "2018-06-28T15:44:36.881991+03:00",
      "endDate": "2018-07-05T15:44:36.881991+03:00"
    },
    "submissionMethod": "electronicAuction",
    "next_check": "2018-07-05T16:28:36.881991+03:00",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "0440000000"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "uri": "http://www.dus.gov.ua/"
      },
      "name": "Державне управління справами",
      "address": {
        "postalCode": "01220",
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "region": "м. Київ",
        "locality": "м. Київ"
      }
    },
    "questions": [
      {
        "description": "Просимо додати таблицю потрібної калорійності харчування",
        "title": "Калорійність",
        "date": "2018-07-05T15:44:44.418932+03:00",
        "answer": "Таблицю додано в файлі \"Kalorijnist.xslx\"",
        "id": "7a8ea78f01b9408b9c4700de5409f22c",
        "questionOf": "tender"
      }
    ],
    "owner": "broker",
    "id": "bf6575a30f2c4465ae43e06981df3b5a",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "document description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1ce52fd03573440ba6b1731c6c9cecea?KeyID=172d32c8&Signature=XDud%252BUyeXQuy9iOTIwWE5%2FBSWPmsPRKjG4XveLWCa1z%252B4JJKJDzTSOGkFVRpqZzb66rODALSr36dEGC%2F1qsXAQ%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:43.962162+03:00",
        "documentType": "technicalSpecifications",
        "dateModified": "2018-07-05T15:44:43.962214+03:00",
        "id": "806548dfbbbd4c64a320cd6a2493c942"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c62be1575beb463786d360a782b04a07?KeyID=172d32c8&Signature=dq9l6ox%252B9bq5wtran%2FzRS74f6mVwD%252Bmw3iST96fFDO7OkbCnzDM2GeAK%2FbePequlPdkoHeILvxVjDyjauAhdCg%253D%253D",
        "title": "AwardCriteria.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.029815+03:00",
        "dateModified": "2018-07-05T15:44:44.029835+03:00",
        "id": "1ee1b150bb7c4d4197379afa2e86f40a"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/2bb32e6b501c48f29534ca6f1629ab98?KeyID=172d32c8&Signature=MQp%2F0yv3CvwcJgO7%2F1SbsWjgCBayJX7KKJn3xcScfae%252B3iWRPtoum0egzO7KQ5bWCI%252BN3DyYsVMs%2FiFdhiKtBg%253D%253D",
        "title": "AwardCriteria-2.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.029815+03:00",
        "dateModified": "2018-07-05T15:44:44.085971+03:00",
        "id": "1ee1b150bb7c4d4197379afa2e86f40a"
      },
      {
        "index": 1,
        "hash": "md5:00000000000000000000000000000000",
        "description": "First illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/526d91d33db34ca4b233b5855c6c22dd?KeyID=172d32c8&Signature=xuvepRcqmKQPNLtNMz1cmYOE8GiU%252Bf5Eh7Ams09PmLwV3CKbOWuxOxelmmExxWtkYWrdpfF70RJv8b1ltcIzAw%253D%253D",
        "title": "first_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.148863+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-05T15:44:44.148896+03:00",
        "id": "031929ac55d141b083d831f16cc9fecd"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Second illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/a1cbeaa2c76140f8b37f0af516a23560?KeyID=172d32c8&Signature=FAkPz4qiw3ChZWW53oZeSn9ukX6GzYrNI4fClQEmgJVhGyjOqjvw0rKs3zgGYAwRg%2FpOC13F%2F6vUYQw2DAhxCw%253D%253D",
        "title": "second_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.217182+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-05T15:44:44.217203+03:00",
        "id": "dc25aac992074754a54e622b75ccf552"
      },
      {
        "index": 2,
        "hash": "md5:00000000000000000000000000000000",
        "description": "Third illustration description",
        "format": "image/jpeg",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/7a1640d5df0448cb9042c1410430a809?KeyID=172d32c8&Signature=iY06XmBxdm5LarAm6R6Z8ggoBnSqJE0dzJ03C9WO70NZ7Yj9nibjk4RfdxC%2FKrvTfCD59I1mxLLXqFYCryXvDA%253D%253D",
        "title": "third_illustration.jpeg",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.264917+03:00",
        "documentType": "illustration",
        "dateModified": "2018-07-05T15:44:44.264939+03:00",
        "id": "fbf05d710f3d4c19acd84b0f17017eea"
      },
      {
        "title": "Familiarization with bank asset",
        "format": "offline/on-site-examination",
        "accessDetails": "Familiar with asset: days, time, address",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.337012+03:00",
        "documentType": "x_dgfAssetFamiliarization",
        "dateModified": "2018-07-05T15:44:44.337032+03:00",
        "id": "f322908bc35041ca898fddc2f640e5d1"
      }
    ],
    "title": "футляри до державних нагород",
    "tenderAttempts": 1,
    "dateModified": "2018-07-05T15:44:45.260150+03:00",
    "status": "active.auction",
    "tenderPeriod": {
      "startDate": "2018-06-28T15:44:36.881991+03:00",
      "endDate": "2018-07-05T15:44:36.881991+03:00"
    },
    "auctionPeriod": {
      "startDate": "2018-07-05T15:44:36.881991+03:00",
      "shouldStartAfter": "2018-07-06T00:00:00+03:00"
    },
    "procurementMethodType": "propertyLease",
    "date": "2018-07-05T15:44:43.531351+03:00",
    "lotIdentifier": "219560",
    "rectificationPeriod": {
      "startDate": "2018-06-28T15:44:36.881991+03:00",
      "endDate": "2018-06-29T15:44:36.881991+03:00",
      "invalidationDate": "2018-07-05T15:44:44.337161+03:00"
    },
    "contractTerms": {
      "type": "lease",
      "leaseTerms": {
        "escalationClauses": [
          {
            "escalationPeriodicity": "P5M",
            "conditions": "conditions description",
            "escalationStepPercentage": 0.1,
            "id": "2ca4bc6c445e46459bda9c85019dcd33"
          }
        ],
        "leaseDuration": "P10Y",
        "taxHolidays": [
          {
            "taxHolidaysDuration": "P5M",
            "conditions": "conditions description",
            "id": "d235e459369d465da4e7771e6573239b",
            "value": {
              "currency": "UAH",
              "amount": 100.0,
              "valueAddedTaxIncluded": true
            }
          }
        ]
      }
    },
    "minimalStep": {
      "currency": "UAH",
      "amount": 35.0,
      "valueAddedTaxIncluded": true
    },
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 100.0,
      "valueAddedTaxIncluded": true
    },
    "awardCriteria": "highestCost"
  }
}

Учасники можуть дізнатись свої URL-адреси для участі через свої пропозиції:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a?acc_token=3d0951140fc2460d89bb86cf5134b2a2 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/192d6412b08e4743b9cf6d267538c72a/documents/e6c52d6a2e19412a80e7f82233a891b3?download=9133e028fcaa49c2a1a0a6f8ab88e680",
        "title": "Proposal.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:44.918925+03:00",
        "dateModified": "2018-07-05T15:44:44.918952+03:00",
        "id": "e6c52d6a2e19412a80e7f82233a891b3"
      }
    ],
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:44.764641+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "owner": "broker",
    "id": "192d6412b08e4743b9cf6d267538c72a",
    "participationUrl": "http://auction-sandbox.openprocurement.org/auctions/bf6575a30f2c4465ae43e06981df3b5a?key_for_bid=192d6412b08e4743b9cf6d267538c72a"
  }
}

Дивіться на Bid.participationUrl у відповіді. Схожу, але іншу, URL-адресу можна отримати для інших учасників.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/bids/19d92b47538f4bcfb7d087eaabb84afa?acc_token=beb5b717e1644629b197f91fc2473d2a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:45.018848+03:00",
    "qualified": true,
    "tenderers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "owner": "broker",
    "id": "19d92b47538f4bcfb7d087eaabb84afa",
    "participationUrl": "http://auction-sandbox.openprocurement.org/auctions/bf6575a30f2c4465ae43e06981df3b5a?key_for_bid=19d92b47538f4bcfb7d087eaabb84afa"
  }
}

Кваліфікація

Після аукціону створюються awards:
  • перший кандидат (учасник, який поставив найвищу ставку на аукціоні) - спочатку перебуває у статусі pending.verification і очікує, поки Організатор завантажить протокол аукціону.

  • інші кандидати.

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "status": "pending.verification",
      "paymentPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00",
        "endDate": "2018-08-02T18:00:00.557459+03:00"
      },
      "verificationPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00",
        "endDate": "2018-07-13T18:00:00.557459+03:00"
      },
      "signingPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00",
        "endDate": "2018-08-02T18:00:00.557459+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "aagt@gmail.com",
            "telephone": "+380 (322) 91-69-30",
            "name": "Андрій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137226",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Книга»",
          "address": {
            "postalCode": "79013",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 34",
            "region": "м. Львів",
            "locality": "м. Львів"
          }
        }
      ],
      "complaintPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00"
      },
      "bid_id": "19d92b47538f4bcfb7d087eaabb84afa",
      "value": {
        "currency": "UAH",
        "amount": 501.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2018-07-05T15:44:45.557459+03:00",
      "id": "c525bd6997924149a071ab0d845875f0"
    },
    {
      "status": "pending.waiting",
      "complaintPeriod": {
        "startDate": "2018-07-05T15:44:45.557459+03:00"
      },
      "suppliers": [
        {
          "contactPoint": {
            "email": "soleksuk@gmail.com",
            "telephone": "+380 (432) 21-69-30",
            "name": "Сергій Олексюк"
          },
          "identifier": {
            "scheme": "UA-EDR",
            "id": "00137256",
            "uri": "http://www.sc.gov.ua/"
          },
          "name": "ДКП «Школяр»",
          "address": {
            "postalCode": "21100",
            "countryName": "Україна",
            "streetAddress": "вул. Островського, 33",
            "region": "м. Вінниця",
            "locality": "м. Вінниця"
          }
        }
      ],
      "bid_id": "192d6412b08e4743b9cf6d267538c72a",
      "value": {
        "currency": "UAH",
        "amount": 500.0,
        "valueAddedTaxIncluded": true
      },
      "date": "2018-07-05T15:44:45.557459+03:00",
      "id": "94df6a7fba0e49749ed3009cf0d1feae"
    }
  ]
}

Підтвердження кваліфікації

Організатор має завантажити та підтвердити протокол аукціону auctionProtocol і додати його в award протягом 6 робочих днів після початку періоду кваліфікації. Кандидат має можливість завантажити протокол, але це є необов’язковим і недостатнім для переходу в наступний статус. Для того, щоб перевести award в наступний статус, Організатор має змінити його вручну.

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0/documents?acc_token=beb5b717e1644629b197f91fc2473d2a HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 381
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/634b8812abec4bed88f99fae0b19e0ed?KeyID=172d32c8&Signature=9LMgK3YF%2FnTHNIZGC%2BdtMshvNq86dJ5RFSX1avQ9JshoQaivycbp1mfmzjpInHaG4j%2BkgktNOZHvicqnBBKrBg%3D%3D",
    "title": "SignedAuctionProtocol.pdf",
    "format": "application/pdf",
    "hash": "md5:00000000000000000000000000000000",
    "documentType": "auctionProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0/documents/045ca245f33740a7a0e0d3cea8dc7b4e
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "bid_owner",
    "title": "SignedAuctionProtocol.pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/634b8812abec4bed88f99fae0b19e0ed?KeyID=172d32c8&Signature=AM16nchbBzt03Ga62R68itoWzRR1XZean6QW6kjlgzA7kwBza3Nm%252BfNpS0P%252BgyngKTjIu5Rq3KE7jjhkYiaWCQ%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:46.033757+03:00",
    "documentType": "auctionProtocol",
    "dateModified": "2018-07-05T15:44:46.033778+03:00",
    "id": "045ca245f33740a7a0e0d3cea8dc7b4e"
  }
}
POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 383
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/87da15a07f5e4809a4b4a2ab9c16bae1?KeyID=172d32c8&Signature=K%2BU2mnmfTeZYdv2HODx3bhN6l7o%2FPtK1qBhl742tiTFXpp42l%2BeP8yg37kxBDgZ3jAqhCWQIPgfS%2BfHwK5ZYCQ%3D%3D",
    "title": "SignedAuctionProtocol.pdf",
    "format": "application/pdf",
    "hash": "md5:00000000000000000000000000000000",
    "documentType": "auctionProtocol"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0/documents/850eff6be8de4f70922aa99415eec581
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "author": "auction_owner",
    "title": "SignedAuctionProtocol.pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/87da15a07f5e4809a4b4a2ab9c16bae1?KeyID=172d32c8&Signature=12lOdsrwdSYqiYe%252BaDBYs444ZR61xmz2cuUwu6T6zEOWS3cBWSbgY%2FqEy5dlgw7PVR9npNInMuvdgSucfh8%252BDA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:46.170042+03:00",
    "documentType": "auctionProtocol",
    "dateModified": "2018-07-05T15:44:46.170096+03:00",
    "id": "850eff6be8de4f70922aa99415eec581"
  }
}

Обов’язком Організатора є завантаження та затвердження протоколу при тому, що award не перейде в статус ‘pending.payment’ автоматично.

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 39
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "pending.payment"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "pending.payment",
    "paymentPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-08-02T18:00:00.557459+03:00"
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "bid_owner",
        "title": "SignedAuctionProtocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/634b8812abec4bed88f99fae0b19e0ed?KeyID=172d32c8&Signature=AM16nchbBzt03Ga62R68itoWzRR1XZean6QW6kjlgzA7kwBza3Nm%252BfNpS0P%252BgyngKTjIu5Rq3KE7jjhkYiaWCQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.033757+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-05T15:44:46.033778+03:00",
        "id": "045ca245f33740a7a0e0d3cea8dc7b4e"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "auction_owner",
        "title": "SignedAuctionProtocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/87da15a07f5e4809a4b4a2ab9c16bae1?KeyID=172d32c8&Signature=12lOdsrwdSYqiYe%252BaDBYs444ZR61xmz2cuUwu6T6zEOWS3cBWSbgY%2FqEy5dlgw7PVR9npNInMuvdgSucfh8%252BDA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.170042+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-05T15:44:46.170096+03:00",
        "id": "850eff6be8de4f70922aa99415eec581"
      }
    ],
    "verificationPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-07-05T15:44:46.310338+03:00"
    },
    "complaintPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "signingPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-08-02T18:00:00.557459+03:00"
    },
    "bid_id": "19d92b47538f4bcfb7d087eaabb84afa",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:46.317584+03:00",
    "id": "c525bd6997924149a071ab0d845875f0"
  }
}

Протягом 20 робочих днів після оголошення учасника кандидатом він/вона має провести оплату й Організатор має підтвердити оплату. Коли платіж отримано, Організатор може перевести award в статус active, але ця дія не є обов’язковою.

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/awards/c525bd6997924149a071ab0d845875f0?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "paymentPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-07-05T15:44:46.426889+03:00"
    },
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "bid_owner",
        "title": "SignedAuctionProtocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/634b8812abec4bed88f99fae0b19e0ed?KeyID=172d32c8&Signature=AM16nchbBzt03Ga62R68itoWzRR1XZean6QW6kjlgzA7kwBza3Nm%252BfNpS0P%252BgyngKTjIu5Rq3KE7jjhkYiaWCQ%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.033757+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-05T15:44:46.033778+03:00",
        "id": "045ca245f33740a7a0e0d3cea8dc7b4e"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "author": "auction_owner",
        "title": "SignedAuctionProtocol.pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/87da15a07f5e4809a4b4a2ab9c16bae1?KeyID=172d32c8&Signature=12lOdsrwdSYqiYe%252BaDBYs444ZR61xmz2cuUwu6T6zEOWS3cBWSbgY%2FqEy5dlgw7PVR9npNInMuvdgSucfh8%252BDA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.170042+03:00",
        "documentType": "auctionProtocol",
        "dateModified": "2018-07-05T15:44:46.170096+03:00",
        "id": "850eff6be8de4f70922aa99415eec581"
      }
    ],
    "verificationPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-07-05T15:44:46.310338+03:00"
    },
    "complaintPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-07-05T15:44:46.426889+03:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "signingPeriod": {
      "startDate": "2018-07-05T15:44:45.557459+03:00",
      "endDate": "2018-08-02T18:00:00.557459+03:00"
    },
    "bid_id": "19d92b47538f4bcfb7d087eaabb84afa",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:46.433858+03:00",
    "id": "c525bd6997924149a071ab0d845875f0"
  }
}

Дискваліфікація кандидата

У випадаку ручної дискваліфікації, Організатор має завантажити документ з причинами:

POST /api/2.3/auctions/9ccb1169681a4b9a814a70faa17b1d96/awards/d8337e5253024539ad07414008d58913/documents?acc_token=ebb7d8c3a9bb49628b630721b2ff2fee HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 386
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b4b306e1106b4bfa9c94727106b0bf6e?KeyID=abd28e21&Signature=ri55p6U9BbZIaDsRALjXGihRUGfb7%2BDQJPiv7GjLpfOQRqR2xUQ%2B3gYD8sgnQGJXevhGM6B877t0lFe%2BuqZXDw%3D%3D",
    "title": "Disqualified_reason.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "description": "Disqualification reason",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/9ccb1169681a4b9a814a70faa17b1d96/awards/d8337e5253024539ad07414008d58913/documents/79ac5290dfb94bd0bedeebbf92201e14

{
  "data": {
    "dateModified": "2017-11-30T16:56:22.626178+02:00",
    "hash": "md5:00000000000000000000000000000000",
    "description": "Disqualification reason",
    "author": "auction_owner",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b4b306e1106b4bfa9c94727106b0bf6e?KeyID=abd28e21&Signature=KwbVPZXVni%252B%2FUN0hhgWEjKSV8ZFB4hmlD%252BfYQrN7Iwd6WEv7elzrwbEzDIV97WLu%252BNJPOKJgmFrN1Gpkrx6xDA%253D%253D",
    "format": "application/pdf",
    "documentOf": "tender",
    "datePublished": "2017-11-30T16:56:22.626152+02:00",
    "title": "Disqualified_reason.pdf",
    "id": "79ac5290dfb94bd0bedeebbf92201e14"
  }
}

Та дискваліфікувати кандидата:

PATCH /api/2.3/auctions/9ccb1169681a4b9a814a70faa17b1d96/awards/d8337e5253024539ad07414008d58913?acc_token=ebb7d8c3a9bb49628b630721b2ff2fee HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 146
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "unsuccessful",
    "description": "Candidate didn’t sign the auction protocol in 3 business days",
    "title": "Disqualified"
  }
}


200 OK
Content-Type: application/json; charset=UTF-8
Location: http://api-sandbox.ea.openprocurement.org/api/2.3/auctions/9ccb1169681a4b9a814a70faa17b1d96/awards/00fb536c33254038ae8034d3e10a6ee8

{
  "data": {
    "status": "unsuccessful",
    "paymentPeriod": {
      "startDate": "2017-11-30T16:56:22.318120+02:00",
      "endDate": "2017-11-30T16:56:22.787355+02:00"
    },
    "documents": [
      {
        "dateModified": "2017-11-30T16:56:22.492463+02:00",
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/c93c3c57873e4c39b205730e7168c9a7?KeyID=abd28e21&Signature=h5sEpdO0WwgNvLznoP73EevycNuLkysJ5fCrl5di6ZItM2rmLGrMYQSN6Lxu%252BdT9VNI1SXrim1MLa9%2F050blAw%253D%253D",
        "author": "bid_owner",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:22.492435+02:00",
        "documentType": "auctionProtocol",
        "title": "auction_protocol.pdf",
        "id": "4fee5118ccf84458833fb9f9bcc0e09e"
      },
      {
        "dateModified": "2017-11-30T16:56:22.626178+02:00",
        "hash": "md5:00000000000000000000000000000000",
        "description": "Disqualification reason",
        "author": "auction_owner",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/b4b306e1106b4bfa9c94727106b0bf6e?KeyID=abd28e21&Signature=KwbVPZXVni%252B%2FUN0hhgWEjKSV8ZFB4hmlD%252BfYQrN7Iwd6WEv7elzrwbEzDIV97WLu%252BNJPOKJgmFrN1Gpkrx6xDA%253D%253D",
        "format": "application/pdf",
        "documentOf": "tender",
        "datePublished": "2017-11-30T16:56:22.626152+02:00",
        "title": "Disqualified_reason.pdf",
        "id": "79ac5290dfb94bd0bedeebbf92201e14"
      }
    ],
    "verificationPeriod": {
      "startDate": "2017-11-30T16:56:22.318120+02:00",
      "endDate": "2017-11-30T16:56:22.787355+02:00"
    },
    "description": "Candidate didn’t sign the auction protocol in 3 business days",
    "title": "Disqualified",
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "complaintPeriod": {
      "startDate": "2017-11-30T16:56:21.878582+02:00",
      "endDate": "2017-11-30T16:56:22.787355+02:00"
    },
    "bid_id": "0bf6b005db2a4069898facc0892d3701",
    "value": {
      "currency": "UAH",
      "amount": 475.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:22.796624+02:00",
    "id": "d8337e5253024539ad07414008d58913",
    "signingPeriod": {
      "startDate": "2017-11-30T16:56:22.318120+02:00",
      "endDate": "2017-11-30T16:56:22.787355+02:00"
    }
  }
}

Через 20 робочих днів після того, як став кандидатом, новий кандидат має підтвердити кваліфікацію за допомогою кроків, описаних вище (Кваліфікація).

Відмова очікування іншого учасника

Решта кандидатів можуть відомовитись чекати на дискваліфікацію першого кандидата:

PATCH /api/2.3/auctions/301d66e275cb4861ba502c1eaafa88ae/awards/14f4c1774be847098f247565c4871574?acc_token=a94a2b6627aa46f3bbb83ff885e3beae HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 33
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": {
    "status": "cancelled",
    "complaintPeriod": {
      "startDate": "2017-11-30T16:56:27.695166+02:00",
      "endDate": "2017-11-30T16:56:27.920508+02:00"
    },
    "suppliers": [
      {
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "telephone": "+380 (432) 21-69-30",
          "name": "Сергій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "address": {
          "postalCode": "21100",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 33",
          "region": "м. Вінниця",
          "locality": "м. Вінниця"
        }
      }
    ],
    "bid_id": "afaa508128da4829b9202fe300965bf4",
    "value": {
      "currency": "UAH",
      "amount": 500.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2017-11-30T16:56:27.927179+02:00",
    "id": "14f4c1774be847098f247565c4871574"
  }
}

Підписання угоди

The candidate has 20 business days after becoming a candidate to conclude a contract with the bank based on the results of electronic auction. When the organizer confirms that the payment has been received, the award may be switched to the active status, while the procedure moves to the status signingPeriod. Within this stage the organizer should upload and activate the contract in the system.

Завантаження документів щодо укладання угоди

Спробуємо завантажити документ пов’язаний з угодою:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 351
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=4CcD6OI2rjqfEBygj%2BOhQTtr5TX4kFEtbM7W7Aq0LHcKfRU2DlBffBtG%2BsmrmBWC2SJosEt1dlExN%2BuzX5lwAg%3D%3D",
    "title": "contract_first_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents/962a2dccfd3248178dba9a291dfae225
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=d4SD5yjKKpZpExDc%2Fngc5rgeUSnIs1YOHk1gBD%2F0ndHMuBDR5t0PKoezrR7km0HjeOBcStVCrTJsOUoxoAerDA%253D%253D",
    "title": "contract_first_document.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:46.883617+03:00",
    "dateModified": "2018-07-05T15:44:46.883639+03:00",
    "id": "962a2dccfd3248178dba9a291dfae225"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що документ додано.

Переглянемо список завантажених документів:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=d4SD5yjKKpZpExDc%2Fngc5rgeUSnIs1YOHk1gBD%2F0ndHMuBDR5t0PKoezrR7km0HjeOBcStVCrTJsOUoxoAerDA%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:46.883617+03:00",
      "dateModified": "2018-07-05T15:44:46.883639+03:00",
      "id": "962a2dccfd3248178dba9a291dfae225"
    }
  ]
}

Тепер спробуємо додати ще один документ щодо укладанням угоди:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 352
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/969aa13f4a1c435ab43c7b427af92ab3?KeyID=172d32c8&Signature=Fm5eXcIK3Pn6%2F5o7xtk%2Fb67sfaVNXUYwZQ5KwoxsPbZMzFUOPC0x1Kp5%2FcLbk5YIfoAD5oCUDUgb81x6HvpgDg%3D%3D",
    "title": "contract_second_document.doc",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents/7ddd64f00176447f9efe57751f7361fe
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/msword",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/969aa13f4a1c435ab43c7b427af92ab3?KeyID=172d32c8&Signature=0iJX1gukI8TnCgWs%2FyLb%2FB%2F7%252BKDkJPwE0sJP7On10lxJ4oMN0jcmu7yPIVq1PhTZzNOyjOmgB24pfQnDjtT9CQ%253D%253D",
    "title": "contract_second_document.doc",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:47.054363+03:00",
    "dateModified": "2018-07-05T15:44:47.054390+03:00",
    "id": "7ddd64f00176447f9efe57751f7361fe"
  }
}

Код відповіді 201 Created та заголовок Location підтверджують, що ще один документ було додано.

Тепер переглянемо знову усі документи пов’язані із укладанням угоди:

GET /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.ea.openprocurement.org


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=d4SD5yjKKpZpExDc%2Fngc5rgeUSnIs1YOHk1gBD%2F0ndHMuBDR5t0PKoezrR7km0HjeOBcStVCrTJsOUoxoAerDA%253D%253D",
      "title": "contract_first_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:46.883617+03:00",
      "dateModified": "2018-07-05T15:44:46.883639+03:00",
      "id": "962a2dccfd3248178dba9a291dfae225"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "format": "application/msword",
      "url": "http://public.docs-sandbox.ea.openprocurement.org/get/969aa13f4a1c435ab43c7b427af92ab3?KeyID=172d32c8&Signature=0iJX1gukI8TnCgWs%2FyLb%2FB%2F7%252BKDkJPwE0sJP7On10lxJ4oMN0jcmu7yPIVq1PhTZzNOyjOmgB24pfQnDjtT9CQ%253D%253D",
      "title": "contract_second_document.doc",
      "documentOf": "tender",
      "datePublished": "2018-07-05T15:44:47.054363+03:00",
      "dateModified": "2018-07-05T15:44:47.054390+03:00",
      "id": "7ddd64f00176447f9efe57751f7361fe"
    }
  ]
}

Реєстрація угоди

Є можливість встановити дату підписання договору. Якщо дата не встановлена, то вона буде згенерована під час реєстрації угоди. Ви можете зареєструвати угоду:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/contracts/bf54ce84c6e6418382f49614f55d0101?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 80
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "status": "active",
    "dateSigned": "2018-07-05T15:44:47.244215+03:00"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/9b917efd600c445fad8457fd30f5cc5b?KeyID=172d32c8&Signature=d4SD5yjKKpZpExDc%2Fngc5rgeUSnIs1YOHk1gBD%2F0ndHMuBDR5t0PKoezrR7km0HjeOBcStVCrTJsOUoxoAerDA%253D%253D",
        "title": "contract_first_document.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:46.883617+03:00",
        "dateModified": "2018-07-05T15:44:46.883639+03:00",
        "id": "962a2dccfd3248178dba9a291dfae225"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "format": "application/msword",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/969aa13f4a1c435ab43c7b427af92ab3?KeyID=172d32c8&Signature=0iJX1gukI8TnCgWs%2FyLb%2FB%2F7%252BKDkJPwE0sJP7On10lxJ4oMN0jcmu7yPIVq1PhTZzNOyjOmgB24pfQnDjtT9CQ%253D%253D",
        "title": "contract_second_document.doc",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:47.054363+03:00",
        "dateModified": "2018-07-05T15:44:47.054390+03:00",
        "id": "7ddd64f00176447f9efe57751f7361fe"
      }
    ],
    "items": [
      {
        "description": "Земля для військовослужбовців",
        "classification": {
          "scheme": "CAV-PS",
          "description": "Земельні ділянки",
          "id": "04121000-2"
        },
        "additionalClassifications": [
          {
            "scheme": "CPVS",
            "id": "PA01-7",
            "description": "This field is required."
          }
        ],
        "address": {
          "postalCode": "79000",
          "countryName": "Україна",
          "streetAddress": "вул. Банкова 1",
          "region": "м. Київ",
          "locality": "м. Київ"
        },
        "quantity": 5.001,
        "id": "34d79ae5dcdb4eb4b61dba5d6a4000d7",
        "unit": {
          "code": "44617100-9",
          "name": "item"
        },
        "contractPeriod": {
          "startDate": "2018-07-07T15:44:36.881991+03:00",
          "endDate": "2018-07-10T15:44:36.881991+03:00"
        }
      }
    ],
    "suppliers": [
      {
        "contactPoint": {
          "email": "aagt@gmail.com",
          "telephone": "+380 (322) 91-69-30",
          "name": "Андрій Олексюк"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "address": {
          "postalCode": "79013",
          "countryName": "Україна",
          "streetAddress": "вул. Островського, 34",
          "region": "м. Львів",
          "locality": "м. Львів"
        }
      }
    ],
    "period": {
      "startDate": "2018-07-05T15:44:37.150620+03:00",
      "endDate": "2019-07-05T15:44:37.150620+03:00"
    },
    "dateSigned": "2018-07-05T15:44:47.244215+03:00",
    "value": {
      "currency": "UAH",
      "amount": 501.0,
      "valueAddedTaxIncluded": true
    },
    "date": "2018-07-05T15:44:47.325639+03:00",
    "awardID": "c525bd6997924149a071ab0d845875f0",
    "id": "bf54ce84c6e6418382f49614f55d0101",
    "contractID": "UA-EA-2018-07-05-000001-1"
  }
}

Скасування закупівлі

Організатор може скасувати аукціон будь-коли (крім тих випадків, коли аукціон перебуває в термінальному статусі, наприклад, unsuccesfull, canceled, complete).

Для цього потрібно виконати наступні кроки:

  1. Приготуйте запит на скасування.

  2. Наповніть його протоколом про причини скасування.

  3. Скасуйте закупівлю через подані причини

Запит на скасування, який не пройшов активації (3-й крок), не матиме сили, тобто, для скасування закупівлі буде обов’язковим не тільки створити заявку, але і активувати її.

Див. структуру запиту Cancellation для більш детальної інформації.

Формування запиту на скасування

Ви повинні передати змінні reason, status у стані pending. id генерується автоматично і повертається у додатковому заголовку відповіді Location:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 43
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e
X-Content-Type-Options: nosniff

{
  "data": {
    "date": "2018-07-05T15:44:47.497188+03:00",
    "status": "pending",
    "reason": "cancellation reason",
    "cancellationOf": "tender",
    "id": "85e3350a80ab47548c6933c01fe8b85e"
  }
}

Наповнення протоколом та іншою супровідною документацією

Завантаження вмісту файлу:

POST /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e/documents?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 333
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/ff97e1247a614c048b4fb5527ea5b9f1?KeyID=172d32c8&Signature=ttHuFDrv1a%2BAJElzbJM3%2FWjwTf0GnmMZ9GJCsjtZLT%2BOimzTmi0duq%2BcJdsRM0T91kxSEo2yk2DF70hl6WuJAw%3D%3D",
    "title": "Notice.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


201 Created
Content-Type: application/json
Location: http://api-sandbox.ea.openprocurement.org/api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e/documents/c4eb9970b6694811bb16c782ca84b967
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/ff97e1247a614c048b4fb5527ea5b9f1?KeyID=172d32c8&Signature=YkZ8ZOqiheBFefmKSj56cJdeq7CD4OaAzCaSiQn13dny%2FeYiS9ls2WqVvIX5qAV4DUgoej8pUUr5oI4L8DD8Cw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:47.635718+03:00",
    "dateModified": "2018-07-05T15:44:47.635740+03:00",
    "id": "c4eb9970b6694811bb16c782ca84b967"
  }
}

Зміна опису документа та інших властивостей:

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e/documents/c4eb9970b6694811bb16c782ca84b967?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 48
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "description": "Changed description"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/ff97e1247a614c048b4fb5527ea5b9f1?KeyID=172d32c8&Signature=YkZ8ZOqiheBFefmKSj56cJdeq7CD4OaAzCaSiQn13dny%2FeYiS9ls2WqVvIX5qAV4DUgoej8pUUr5oI4L8DD8Cw%253D%253D",
    "title": "Notice.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:47.635718+03:00",
    "dateModified": "2018-07-05T15:44:47.635740+03:00",
    "id": "c4eb9970b6694811bb16c782ca84b967"
  }
}

Завантаження нової версії документа:

PUT /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e/documents/c4eb9970b6694811bb16c782ca84b967?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 331
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

{
  "data": {
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a9c682c7a1247409b01e5df7baa67e6?KeyID=172d32c8&Signature=GKgfs1Zu%2BpJm4hfO83c21wmQAvJo5mpcat7769QW1ZCddLq8MtAuqogldtj8P%2F0YubAilfzrvvwVUfjSCuGLBA%3D%3D",
    "title": "Notice-2.pdf",
    "hash": "md5:00000000000000000000000000000000",
    "format": "application/pdf"
  }
}


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "hash": "md5:00000000000000000000000000000000",
    "description": "Changed description",
    "format": "application/pdf",
    "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a9c682c7a1247409b01e5df7baa67e6?KeyID=172d32c8&Signature=QMKBUG9URxfQnxjPVz00I7zJwZljZ2HV%2F5hh9uYg4cg7kmVCpvWKIQ%252Bf1bPSuVgzflIci5Z93BnbFGI7jXVhAg%253D%253D",
    "title": "Notice-2.pdf",
    "documentOf": "tender",
    "datePublished": "2018-07-05T15:44:47.635718+03:00",
    "dateModified": "2018-07-05T15:44:47.965256+03:00",
    "id": "c4eb9970b6694811bb16c782ca84b967"
  }
}

Активація запиту та скасування аукціону

PATCH /api/2.4/auctions/bf6575a30f2c4465ae43e06981df3b5a/cancellations/85e3350a80ab47548c6933c01fe8b85e?acc_token=686740317fd249638e3ee0420d268ebf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 30
Content-Type: application/json
Host: api-sandbox.ea.openprocurement.org

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


200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff

{
  "data": {
    "status": "active",
    "documents": [
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/ff97e1247a614c048b4fb5527ea5b9f1?KeyID=172d32c8&Signature=YkZ8ZOqiheBFefmKSj56cJdeq7CD4OaAzCaSiQn13dny%2FeYiS9ls2WqVvIX5qAV4DUgoej8pUUr5oI4L8DD8Cw%253D%253D",
        "title": "Notice.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:47.635718+03:00",
        "dateModified": "2018-07-05T15:44:47.635740+03:00",
        "id": "c4eb9970b6694811bb16c782ca84b967"
      },
      {
        "hash": "md5:00000000000000000000000000000000",
        "description": "Changed description",
        "format": "application/pdf",
        "url": "http://public.docs-sandbox.ea.openprocurement.org/get/1a9c682c7a1247409b01e5df7baa67e6?KeyID=172d32c8&Signature=QMKBUG9URxfQnxjPVz00I7zJwZljZ2HV%2F5hh9uYg4cg7kmVCpvWKIQ%252Bf1bPSuVgzflIci5Z93BnbFGI7jXVhAg%253D%253D",
        "title": "Notice-2.pdf",
        "documentOf": "tender",
        "datePublished": "2018-07-05T15:44:47.635718+03:00",
        "dateModified": "2018-07-05T15:44:47.965256+03:00",
        "id": "c4eb9970b6694811bb16c782ca84b967"
      }
    ],
    "reason": "cancellation reason",
    "date": "2018-07-05T15:44:48.136682+03:00",
    "cancellationOf": "tender",
    "id": "85e3350a80ab47548c6933c01fe8b85e"
  }
}