В июне API Маркета получил отдельную причину отмены: групповая покупка не набрала необходимое число участников. Это помогает отличать её от других отмен заказов.

Какой подстатус появился

Официальный канал API сообщил 19 июня об изменении от 17 июня. В данных заказа появился подстатус PURCHASE_GROUP_THRESHOLD_NOT_REACHED_CANCELLED. Он означает, что заказ участвовал в групповой покупке и был отменён, поскольку необходимое количество покупок не было достигнуто.

Значение добавлено в GET v2/campaigns/{campaignId}/orders/{orderId} и POST v1/businesses/{businessId}/orders — получение отдельного заказа магазина и списка заказов кабинета. Релиз описывает передачу причины, а не запуск самой групповой механики и не изменение всех правил отмены на площадке.

Одинаковый итог может иметь разные причины

Для магазина отменённый заказ — недополученная продажа, но причина важна для дальнейшего действия. Нехватка участников групповой покупки отличается от отсутствия товара, ошибки продавца или отказа конкретного покупателя. Если все случаи складываются в одну строку, команда может неверно оценить качество работы склада или спрос на товар.

Отдельный подстатус даёт возможность сохранить это различие в аналитике. При этом нельзя автоматически предполагать одинаковые финансовые последствия всех отмен: их следует сверять по действующим правилам и начислениям, а не выводить только из названия поля.

Что проверить в интеграции

Программа должна принимать новое значение без аварии и не заменять его ближайшей знакомой причиной. Особенно уязвимы системы с закрытым списком кодов, где неизвестный подстатус блокирует загрузку всего заказа. Безопаснее сохранять исходное значение и явно отмечать необходимость обновить расшифровку.

В пользовательском отчёте полезна понятная формулировка о недостижении порога групповой покупки. Технический идентификатор нужен разработчику, но менеджеру важен смысл. Следует также проверить, что повторное получение заказа не создаёт дублирующую отмену или повторную операцию с остатками.