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

Загальний огляд sanctionedAuctionChain

Мета створення сутності та нормативні засади

З метою автоматичного перевиставлення лотів, що відповідає Постанові №75 від 21 січня 2026 в системі Prozorro.Sale на сервісі Jobber реалізовано нову сутність з pipelineMethod: sanctionedAuctionChain

Бізнес назва - Процес реалізації санкційного активу

Посилання

Постанова

Вимоги до Майданчиків (напишу до кінця тижня і віддам)

ТЗ Процедури SAE

ТЗ Процедури SAD

Глоссарій

Особливості

Створення та робота із ланцюжком:

• При створенні ланцюжка НЕМАЄ повʼязаного обʼєкта типу "Обʼєкт реєстру". "Ланцюжок" - перший обʼєкт, який створюється на ЦБД в процесі реалізації Санкційного майна
• При створенні ланцюжка Організатор має вказати:
  • Дату аукціону для першої процедури
  • Період експозиції (tenderPeriod) для другої і третьої процедури в ланцюжку (присутні валідації, які детально описані нижче)
• При створенні ланцюжка Організатор має вказати:
  • Стартову ціну реалізації для першого аукціону, а для другого і третього ЦБД розрахує автоматично згідно описаних нижче правил
  • розмір Гарантійного внеску для першого аукціону, а для другого і третього ЦБД розрахує автоматично згідно описаних нижче правил
  • Мінімальний крок для першого аукціону, а для другого і третього ЦБД розрахує як 1% від стартової ціни відповідного аукціону
• В ланцюжку зберігаються ідентифікатори Процедур, які були автоматично створені цим ланцюжком (в producedEntities)
• Лацюжок складається максимум з трьох процедур, де кожна наступна процедура створюється автоматично за умови, що попередня процедура "неуспішна"
• Якщо будь-яка процедура в Ланцюжку успішна - ланцюжок не продовжується.

Обʼєкт SanctionedAuctionChain

Статуси обʼєкта

Періоди обʼєкта

Періоди відсутні

Документи обʼєкта

При публікації обʼєкта "ланцюжка" необхідно передати документи першої Процедури ланцюжка.

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

Перелік документів описано в ТЗ до Процедури ТУТ

Логіка роботи Ланцюжка

Публікація ланцюжка

Організатор публікує обʼєкт "Ланцюжка", в якому передає:

• всі поля, які потрібні для публікації англійської і голландської (initialProps)
  
  • включно зі Стартовою ціною та розміром Гарантійного внеску для першої процедури
• період експозиції (в днях) для другої процедури (extraSpecs[1].periods)
• період експозиції (в днях) для третьої процедури (extraSpecs[2].periods)

Обʼєкт створюється у статусі pending

В цьому статусі редагування полів "ланцюжка" недоступне.

Публікація першої процедури

Після успішно опублікованого обʼєкта "ланцюжок", протягом 5 хвилин автоматично створюється перша процедура.

Майданчик може отримати токен від автоматично створеної процедури за endpoint: додати приклад запиту

З моменту створення першої процедури "ланцюжок" набуває статусу active.

В цьому статусі "ланцюжка" Організатор може редагувати поля:

• період експозиції (в днях) для другої процедури до моменту створення другої процедри в ланцюжку
• період експозиції (в днях) для третьої процедури до моменту створення третьої процедри в ланцюжку

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

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

Публікація другої процедури

Якщо перша процедура в ланцюжку отримала статус unsuccessful, то протягом 5 хвилин створюється друга процедура, в яку копіюються значення полів із першої процедури + встановлюється дата auctionPeriod.startDate відповідно до періода експозиції із "ланцюжка".

Обʼєкт "ланцюжка" не змінює статус і залишаєтсья у статусі active

Стартова ціна для другої процедури розраховується в момент її створення, як 50% Стартової ціни першої процедури на момент створення другої

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

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

Деталі і приклади розрахунку стартової ціни описані в розділі "Поля що розраховуються автоматично при створенні другої і третьої процедури"

При авто-створенні другої процедури у ланцюжку ЦБД має автоматично для другої процедури проставити tenderAttempt: 2 та у полі previousAuctionId проставити ID першої процедури із ланцюжка.

Публікація третьої процедури

Якщо друга процедура в ланцюжку отримала статус unsuccessful, то протягом 5 хвилин створюється третя процедура, в яку копіюються значення полів із другої процедури + встановлюється дата auctionPeriod.startDate відповідно до періода експозиції із "ланцюжка".

Обʼєкт "ланцюжка" не змінює статус і залишаєтсья у статусі active

Стартова ціна для третьої процедури розраховується в момент її створення, як 100% Стартової ціни другої процедури на момент створення третьої

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

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

Деталі і приклади розрахунку стартової ціни описані в розділі "Поля що розраховуються автоматично при створенні другої і третьої процедури"

При авто-створенні третьої процедури у ланцюжку ЦБД має автоматично для третьої процедури проставити tenderAttempt: 3 та у полі previousAuctionId проставити ID другої процедури із ланцюжка.

Поля що розраховуються автоматично при створенні другої і третьої процедури

Відповідно до пунктів 70 та 71 Порядку реалізації санкційних активів, ЦБД автоматично створює наступні процедури у разі, якщо попередня процедура визнана такою, що не відбулася.

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

Стартова ціна (initialProps.value)

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

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

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

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

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

Стартова ціна другої процедури розраховується за формулою:

Стартова_ціна_процедури_2 = Стартова_ціна_процедури_1 * 0.5

де Стартова_ціна_процедури_1 — стартова ціна першої процедури на момент створення другої процедури.

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

Округлення результату виконується відповідно до правил математичного округлення до двох знаків після коми.

Третя процедура

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

Стартова ціна третьої процедури встановлюється рівною стартовій ціні другої процедури:

Стартова_ціна_процедури_3 = Стартова_ціна_процедури_2

де Стартова_ціна_процедури_2 — стартова ціна другої процедури на момент створення третьої процедури.

Це відповідає вимогам пункту 71 Порядку, відповідно до якого третій аукціон проводиться зі стартовою ціною, визначеною на рівні стартової ціни попереднього аукціону.

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

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

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

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

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

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

Розрахунок виконується за формулою:

guarantee = startPrice * guaranteeRate

де:

if procedure.value.amount ≥ 250 000 000

then guaranteeRate = 0.05

else guaranteeRate = 0.20

Таким чином:

guaranteeProcedure2 = startPriceProcedure2 * guaranteeRateProcedure2

guaranteeProcedure3 = startPriceProcedure3 * guaranteeRateProcedure3

Розрахунок гарантійного внеску виконується ЦБД автоматично під час створення відповідної процедури.

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

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

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

При автоматичній публікації процедур ЦБД встановлює значення поля tenderAttempts відповідно до порядкового номера процедури в ланцюжку:

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

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

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 копіюється із другої процедури.

Скасування

Скасувати "ланцюжок" окремим запитом неможливо.

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

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

initialProps

extraSpecs[ ]

"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
		}
	}
]

_specs

1. Коли тільки створено ланцюжок (status: pending), відповідь на запит має містити:

• Кількість Процедур у ланцюжку - три;
• Порядковий номер кожної процедури:
  • Для Першої Процедури tenderAttempts == 1
  • Для Другої Процедури tenderAttempts == 2
  • Для Третьої Процедури tenderAttempts == 3
• Статус кожної Процедури - scheduled;
• sellingMethod:
  • Перша Процедура - sanctionedAsset-english
  • Друга Процедура - sanctionedAsset-english
  • Третя Процедура - sanctionedAsset-dutch
• Стартова ціна Об'єкта (value):
  • Перша Процедура - initialProps.value
  • Друга Процедура - 50% від initialProps.value
  • Третя Процедура - 50% від initialProps.value
• Крок аукціону (minimalStep):
  • Для Першої Процедури - значення, що вказав Організатор при створенні в  initialProps.minimalStep
  • Для Другої Процедури - значення, що дорівнює 1% від value Поточної Другої Процедури.
  • Для Третьої Процедури - значення, що дорівнює 1% від value Поточної Третьої Процедури.
• Дата проведення аукціону (periods.periodName:auctionPeriod:startDate):
  • Для Першої Процедури це дата, яку вказав Організатор у полі extraSpecs.periods:"auctionPeriod".startDate при створенні ланцюжка
  • Для Другої і Третьої Процедури ця дата не визначена і поле виводити не потрібно.
• Період між аукціонами (periods.periodName:"tenderPeriod".duration):
  • Для Першої Процедури - відсутній
  • Для Другої і Третьої Процедури значення, що вказав Організатор при створенні ланцюжка у extraSpecs.periods.periodName:"tenderPeriod".duration
• Розмір гарантійного внеску (guarantee):
  • Для Першої Процедури значення, що Організатор вніс у initialProps.guarantee
  • Для Другої і Третьої Процедури по формулі: initialProps.guarantee == розраховується по формулі, залежить від Стартової ціни. Формули ТУТ

2. Коли створено Першу Процедуру (status: active), відповідь має містити:

• Кількість Процедур у ланцюжку - три;
• Порядковий номер кожної процедури (tenderAttempts):
  • Для Першої Процедури tenderAttempts == 1
  • Для Другої Процедури tenderAttempts == 2
  • Для Третьої Процедури tenderAttempts == 3
• Статус Процедури (status):
  • Перша Процедура - active
  • Друга і Третя Процедура - scheduled
• sellingMethod (sellingMethod):
  • Перша Процедура - sanctionedAsset-english
  • Друга Процедура - sanctionedAsset-english
  • Третя Процедура - sanctionedAsset-dutch
• Стартова ціна Об'єкта (value):
  • Перша Процедура - initialProps.value
  • Друга Процедура - 50% від initialProps.value
  • Третя Процедура - 50% від initialProps.value
• Крок аукціону (minimalStep):
  • Для Першої Процедури - значення, що вказав Організатор при створенні ланцюжка у initialProps.minimalStep
  • Для Другої Процедури - значення, що дорівнює 1% від value Поточної Другої Процедури.
  • Для Третьої Процедури - значення, що дорівнює 1% від value Поточної Третьої Процедури.
• Дата проведення аукціону (periods.periodName:"auctionPeriod":startDate):
  • Для Першої Процедури це дата, яку вказав Організатор у полі auctionPeriod.startDate при створенні ланцюжка
  • Для Другої і Третьої Процедури ця дата не визначена і поле виводити не потрібно.
• Період між аукціонами (periods.periodName:tenderPeriod.duration):
  • Для Першої Процедури - відсутній
  • Для Другої і Третьої Процедури значення, що вказав Організатор при створенні ланцюжку у tenderPeriodDuration
• Розмір гарантійного внеску (guarantee):
  • Для Першої Процедури значення, що Організатор вніс у initialProps.guarantee
  • Для Другої і Третьої Процедури initialProps.guarantee розраховується по формулі, залежить від Стартової ціни. Формули ТУТ
• auctionID створеної Першої Процедури (relatedEntities)
  • Для першої Процедури вказано
  • Для другої і третьої - ні

3. Коли створено Другу Процедуру (status: active), відповідь має містити:

• Кількість Процедур у ланцюжку - три;
• Порядковий номер кожної процедури (tenderAttempts):
  • Для Першої Процедури tenderAttempts == 1
  • Для Другої Процедури tenderAttempts == 2
  • Для Третьої Процедури tenderAttempts == 3
• Статус Процедури (status):
  • Перша Процедура - unsuccessful
  • Друга Процедура - active
  • Третя Процедура - scheduled
• sellingMethod (sellingMethod):
  • Перша Процедура - sanctionedAsset-english
  • Друга Процедура - sanctionedAsset-english
  • Третя Процедура - sanctionedAsset-dutch
• Стартова ціна Об'єкта (value):
  • Перша Процедура - initialProps.value
  • Друга Процедура - 50% від initialProps.value АБО якщо Організатор відредагував в Першій процедурі "Стартову ціну", то необхідно змінити значення на 50% від Стартової ціни Першої процедури (до розробки: це можливо без довгої розробки?)
  • Третя Процедура - 50% від initialProps.value
• Крок аукціону (minimalStep):
  • Для Першої Процедури - значення, що вказав Організатор при створенні ланцюжка у initialProps.minimalStep
  • Для Другої Процедури - значення, що дорівнює 1% від value Поточної Другої Процедури
  • Для Третьої Процедури - значення, що дорівнює 1% від value Поточної Третьої Процедури
• Дата проведення аукціону (periods.periodName:"auctionPeriod":startDate):
  • Для Першої Процедури це дата, яку вказав Організатор у полі auctionPeriod.startDate при створенні ланцюжка
  • Для Другої і Третьої Процедури поле виводити не потрібно.
• Період між аукціонами (periods.periodName:"tenderPeriod".duration):
  • Для Першої Процедури - відсутній
  • Для Другої і Третьої Процедури значення, що вказав Організатор при створенні ланцюжка у tenderPeriod.duration
• Розмір гарантійного внеску (guarantee):
  • Для Першої Процедури значення, що Організатор вніс у initialProps.guarantee
  • Для Другої Процедури initialProps.guarantee розраховується по формулі, залежить від Стартової ціни. Формули ТУТ (Варто в розрахунок брати Стартову ціну Другої створеної процедури)
  • Для Третьої Процедури initialProps.guarantee розраховується по формулі, залежить від Стартової ціни. Формули ТУТ
• auctionID створеної Першої Процедури (relatedEntities)
  • Для першої і другої Процедури вказано
  • Для третьої - ні

4. Коли створено Третю Процедуру (status: active), відповідь має містити:

• Кількість Процедур у ланцюжку - три;
• Порядковий номер кожної процедури (tenderAttempts):
  • Для Першої Процедури tenderAttempts == 1
  • Для Другої Процедури tenderAttempts == 2
  • Для Третьої Процедури tenderAttempts == 3
• Статус Процедури (status):
  • Перша Процедура - unsuccessful
  • Друга Процедура - unsuccessful
  • Третя Процедура - active
• sellingMethod (sellingMethod):
  • Перша Процедура - sanctionedAsset-english
  • Друга Процедура - sanctionedAsset-english
  • Третя Процедура - sanctionedAsset-dutch
• Стартова ціна Об'єкта (value):
  • Перша Процедура - initialProps.value
  • Друга Процедура - 50% від initialProps.value АБО якщо Організатор відредагував в Першій процедурі "Стартову ціну", то необхідно змінити значення на 50% від Стартової ціни Першої процедури (до розробки: це можливо без довгої розробки?)
  • Третя Процедура - 50% від initialProps.value АБО якщо Організатор відредагував в Другій процедурі "Стартову ціну", то необхідно змінити значення на 50% від Стартової ціни Другої процедури (до розробки: це можливо без довгої розробки?)
• Крок аукціону (minimalStep):
  • Для Першої Процедури - значення, що вказав Організатор при створенні у initialProps.minimalStep
  • Для Другої Процедури - значення, що дорівнює 1% від value Поточної Другої Процедури.
  • Для Третьої Процедури - значення, що дорівнює 1% від value Поточної Третьої Процедури.
• Дата проведення аукціону (periods.periodName:"auctionPeriod":startDate):
  • Для Першої Процедури це дата, яку вказав Організатор у полі auctionPeriod.startDate при створенні ланцюжка
  • Для Другої і Третьої Процедури поле виводити не потрібно.
• Період між аукціонами (periods.periodName:tenderPeriod.duration):
  • Для Першої Процедури - відсутній
  • Для Другої і Третьої Процедури значення, що вказав Організатор при створенні ланцюжка у tenderPeriod.duration
• Розмір гарантійного внеску (guarantee):
  • Для Першої Процедури значення, що Організатор вніс у initialProps.guarantee
  • Для Другої Процедури initialProps.guarantee розраховується по формулі, залежить від Стартової ціни. Формули ТУТ (Варто в розрахунок брати Стартову ціну Другої створеної процедури)
  • Для Третьої Процедури initialProps.guarantee розраховується по формулі, залежить від Стартової ціни. Формули ТУТ (Варто в розрахунок брати Стартову ціну Третьої створеної процедури)
• auctionID Першої Процедури, auctionID Другої Процедури і auctionID створеної Третьої Процедури

Приклад:

"_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": 1200
					}
				}
			},
			{
				"producedEntities": [
					{
						"type": "procedure",
						"_id": "69945f5d410e8611f93bb134",
						"objectId": "SAE001-UA-20260417-44432",
						"url": "/api/procedures/69945f5d410e8611f93bb134"
					}
				],
				"status": "active",
				"name": "sa-english-second",
				"calculatedData": {
					"value": {
						"currency": "UAH",
						"amount": 50000,
						"valueAddedTaxIncluded": true
					},
 					"guarantee": {
						"currency": "UAH",
						"amount": 10000
					}, 
                    "registrationFee": {
						"currency": "UAH",
						"amount": 800
					},
					"sellingMethod": "sanctionedAsset-english",
					"tenderAttempts": 2,
					"tenderPeriod": [
						{
							"unit": "с_day",
							"quantity": 25
						}
					],
					"minimalStep": {
						"currency": "UAH",
						"amount": 500
					}
				}
			},
			{
				"producedEntities": [],
				"status": "sheduled",
				"name": "sa-dutch-first",
				"calculatedData": {
					"value": {
						"currency": "UAH",
						"amount": 50000,
						"valueAddedTaxIncluded": true
					},
 					"guarantee": {
						"currency": "UAH",
						"amount": 10000
					}, 
                    "registrationFee": {
						"currency": "UAH",
						"amount": 800
					},
					"sellingMethod": "sanctionedAsset-dutch",
					"tenderAttempts": 3,
					"tenderPeriod": [
						{
							"unit": "c_day",
							"quantity": 35
						}
					],
					"minimalStep": {
						"currency": "UAH",
						"amount": 500
					}
				}
			}
		]
	}
}