Туторіал¶
Базові правила¶
Подивимось як працює точка входу claimRights:
GET /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/0.1/assets?offset=",
"uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets?offset=",
"offset": ""
},
"data": []
}
При виклику видає пустий набір.
Спробуймо створити нове право вимоги:
POST /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 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/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 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.
Створення активу¶
Створимо claim right з мінімально допустимим набором даних (тільки параметри, обовязкові для заповнення):
POST /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3673
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
"data": {
"assetType": "claimRights",
"classification": {
"scheme": "CAV",
"id": "39513200-3",
"description": "Земельні ділянки"
},
"title": "Земля для космодрому",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"id": "39513200-3",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"id": "39513200-3",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100
},
"unit": {
"code": "39513200-3",
"name": "item"
},
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100
},
"value": {
"currency": "UAH",
"amount": 1
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"debtorType": "legalPerson"
},
"assetCustodian": {
"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": "м. Київ"
}
},
"quantity": 5
}
}
Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets/6aa3093c0b00447abefcacf9a11da277
X-Content-Type-Options: nosniff
{
"access": {
"token": "431a00c918cd47d48d6f37d62f631c37"
},
"data": {
"status": "draft",
"assetType": "claimRights",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000001",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "d778f751485b4bd79f285fc6e8fa90c1",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "ada801c8e60b41e3a3164b2ab42aff15",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:03.842028+02:00",
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:03.835865+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "6aa3093c0b00447abefcacf9a11da277",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
PATCH /api/0.1/assets/6aa3093c0b00447abefcacf9a11da277?acc_token=431a00c918cd47d48d6f37d62f631c37 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
"data": {
"status": "pending"
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "claimRights",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000001",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "d778f751485b4bd79f285fc6e8fa90c1",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "ada801c8e60b41e3a3164b2ab42aff15",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:03.936033+02:00",
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:03.935835+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "6aa3093c0b00447abefcacf9a11da277",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
Успіх! Тепер ми бачимо, що новий об’єкт було створено. Код відповіді 201 та заголовок відповіді Location вказує місцерозташування створеного об’єкта. Тіло відповіді показує інформацію про створене право вимоги, його внутрішній id (яке співпадає з сегментом Location), його офіційний assetID та dateModified (дату, що показує час, коли право вимоги востаннє модифікувалося). Зверніть увагу на assetType, а також на те, що право вимоги створюється зі статусом pending.
Використаємо URL створеного об’єкта (заголовок відповіді Location):
GET /api/0.1/assets/6aa3093c0b00447abefcacf9a11da277 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "claimRights",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000001",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "d778f751485b4bd79f285fc6e8fa90c1",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "ada801c8e60b41e3a3164b2ab42aff15",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:03.936033+02:00",
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:03.935835+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "6aa3093c0b00447abefcacf9a11da277",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
Ми бачимо ту ж відповідь, що і після створення активу.
Подивимось, що показує список прав вимоги:
GET /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/0.1/assets?offset=",
"uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets?offset=",
"offset": ""
},
"data": []
}
Ми бачимо внутрішнє id активу та його dateModified.
Попередній актив був створений лише з обов’язковими полями. Тепер додамо актив з максимально допустимим набором даних при створенні (статус created):
POST /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3673
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
"data": {
"assetType": "claimRights",
"classification": {
"scheme": "CAV",
"id": "39513200-3",
"description": "Земельні ділянки"
},
"title": "Земля для космодрому",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"id": "39513200-3",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"id": "39513200-3",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100
},
"unit": {
"code": "39513200-3",
"name": "item"
},
"address": {
"countryName": "Україна",
"postalCode": "79000",
"region": "м. Київ",
"streetAddress": "вул. Банкова 1",
"locality": "м. Київ"
},
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100
},
"value": {
"currency": "UAH",
"amount": 1
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"debtorType": "legalPerson"
},
"assetCustodian": {
"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": "м. Київ"
}
},
"quantity": 5
}
}
Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets/6f32878c0ec44d8e992cf5365fa919ee
X-Content-Type-Options: nosniff
{
"access": {
"token": "1bfd7fe16c4d496ea7f780aa35ad53af"
},
"data": {
"status": "draft",
"assetType": "claimRights",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000002",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "a290d61cb5304a1cba4ca8652c31d915",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "7bfe30e3c1ce4c53991e2540f6b5845d",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:04.131200+02:00",
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:04.127806+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "6f32878c0ec44d8e992cf5365fa919ee",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
І знову код відповіді 201 Created, заголовок Location і тіло з додатковим id, assetID, та властивість dateModified.
Перевіримо, що містить реєстр активів:
GET /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/0.1/assets?offset=2018-01-09T18%3A31%3A03.936033%2B02%3A00",
"uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets?offset=2018-01-09T18%3A31%3A03.936033%2B02%3A00",
"offset": "2018-01-09T18:31:03.936033+02:00"
},
"data": [
{
"id": "6aa3093c0b00447abefcacf9a11da277",
"dateModified": "2018-01-09T18:31:03.936033+02:00"
}
]
}
Дійсно, в нас зараз є два активи.
Модифікація права вимоги¶
Оновимо право вимоги шляхом надання йому усіх інших важливих властивостей:
PATCH /api/0.1/assets/6aa3093c0b00447abefcacf9a11da277?acc_token=431a00c918cd47d48d6f37d62f631c37 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 347
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
"data": {
"description": "Земельні ділянки із великими покладами благородних металів"
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "claimRights",
"description": "Земельні ділянки із великими покладами благородних металів",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000001",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "d778f751485b4bd79f285fc6e8fa90c1",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "ada801c8e60b41e3a3164b2ab42aff15",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:04.262976+02:00",
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:03.935835+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "6aa3093c0b00447abefcacf9a11da277",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
Ми бачимо, що додаткові властивості об’єднані з існуючими даними права вимоги. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.
Ще одна перевірка списку відображає нову дату модифікації:
GET /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/0.1/assets?offset=2018-01-09T18%3A31%3A03.936033%2B02%3A00",
"uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets?offset=2018-01-09T18%3A31%3A03.936033%2B02%3A00",
"offset": "2018-01-09T18:31:03.936033+02:00"
},
"data": [
{
"id": "6aa3093c0b00447abefcacf9a11da277",
"dateModified": "2018-01-09T18:31:03.936033+02:00"
}
]
}
Видалення права вимоги¶
Видалимо право вимоги
PATCH /api/0.1/assets/6aa3093c0b00447abefcacf9a11da277?acc_token=431a00c918cd47d48d6f37d62f631c37 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
"data": {
"status": "deleted"
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "deleted",
"assetType": "claimRights",
"description": "Земельні ділянки із великими покладами благородних металів",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000001",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "d778f751485b4bd79f285fc6e8fa90c1",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "ada801c8e60b41e3a3164b2ab42aff15",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:04.355377+02:00",
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:04.355162+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "6aa3093c0b00447abefcacf9a11da277",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
Інтеграція з лотами¶
Припустімо, до лоту ‘причеплено’ активи:
GET /api/0.1/assets/68dcee4e1af44aa493c6a040a924c03f HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"relatedLot": "960b16754d55425db2d6d5063b7df083",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000004",
"assetType": "claimRights",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:05.506163+02:00",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "35e00aa638364d06a829a616854dca25",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "8fa1341b52a840539d5093471193adaa",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:05.505967+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "68dcee4e1af44aa493c6a040a924c03f",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
Спробуймо перевести статус лоту в recomposed.
Після виконання такої дії, активи ‘відкріплюються’ від лоту, відтак їхній статус атоматично переходить у pending.
GET /api/0.1/assets/68dcee4e1af44aa493c6a040a924c03f HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "claimRights",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000004",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "35e00aa638364d06a829a616854dca25",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "8fa1341b52a840539d5093471193adaa",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:05.592916+02:00",
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:05.592681+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "68dcee4e1af44aa493c6a040a924c03f",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
GET /api/0.1/assets/b1845029a72a4077aeff912604721ee7 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"relatedLot": "9939b607995a4c799969c97222957f24",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000003",
"assetType": "claimRights",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:04.788157+02:00",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "ecc9f4ec8b524f51a21c2736724f7848",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "5262128ff2d344a9b720227e724840db",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:04.787961+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "b1845029a72a4077aeff912604721ee7",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
GET /api/0.1/assets/b1845029a72a4077aeff912604721ee7 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "claimRights",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000003",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "ecc9f4ec8b524f51a21c2736724f7848",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "5262128ff2d344a9b720227e724840db",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:04.904205+02:00",
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:04.903875+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "b1845029a72a4077aeff912604721ee7",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}
GET /api/0.1/assets/b1845029a72a4077aeff912604721ee7 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "complete",
"relatedLot": "b5ca6aa850694154b6a5f6db4e65f5da",
"classification": {
"scheme": "CAV",
"description": "Земельні ділянки",
"id": "39513200-3"
},
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-01-09-000003",
"assetType": "claimRights",
"value": {
"currency": "UAH",
"amount": 100.0,
"valueAddedTaxIncluded": true
},
"dateModified": "2018-01-09T18:31:05.192219+02:00",
"items": [
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "ecc9f4ec8b524f51a21c2736724f7848",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
},
{
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV",
"description": "Cartons",
"id": "39513200-3"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"id": "5262128ff2d344a9b720227e724840db",
"unit": {
"code": "44617100-9",
"name": "item"
},
"quantity": 5
}
],
"owner": "broker",
"assetCustodian": {
"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": "м. Київ"
}
},
"address": {
"postalCode": "79000",
"countryName": "Україна",
"streetAddress": "вул. Банкова 1",
"region": "м. Київ",
"locality": "м. Київ"
},
"date": "2018-01-09T18:31:05.191861+02:00",
"debt": {
"agreementNumber": "42",
"debtCurrencyValue": {
"currency": "USD",
"amount": 100.0
},
"dateSigned": "2017-08-16T12:30:17.615196+03:00",
"value": {
"currency": "UAH",
"amount": 1.0
},
"debtorType": "legalPerson"
},
"id": "b1845029a72a4077aeff912604721ee7",
"unit": {
"code": "39513200-3",
"name": "item"
},
"quantity": 5
}
}