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

Описание журнала заказов Деловых Линий обновлено 16 февраля 2026 года и проверено редакцией 13 октября. Это инструкция по интерпретации данных.

Читайте признак вместе с причиной и статусом

В журнале API returnState обозначает возвратный груз, returnReason содержит причину, а returnDate — дату и время установки этого признака. Текущий статус заказа передаётся отдельно в state и stateName.

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

Сохраняйте связь с продажей

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

Учебный сценарий: у двух отправлений одного клиента одинаковое число коробок. Возвратный признак появился у первого. Массовое изменение обоих заказов исказит продажи и ожидаемый остаток. Правильная запись должна объяснять, какая транспортная операция изменилась и какие товарные единицы предстоит проверить после получения.

Не заменяйте отсутствующие данные отрицанием

Документация предупреждает, что недоступная информация может возвращаться как null, например из-за состава доступа или применимости поля. Это не равнозначно подтверждённому отрицательному значению.

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

Закрывайте возврат после осмотра

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

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