В июне в ответ метода заказов на уровне кабинета появилось поле itemStatuses. Оно позволяет получать состояние отдельных единиц товара, а не опираться только на общий заказ.

Что добавили в данные заказа

В сообщении от 17 июня официальный канал API Маркета описал обновление от 15 июня: в товарах заказа метода POST v1/businesses/{businessId}/orders появилось поле itemStatuses. В нём возвращается информация о статусах отдельных единиц товара.

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

Общий статус может скрывать различия внутри покупки

Заказ способен содержать несколько товаров или несколько единиц одной позиции. Для складского и финансового учёта важно не потерять различие между количеством и отдельным состоянием. Если программа обновляет всё содержимое только по одной общей отметке, детализация может исчезнуть ещё до попадания в отчёт магазина.

Новое поле позволяет точнее строить такую модель, но требует аккуратного сопоставления идентификаторов. Нельзя связывать записи только по названию: одинаковые товары могут встречаться в разных заказах, а название карточки может меняться.

Как проверить обработку

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

Интеграция должна сохранять смысл неизвестных значений, а не автоматически превращать их в успешное завершение. Это помогает переживать дальнейшее расширение модели без скрытых ошибок. Для оператора желательно показывать понятное объяснение, когда данные требуют повторной проверки.

Практический результат проверки — сохранённое соответствие «заказ — товар — состояние единиц». Это помогает разбирать расхождения количества, но не заменяет финансовый документ и само по себе не подтверждает сумму выплаты.