Редагування версії

POST /ecom/jws/scheduled_payments/plan/version/update_v1

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

Що можна змінити залежить від стану версії:

Стан версії	Дозволено змінити	Бізнес потреба
Ще не почалась	appliesDateTimeFrom, appliesDateTimeTo	Зміна дати завершення версіі Зміна дати початку версіі (з автоскороченням активної)
Вже діє	Тільки appliesDateTimeTo	Продовження терміну дії версіі Скорочення терміну дії

Параметри coinAmount, intervalUnit, intervalValue — НЕ редагуються. Якщо потрібно змінити суму або частоту — створюється нова версія плану ендпоітом Редагування плану та додавання нової версіі

Після будь-якого редагування графік ще не виконаних (WAITING) платежів автоматично перебудовується — вже виконані списання це не зачіпає.

Вхідні параметри:

Параметр	Опис	Формат даних	Обовʼязковість	Приклад
planId	Id плану	uuid	так
versionId	Id версіі	int	так
infiniteVersion	ознака нескінченності версіі	boolean	ні, по дефолту false	true
appliesDateTimeFrom	зміна версії застосовується з	TIMESTAMPZ	ні, якщо параметр не передано, то нічого не змінюється	2026-02-26 11:23:45.12+02:00
appliesDateTimeTo	версія застосовується до	TIMESTAMPZ	ні, якщо параметр не передано, то нічого не змінюється	2026-02-26 11:23:45.12+02:00

Вихідні параметри:

Параметр	Опис	Формат даних	Приклад
planId	Id плану	uuid
versionId	Id версіі	int	1
rules.paymentNumberFrom	початковий номер платіжа з якого почина діяти дане правило	integer	1
rules.paymentNumberTo	останній номер платіжа для якого ще працює правило	integer	1
rules.intervalValue	Значення білінг-інтервалу	integer	1
rules.intervalUnit	Одиниця білінг-інтервалу	string	MONTH
rules.coinAmount	сума	long	10
rules.currency	валюта	string	980
appliesDateTimeFrom	зміна застосовується з	TIMESTAMPZ	2026-02-26 11:23:45.12+02:00
appliesDateTimeTo	зміна застосовується до	TIMESTAMPZ	2026-02-26 11:23:45.12+02:00
createdAt	Дата та час створення версіі	TIMESTAMPZ	2026-02-26 11:23:45.12+02:00
updatedAt	Дата та час останнього оновлення версіі	TIMESTAMPZ	2026-02-26 11:23:45.12+02:00

Приклад запиту

{
   "planId":"{{planId}}",
   "versionId":"4",
   "infiniteVersion":"false",
   "appliesDateTimeTo": "2026-10-18 13:46:00.52+03:00",
   "appliesDateTimeTo": "2026-12-18 13:46:00.52+03:00"
}

Приклад відповіді

{
    "planId": "a9562240-10ca-42d7-8d90-bbd1ace3dc5a",
    "versionId": 4,
    "rules": [
        {
            "paymentNumberFrom": 1,
            "paymentNumberTo": 3,
            "intervalValue": 1,
            "intervalUnit": "DAY",
            "coinAmount": 205,
            "currency": "980"
        },
        {
            "paymentNumberFrom": 4,
            "paymentNumberTo": 6,
            "intervalValue": 1,
            "intervalUnit": "MONTH",
            "coinAmount": 8000,
            "currency": "980"
        }
    ],
    "appliesDateTimeFrom": "2026-10-18 13:46:00.52+03:00",
    "appliesDateTimeTo": "2026-12-18 12:46:00.52+02:00",
    "createdAt": "2026-07-10 11:59:54.48+03:00",
    "updatedAt": "2026-07-10 12:10:34.14+03:00"
}