29.12.2025

Оновлення API за 29.12.2025

Оновлення API eCom: зміни параметра onFailReceiveType.

З метою уніфікації процесів повернення та підвищення стабільності роботи API повідомляємо про зміни в обробці параметра onFailReceiveType.

В API eCom підтримуватимуться лише два допустимі значення цього параметра:

1. RETURN — повернути відправлення відправнику;
2. PROCESS_AS_REFUSAL — не повертати відправлення (знищення).

Усі інші значення (зокрема RETURN_7_DAYS, RETURN_14_DAYS тощо) будуть вилучені та більше не підтримуватимуться.

Важливо:

Строк повернення відправлення (7 або 14 днів) система визначатиме автоматично — залежно від типу відділення. Для відділень міського типу 7 дні, для відділень сільського типу 14 днів. Додатково передавати цей параметр у запиті більше не потрібно.

Критичність змін:

Починаючи з 2026 року, без оновлення інтеграції створення відправлень через API стане неможливим.

У разі передачі недопустимого значення система повертатиме помилку:

invalid onFailReceiveType.

Що необхідно зробити:

Рекомендуємо протягом січня 2026 року:

1. внести відповідні зміни у ваш код / API-інтеграцію;
2. видалити застарілі значення параметра onFailReceiveType;
3. протестувати створення відправлень після оновлення.

Рекомендовані дії:

1. Ознайомтеся з повним переліком змін у матеріалі.
2. Передайте цю інформацію вашим ІТ-фахівцям або партнерам з інтеграції.
3. Або скористайтеся покроковою інструкцією для внесення змін.
4. У разі виникнення запитань звертайтеся до служби підтримки B2B-клієнтів Укрпошти.

З повагою команда розробників API.