Tutorial¶
Exploring basic rules¶
Let’s try exploring the /assets endpoint:
GET /api/2.4/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/2.4/assets?offset=",
"uri": "http://lb.api-sandbox.registry.ea2.openprocurement.net/api/2.4/assets?offset=",
"offset": ""
},
"data": []
}
Just invoking it reveals empty set.
Now let’s attempt creating some asset:
POST /api/2.4/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.ea2.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"
}
]
}
Error states that the only accepted Content-Type is application/json.
Let’s satisfy the Content-type requirement:
POST /api/2.4/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.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"
}
]
}
Error states that no data has been found in JSON body.
Creating asset¶
Let’s create asset with the minimal data set:
POST /api/2.4/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2734
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.openprocurement.net
DATA:
{
"data": {
"assetType": "bounce",
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"id": "06121000-6",
"description": "Description"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Ukraine"
},
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"id": "06121000-6",
"description": "Description"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Ukraine"
},
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"assetCustodian": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256"
},
"address": {
"countryName": "Україна"
}
}
}
}
Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea2.openprocurement.net/api/2.4/assets/5c8cd4c766c74f60b25b2b9cdbfb8ef7
X-Content-Type-Options: nosniff
{
"access": {
"token": "f9954df58b5c4f40a7ba11f1eae6063c"
},
"data": {
"status": "draft",
"assetType": "bounce",
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:39:54.423035+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:39:54.423082+03:00",
"id": "e5796e629edd4477a730aa732a425f9d"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "ca254ba6052947539d7bb26aaa163e8d",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "1a1cf1d83a424e7284976caef828d680",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"dateModified": "2018-05-22T13:39:54.429965+03:00",
"owner": "broker",
"date": "2018-05-22T13:39:54.422540+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "5c8cd4c766c74f60b25b2b9cdbfb8ef7",
"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": "м. Київ"
}
}
}
}
The object you’re trying to add initially receives draft status. For the asset to be created within the Registry, it should be manually switched to pending status (2 Phase Commit mechanism):
PATCH /api/2.4/assets/5c8cd4c766c74f60b25b2b9cdbfb8ef7?acc_token=f9954df58b5c4f40a7ba11f1eae6063c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.openprocurement.net
DATA:
{
"data": {
"status": "pending"
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "bounce",
"rectificationPeriod": {
"startDate": "2018-05-22T13:39:54.509530+03:00",
"endDate": "2018-05-23T13:39:54.509530+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:39:54.423035+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:39:54.423082+03:00",
"id": "e5796e629edd4477a730aa732a425f9d"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "ca254ba6052947539d7bb26aaa163e8d",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "1a1cf1d83a424e7284976caef828d680",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"dateModified": "2018-05-22T13:39:54.510132+03:00",
"owner": "broker",
"date": "2018-05-22T13:39:54.509861+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "5c8cd4c766c74f60b25b2b9cdbfb8ef7",
"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": "м. Київ"
}
}
}
}
Success! Now we can see that new object was created. Response code is 201 and Location response header reports the location of the created object. The body of response reveals the information about the created asset: its internal id (that matches the Location segment), its official assetID and dateModified datestamp stating the moment in time when asset was last modified. Pay attention to the assetType. Note that asset is created with pending status.
Let’s access the URL of the created object (the Location header of the response):
GET /api/2.4/assets/5c8cd4c766c74f60b25b2b9cdbfb8ef7 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "bounce",
"rectificationPeriod": {
"startDate": "2018-05-22T13:39:54.509530+03:00",
"endDate": "2018-05-23T13:39:54.509530+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:39:54.423035+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:39:54.423082+03:00",
"id": "e5796e629edd4477a730aa732a425f9d"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "ca254ba6052947539d7bb26aaa163e8d",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "1a1cf1d83a424e7284976caef828d680",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"dateModified": "2018-05-22T13:39:54.510132+03:00",
"owner": "broker",
"date": "2018-05-22T13:39:54.509861+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "5c8cd4c766c74f60b25b2b9cdbfb8ef7",
"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": "м. Київ"
}
}
}
}
We can see the same response we got after creating asset.
Let’s see what listing of assets reveals us:
GET /api/2.4/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/2.4/assets?offset=2018-05-22T13%3A39%3A54.510132%2B03%3A00",
"uri": "http://lb.api-sandbox.registry.ea2.openprocurement.net/api/2.4/assets?offset=2018-05-22T13%3A39%3A54.510132%2B03%3A00",
"offset": "2018-05-22T13:39:54.510132+03:00"
},
"data": [
{
"id": "5c8cd4c766c74f60b25b2b9cdbfb8ef7",
"dateModified": "2018-05-22T13:39:54.510132+03:00"
}
]
}
We do see the internal id of a asset (that can be used to construct full URL by prepending http://lb.api-sandbox.registry.ea2.openprocurement.net/api/<api_version>/assets/) and its dateModified datestamp.
Let’s create another asset:
POST /api/2.4/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 2734
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.openprocurement.net
DATA:
{
"data": {
"assetType": "bounce",
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"id": "06121000-6",
"description": "Description"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "0",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"id": "06121000-6",
"description": "Description"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "0",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"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": "м. Київ"
}
}
}
}
Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea2.openprocurement.net/api/2.4/assets/8a94b664b34740dfbb4d3109f1e2ec61
X-Content-Type-Options: nosniff
{
"access": {
"token": "799ae2f90a16420ca7a32e9493fa2f20"
},
"data": {
"status": "draft",
"assetType": "bounce",
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:40:23.202137+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:40:23.202180+03:00",
"id": "bfe3c9b7e55846859049aa9f00ffc54e"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000002",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "7646155d79c049538715fc82837b0931",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "1c6b8c9b6ca2486aa765798fe199d806",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"dateModified": "2018-05-22T13:40:23.205533+03:00",
"owner": "broker",
"date": "2018-05-22T13:40:23.201731+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "8a94b664b34740dfbb4d3109f1e2ec61",
"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": "м. Київ"
}
}
}
}
After switching this object to pending, let’s check what assets registry contains:
GET /api/2.4/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/2.4/assets?offset=2018-05-22T13%3A39%3A54.510132%2B03%3A00",
"uri": "http://lb.api-sandbox.registry.ea2.openprocurement.net/api/2.4/assets?offset=2018-05-22T13%3A39%3A54.510132%2B03%3A00",
"offset": "2018-05-22T13:39:54.510132+03:00"
},
"data": [
{
"id": "5c8cd4c766c74f60b25b2b9cdbfb8ef7",
"dateModified": "2018-05-22T13:39:54.510132+03:00"
},
{
"id": "f9954df58b5c4f40a7ba11f1eae6063c",
"dateModified": "2018-05-22T13:39:54.510132+03:00"
}
]
}
And indeed we have 2 assets now.
Modifying Asset¶
Let’s update asset description:
PATCH /api/2.4/assets/5c8cd4c766c74f60b25b2b9cdbfb8ef7?acc_token=f9954df58b5c4f40a7ba11f1eae6063c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 347
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.openprocurement.net
DATA:
{
"data": {
"description": "Земельні ділянки із великими покладами благородних металів"
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "bounce",
"rectificationPeriod": {
"startDate": "2018-05-22T13:39:54.509530+03:00",
"endDate": "2018-05-23T13:39:54.509530+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:39:54.423035+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:39:54.423082+03:00",
"id": "e5796e629edd4477a730aa732a425f9d"
}
],
"description": "Земельні ділянки із великими покладами благородних металів",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "ca254ba6052947539d7bb26aaa163e8d",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "1a1cf1d83a424e7284976caef828d680",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"dateModified": "2018-05-22T13:40:23.343097+03:00",
"owner": "broker",
"date": "2018-05-22T13:39:54.509861+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "5c8cd4c766c74f60b25b2b9cdbfb8ef7",
"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": "м. Київ"
}
}
}
}
We see the added properties have merged with existing asset data. Additionally, the dateModified property was updated to reflect the last modification date stamp.
Note that the asset can be modified only within the rectification period (up to rectificationPeriod.endDate).
Checking the listing again reflects the new modification date:
GET /api/2.4/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"next_page": {
"path": "/api/2.4/assets?offset=2018-05-22T13%3A39%3A54.510132%2B03%3A00",
"uri": "http://lb.api-sandbox.registry.ea2.openprocurement.net/api/2.4/assets?offset=2018-05-22T13%3A39%3A54.510132%2B03%3A00",
"offset": "2018-05-22T13:39:54.510132+03:00"
},
"data": [
{
"id": "5c8cd4c766c74f60b25b2b9cdbfb8ef7",
"dateModified": "2018-05-22T13:40:23.343097+03:00"
}
]
}
Let’s modify one of the items added before:
PATCH /api/2.4/assets/c6f779c422954268b1bb2adf139e307d/items/50ffa36d59084905a520d8a1069565cd HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 748
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.openprocurement.net
X-Access-Token: 7339b31b04cc44d8ad3c756e4b3545b4
DATA:
{
"data": {
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"id": "06121000-6",
"description": "Description"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"address": {
"countryName": "Ukraine"
},
"unit": {
"code": "code"
},
"quantity": 42
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "50ffa36d59084905a520d8a1069565cd",
"unit": {
"code": "code"
},
"quantity": 42
}
}
Deleting Asset¶
Let’s delete asset.
Firstly, a document with the documentType: canellationDetails has to be added:
POST /api/2.4/assets/5c8cd4c766c74f60b25b2b9cdbfb8ef7/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 350
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.openprocurement.net
X-Access-Token: f9954df58b5c4f40a7ba11f1eae6063c
DATA:
{
"data": {
"url": "http://localhost/get/d569aea176a947e5abaf289e583cf96b?KeyID=9f887607&Signature=b4DgGl2WRakYWuEwJAZGbjbvN3Bu3cslLQJmcwXZzO%2FstWuhw75ZouJ5R7qEOU46OvwnAA1TO0s%2FRFWHAHOBBw%3D%3D",
"title": "укр.doc",
"format": "application/msword",
"hash": "md5:00000000000000000000000000000000",
"documentType": "cancellationDetails"
}
}
Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea2.openprocurement.net/api/2.4/assets/5c8cd4c766c74f60b25b2b9cdbfb8ef7/documents/c793551c2cdd483f89ac60d7ce36bc76
X-Content-Type-Options: nosniff
{
"data": {
"dateModified": "2018-05-22T13:40:23.403225+03:00",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://localhost/get/d569aea176a947e5abaf289e583cf96b?KeyID=9f887607&Signature=z3YrEXB8FwIR3ulRtu4lPjsEqD5kHKlH8rrCRG9kvJE6Ph%252Bjg%2FKou%252BxAsAhtlxFcKtYoAi8wMn0c1hf126IQDA%253D%253D",
"author": "asset_owner",
"documentOf": "asset",
"datePublished": "2018-05-22T13:40:23.403197+03:00",
"documentType": "cancellationDetails",
"title": "укр.doc",
"id": "c793551c2cdd483f89ac60d7ce36bc76"
}
}
And now asset can be easily deleted:
PATCH /api/2.4/assets/5c8cd4c766c74f60b25b2b9cdbfb8ef7?acc_token=f9954df58b5c4f40a7ba11f1eae6063c HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.openprocurement.net
DATA:
{
"data": {
"status": "deleted"
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "deleted",
"assetType": "bounce",
"rectificationPeriod": {
"startDate": "2018-05-22T13:39:54.509530+03:00",
"endDate": "2018-05-23T13:39:54.509530+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:39:54.423035+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:39:54.423082+03:00",
"id": "e5796e629edd4477a730aa732a425f9d"
},
{
"dateModified": "2018-05-22T13:40:23.403225+03:00",
"hash": "md5:00000000000000000000000000000000",
"format": "application/msword",
"url": "http://localhost/get/d569aea176a947e5abaf289e583cf96b?KeyID=9f887607&Signature=z3YrEXB8FwIR3ulRtu4lPjsEqD5kHKlH8rrCRG9kvJE6Ph%252Bjg%2FKou%252BxAsAhtlxFcKtYoAi8wMn0c1hf126IQDA%253D%253D",
"author": "asset_owner",
"documentOf": "asset",
"datePublished": "2018-05-22T13:40:23.403197+03:00",
"documentType": "cancellationDetails",
"title": "укр.doc",
"id": "c793551c2cdd483f89ac60d7ce36bc76"
}
],
"description": "Земельні ділянки із великими покладами благородних металів",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "ca254ba6052947539d7bb26aaa163e8d",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "1a1cf1d83a424e7284976caef828d680",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"dateModified": "2018-05-22T13:40:23.486221+03:00",
"owner": "broker",
"date": "2018-05-22T13:40:23.486033+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "5c8cd4c766c74f60b25b2b9cdbfb8ef7",
"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": "м. Київ"
}
}
}
}
Integration with lots¶
As long as the lot is formed, the system should verify whether the asset can be attached to that lot. With the lot status being changed to verification the asset automatically reaches verification as well.
PATCH /api/2.4/assets/e5ad643dfbbf4689a1adfec69f254603 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Content-Length: 86
Content-Type: application/json
Host: lb.api-sandbox.registry.ea2.openprocurement.net
DATA:
{
"data": {
"status": "verification",
"relatedLot": "888fa9fe1a544efd962c013a23b3277f"
}
}
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "verification",
"relatedLot": "888fa9fe1a544efd962c013a23b3277f",
"rectificationPeriod": {
"startDate": "2018-05-23T13:21:12.727792+03:00",
"endDate": "2018-05-24T13:21:12.727792+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-23T13:21:12.647141+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-23T13:21:12.647227+03:00",
"id": "9f159b4177524cedb71231de6843cd1d"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-23-000001",
"assetType": "bounce",
"dateModified": "2018-05-23T13:21:12.808217+03:00",
"owner": "broker",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "5be78bff843544d8babc11965f3509d8",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "3efae29fac6a4f0f9a742c143d9b9e91",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"date": "2018-05-23T13:21:12.807966+03:00",
"decisions": [
{
"decisionDate": "2018-05-23T13:21:10.853759+03:00",
"decisionID": "1111-4"
}
],
"id": "e5ad643dfbbf4689a1adfec69f254603",
"assetCustodian": {
"contactPoint": {
"name": "Державне управління справами",
"telephone": "0440000000"
},
"identifier": {
"scheme": "UA-EDR",
"id": "00037256"
},
"address": {
"countryName": "Україна"
}
}
}
}
In case of the asset being available, its status automatically becomes active.
GET /api/2.4/assets/7ca56d7436a1441da057379056a26840 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "active",
"relatedLot": "4bc7b2bbce9c4d30a125677cd8a6af85",
"rectificationPeriod": {
"startDate": "2018-05-22T13:40:23.777353+03:00",
"endDate": "2018-05-23T13:40:23.777353+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:40:23.714151+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:40:23.714189+03:00",
"id": "e89331862c044d4ab8260d274ae7b862"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"assetType": "bounce",
"dateModified": "2018-05-22T13:40:23.899883+03:00",
"owner": "broker",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "dab50dde2a5843658f02d790fd3cf2e5",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "02079cb4c55943cfb5c4629aa0ee450b",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"date": "2018-05-22T13:40:23.899692+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "7ca56d7436a1441da057379056a26840",
"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": "м. Київ"
}
}
}
}
If the lot is formed incorrectly, the asset will automatically receive pending status and so that the relatedLot field will be empty.
GET /api/2.4/assets/7ca56d7436a1441da057379056a26840 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "bounce",
"rectificationPeriod": {
"startDate": "2018-05-22T13:40:23.777353+03:00",
"endDate": "2018-05-23T13:40:23.777353+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:40:23.714151+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:40:23.714189+03:00",
"id": "e89331862c044d4ab8260d274ae7b862"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "dab50dde2a5843658f02d790fd3cf2e5",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "02079cb4c55943cfb5c4629aa0ee450b",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"dateModified": "2018-05-22T13:40:23.976785+03:00",
"owner": "broker",
"date": "2018-05-22T13:40:23.976551+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "7ca56d7436a1441da057379056a26840",
"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": "м. Київ"
}
}
}
}
As long as the lot status becomes either pending.deleted or pending.dissolution, the asset attached to that lot also receives pending status.
GET /api/2.4/assets/7ca56d7436a1441da057379056a26840 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "pending",
"assetType": "bounce",
"rectificationPeriod": {
"startDate": "2018-05-22T13:40:23.777353+03:00",
"endDate": "2018-05-23T13:40:23.777353+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:40:23.714151+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:40:23.714189+03:00",
"id": "e89331862c044d4ab8260d274ae7b862"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "dab50dde2a5843658f02d790fd3cf2e5",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "02079cb4c55943cfb5c4629aa0ee450b",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"dateModified": "2018-05-22T13:40:23.976785+03:00",
"owner": "broker",
"date": "2018-05-22T13:40:23.976551+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "7ca56d7436a1441da057379056a26840",
"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": "м. Київ"
}
}
}
}
As long as the lot receives pending.sold status, the asset attached to that lot becomes complete.
GET /api/2.4/assets/7ca56d7436a1441da057379056a26840 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea2.openprocurement.net
Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
"data": {
"status": "complete",
"relatedLot": "82900177353b4bf9963500218690f880",
"rectificationPeriod": {
"startDate": "2018-05-22T13:40:23.777353+03:00",
"endDate": "2018-05-23T13:40:23.777353+03:00"
},
"documents": [
{
"title": "Інформація про оприлюднення інформаційного повідомлення",
"url": "https://prozorro.sale/info/ssp_details ",
"documentOf": "asset",
"datePublished": "2018-05-22T13:40:23.714151+03:00",
"documentType": "informationDetails",
"dateModified": "2018-05-22T13:40:23.714189+03:00",
"id": "e89331862c044d4ab8260d274ae7b862"
}
],
"description": "Опис землі для космодрому",
"title": "Земля для космодрому",
"assetID": "UA-AR-DGF-2018-05-22-000001",
"assetType": "bounce",
"dateModified": "2018-05-22T13:40:24.192543+03:00",
"owner": "broker",
"items": [
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "dab50dde2a5843658f02d790fd3cf2e5",
"unit": {
"code": "code"
},
"quantity": 5.0001
},
{
"registrationDetails": {
"status": "unknown"
},
"description": "футляри до державних нагород",
"classification": {
"scheme": "CAV-PS",
"description": "Description",
"id": "06121000-6"
},
"additionalClassifications": [
{
"scheme": "UA-EDR",
"description": "папір і картон гофровані, паперова й картонна тара",
"id": "17.21.1"
}
],
"address": {
"countryName": "Ukraine"
},
"id": "02079cb4c55943cfb5c4629aa0ee450b",
"unit": {
"code": "code"
},
"quantity": 5.0001
}
],
"date": "2018-05-22T13:40:24.192312+03:00",
"decisions": [
{
"decisionDate": "2018-05-22T13:39:53.504199+03:00",
"decisionID": "1111-4"
}
],
"id": "7ca56d7436a1441da057379056a26840",
"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": "м. Київ"
}
}
}
}