Справочник служб доставки: поля, команды, СДЭК, Я.Доставка, ТК Энергия.
Справочник Маркетплейсы: Службы доставки - подключение СДЭК, Я.Доставка, ТК Энергия и других служб для оформления отправлений из модуля.
1. Как открыть
Обычные формы - Операции → Справочник → Маркетплейсы: Службы доставки.
Управляемые формы - ИТС: мБридж → Маркетплейсы: Службы доставки (раздел Дополнительно / Сервис - в зависимости от меню).
2. Команды формы
Записать и закрыть - сохранить элемент и закрыть окно. Без записи параметры службы в форме Управление доставкой не применяются.
Записать - сохранить без закрытия (ключи API, офисы и параметры по умолчанию).
Заполнить офисы - загрузить офисы/ПВЗ с API службы. Без загрузки выбор ПВЗ из справочника службы недоступен или устарел.
Проверить подключение - проверка связи с API (ключи, сеть и proxy) до реальных заказов.
3. Общие поля шапки
ID - служебный идентификатор элемента; обычно не редактируют вручную.
Наименование - название настройки в списках. На API не влияет, нужно для выбора нужной службы в формах доставки.
Tracking url - шаблон ссылки отслеживания с плейсхолдером
[tracking_number](пример для СДЭК:https://www.cdek.ru/ru/tracking?order_id=[tracking_number]). Используется для открытия трека по номеру накладной из модуля.Служба доставки - тип: СДЭК, Я.Доставка, ТК Энергия, другая. Влияет на набор полей формы и на то, какой API вызывается при создании отправления.
Отладка - расширенный вывод диагностики обмена (в бою обычно выключают).
Логирование (Выкл. / Ошибки / Все) - объём журнала обмена для разбора сбоев.
4. Параметры подключения
Система интеграции - вариант API/продукта службы (зависит от выбранной службы, для Я.Доставка - например "Доставка в другой день").
Прокси - промежуточный сервер для API службы, если с сервера 1С нет прямого доступа к API перевозчика.
Использовать тестовую среду API - sandbox. Влияет на то, куда уходят запросы: в песочницу или в боевую среду (тестовые накладные не равны боевым).
Client ID / Client SECRET (СДЭК и аналоги) - ключи API. Без верных ключей создание заказов и загрузка офисов невозможны.
E-mail / Пароль (ТК Энергия и аналоги) - учётные данные API перевозчика.
5. Параметры доставки (общие)
Офис отправления / Адрес отправления - точка сдачи груза; при заполнении обоих приоритет у офиса (ПВЗ или забор по адресу).
Страны доставки - коды ISO через запятую (по умолчанию
RU) - допустимые направления.Тип заказа - интернет-магазин / доставка (для СДЭК и др.) - тип договора/продукта в API службы.
Организация отправления, контактное лицо, телефон - реквизиты отправителя в накладной.
Использовать объявленную стоимость - передавать стоимость груза для страховки/объявленной ценности у перевозчика.
Автоматически проверять статусы - фоновый опрос статусов без ручного "Получить".
Максимальные размеры грузового места (ширина / глубина / высота) - лимиты места при подборе упаковки.
Параметры по умолчанию - наименование товара, размеры и вес, комментарий, если не заполнены в карточке номенклатуры. Подставляются в отправление, когда в заказе нет полных габаритов.
Офисы можно подтянуть кнопкой Заполнить офисы после успешного подключения API. После настройки служба выбирается в форме Управление доставкой при создании отправления.
6. Откуда брать настройки (по провайдерам)
СДЭК
В форме нужны Client ID и Client SECRET.
Откуда: личный кабинет СДЭК lk.cdek.ru → раздел интеграций / API (названия пунктов: "Интеграции", "API", "Ключи доступа" - зависят от версии ЛК). Создайте ключи Account/Secure Password (в API v2 это client_id / client_secret).
Документация API: apidoc.cdek.ru.
Параметры доставки (организация, телефоны, офис/адрес, габариты) заполняются по данным вашего договора и склада - не из API-ключей.
Я.Доставка
В форме: Система интеграции, прокси, тестовая среда; на вкладке доставки - офис/адрес, статусы, габариты по умолчанию.
Откуда токен/доступ: личный кабинет Яндекс Доставки dostavka.yandex.ru → вкладка Интеграции → Получить токен (по официальному quickstart).
Документация API: Быстрый старт API Яндекс Доставки.
В меню мБридж для Я.Доставка также могут быть справочники упаковочных коробок, ПВЗ и тарифов - для подбора упаковки и точек в форме управления доставкой.
ТК Энергия
В форме: E-mail, Пароль, Прокси.
Откуда: учётные данные доступа к API/личному кабинету ТК "Энергия", выданные перевозчиком. Сайт: nrg-tk.ru.
Учётные данные API уточняйте в договоре или личном кабинете.
Другая служба
Минимальный набор: наименование и Tracking url. Шаблон ссылки отслеживания берите с сайта выбранной службы (плейсхолдер
[tracking_number]). Нужен для ручного/частичного сопровождения трека, если полного API в модуле нет.
См. также
Управление доставкой - создание отправлений, печать квитанций/ярлыков и статусы по выбранной службе.
СДЭК - отдельная инструкция по полям СДЭК.
Я.Доставка - отдельная инструкция по Яндекс Доставке.
Функционал может отличаться в зависимости от конфигурации 1С, версии модуля и маркетплейса и доступен при наличии соответствующих прав и настроек.