Versions Compared

Old Version 38

changes.mady.by.user Filip Kuzmin

Saved on

compared with

New Version 39

changes.mady.by.user Filip Kuzmin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Code Block
SACJSC (master object)
   ├── Procedure #1 (англійський)
   ├── Procedure #2 (-50% від стартової)
   ├── Procedure #3 (голландський з -50% від першого)
   └── Procedure status controller

...

ТермінПояснення
Ланцюжок

це master-об’єкт в ЦБД на сервісі Jobber, який представляє бізнес-процес реалізації одного санкційного активу через послідовність автоматично створюваних аукціонних процедур.

Ланцюжок створюється Організатором як первинний об’єкт процесу реалізації активу та містить:

  • всі вихідні дані, необхідні для створення процедур
  • автоматично створює до трьох процедур продажу активу
  • зберігає ідентифікатори всіх процедур, що належать цьому процесу
  • керує логікою створення наступної процедури у випадку неуспішності попередньої
  • має власний життєвий цикл та статус (pending, active, sold, dissolved)

Ланцюжок є технічною сутністю, яка використовується для автоматизації перевиставлення активу відповідно до нормативних вимог.

Master-об’єкт

це основна сутність, яка:

  • містить всі дані процесу

  • управляє створенням дочірніх процедур

  • зберігає зв’язок між процедурами

У цьому ТЗ master-об’єктом є SACJSC.

Автоматично створена процедураце процедура, створена ЦБД без участі Організатора на основі правил Ланцюжка.
Попередня процедура

це процедура, на основі якої була створена наступна процедура в Ланцюжку.

В розрізі данного ТЗ "Попередня процедура" може бути лише процедурою цього самого одного ланцюжка і вона не може бути створена раніше до ланцюжка.

Стартова ціна

це початкова ціна продажу активу для конкретної процедури.

Особливості:

  • задається Організатором для першої процедури

  • для другої процедури автоматично зменшується на 50%

  • для третьої процедури використовується стартова ціна другої процедури

Розрахунок і округлення виконуються автоматично ЦБД.

Гарантійний внесок

це сума коштів, яку учасник повинен сплатити для участі в аукціоні.

Розмір:

  • 5% стартової ціни, якщо стартова ціна ≥ 250 млн грн;

  • 20% стартової ціни, якщо стартова ціна < 250 млн грн.

Гарантійний внесок:

  • задається для першої процедури;

  • для наступних процедур розраховується автоматично

Реєстраційний внесок

це плата за реєстрацію заяви на участь в аукціоні.

Цей внесок:

  • передається Майданчиком в запиті на публікації обʼєкта SACJSC

  • не валідується на ЦБД (окрім перевірки, що значення > 0)

...

В другу і третю процедури модель documents[] копіюється із попередньої процедури цього ланцюжка (не із SACJSC, а саме з попередньої процедури)

...

Організатор може редагувати поля створеної процедури протягом 48 годин. Зміни потрібно робити безпосередньо в створеній процедурі, а не в обʼєкті SACJSC. В SAC JSC редагуються тільки два вищевказані параметри.

...

Info
titleПриклад

Організатор створює ланцюжок, де передає:

  • Стартова ціна = 100 000 грн
  • Гарантійний внесок = 10 000 грн (згідно нормативки має бути 20 000 грн, але ЦБД не валідує і пропустить такий обʼєкт)
  • Мінімальний крок = 1200 грн (згідно нормативки має бути 1% від Стартової, але ЦБД не валідує і пропустить такий обʼєкт)

Протягом 5 хвилин створилася перша процедура SAE.

Організатор протягом 48 годин редагує в Процедурі SAE:

  • Стартова ціна = 80 000 грн

В обʼєкті SAC JSC залишиться першочергова Стартова ціна 100 000 грн, а в першіій процедурі SAE Організатор змінив на 80 000 грн.

За результатами - Перша процедура SAE НЕ успішна і отримує статус unsuccessful.

ЦБД протягом 5 хвилин, після отримання Першою процедурою статуса unsuccessful автоматично створює другу процедуру SAE

ЦБД автоматично розраховує:

  • Стартова ціна = 40 000 грн (зверніть увагу, що взяли 50% від останньої ціни, а не від першочергової)
  • Гарантійний внесок = 20% від Стартової ціни = 8 000 грн
  • Мінімальний крок = 1% від Стартової ціни = 400 грн

Організатор протягом 48 годин редагує в другій Процедурі SAE:

  • Стартова ціна = 38 000 грн
  • Гарантійний внесок = 7 000 грн

В обʼєкті SAC JSC залишиться першочергова Стартова ціна 100 000 грн і першочерговий Гарантійний внесок 10 000 грн.

За результатами - Друга процедура SAE НЕ успішна і отримує статус unsuccessful.

ЦБД протягом 5 хвилин, після отримання Другою процедурою статуса unsuccessful автоматично створює третью процедуру SAD

ЦБД автоматично розраховує:

  • Стартова ціна = 38 000 грн
  • Гарантійний внесок = 20% від Стартової ціни = 7 600 грн
  • Мінімальний крок = 1% від Стартової ціни = 380 грн

Організатор протягом 48 годин від моменту створення процедури може редагувати Стартову ціну, Гарантійку, Мінімальний крок і інші поля згідно ТЗ процедури.

...

Перша процедура

При публікації об’єкта SAC JSC Організатор зобов’язаний передати стартову ціну активу у полі initialProps.value

Перша процедура автоматично створюється ЦБД із тим самим значенням стартової ціни, яке було передано в об’єкті SACJSC.

Друга процедура

У разі якщо перша процедура набуває статусу unsuccessful, ЦБД автоматично створює другу процедуру.

...

Розмір гарантійного внеску для першої процедури автоматично втановлюється той, який Організатор вказав при публікації обʼєкта SACJSC

Друга та третя процедура

Гарантійний внесок для другої та третьої процедур розраховується автоматично на основі стартової ціни відповідної процедури

...

Номер спроби продажу (tenderAttempts)

При публікації обʼєкта SAC JSC Організатор НЕ передає параметр tenderAttempts

...

Anchor
minimalStep
minimalStep
Мінімальний крок аукціону

При публікації обʼєкта SAC JSC Організатор передає параметр minimalStep.amount та minimalStep.currency

При автоматичній публікації першої процедури ЦБД встановлює значення поля minimalStep.amount та minimalStep.currency точно таким, як вказав Організатор при публікації SACJSC

При автоматичній публікації другої процедури ЦБД розраховує значення поля minimalStep.amount, як 1% від Стартової ціни другої процедури (minimalStep.amount == value.amount * 0,01)

...

minimalStep.currency копіюється із другої процедури.


Anchor
sac_model
sac_model
Структура даних обʼєкта

...

JSC


Field nameRequired for publishingTypereadOnlyx-legalNameUax-legalNameEncomment
1owner-stringtrueІдентифікатор майданчикаBroker Name
2ownerToken-string($uuid)true

x-default: hex
3_id-string

trueВнутрішній ідентифікаторIDx-default: object_id
x-serialize_when_none: false
x-format: object-id
4datePublished-string($date-time)
trueДата публікаціїPublished datex-default: now
5dateModified-string($date-time)
trueОстання дата зміниDate modified
6objectId-string
trueІдентифікатор ланцюжкаChain IDexample: SAC001JSC001-UA-20260217-12345
7status-stringtrueСтатус процедуриProcedure status

enum:

  • pending
  • active
  • sold
  • dissolved
8pipelineMethod+
stringfalseТипChain type

enum:

  • sanctionedAuctionChain
  • sanctionedAuctionChain-fast
  • sanctionedAuctionChain-manual
  • sanctionedAuctionChain-ultrafast
  • sanctionedAuctionChain-fast-prod
  • sanctionedAuctionChain-fast-prod-fast-first
9initialProps+objectfalseЗагальна інформація про процедуриProcedure informantion


10extraSpecs+list[ ] of objectsfalseІнформація для базових специфікаційBase information
11producedEntities-list[ ] of objectstrueСтворені обʼєктиProduced entitiesbase.ProducedEntity{
type

string
readOnly: true

default: procedure

Тип зв'язку

_idstring
readOnly: true
x-legalNameUa: Внутрішній ідентифікатор створеної сутності
x-legalNameEn: ID
x-default: object_id
x-serialize_when_none: false
x-format: object-id
objectIdstring
readOnly: true
example: SAE001-UA-20260320-12345
x-legalNameUa: идентифікатор створеної сутності
x-legalNameEn: produced entity id

Людиночитаємий идентифікатор створеної сутності

ownerTokenstring($uuid)
readOnly: true
x-default: hex

Token used for get access to produced entity

urlstring
readOnly: true

Direct url to produced entity.


12_specs-objecttrueРозрахункові даніCalculated data

 

13_meta- objecttrue  

Використовується стандартна логіка

14additionalInformation- objecttrue  

Використовується стандартна логіка

15metaInfo- objecttrue  

Використовується стандартна логіка

...


field nameRequired for publishingtypereadOnlyx-legalNameUax-legalNameEncomment
1sellingEntity +base.SellingEntity falseІнформація про Організатора аукціонуOrganizer information

Використовується стандартна модель

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

2lotId+
stringfalseНомер лотаLot number

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

3title+base.MultiLangfalseНазва аукціонуAuction title

Використовується стандартна модель

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

4description+base.MultiLangfalseОпис аукціонуAuction description

Використовується стандартна модель

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

5saleCondition+stringfalseНаявність умов продажуSale conditions

enum:

  • yes
  • no

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

6value+base.ValueWithTaxfalseСтартова ціна лотаStart price

Використовується стандартна модель

nametypereadOnly

Comment

currency *string
false

default: UAH
x-legalNameUa: Валюта
x-legalNameEn: Currency

Enum:
[ UAH, USD, EUR ]

amount *number($float)falseexample: 10
minimum: 2
exclusiveMinimum: true
x-format: decimal-float
x-legalNameUa: Сума
x-legalNameEn: Amount
valueAddedTaxIncludedbooleanfalsedefault: true
x-legalNameUa: Податок
x-legalNameEn: Tax

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку відбувається авторозрахунок згідно правил

7valueAddedTaxCharged-booleanfalseНа фінальну суму нараховується ПДВValue added tax charged

default: false

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

8minimalStep+base.ValuefalseРозмір кроку аукціонуMinimal step

Використовується стандартна модель

  • Для Першої Процедури - значення, що вказав Організатор при створенні ланцюжка у initialProps.minimalStep
  • Для Другої Процедури - значення, що дорівнює 1% від value Поточної Другої Процедури.
  • Для Третьої Процедури - значення, що дорівнює 1% від value Поточної Третьої Процедури.

Описано ТУТ

9guarantee+

base.Value

falseРозмір гарантійного внескуGuarantee Fee


field nametypereadOnlycomment
currency *string
false

default: UAH
x-legalNameUa: Валюта
x-legalNameEn: Currency

Enum:
[ UAH, USD, EUR ]

amount *number($float)falseexample: 10
minimum: 0
exclusiveMinimum: true
x-format: decimal-float
x-legalNameUa: Сума
x-legalNameEn: Amount

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку відбувається авторозрахунок згідно правил

Info
titleПостанова

гарантійний внесок - сума коштів:

  • 5 % стартової ціни, якщо вона дорівнює або перевищує 250 млн. гривень
  • 20 % стартової ціни, якщо вона є меншою, ніж 250 млн. гривень

Логіка розрахунку описана ТУТ

10registrationFee-base.ValuefalseРозмір реєстраційного внеску
field nametypereadOnlycomment
currency *string
false

default: UAH
x-legalNameUa: Валюта
x-legalNameEn: Currency

Enum:
[ UAH, USD, EUR ]

amount *number($float)falseexample: 10
minimum: 0
exclusiveMinimum: true
x-format: decimal-float
x-legalNameUa: Сума
x-legalNameEn: Amount


Info
titleПостанова

Реєстраційний внесок - плата за реєстрацію заяви про участь в аукціоні, що вноситься особою, яка має намір взяти участь в аукціоні, на відповідний рахунок оператора, у розмірі

  • 0,2 мінімальної заробітної плати, встановленої станом на 1 січня поточного року, для активів, стартова ціна яких є меншою, ніж 250 млн.гривень
  • у розмірі 10 мінімальних заробітних плат, встановлених станом на 1 січня поточного року, - для активів, стартова ціна яких дорівнює або перевищує 250 млн. гривень

Залишаємо на відповідальність Майданчика. ЦБД отримує значення і не валідує їх

Тільки, що значення >0

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

11bankAccounts+sanctionedAssets.BankAccountsByTypefalseБанківські рахункиBank accounts

Використовується стандартна модель

Обов'язково один банківський рахунок з типом guarantee і валютою UAH. Рахунків для кожного типу в UAH/USD/EUR може бути безліч. 

field nametypecomment
accountTypestring

x-dictionaries: List [ "accountType" ]

Enum:
[ registrationFee, guarantee, other, payment ]

accountscommercialSell.BankAccountWithCurrencyx-baseClass: "prozorro_sale.procedure.models.base.BankAccount"

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

12 items+sanctionedAssets.ItemfalseСклад лотаLot composition

Використовується стандартна модель

x-format: list-object
minItems: 1
default: List []

13documents+ base.DocumentsfalseВсі документи аукціону та пов'язані додаткиDocuments

Використовується стандартна модель

x-format: list-object
default: List []

14minNumberOfQualifiedBids-integer($int64)falseМінімальна кількість заявMinimal number of bidsdefault: 1
minimum: 1
maximum: 2

При публікації обʼєкта можна не передавати. ЦБД автоматично згенерує == 1.

Організатор може передати явно 1 або 2 за необхідності.

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

15accessDetails-base.MultiLangfalseПорядок ознайомлення з майном, час і місце проведення огляду об’єктаAuction access details

Використовується стандартна модель

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

16x_documentRequirements-base.MultiLangfalseПерелік та вимоги до оформлення документівList and requirements of registration documents

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

17x_additionalInformation-base.MultiLangfalseДодаткові відомостіOther requirements and additional information

Очікуємо цей параметр в запиті на публікації SACJSC

При авто-створенні першої процедури копіюємо значення в неї.

При авто-створенні другої та\або третьої процедури в ланцюжку копіюємо це значення із попередньої процедури ланцюжка

18tenderAttempts-integer($int64)
trueЛот виставляєтьсяAttempt number

Не повинно відображатися в моделі SAC JSC як окреме поле, але має авто-розраховуватись і відображатись в Процедурі

При публікації SAC JSC не очікуємо в запиті поля tenderAttempts.

При авто-публікації першої процедури ЦБД має проставити:

1-й процедурі: tenderAttempts = 1

2-й процедурі: tenderAttempts = 2 та у полі previousAuctionId значення auctionId від першої процедури цього ланцюжка

3-й процедурі: tenderAttempts = 3 та у полі previousAuctionId значення auctionId від другої процедури цього ланцюжка

...

field namerequired for publishingtypereadOnlyx-legalNameUax-legalNameEncomment
periods+base.PeriodSpecfalseІнформація про періоди аукціонівPeriods info
field nametypenamecomment
periodNamestringx-legalNameUa: Назва періода
x-legalNameEn: Period name

enum:

  • auctionPeriod
  • tenderPeriod
startDatestring($date-time)

x-legalNameUa: Дата та час початку
x-legalNameEn: Start date
endDatestring($date-time)

x-legalNameUa: Дата та час завершення
x-legalNameEn: End date
durationbase.Durationx-legalNameUa: Тривалість періоду
x-legalNameEn: Period duration
nametypecomment
unitstringEnum:
  • b_day
  • c_day
  • hour
  • minute
  • second
quantityinteger($int64)

minimum: 1

При публікації "ланцюжка", ЦБД очікує, що в extraSpecs обовʼязково буде передано обʼєкт для кожної процедури.

Тобто, всього три обʼєкта в extraSpecs, бо процедур в ланцюжку три.

Валідації

На рівні ЦБД необхідно встановити валідації для pipelineMethod: sanctionedAuctionChain:

Для першої процедури приймається значення:

extraSpecs.[0].periods.periodName=="auctionPeriod"

extraSpecs.[0].periods.startDate ==

if value.amount < 250 000 000 (двісті п'ятдесят мільйонів)

then 
ЦБД має приймати тільки значення для extraSpecs.[0].periods[0].startDate в діапазоні  currentDate+25 c_day <= startDate <=  currentDate+35 c_day

ЦБД повинна відхилити запит, якщо знчення extraSpecs.[0].periods[0].startDate, яке передають в запиті на публікацію SAC JSC знаходиться поза цим діапазоном.

else if value.amount >= 250 000 000 (двісті п'ятдесят мільйонів)

then
ЦБД має приймати тільки значення для auctionPeriod.startDate в діапазоні  currentDate+60 c_day <= startDate <=  currentDate+90 c_day

ЦБД повинна відхилити запит, якщо знчення extraSpecs.[0].periods[0].startDate, яке передають в запиті на публікацію SAC JSC знаходиться поза цим діапазоном.

При цьому дата початку аукціону не може припадати на святковий чи вихідний день! 

Для другої процедури приймається значення:

extraSpecs.[1].periods.periodName=="tenderPeriod"

extraSpecs.[1].periods.duration ==

if value.amount < 250 000 000 (двісті п'ятдесят мільйонів)

then 
ЦБД має приймати тільки значення для extraSpecs.[1].periods[0].duration в діапазоні  20 c_day <= duration <=  35 c_day

ЦБД повинна відхилити запит, якщо знчення duration, яке передають в запиті на публікацію SAC JSC знаходиться поза цим діапазоном.

else if value.amount >= 250 000 000 (двісті п'ятдесят мільйонів)

then
ЦБД має приймати тільки значення для extraSpecs.[1].periods[0].duration в діапазоні  30 c_day <= startDate <=  90 c_day

ЦБД повинна відхилити запит, якщо знчення duration, яке передають в запиті на публікацію SAC JSC знаходиться поза цим діапазоном.

Для третьої процедури приймається значення:

extraSpecs.[1].periods.periodName=="tenderPeriod"

extraSpecs.[1].periods.duration ==

if value.amount < 250 000 000 (двісті п'ятдесят мільйонів)

then 
ЦБД має приймати тільки значення для extraSpecs.[2].periods[0].duration в діапазоні  20 c_day <= duration <=  35 c_day

ЦБД повинна відхилити запит, якщо знчення duration, яке передають в запиті на публікацію SAC JSC знаходиться поза цим діапазоном.

else if value.amount >= 250 000 000 (двісті п'ятдесят мільйонів)

then
ЦБД має приймати тільки значення для extraSpecs.[2].periods[0].duration в діапазоні  30 c_day <= startDate <=  90 c_day

ЦБД повинна відхилити запит, якщо знчення duration, яке передають в запиті на публікацію SAC JSC знаходиться поза цим діапазоном.


Приклад для value.amount < 250 000 000 (двісті п'ятдесят мільйонів):

Code Block
"extraSpecs": [
	{
		"periods": [
			{
				"periodName": "auctionPeriod",
				"startDate": "2026-03-20T10:00:00.000000Z"
			}
		]
	},
	{
		"periods": [
			{
				"periodName": "tenderPeriod",
				"duration": [
					{
						"unit": "c_day",
						"quantity": 25
					}
				]
			}
		]
	},
	{
		"periods": [
			{
				"periodName": "tenderPeriod",
				"duration": [
					{
						"unit": "c_day",
						"quantity": 35
					}
				]
			}
		],
		"dutchStep": {
			"dutchStepQuantity": 99
		}
	}
]


dutchStep+base.DutchStepfalseКрок голландського раундуDutch step

Поля dutchStepPercent та dutchStepValue автогенеруються на рівні ЦБД, без можливості внесення змін Організатором
Для поля dutchStepQuantity ЦБД формує дефолтне значення згідно процедури, Організатор має можливість змінити дефолтне значення.

field nametypenamecomment
dutchStepQuantity

integer($int64)

x-legalNameUa: Кількість кроків
x-legalNameEn: Dutch steps quantity		default: 99
maximum: 99
minimum: 1
dutchStepPercent

integer($int64)

x-legalNameUa: Відсоток зниження, %
x-legalNameEn: Percentage reduction, %		default: 1
readOnly: true
dutchStepValuebase.Value

x-legalNameUa: Розмір кроку голландського раунду, грн

x-legalNameEn: Dutch step value

автогеровано, розраховується як 1 % від стартової ціни

currencystring
default: UAH
x-legalNameUa: Валюта
x-legalNameEn: CurrencyEnum:
enum: UAH, USD, EUR
amountnumber($float)
example: 10
minimum: 0
x-format: decimal-float
x-legalNameUa: Сума
x-legalNameEn: Amount
 

...

Note
titleПИТАННЯ
  1. Чи будемо відображати сутність "Процес реалізації санкційного активу" на Порталі, Майданчику чи на будь-якому іншому фронті? - На фронті має відображатися період експозиції для майбутніх Процедур, а ця інформація міститься тільки в SACJSC
  2. Реєстраційний внесок поривʼязаний до мін ЗП і ми його не валідуємо, а віддаємо на Майданчик.
  3. Валідації на Періоди? - так, робимо у нас
  4. ендпоінт на мінСтартДейт робимо пізніше окремою таскою. 

...