Документы Деловых Линий через API: как связать счёт и накладную с правильной перевозкой
Как получать документы Деловых Линий через API: найти UID накладной, выбрать тип формы, проверить роль плательщика и сохранить файл нужной перевозки.
Содержание статьи
При большом числе отправлений документы удобно сохранять автоматически, но ошибка сопоставления может отправить в папку заказа чужой счёт. Для магазина важна цепочка от номера перевозки до конкретного документа и доступного файла, а не только отсутствие ошибки загрузки.
Официальная документация Деловых Линий обновлена 5 февраля 2026 года, проверена редакцией 13 октября. Реальные запросы к кабинету продавца не выполнялись.
Найдите идентификатор транспортного документа
Метод печатных форм использует docUID. Его получают из UID документа в журнале заказов, из блока с типом shipping. Тип требуемой формы задают отдельно: счёт, накладная, счёт-фактура или накладная на выдачу.
Не заменяйте этот идентификатор номером заказа своего магазина. Между продажей, транспортной заявкой и документом есть связь, но это разные сущности. Для интегратора сформулируйте проверку: файл должен возвращаться в карточку той перевозки, по которой выбран исходный транспортный документ.
Учитывайте роль доступа
Счёт-фактура доступен плательщику по накладной при полном доступе к соответствующему контрагенту. Поэтому отсутствие документа может быть связано с полномочиями используемой учётной записи, а не с тем, что перевозка не существует.
Редакционная рекомендация — сначала проверить назначение кабинета и контрагента. Не обходите ограничение передачей чужого логина всем сотрудникам. Ответственный за учёт должен согласовать, кто получает документы и куда они сохраняются. Складскому сборщику полный доступ к расчётам обычно не нужен для выполнения задачи передачи груза.
Разберите формат и ошибку
Документация описывает PDF в base64; ссылка для скачивания предусмотрена только для накладной на выдачу. Ошибки «накладная не найдена» и «изображение не найдено» имеют разные коды — 706001 и 706002.
Если интеграция ожидает ссылку для каждого типа, она может ошибочно объявить документ отсутствующим. В задании разработчику разделите получение ответа, извлечение файла и проверку его содержимого. Код ошибки сохраняйте вместе с типом формы и идентификатором, скрывая секреты доступа из обычного журнала поддержки.
Проверьте архив по существу
После сохранения сопоставьте номер, участников и назначение документа с перевозкой. Имя файла с правильным заказом не доказывает правильность вложения. Для первой партии достаточно выборочно открыть несколько разных типов и проверить, что автоматическая связь соответствует ожидаемой.
Это отличается от письменного запроса копий ПЭК: здесь проверяется автоматический обмен и идентификаторы. Настройте список отсутствующих или неразобранных файлов отдельно от успешно проверенного архива. Тогда закрытие периода не будет зависеть от предположения, что каждый ответ системы обязательно содержит нужный документ.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы