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

...

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

Посилання

Постанова

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

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

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

...

...

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

...

...

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

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

Відсутні обовʼязкові документи. "Ланцюжок" можна створити з пустим масивом documents[]

При публікації обʼєкта "ланцюжка" необхідно передати Організатор за потреби додає документи першої Процедури ланцюжка. Тобто, при авто-публікації процедури всі документи будуть скопійовані в Першу процедуру.

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

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

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

...

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

 {{baseUrl}}/api/jobber/sanctionedAuctionChain/jsc/{{object_id}}/produced_entities?acc_token={{object_acc_token}}

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

...

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

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

...

...

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

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

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

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

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

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

...

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

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

...

Розмір гарантійного внеску для першої процедури автоматично втановлюється той, який Організатор вказав при публікації обʼєкта 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

...

Anchor
initialProps initialProps

initialProps

Anchor
extraSpecs extraSpecs

extraSpecs AnchorextraSpecsextraSpecsextraSpecs[ ]

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

...

• Кількість Процедур у ланцюжку - три;
• Порядковий номер кожної процедури:
  • Для Першої Процедури tenderAttempts == 1
  • Для Другої Процедури tenderAttempts == 2
  • Для Третьої Процедури tenderAttempts == 3
• Статус кожної Процедури - scheduled;
• sellingMethod:
  • Перша Процедура - sanctionedAsset-english
  • Друга Процедура - sanctionedAsset-english
  • Третя Процедура - sanctionedAsset-dutch
• Стартова ціна Об'єкта (value):
  • Перша Процедура - initialProps.value
  • Друга Процедура - 50% від initialPropsinitialProps.value *0.5
  • Третя Процедура - 50% від initialProps.value *0.5 
• Крок аукціону (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 == розраховується по формулі, залежить від Стартової ціни. Формули ТУТ

...

• Кількість Процедур у ланцюжку - три;
• Порядковий номер кожної процедури (tenderAttempts):
  • Для Першої Процедури tenderAttempts == 1
  • Для Другої Процедури tenderAttempts == 2
  • Для Третьої Процедури tenderAttempts == 3
• Статус Процедури (status):
  • Перша Процедура - active
  • Друга і Третя Процедура - scheduled
• sellingMethod (sellingMethod):
  • Перша Процедура - sanctionedAsset-english
  • Друга Процедура - sanctionedAsset-english
  • Третя Процедура - sanctionedAsset-dutch
• Стартова ціна Об'єкта (value):
  • Перша Процедура - initialProps.value
  • Друга Процедура - 50% від initialProps.value *0.5
  • Третя Процедура - 50% від initialProps.value *0.5 
• Крок аукціону (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)
  • Для першої Процедури вказано
  • Для другої і третьої - ні

...

• Кількість Процедур у ланцюжку - три;
• Порядковий номер кожної процедури (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% від Стартової ціни Першої процедури (до розробки: це можливо без довгої розробки?)*0.5
  • Третя Процедура - 50% від initialProps.value *0.5

• Крок аукціону (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)
  • Для першої і другої Процедури вказано
  • Для третьої - ні

...

• Кількість Процедур у ланцюжку - три;
• Порядковий номер кожної процедури (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% від Стартової ціни Першої процедури (до розробки: це можливо без довгої розробки?)*0.5
  • Третя Процедура - 50% від initialProps.value АБО якщо Організатор відредагував в Другій процедурі "Стартову ціну", то необхідно змінити значення на 50% від Стартової ціни Другої процедури (до розробки: це можливо без довгої розробки?)initialProps.value *0.5 
• Крок аукціону (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": {
						"currencysellingMethod": "UAHsanctionedAsset-english",
						"amounttenderAttempts": 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
					}
				}
			}
		]
	}
}	],
					"minimalStep": {
						"currency": "UAH",
						"amount": 500
					}
				}
			}
		]
	}
}

Search

Потрібно реалізувати публічні ендпоінти, які будуть давати можливість отримувати перелік JSC обʼєктів за заданим пошуком

POST {{baseUrl}}/api/search/sanctionedAuctionChain

Мають бти реалізовані фільтри:

{
    "page": 1,
    "limit": 10,
    "filters": [
        {
            "field": "dateModified",
            "operator": "gt",
            "value": "2020-01-01T05:12:47.00Z"
        },
        {
            "field": "dateModified",
            "operator": "gte",
            "value": "2020-01-01T05:12:47.00Z"
        },
        {
            "field": "dateModified",
            "operator": "lte",
            "value": "2022-01-01T05:12:47.00Z"
        },
        {
            "field": "dateModified",
            "operator": "lt",
            "value": "2026-04-01T05:12:47.00Z"
        },
        {
            "field": "datePublished",
            "operator": "lt",
            "value": "2026-04-01T05:12:47.00Z"
        },
        {
            "field": "owner",
            "operator": "eq",
            "value": "auction"
        },
        {
            "field": "producedEntities.type",
            "operator": "eq",
            "value": "procedure"
        },
        {
            "field": "producedEntities.objectId",
            "operator": "eq",
            "value": "SAE001-UA-20221216-99328"
        },
        {
            "field": "producedEntities._id",
            "operator": "eq",
            "value": "639c8a6a8646c52cb6413d2c"
        },
        {
            "field": "extended_filters.human_id",
            "operator": "eq",
            "value": "JSC001-UA-20221216-41456"
        }
    ]
}

Має бути можливість отримувати обʼєкти з сортуванням:

POST {{baseUrl}}/api/search/sanctionedAuctionChain

{
    "page": 1,
    "limit": 10,
    "sort": [
        {
            "field": "dateModified",
            "direction": "desc"
        }
    ]
}

Mirror

Має бути реалізована можливість майданчикам отримувати обʼєкти JSC по Mirror для сервісу Jobber

Допрацювання процедур SAE SAD

В модель обʼєкта процедури необхідно додати поле relatedEntities (base.RelatedEntity)

Вимоги до Адмінки ЦБД

Додаткова інформація

Функціонал "Додавання додаткової інформації" не вимагається, але може автоматично працювати для JSC. Бізнес запиту на додвання ДІ до JSC не буде, бо бізнесово не існує сутності JSC а також інфо з JSC не буде виводитися на жодному фронті, відповідно і ДІ з JSC також не буде виводитися, якщо ДІ буде додано до обʼєкта.
Але має бути можливість додавати ДІ до авто-опублікованих процедур SAE та SAD за стандартною логікою.

Перенесення обʼєкта з одного Майданчика на інший

Бізнес запит на перенесення обʼєкта буде надходити тільки відносно Процедури. Але реальна бізнес-потреба, однозначно, - в перенесенні всього ланцюжка (обʼєкта JSC)

НЕ реалізовуємо перенос "звʼязки".

Кожен обʼєкт має переноситись індивідуально, незалежно від того, чи це Процедура, чи обʼєкт Джоббера.
Інструкція буде містити інформацію, що для коректного переносу, окрім вказання ідентифікатора Процедури також необхідно вказати ідентифікатор батьківського обʼєкта-ланцюжка.

Організатор на інтерфейсах Майданчика чи на Порталі НЕ має бачити ID ланцюжка. Нормативно ланцюжка не існує, це виключно технічний обʼєкт.

Для переносу всіх повʼязаних обʼєктів їх ID-шники має доповнити в заявку представник зі сторони Prozorro.Sale, який обробляє запит, який надійшов від Організатора.
Організатор точно в своїй заяві не вкаже ID обʼєкта JSC. Його має знайти і дозаповнити представник від Prozorro.Sale

...