На Prozorro.Sale надходить письмовий запит на перенесення обʼєкта з одного Майданчика на інший Майданчик. (Технічно - просять змінити owner-а)
(Ніяких змін в ініціації процесу переносу не відбувається!)
В разі отримання звернення, адміністратор ЦБД виконує технічну команду.
Результатом виконання команди зміни owner-а, в обʼєкті в _meta{} додається поле ownerTransfer зі значенням owner name майданчика, на який переносять обʼєкт.
Приклад структури _meta{}:
"_meta": {
"ownerTransfer": "filip.kuzmin@prozorro.sale"
"systemDateModified": "2025-04-09T18:00:03.751000Z"
} |
Приклад обʼєкта, для якого виконали команду і цей обʼєкт готовий для передачі: https://procedure-dev.prozorro.sale/api/procedures/680f67d2196e27e271cc2c2a
Ознакою того, що на Майданчик хочуть перенести обʼєкт є наявність в обʼєкті поля _meta{}.ownerTransfer в якому записано значення owner name майданчика-реціпієнта.
Наприклад, якщо в Адмінці була виконана команда на переніс обʼєкта на Майданчик "test_broker_1", то в обʼєкті, який переносять буде:
"_meta": {
"systemDateModified": "2025-05-15T06:39:31.450000Z",
"ownerTransfer": "filip.kuzmin@prozorro.sale"
} |
ВАЖЛИВО! Токен до обʼєкта процедури на цьому етапі не змінюється! Навіть при наявності в обʼєкті поля _meta.ownerTransfer попередній owner обʼєкта може виконувати дії над обʼєктом використовуючи свій токен.
Щоб отримати токен до обʼєкту, Майданчику-реціпієнту необхідно виконати запит в залежності від типу обʼєкта (запити будуть в Swagger):
| Тип обʼєкта | Бізнес назва | Приклад запиту |
|---|---|---|
| Procedure | Процедура | POST /api/procedures/{{_id}}/transfer Header Authorization: {{broker_token} |
| Asset | Обʼєкт малої приватизації | POST /api/registry/assets/{{_id}}/transfer Header Authorization: {{broker_token} |
| Large Asset | Обʼєкт великої приватизації | POST /api/registry/large_assets/{{_id}}/transfer Header Authorization: {{broker_token} |
| Execution | Виконання умов малої приватизації | POST /api/registry/executions/{{_id}}/transfer Header Authorization: {{broker_token} |
| Large Execution | Виконання умов великої приватизації | POST /api/registry/large_executions/{{_id}}/transfer Header Authorization: {{broker_token} |
| Registry | Обʼєкт реєстру оренди | POST /api/registry/objects/{{_id}}/transfer Header Authorization: {{broker_token} |
| Action | Дія над обʼєктом оренди | POST /api/registry/actions/{{_id}}/transfer Header Authorization: {{broker_token} |
| Lease_request | Запит на обʼєкт оренди | POST /api/registry/lease_requests/{{_id}}/transfer Header Authorization: {{broker_token} |
| Announcement | Інформаційне повідомлення малої приватизації | POST /api/jobber/announcements/jas/{{_id}}/transfer Header Authorization: {{broker_token} |
| Large Announcement | Інформаційне повідомлення великої приватизації | POST /api/jobber/announcements/jal/{{_id}}/transfer Header Authorization: {{broker_token} |
| Redemption | Приватизація шляхом викупу малої приватизації | POST /api/jobber/redemption/jrs/{{_id}}/transfer Header Authorization: {{broker_token} |
| Large Redemption | Приватизація шляхом викупу великої приватизації | POST /api/jobber/redemption/jrl/{{_id}}/transfer Header Authorization: {{broker_token} |
Приклад запиту:
POST https://{host}/api/procedures/{object_id}/transfer
Authorization: {{broker_token}}
Приклад сURL
curl --location --request POST 'https://procedure-dev.prozorro.sale/api/procedures/67c7fb9b150280fe7b87f69b/transfer' \ |
params:
host -
| Назва | host |
|---|---|
| Dev | |
| Sandbox | |
| Prod | https://procedure.prozorro.sale |
_id - технічний ідентифікатор обʼєкта "_id". Приклад: 67c7fb9b150280fe7b87f69b
Відповідь 200 ОК:
{
"id": "67c7fb9b150280fe7b87f69b",
"acc_token": "a4082115-ae38-409f-9093-bcacdb701cb5"
} |
Запит обовʼязково має бути аутентифікований (відпрацьовує тільки з використанням унікального токену Майданчика)
ВАЖЛИВО! Результатом успішного виконання запиту має бути видача токена новому власнику, а також прибирання із обʼєкта, для якого виконувався переніс, поля ownerTransfer
Тобто, поле ownerTransfer відображається з моменту успішного виконання команди і до моменту успішного POST запиту майданчиком-реціпієнтом.
Відповідь 403 Forbidden:
{
"message": "Forbidden. You are not authorized to receive token to this object"
} |
Якщо обʼєкт ще не передано (відсутнє поле ownerTransfer), то повертаємо 403
Відповідь 404 Not Found:
{
"message": "Not found procedure object with id 67f38f3de820f002c07a0644"
} |
Коли в mirror прилітає обʼєкт, то необхідно дивитись на наявність поля ownerTransfer в _meta{}
Якщо в обʼєкті присутнє поле ownerTransfer, то перевірити чи вказано в цьому полі ownerName Вашого Майданчика?