Page History

...

draw.io Diagram

border	true

diagramName	SAC_statuses
simpleViewer	false
width
links	auto
tbstyle	top
lbox	true
diagramWidth	347
revision	45

tech	УКР назва	АНГЛ назва	Перехід з	За умови	Коментар
pending	Опубліковано	Created	-	перший статус, який отримує обʼєкт при публікації	Статус, в якому перебуває обʼєкт до моменту створення першої процедури в ланцюжку Протягом 5 хвилин має автоматично опублікуватися Перша процедура SAE
active	Проходить аукціон	Auction	pending	Створено першу процедуру в ланцюжку	Обʼєкт має цей статус з моменту створення першої процедури в ланцюжку і до моменту, поки: третя в ланцюжку процедура не набуває термінального статусу (procedure.status: complete OR unsuccessful) АБО будь-яка процедура в цьому ланцюжку набуває статусу cancelled
sold	Продано	Sold	active	Будь-яка процедура в цьому ланцюжку набуває статусу procedure.status: complete	Термінальний статус
dissolved	Не продано	Dissolved	active	Будь-яка процедура в цьому ланцюжку набуває статусу procedure.status: cancelled Третя в ланцюжку процедура набуває статусу procedure.status: unsuccessful	Термінальний статус

...

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

...

metaInfo object

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: 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: JSC001-UA-20260217-12345

7

status

-

string

true

Статус процедури

Procedure status

enum:

pending
active
sold
dissolved

8

pipelineMethod

+

string

false

Тип

Chain type

enum:

sanctionedAuctionChain
sanctionedAuctionChain-fast
sanctionedAuctionChain-manual
sanctionedAuctionChain-ultrafast
sanctionedAuctionChain-fast-prod
sanctionedAuctionChain-fast-prod-fast-first

9

initialProps

+

object

false

Загальна інформація про процедури

Procedure informantion

10

extraSpecs

+

list[ ] of objects

false

Інформація для базових специфікацій

Base information

minItems: 3

11

producedEntities

-

list[ ] of objects

true

Створені обʼєкти

Produced entities

base.ProducedEntity{

type	string readOnly: true default: procedure Тип зв'язку
_id	string readOnly: true x-legalNameUa: Внутрішній ідентифікатор створеної сутності x-legalNameEn: ID x-default: object_id x-serialize_when_none: false x-format: object-id
objectId	string readOnly: true example: SAE001-UA-20260320-12345 x-legalNameUa: идентифікатор створеної сутності x-legalNameEn: produced entity id Людиночитаємий идентифікатор створеної сутності
ownerToken	string($uuid) readOnly: true x-default: hex Token used for get access to produced entity
url	string readOnly: true Direct url to produced entity.

12

_specs

-

object

true

Розрахункові дані

Calculated data

13

_meta

-

object

true

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

14

additionalInformation

-

object

true

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

15

activeScenario

-

string

true

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

...

Відображається поточний стан JSC

16

archiveId

-

string

true

x-format: object-id
x-serialize_when_none: false

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

17

_protected

-

boolean

true

default: false

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

18

_version

-

integer($int64)

true

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

19

timer

string($date-time)

true

x-format: timer
x-serialize_when_none: false

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

20

periods

-

object

base.Period

true

Час до створення першої процедури

First procedure creation time

тех назва	Required	Type	Бізнес назва УКР	Бізнес назва АНГЛ
rectificationPeriod
startDate	-	string($date-time)	Дата та час початку	Start time
endDate	-	string($date-time)	Дата та час завершення	End time

Anchor
initialProps
initialProps
initialProps

field name

Required for publishing

type

readOnly

x-legalNameUa

x-legalNameEn

comment

1

sellingEntity

+

base.SellingEntity

false

Інформація про Організатора аукціону

Organizer information

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

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

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

При авто

field name

Required for publishing

type

readOnly

x-legalNameUa

x-legalNameEn

comment

1

sellingEntity

+

base.SellingEntity

false

Інформація про Організатора аукціону

Organizer information

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

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

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

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

2

lotId

+

string

false

Номер лота

Lot number

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

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

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

3

title

+

base.MultiLang

false

Назва аукціону

Auction title

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

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

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

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

4

description

+

base.MultiLang

false

Опис аукціону

Auction description

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

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

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

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

5

saleCondition

+

string

false

Наявність умов продажу

Sale conditions

enum:

yes
no

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

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

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

6

value

+

base.ValueWithTax

false

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

Start price

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

name	type	readOnly	Comment
currency *	string	false	default: UAH x-legalNameUa: Валюта x-legalNameEn: Currency Enum: [ UAH, USD, EUR ]
amount *	number($float)	false	example: 10 minimum: 2 exclusiveMinimum: true x-format: decimal-float x-legalNameUa: Сума x-legalNameEn: Amount
valueAddedTaxIncluded	boolean	false	default: true x-legalNameUa: Податок x-legalNameEn: Tax

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

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

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

7

valueAddedTaxCharged

-

boolean

false

На фінальну суму нараховується ПДВ

Value added tax charged

default: false

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

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

8

minimalStep

+

base.Value

false

Розмір кроку аукціону

Minimal step

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

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

Описано ТУТ

9

guarantee

+

base.Value

false

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

Guarantee Fee

field name

type

readOnly

comment

currency *

string

false

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

Enum:
[ UAH, USD, EUR ]

amount *

number($float)

false

example: 10
minimum: 0
exclusiveMinimum: true
x-format: decimal-float
x-legalNameUa: Сума
x-legalNameEn: Amount

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

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

Info

title	Постанова

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

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

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

10

registrationFee

-

base.Value

false

Розмір реєстраційного внеску

field name

type

readOnly

comment

currency *

string

false

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

Enum:
[ UAH, USD, EUR ]

amount *

number($float)

false

example: 10
minimum: 0
exclusiveMinimum: true
x-format: decimal-float
x-legalNameUa: Сума
x-legalNameEn: Amount

Info

title	Постанова

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

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

Note
ЦБД не перевіряє відповідність registrationFee нормативному значенню. Відповідальність за коректність лежить на майданчику.

Значення >0

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

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

11

bankAccounts

+

sanctionedAssets.BankAccountsByType

false

Банківські рахунки

Bank accounts

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

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

field name

type

comment

accountType

string

x-dictionaries: List [ "accountType" ]

Enum:
[ registrationFee, guarantee, other, payment ]

accounts

commercialSell.BankAccountWithCurrency

x-baseClass: "prozorro_sale.procedure.models.base.BankAccount"

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

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

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

12

items

+

sanctionedAssets.Item

false

Склад лота

Lot composition

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

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

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

13

documents

+-

base.Documents

false

Всі документи аукціону та пов'язані додатки

Documents

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

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

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

14

minNumberOfQualifiedBids

-

integer($int64)

false

Мінімальна кількість заяв

Minimal number of bids

default: 1
minimum: 1
maximum: 2

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

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

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

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

15

accessDetails

-

base.MultiLang

false

Порядок ознайомлення з майном, час і місце проведення огляду об’єкта

Auction access details

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

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

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

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

16

x_documentRequirements

-

base.MultiLang

false

Перелік та вимоги до оформлення документів

List and requirements of registration documents

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

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

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

17

x_additionalInformation

-

base.MultiLang

false

Додаткові відомості

Other requirements and additional information

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

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

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

18

tenderAttempts

-

integer($int64)

true

Лот виставляється

Attempt number

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

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

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

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

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

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

...

field name

required for publishing

type

readOnly

x-legalNameUa

x-legalNameEn

comment

periods

+

base.PeriodSpec

false

Інформація про періоди аукціонів

Periods info

field name

type

name

comment

periodName

string

x-legalNameUa: Назва періода
x-legalNameEn: Period name

enum:

auctionPeriod
tenderPeriod

startDate

string($date-time)

x-legalNameUa: Дата та час початку
x-legalNameEn: Start date

endDate

string($date-time)

x-legalNameUa: Дата та час завершення
x-legalNameEn: End date

duration

base.Duration

x-legalNameUa: Тривалість періоду
x-legalNameEn: Period duration

name	type	comment
unit	string	Enum: b_day c_day hour minute second
quantity	integer($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, яке передають в запиті на публікацію 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, яке передають в запиті на публікацію JSC знаходиться поза цим діапазоном.

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

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

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

extraSpecs.[1].periods.duration ==

if value.amount < 250 000 000 (двісті п'ятдесят мільйонів) ВАЖЛИВО! value.amount береться ДРУГОЇ процедури2-ї процедури = value.amount із JSC*0,5 (тобто, 50% від стартової ціни, яку передає Організатор)

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

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

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

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

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

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

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

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

extraSpecs.[2].periods.duration ==

if value.amount < 250 000 000 (двісті п'ятдесят мільйонів) ВАЖЛИВО! value.amount береться ТРЕТЬОЇ процедуриятдесят мільйонів) ВАЖЛИВО! value.amount 3-ї процедури = value.amount із JSC*0,5 (тобто, 50% від стартової ціни, яку передає Організатор)

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

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

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

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

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

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

Note

title	ВАЖЛИВО

tenderPeriod валідується тільки один рах при створенні і якщо Організатор редагує value.amount то tenderPeriod вже не перераховується і не валідується

Приклад для 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.DutchStep

false

Крок голландського раунду

Dutch step

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

field name

type

name

comment

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

dutchStepValue

base.Value

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

x-legalNameEn: Dutch step value

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

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

...

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
					},"calculatedData": {
					"guaranteevalue": {
						"currency": "UAH",
						"amount": 10000100000,
						"valueAddedTaxIncluded": true
					},
                    "registrationFee					"guarantee": {
						"currency": "UAH",
						"amount": 80010000
					},
 					"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",
						"amountvalueAddedTaxIncluded": 10000true
					}, 
                    "registrationFee 					"guarantee": {
						"currency": "UAH",
						"amount": 80010000
					},
					"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
					}
				}
			}
		]
	}
}

...

field name	required for publishing	type	readOnly	x-legalNameUa	x-legalNameEn	comment
type	-	string	true	Тип споріднення	Relate type	enum: sanctionedAuctionChain sanctioned_auction_chain
_id	-	string	true	Внутрішній ідентифікатор повʼязаного обʼєкта	Internal related object id	x-default: object_id x-serialize_when_none: false x-format: object-id Поле має заповнитися значенням _id повʼязаного JSC обʼєкта
objectId	-	string	true	Ідентифікатор повʼящаного обʼєкта	Related object id	example: SAE001-UA-20260220-12345 Поле має заповнитися значенням objectId повʼязаного JSC обʼєкта
url	-	string	true	Посилання на повʼязаний обʼєкт	URL	Посилвання на JSC обʼєкт

...

Space shortcuts

Page tree

Versions Compared

Old Version 61

New Version Current

Key

Anchor
initialProps
initialProps
initialProps

Space shortcuts

Page tree

Page History

Versions Compared

Old Version 61

New Version Current

Key

AnchorinitialPropsinitialPropsinitialProps

Anchor
initialProps
initialProps
initialProps