Ініціація перенесення обʼєкта

На Prozorro.Sale надходить письмовий запит на перенесення обʼєкта з одного Майданчика на інший Майданчик. (Технічно - просять змінити owner-а)

(Ніяких змін в ініціації процесу переносу не відбувається!)

Частина Prozorro.Sale

В разі отримання звернення, адміністратор ЦБД виконує технічну команду.

Результатом виконання команди зміни 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

Частина Майданчика-реціпієнта

API -запит на отримання токену

Ознакою того, що на Майданчик хочуть перенести обʼєкт є наявність в обʼєкті поля _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' \
--header 'Authorization: *******-*****-****-****-*******'

params:

host -

Назваhost
Dev

https://procedure-dev.prozorro.sale

Sandbox

https://procedure-sandbox.prozorro.sale

Prodhttps://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 Вашого Майданчика?

  • Вказано.
    • Необхідно забрати обʼєкт виконавши POST запит описаний вище (можна автоматизувати, можна викликати запит вручну. Отримати токен і записати в БД)
    • Якому саме користувачу Вашого Майданчика належить обʼєкт можна спробувати дізнатись порівнявши ЄДРПОУ\ІПН із поля sellingEntity.identifier.id з реєстраційними даними на Майданчику. Має бути користувач з таким ЄДРПОУ, йому і привʼязати обʼєкт (ці дії за межами Prozorro.Sale і приклад описано теоретичний)
  • НЕ вказно
    • Необхідно перевірити "Чи в полі owner вказано ownerName Вашого Майданчика?"
      • Вказано.
        • Обʼєкт хочуть перенести з Вашого Майданчика на інший. Можна відвʼязувати обʼєкт від кабінету.
      • Не Вказано.
        • Не виконувати ніяких дій. Ви не являєтесь власником обʼєкта і на Вас його не переносять.



  • No labels