| Table of Contents |
|---|
| Code Block |
|---|
SAC (master object)
├── Procedure #1 (англійський)
├── Procedure #2 (-50% від стартової)
├── Procedure #3 (голландський з -50% від першого)
└── Procedure status controller |
...
| Info | ||
|---|---|---|
| ||
Організатор створює ланцюжок, де передає:
Протягом 5 хвилин створилася перша процедура SAE. Організатор протягом 48 годин редагує в Процедурі SAE:
В обʼєкті SAC залишиться першочергова Стартова ціна 100 000 грн, а в першіій процедурі SAE Організатор змінив на 80 000 грн. За результатами - Перша процедура SAE НЕ успішна і отримує статус unsuccessful. ЦБД протягом 5 хвилин, після отримання Першою процедурою статуса unsuccessful автоматично створює другу процедуру SAE ЦБД автоматично розраховує:
Організатор протягом 48 годин редагує в другій Процедурі SAE:
В обʼєкті SAC залишиться першочергова Стартова ціна 100 000 грн і першочерговий Гарантійний внесок 10 000 грн. За результатами - Друга процедура SAE НЕ успішна і отримує статус unsuccessful. ЦБД протягом 5 хвилин, після отримання Другою процедурою статуса unsuccessful автоматично створює третью процедуру SAD ЦБД автоматично розраховує:
Організатор протягом 48 годин від моменту створення процедури може редагувати Стартову ціну, Гарантійку і інші поля згідно ТЗ процедури. |
...
3-й процедурі: tenderAttempts = 3 та у полі previousAuctionId значення auctionId від другої процедури цього ланцюжка
Скасування
Скасувати "ланцюжок" окремим запитом неможливо.
При скасуванні будь-якої процедури ланцюжка - автоматично скасовується ланцюжок.
...
Мінімальний крок аукціону
При публікації обʼєкта SAC Організатор передає параметр minimalStep.amount та minimalStep.currency
При автоматичній публікації першої процедури ЦБД встановлює значення поля minimalStep.amount та minimalStep.currency точно таким, як вказав Організатор при публікації SAC
При автоматичній публікації другої процедури ЦБД розраховує значення поля minimalStep.amount, як 1% від Стартової ціни другої процедури (minimalStep.amount == value.amount * 0,01)
minimalStep.currency копіюється із першої процедури.
При автоматичній публікації третьої процедури ЦБД розраховує значення поля minimalStep.amount, як 1% від Стартової ціни третьої процедури (minimalStep.amount == value.amount * 0,01)
minimalStep.currency копіюється із другої процедури.
Скасування
Скасувати "ланцюжок" окремим запитом неможливо.
При скасуванні будь-якої процедури ланцюжка - автоматично скасовується ланцюжок.
| Anchor | ||||
|---|---|---|---|---|
|
| Field name | Required for publishing | Type | readOnly | x-legalNameUa | x-legalNameEn | comment | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | owner | - | string | true | Ідентифікатор майданчика | Broker Name | ||||||||||||||||||||||||||||
| 2 | ownerToken | - | string($uuid) | true | x-default: hex | |||||||||||||||||||||||||||||
| 3 | _id | - | string | true | Внутрішній ідентифікатор | ID | x-default: | Field name | Required for publishing | Type | readOnly | x-legalNameUa | x-legalNameEn | comment | 1 | owner | - | string | true | Ідентифікатор майданчика | Broker Name | 2 | ownerToken | - | string($uuid) | true | x-default: hex | 3 | _id | - | stringtrue | Внутрішній ідентифікатор | ID | x-default: object_id x-serialize_when_none: false x-format: object-id |
| 4 | datePublished | - | string($date-time) | true | Дата публікації | Published date | x-default: now | |||||||||||||||||||||||||||
| 5 | dateModified | - | string($date-time) | true | Остання дата зміни | Date modified | ||||||||||||||||||||||||||||
| 6 | objectId | - | string | true | Ідентифікатор ланцюжка | Chain ID | example: SAC001-UA-20260217-12345 | |||||||||||||||||||||||||||
| 7 | status | - | string | true | Статус процедури | Procedure status | enum:
| |||||||||||||||||||||||||||
| 8 | pipelineMethod | + | string | false | Тип | Chain type | enum:
| |||||||||||||||||||||||||||
| 9 | initialProps | + | object | false | Загальна інформація про процедури | Procedure informantion | ||||||||||||||||||||||||||||
| 10 | extraSpecs | + | list[ ] of objects | false | Інформація для базових специфікацій | Base information | ||||||||||||||||||||||||||||
| 11 | producedEntities | - | list[ ] of objects | true | Створені обʼєкти | Produced entities | base.ProducedEntity{
| |||||||||||||||||||||||||||
| 12 | _specs | - | object | true | Розрахункові дані | Calculated data |
| |||||||||||||||||||||||||||
| 13 | _meta | - | Використовується стандартна логіка | |||||||||||||||||||||||||||||||
| 14 | additionalInformation | - | Використовується стандартна логіка | |||||||||||||||||||||||||||||||
| 15 | metaInfo | - | Використовується стандартна логіка |
...
| field name | required for publishing | type | readOnly | x-legalNameUa | x-legalNameEn | comment | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | sellingEntity | base.SellingEntity | Інформація про Організатора аукціону | Organizer information | Використовується стандартна модель Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||||
| 2 | title | + | base.MultiLang | false | Назва аукціону | Auction title | Використовується стандартна модель Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 3 | description | + | base.MultiLang | false | Опис аукціону | Auction description | Використовується стандартна модель Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 4 | x_documentRequirements | - | base.MultiLang | false | Перелік та вимоги до оформлення документів | List and requirements of registration documents | Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 5 | x_additionalInformation | - | base.MultiLang | false | Додаткові відомості | Other requirements and additional information | Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 6 | saleCondition | + | string | false | Наявність умов продажу | Sale conditions | enum:
Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 7 | value | + | base.ValueWithTax | false | Стартова ціна | Start price | Використовується стандартна модель
Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку відбувається авторозрахунок згідно правил | |||||||||||||||||
| 8 | valueAddedTaxCharged | - | boolean | false | На фінальну суму нараховується ПДВ | Value added tax charged | default: false При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 9 | guarantee | + | base.Value | false | Розмір гарантійного внеску | Guarantee Fee |
При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку відбувається авторозрахунок згідно правил
| |||||||||||||||||
| 10 | registrationFee | + | base.Value | false | Розмір реєстраційного внеску |
Залишаємо на відповідальність Майданчика. ЦБД отримує значення і не валідує їх Тільки, що значення >0 При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | ||||||||||||||||||
| 11 | minNumberOfQualifiedBids | - | integer($int64) | false | Мінімальна кількість заяв | Minimal number of bids | default: 1 minimum: 1 maximum: 2 При публікації обʼєкта можна не передавати. ЦБД автоматично згенерує == 1. Організатор може передати явно 1 або 2 за необхідності. При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 12 | minimalStep | + | base.Value | false | Розмір кроку аукціону | Minimal step | Використовується стандартна модель |
Описано ТУТ | ||||||||||||||||
| 13 | accessDetails | - | base.MultiLang | false | Порядок ознайомлення з майном, час і місце проведення огляду об’єкта | Auction access details | Використовується стандартна модель Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 14 | bankAccounts | + | sanctionedAssets.BankAccountsByType | false | Банківські рахунки організатора | Bank accounts | Використовується стандартна модель Обов'язково один банківський рахунок з типом guarantee і валютою UAH. Рахунків для кожного типу в UAH/USD/EUR може бути безліч.
Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 15 | tenderAttempts | + | integer($int64) | true | Лот виставляється | Attempt number | Не повинно відображатися в моделі SAC як окреме поле, але має авто-розраховуватись і відображатись в Процедурі При публікації SAC не очікуємо в запиті поля tenderAttempts. При авто-публікації першої процедури ЦБД має проставити: 1-й процедурі: tenderAttempts = 1 2-й процедурі: tenderAttempts = 2 та у полі previousAuctionId значення auctionId від першої процедури цього ланцюжка 3-й процедурі: tenderAttempts = 3 та у полі previousAuctionId значення auctionId від другої процедури цього ланцюжка | |||||||||||||||||
| 16 | lotId | + | string | false | Номер лота | Lot number | Очікуємо цей параметр в запиті на публікації SAC При авто-створенні першої процедури копіюємо значення в неї. При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка | |||||||||||||||||
| 17 | items | + | sanctionedAssets.Item | false | Склад лота | Lot composition | Використовується стандартна модель x-format: list-object | |||||||||||||||||
| 18 | documents | + | base.Documents | false | Всі документи аукціону та пов'язані додатки | Documents | Використовується стандартна модель x-format: list-object |
...
| field name | required for publishing | type | readOnly | x-legalNameUa | x-legalNameEn | comment | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| periods | + | base.PeriodSpec | false | Інформація про періоди аукціонів | Periods info |
При публікації "ланцюжка", ЦБД очікує, що в extraSpecs обовʼязково буде передано обʼєкт для кожної процедури. Тобто, всього три обʼєкта в extraSpecs, бо процедур в ланцюжку три. Валідації На рівні ЦБД необхідно встановити валідації для pipelineMethod: sanctionedAuctionChain:
Приклад для value.amount < 250 000 000 (двісті п'ятдесят мільйонів):
| ||||||||||||||||||||||||||||||||||
| dutchStep | + | base.DutchStep | false | Крок голландського раунду | Dutch step | Поля dutchStepPercent та dutchStepValue автогенеруються на рівні ЦБД, без можливості внесення змін Організатором
|
_specs
|
_specs
| Code Block |
|---|
"_specs": {
"pipeline": {
"stages": [
{
"producedEntities": [
{
"type": "procedure",
"_id": "69945eec410e8611f93bb132",
"objectId": "SAE001-UA-20260320-17748",
"url": "/api/procedures/69945eec410e8611f93bb132"
}
],
"status": "unsuccessful",
"name": "sa-english-first",
"calculatedData": {
"value": {
"currency": "UAH",
"amount": 100000,
"valueAddedTaxIncluded": true
},
"guarantee": {
"currency": "UAH",
"amount": 10000
},
"registrationFee": {
"currency": "UAH",
"amount": 800
},
"tenderAttempts": 1,
"auctionPeriod": {
"startDate": "2026-03-20T14:30:31.326000+02:00"
},
"sellingMethod": "sanctionedAsset-english",
"minimalStep": {
"currency": "UAH",
"amount": 100
}
}
}, |
| Code Block |
"_specs": { "pipeline": { "stages": [ { "producedEntities": [ { "type": "procedure", "_id": "69945eec410e8611f93bb13269945f5d410e8611f93bb134", "objectId": "SPE001-UA-20260217-1774844432", "url": "/api/procedures/69945eec410e8611f93bb13269945f5d410e8611f93bb134" } ], "status": "unsuccessfulactive", "name": "sp-english-firstsecond", "calculatedData": { "value": { "currency": "UAH", "amount": 1000500, "valueAddedTaxIncluded": true }, "registrationFee": { "currency": "UAH", "amount": 200 }, "auctionPeriodsellingMethod": {"smallPrivatization-english-fast", "startDatetenderAttempts": "2026-02-17T14:30:31.326000+02:00" 2, }, "guarantee": { "sellingMethodcurrency": "smallPrivatization-english-fastUAH", "tenderAttemptsamount": 1100 }, "guaranteetenderPeriod": [ { "currencyunit": "UAHb_day", "amountquantity": 500344 } ], "minimalStep": { "currency": "UAH", "amount": 1005 } } }, { "producedEntities": [ { "type": "procedure", "_id": "69945f5d410e8611f93bb134", "objectId": "SPE001-UA-20260217-44432", "url": "/api/procedures/69945f5d410e8611f93bb134" } ], "status": "active", "name": "sp-english-second", "calculatedData": { "value": { "currency": "UAH", "amount": 500, "valueAddedTaxIncluded": true }, "registrationFee": { "currency": "UAH", "amount": 200 }, "sellingMethod": "smallPrivatization-english-fast", "tenderAttempts": 2, "guarantee": { "currency": "UAH", "amount": 100 }, "tenderPeriod": [ { "unit": "b_day", "quantity": 344 } ], "minimalStep": { "currency": "UAH", "amount": 5 } } }, {}, {} ] ] } } |
| Note | ||
|---|---|---|
| ||
При цьому дата початку аукціону не може припадати на святковий чи вихідний день! |
...