Ozon 14 апреля сообщил об исправлении логики параметра delete_current_version в методе /v1/cargoes/create. По объяснению команды API, прежде параметр не учитывался и существующие грузоместа перезаписывались при любом запросе. Теперь предусмотренная параметром логика работает. Интеграции, которые привыкли к прежнему фактическому поведению, требуют проверки.

Почему исправление тоже меняет процесс

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

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

Какие сценарии проверить на складе

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

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

Как сделать действие понятным сотруднику

В интерфейсе склада различайте «добавить» и «заменить». Универсальная кнопка «сохранить всё» без объяснения эффекта создаёт риск потери ранее внесённых данных. После изменения полезно показывать сотруднику итоговый состав перед печатью этикеток.

Если произошёл сетевой сбой, сначала перечитайте состояние поставки и только потом повторяйте действие. Это редакционная рекомендация организации интеграции: повтор не должен автоматически означать создание ещё одного комплекта данных.

Как подтвердить исправность интеграции

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