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

Сначала проверить применимость метода

В документации downloadShipmentTransportationWaybill прямо разделены два сценария. Если Маркет забирает товары со склада продавца, метод возвращает транспортную накладную заданной отгрузки. Если продавец сам привозит груз в ПВЗ или сортировочный центр, накладная этим способом не предоставляется. Ограничение относится к API-методу, а не к универсальному перечню документов любой перевозки.

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

Как сопоставить отгрузку и запрос

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

Если рейс готовится повторно, проверьте, к какой операции относится сохранённый файл. Нельзя просто переименовать документ вчерашней отгрузки ради удобства водителя. Механика предварительных актов рассмотрена в руководстве по подтверждению FBS. Транспортная накладная и акт не должны сливаться в одну неопределённую кнопку «скачать документы».

Почему успешный ответ может не открываться

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

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

Как завершить разбор без подмены документов

Если метод неприменим к выбранному способу передачи, зафиксируйте это как объяснённый результат и используйте документы предусмотренного сценария. Общие изменения электронного транспортного документооборота рассмотрены в материале об ЭТрН Маркета. Получение XLSX через этот API само по себе не доказывает выполнение всех требований к электронным перевозочным документам.

Для применимого сценария результатом проверки будет читаемый файл, относящийся к правильной отгрузке, и понятное место его хранения для сотрудников. Для неприменимого — отсутствие лишней аварийной очереди повторных запросов. Документация проверена 22 октября 2026 года; это руководство по диагностике действующего метода, а не сообщение о новом обязательном документе для всех продавцов.