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

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

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

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

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


Глоссарій


Особливості

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


  1. (Андрій)

Чи будемо відображати сутність "Процес реалізації санкційного активу" на Порталі чи на будь-якому іншому фронті?

Ця сутність може бути суто технічна і існувати для автоматизації створення процедур.

В такому випадку не бачу потреби розділяти статуси "успішний" та "неуспішний" процес. Процес (ланцюжок) або "діючий", або "закритий"


2. (Діма)

Якщо Джоббер створив Процедуру і Орг редагує процедуру (наприклад Стартову ціну), то чи зможе Джобер, коли буде створювати другу процедуру забрати із першої Стартову ціну, а не із мастер-обʼєкта?


3. (Андрій)

В Нормативці вказано: Оголошення про проведення аукціону, що публікується організатором аукціону, повинно містити такі відомості: ... 

  • стартова ціна активу для кожного аукціону;

  • розмір гарантійного внеску електронного аукціону для кожного аукціону;

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

Або розраховуємо самі при авто-публікації, а Орга просимо передати тільки для першої? В нормативці написано, що має передати для кожної.

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

Реєстраційний внесок поривєязаний дл мін ЗП і ми також його не валідуємо, а віддаємо на Майданчик. 


Обʼєкт SanctionedAuctionChain

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


techУКР назваАНГЛ назваПерехід зЗа умовиКоментар
pendingОпублікованоCreated-перший статус, який отримує обʼєкт при публікації

Статус, в якому перебуває обʼєкт до моменту створення першої процедури в ланцюжку

Дії Організатора відсутні (тому що планую максимально швидко створювати повʼязану першу процедуру)

active_auctionПроходить аукціонAuctionpendingСтворено першу процедуру в ланцюжкуОбʼєкт має цей статус з моменту створення першої процедури в ланцюжку і до моменту, поки:
  • третя в ланцюжку процедура не набуває термінального статусу (procedure.status: complete OR unsuccessful)
    АБО
  • будь-яка процедура в цьому ланцюжку набуває статусу cancelled
finishedЗавершеноFinishedactive_auction

Третя в ланцюжку процедура набуває статусу procedure.status: complete OR unsuccessful


АБО

Будь-яка процедура в цьому ланцюжку набуває статусу procedure.status: cancelled

Термінальний статус

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

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

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

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

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


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

Організатор публікує обʼєкт SAC, в якому передає:

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

Організатор може редагувати в SAC поля:

до моменту створення другої процедри в ланцюжку.

Організатор може редагувати в SAC поля:

до моменту створення третьої процедри в ланцюжку.


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

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

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

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

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


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


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

70. Якщо електронний аукціон за методом підвищення ціни визнаний таким, що не відбувся, електронна торгова система автоматично оголошує повторний аукціон за методом підвищення ціни із зниженням стартової ціни на 50 відсотків, який проводиться не раніше ніж на двадцятий та не пізніше ніж на тридцять п’ятий день з дати його оголошення (стосовно активу, стартова ціна якого становить менше 250 млн. гривень) або не раніше ніж на тридцятий та не пізніше ніж на дев’яностий день з дати його оголошення (стосовно активу, стартова ціна якого більше або дорівнює 250 млн. гривень).


1) сума, що закінчується від 0,0001 до 0,4999 копійки, заокруглюється в бік зменшення до найближчої суми, яка дорівнює цілій копійці;

2) сума, що закінчується від 0,5 до 0,9999 копійки, заокруглюється в бік збільшення до найближчої суми, яка дорівнює цілій копійці.


Правила заокруглення:

Якщо стартова ціна 11,11 грн, то стартова другого має бути 5,56 грн

Якщо стартова 88,73, то для другого - 44,37 грн


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


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: SAC001-UA-20260217-12345
7pipelineMethod+
stringfalseТипChain type

enum:

  • sanctionedAuctionChain
  • sanctionedAuctionChain-fast
  • sanctionedAuctionChain-manual
  • sanctionedAuctionChain-ultrafast
  • sanctionedAuctionChain-fast-prod
  • sanctionedAuctionChain-fast-prod-fast-first
8sellingEntity base.SellingEntity Інформація про Організатора аукціонуOrganizer information

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

enum: yes, no

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

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

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

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

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

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
valueAddedTaxIncludedbooleanfalsedefault: true
x-legalNameUa: Податок

x-legalNameEn: Tax

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

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

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

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

default: false

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

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

16guarantee+

list[ ] of objects

base.Value

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

Очікуємо в запиті три обʼєкта guarantee для кожної із процедур ланцюжка відповідно


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


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

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


17registrationFee+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


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

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

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

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

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

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

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

maximum: 2

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

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

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

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

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

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

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

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

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

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

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

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

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

21bankAccounts+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"

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

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

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

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

default: 1

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

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

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

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

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

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

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

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

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

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

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

x-format: list-object
minItems: 1

default: List []

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

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

name


dutchStepQuantityinteger($int64)
maximum: 99

default: 99

minimum: 1

x-legalNameUa: Кількість кроків

x-legalNameEn: Dutch steps quantity


dutchStepPercentinteger($int64)
default: 1

readOnly: true

x-legalNameUa: Відсоток зниження, %

x-legalNameEn: Percentage reduction, %


dutchStepValuebase.Value{
description:

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

currency*string
default: UAH

x-legalNameUa: Валюта

x-legalNameEn: Currency
Enum:
Array [ 3 ]
amount*number($float)
example: 10

minimum: 0

x-format: decimal-float

x-legalNameUa: Сума

x-legalNameEn: Amount

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


x-legalNameEn:"Dutch step value"


 

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

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

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

27extraSpecs     

 

28status-stringtrueСтатус процедуриProcedure status

enum:


29_meta     

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

30additionalInformation     

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

31metaInfo     

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


extraSpecs

field namerequired for publishingtypereadOnlyx-legalNameUax-legalNameEncomment
periods
base.PeriodSpec
Інформація про періоди аукціонів
nametypeDescriptioncomment
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