На Prozorro.Sale надходить письмовий запит на перенесення обʼєкта з одного Майданчика на інший Майданчик.
В разі отримання звернення, адміністратор ЦБД виконує технічну команду по створеній на нього Jira завці.
Результатом виконання команди зміни owner-а, в обʼєкті в _meta{} додається поле ownerTransfer зі значенням owner name майданчика, на який переносять обʼєкт.
Приклад структури _meta{}:
"_meta": {
"ownerTransfer": "filip.kuzmin@prozorro.sale"
"systemDateModified": "2025-04-09T18:00:03.751000Z"
} |
Приклад обʼєкта, для якого виконали команду: https://procedure-epic.prozorro.sale/api/procedures/682462182cf8333bd1c00c64
Ознакою того, що на Майданчик хочуть перенести обʼєкт є наявність в обʼєкті поля _meta{}.ownerTransfer в якому записано значення owner name майданчика-реціпієнта.
Наприклад, якщо в Адмінці була виконана команда на переніс обʼєкта на Майданчик "test_broker_1", то в обʼєкті, який переносять буде:
"_meta": {
"systemDateModified": "2025-05-15T06:39:31.450000Z",
"ownerTransfer": "test_broker_1"
} |
Щоб отримати токен до обʼєкту, Майданчику-реціпієнту необхідно виконати запит
| HTTP метод | POST | |
| 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 |
object_id - технічний ідентифікатор обʼєкта "_id". Приклад: 67f3889fe820f82002c07a04
Відповідь 200 ОК:
{
"id": "67f3889fe820f82002c07a04",
"acc_token": "17e86edb-18d8-4d43-9511-2c49146cbe94"
} |
Запит обовʼязково має бути аутентифікований (відпрацьовує тільки з використанням унікального токену Майданчика)
ВАЖЛИВО! Результатом успішного виконання запиту має бути видача токена новому власнику, а також прибирання із обʼєкта, для якого виконувався переніс, полів _id, objType та ownerTo в масиві transfer[]
Тобто, поля в transfer[] відображаються з моменту успішного виконання команди в Адмінці і до моменту успішного GET запиту майданчиком-реціпієнтом.
Відповідь 403 Forbidden:
{
"message": "Forbidden. You are not authorized to receive token to this object"
} |
Якщо обʼєкт ще не передано (відсутнє поле metaInfo.ownerTransfer), то повертаємо 403
Відповідь 404 Not Found:
{
"message": "Not found procedure object with id 67f38f3de820f002c07a0644"
} |
В системі має відбуватись логування дій отримання токену Майданчиком-реціпієнтом.
Команда може виконуватись повторно для обʼєкта, навіть якщо в meta{} вже присутнє поле "ownerTransfer". В такому випадку значення поля "ownerTransfer" заміняється на нове.
Видалити поле "ownerTransfer" неможливо, якщо його вже додали командою.
Можна замінити значення в полі "ownerTransfer" повторним виконанням команди Change procedure owner commands.
Поле "ownerTransfer" має зникнути після отримання Майданчиком-реціпієнтом токену. Тобто, "ownerTransfer" відображається з моменту успішного виконання команди і до моменту успішного запиту майданчиком-реціпієнтом.
ВАЖЛИВО! Токен до обʼєкта процедури на цьому етапі не змінюється! Навіть при наявності в обʼєкті поля _meta.ownerTransfer попередній owner обʼєкта може виконувати дії над обʼєктом використовуючи свій токен.
Перевірити успішність виконання команди, зокрема, можна переглянувши JSON обʼєкта.
Результатом виконання команди в Адмінці є наявність в обʼєкті поля _meta{}.ownerTransfer в якому має бути записано owner name майданчика на який переносили обʼєкт.
В результаті виконання команди в обʼєкті для якого виконували команду має бути присутнє поле ownerTransfer в _meta
На цьому етапі Токен до процедури не змінився, Майданчик-донор може виконувати дії над Процедурою використовуючи свій токен.
Для фактичної зміни токена до процедури Майданчику-реціпієнту потрібно зробити виклик API-запиту