Инструкция

Когда использовать эту операцию

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

Удаление необратимо через интерфейс. Оно убирает выбранный файл, а не переносит его в другую заявку. Сначала установите, какой документ действительно нужно убрать, и сохраните необходимый исходник. Фото, которым подтверждена доставка без заданного места, сервер удалить не разрешает. Это относится и к снимку водителя, и к необязательному фото, приложенному администратором или диспетчером при «Закрыть заявку». Файл называется «Место завершения.jpg» или «Место завершения.png».

Определить правильный ID файла

1. В «Документах» раскройте «Фильтры и поиск» и в поле «Название файла или номер заявки» найдите нужный файл. При нескольких версиях сравните дату загрузки и размер.
2. Откройте заявку по её номеру, затем нужное вложение в «Документы и фотографии». Убедитесь по содержимому, что это ошибочный файл.
3. Посмотрите адрес ссылки скачивания: в адресе вида /files/123 число обозначает ID файла, а не ID заявки. Используйте фактическое число из нужной ссылки; пример 123 не является указанием для удаления.
4. Проверьте «История»: если это фото подтверждения доставки, прекращайте удаление и разбирайте ошибку перевозки отдельно. Обычный PDF или изображение, загруженное через «Документы», само по себе доставку не подтверждает.

API «Документы заявок» показывает до 500 последних файлов. Отсутствие старого файла в этой выдаче не означает, что он удалён: для поиска используйте страницу «Документы» с переходом по порциям и конкретную карточку заявки.

Удалить ошибочное обычное вложение

1. Откройте «API и документация» в собственном сеансе администратора и найдите операцию «Удалить документ или вложение». Это POST-операция /documents/{id}/delete в документации API v1.
2. Раскройте операцию, нажмите «Try it out» и заполните параметр id точным ID файла. Не подставляйте номер заявки и не выбирайте соседний документ, если нужный ID неизвестен.
3. Нажмите «Execute» один раз. Это реальное удаление, отдельного учебного режима в документации нет.
4. Проверьте успешный ответ с тем же ID. Затем заново найдите файл в «Документах» и в карточке заявки: прежняя ссылка должна стать недоступной.
5. Если нужен правильный документ, загрузите его к правильной заявке через обычную форму и проверьте новую строку. Новая загрузка создаёт отдельное вложение с новым ID.

Ожидаемый результат — убран только ошибочный файл; заявка, её этап и остальные вложения сохранены. В журнале действий найдите событие document.delete по типу объекта PortalFiles и ID файла. Там можно сопоставить имя, прежнюю привязку и участника операции.

Разобрать отказ или потерянный ответ

• «Фото, подтверждающее доставку, нельзя удалить» — файл защищён как доказательство рейса. Смена роли или другой ключ это условие не отменяют.
• 401 или 403 — проверьте действующий вход администратора либо права ключа. Диспетчер не получает право удаления за счёт доступа к списку документов.
• 404 — проверьте ID, доступность заявки и факт предыдущего удаления. После потерянного ответа сначала сверяйте список и журнал, а не выполняйте новый запрос с другим ID.
• Ошибка хранилища или сервера — сохраните номер файла, номер заявки, время и текст ответа для сопровождения. Не удаляйте другие вложения ради проверки работоспособности.