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

Получите изображение из правильного возврата

Метод getReturnPhoto получает фотографии, которые покупатель приложил к заявлению. Он доступен для FBY, FBS, Экспресса и DBS. imageHash берут из поля images решения по товару в информации о возврате. Документация проверена 19 октября 2026 года; инструкция не сообщает о запуске новой функции.

Для запроса нужны идентификаторы магазина, заказа, возврата и товара, а также хеш изображения. Редакционная рекомендация — хранить их вместе как карточку доказательств. Название файла вроде «царапина.jpg» не даёт такой связи: одинаковые имена могут встретиться в десятках обращений. Добавьте технический ID файла и дату получения, оставив исходные сведения доступными ответственному сотруднику.

Проверьте файл до передачи редактору обращения

Документация указывает максимальный размер изображения 50 МБ. Тип определяют по Content-Type; успешный ответ может содержать JPEG или PNG. Не сохраняйте тело ошибки API под расширением картинки только потому, что запрос назывался «скачать фото». Сначала проверьте статус и формат результата.

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

Отделите наблюдение от решения

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

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

Настройте передачу дела между сменами

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

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

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