1C-Bitrix

Установка и настройка

Шаг 1. Предварительная настройка

Создание API-ключа СберЛогистики

В личном кабинете СберЛогистики выберите Настройки пользователя > API и нажмите +.

В окне Создание токена укажите:

• Название — имя, с которым токен будет отображаться в общей таблице API-ключей.
• Права доступа — чекбоксы Чтение и Запись должны быть активными.

Нажмите Сохранить.

Настройки стандартного функционала 1C-Bitrix 

Для каждого типа плательщика настройте свойства заказа.

Настройка свойств заказа обязательна: данные из них используются при создании отправления.

Перейдите в Магазин > Настройки > Свойства заказа > Список свойств и выберите из общего списка:

• Местоположение — активируйте чекбоксы Активность, Обязательное, Использовать как местоположение для расчета доставки, а в графе Тип выберите вариант Местоположение. Проверьте, чтобы настройки на сайте соответствовали настройкам на скриншоте.
• Телефон — активируйте чекбоксы Активность, Обязательное, Является телефоном, а в графе Тип выберите вариант Строка. Проверьте, чтобы настройки на сайте соответствовали настройкам на скриншоте.
• Адрес доставки — активируйте чекбоксы Активность, Обязательное, Является адресом, а в графе Тип выберите вариант Строка. Если используется составной адрес из нескольких полей (улица, дом, квартира), настройте аналогичным образом каждое из них. После этого задайте порядок сортировки для вывода информации покупателю. Проверьте, чтобы настройки на сайте соответствовали настройкам на скриншоте.
  
• Пункт выдачи — создается при установке модуля и не требует настройки. Свойство используется для сохранения номера пункта самовывоза в заказе. Присутствует по умолчанию.

Шаг 2. Установка модуля 1С-Bitrix

Модуль устанавливается из Marketplace, который встроен в 1C-Bitrix. Перейдите в Marketplace > Каталог решений.

Введите в строку поиска СберЛогистика. В результатах поиска найдите СБЕРЛОГИСТИКА и нажмите Установить.

При первой установке доступен мастер легкого старта с пошаговой настройкой модуля.

Этап 1

В поле Ключ доступа к API СберЛогистики вставьте API-ключ из личного кабинета СберЛогистики (как его создать см. Создание API-ключа СберЛогистики).

В блоке Отправитель заполните контактные данные. Они необходимы для корректного расчета доставки.

Нажмите Далее.

Этап 2

В блоке Способы оплаты отметьте:

• Способ оплаты при получении наличными — системы, которые предполагают оплату наложенного платежа наличными.
• Способ оплаты при получении картой — системы, которые предполагают оплату наложенного платежа картой.

Чтобы выбрать несколько вариантов, зажмите клавишу CTRL. Настройка не является обязательной.

В блоке Параметры посылки выберите:

• Способ расчета параметров — поле имеет два возможных варианта:
  • Постоянные вес и габариты посылки — расчет итоговых габаритов посылки производится на основании умолчаний.
  • Автоматически — расчет итоговых габаритов посылки производится на основании измерений, указанных в карточке товара. Если в ней какие-то параметры не указаны, то для них используются умолчания.
• Длина (умолчание) — усредненное значение для 1 ед. товара или всей посылки в зависимости от значения опции Способ расчета параметров.
• Ширина (умолчание) — усредненное значение для 1 ед. товара или всей посылки в зависимости от значения опции Способ расчета параметров.
• Высота (умолчание) — усредненное значение для 1 ед. товара или всей посылки в зависимости от значения опции Способ расчета параметров.
• Вес (умолчание) — усредненное значение для 1 ед. товара или всей посылки в зависимости от значения опции Способ расчета параметров.

Нажмите Далее.

Этап 3

Чекбокс Включить профили доставки для покупателя может быть:

• Активен — доступные методы доставки включаются автоматически после завершения установки.
• Неактивен — доступные методы доставки не включаются автоматически. После завершения установки их можно самостоятельно активировать в настройках модуля.

Нажмите Сохранить для завершения установки.

Шаг 3. Настройка модуля

Настройки мастера легкой установки можно изменить при необходимости. Для этого перейдите в Настройки > Настройки продукта > Настройки модулей > Настройки модуля> СБЕРЛОГИСТИКА.

Настройки

Во вкладке Настройки определите следующие параметры:

• Ключ доступа к API СберЛогистики — API-ключ из личного кабинета СберЛогистики (как его получить см. Создание API-ключа СберЛогистики).
• Источник карты — источник вызова карты на странице оформления заказа. Это может быть:
  • Сайт — выберите этот вариант, если карта подключается не из модуля, а непосредственно сайтом (по умолчанию).
  • Модуль — выберите этот вариант, если подключение карты на сайте происходит с ошибками. В этом случае она будет подключена из модуля.
• Ключ доступа к API карты — ключ, который используется для поиска по карте ПВЗ. Для его получения перейдите в Кабинет разработчика, нажмите Подключить API, в новом окне выберите JavaScript API и HTTP Геокодер и скопируйте ключ. Поле подключается, если Источник карты имеет значение Модуль.
• Вести запись в журнал — чекбокс для записи всех сеансов обмена данными с сервисами СберЛогистики. По умолчанию отключен.

Обработка заказов

В блоке Обработка заказов определите:

• Способ вызова курьера — выберите способ создания заявки для курьерского сбора:
  • Автоматически — заявки на курьерские сборы создаются автоматически.
  • Вручную — заявки на курьерские сборы создаются вручную. Выбрано по умолчанию.
  • Настроить агент — кнопка перехода к настройкам агента CSblAgent::CreateCourierSbor();. Подключается после нажатия Применить, если в Способ вызова курьера выбрано значение Автоматически. Не рекомендуется включать его чаще чем один раз в сутки.
  В сбор попадают только те отгрузки, которые получили трек-номер.
• Задержка отгрузки — число дней, которое будет прибавляться к ближайшей дате отгрузки посылок курьеру СберЛогистики. По умолчанию выбрано Следующий день.

Отслеживание

Поле Способ отслеживания может принимать два значения:

• Автоматически — обновление статусов доставки автоматически. После нажатия кнопки Применить появится дополнительное поле Настройка агента. Агент CSblAgent::GetStatusShipment(); отвечает за обновление статусов доставки в установленное время или через заданный интервал. При этом он не должен превышать 3600 сек. Такая настройка позволит избежать лишней нагрузки на сервер и сайт.
• Вручную — обновление статусов доставки при открытии страниц отгрузок или заказов. Выбрано по умолчанию. 

Блок Сопоставление статусов позволяет настроить сопоставление статусов отправления в СберЛогистике со статусами отгрузок и заказов в Bitrix. Здесь:

• Статус заказа в Bitrix — статус заказа в Bitrix, который присваивается при получении статуса отправления из Статус СберЛогистики.
• Статус отгрузки в Bitrix — статус заказа в Bitrix, который присваивается при получении статуса отправления из Статус СберЛогистики.
• Установить флаг отгрузки — чекбокс, который регулирует автоматическое изменение статуса отгрузки на Отгружено по заданному статусу.

Выберите нужный вариант для каждого поля из выпадающего списка.

Шаг 4. Служба доставки

Для отображения нужных методов доставки используется служба доставки СберЛогистика.

Создание

Вместе с модулем автоматически устанавливается служба доставки. При необходимости к ней можно добавить другие со своими профилями.

Чтобы создать службу доставки типа СберЛогистика вручную, перейдите в Магазин > Настройки > Службы доставки, нажмите кнопку Добавить и из выпадающего списка выберите СБЕРЛОГИСТИКА. 

Для настройки созданной службы откройте окно ее редактирования.

Общие настройки

Вкладка Настройки позволяет определить отображение службы доставки в списке других служб доставки и в админпанели заказов.

• Название — укажите название родительской службы доставки.Оно будет отображаться при оформлении заказа.
• Активность — включите и выключите родительскую службу доставки. При выключении все ее дочерние профили станут неактивными.

Обработчик

В блоке Способы оплаты отметьте:

• Способ оплаты при получении наличными — системы, которые предполагают оплату наложенного платежа наличными.
• Способ оплаты при получении картой — системы, которые предполагают оплату наложенного платежа картой.

Чтобы выбрать несколько вариантов, зажмите клавишу CTRL. Настройка не является обязательной.

В блоке Параметры посылки выберите:

• Способ расчета параметров — поле имеет два возможных варианта:
  • Постоянные вес и габариты посылки — расчет итоговых габаритов посылки происходит на основании умолчаний.
  • Автоматически — расчет итоговых габаритов посылки производится на основании измерений, указанных в карточке товара. Если в ней какие-то параметры не указаны, то для них используются умолчания.
• Длина (умолчание) — усредненное значение для 1 ед. товара или всей посылки в зависимости от значения опцииСпособ расчета параметров.
• Ширина (умолчание) — усредненное значение для 1 ед. товара или всей посылки в зависимости от значения опцииСпособ расчета параметров.
• Высота (умолчание) — усредненное значение для 1 ед. товара или всей посылки в зависимости от значения опцииСпособ расчета параметров.
• Вес (умолчание) — усредненное значение для 1 ед. товара или всей посылки в зависимости от значения опцииСпособ расчета параметров.

Шаг 5. Профили доставки

Способы доставки, которые подчиняются родительской службе, отображаются при помощи профилей. Они создаются автоматически после установки модуля. Их количество соответствует настройкам ЛК СберЛогистики. При необходимости профили можно дублировать с разными ограничениями по отображению на сайте.

Создание

Чтобы создать профиль выберите Редактировать для службы доставки СберЛогистика и перейдите на вкладкуПрофили. Нажмите Добавить профиль и из выпадающего списка выберите нужный вариант.

Общие настройки

Перейдите на вкладку Магазин > Настройки > Службы доставки > Профили, выберите нужный из списка и нажмите на его название или выберите Редактировать из меню.

Здесь настраиваются параметры: 

• Название — укажите название профиля доставки. В дальнейшем оно будет отображаться при оформлении заказа.
• Активность — включите или выключите профиль доставки.
• Сортировка — укажите порядок сортировки среди активных профилей доставки. Чем меньше значение, тем выше профиль среди доступных при оформлении заказа. 
• Описание — добавьте описание профиля доставки. Оно будет отображаться при оформлении заказа.
• Логотип — загрузите свой логотип профиля доставки. По умолчанию используются стандартные логотипы.

Обработчик 

Выберите Магазин > Настройки > Службы доставки > Профили > нужный профиль доставки и перейдите на вкладку Обработчик. Здесь:

• Срок доставки — режим отображения срока доставки на странице оформления заказа.
• Добавить дней — число рабочих дней, которые будут прибавляться к расчетному сроку доставки.
• Стоимость доставки — алгоритм расчета стоимости доставки:
  • По API — стоимость доставки рассчитывается автоматически и зависит от параметров заказа. Выбрано по умолчанию.
  • Фиксированная — стоимость доставки указывается в настройках и не зависит от параметров заказа.
• Стоимость в рублях — стоимость доставки, которая постоянна для всего профиля. Поле подключается, если в Стоимость доставки выбрано значение Фиксированная.

Ограничения 

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

• По весу — профиль доступен в указанном диапазоне веса.
• По категории товара — профиль доступен для указанных типов товара.
• По максимальному размеру/размерам — профиль доступен для товаров с габаритами, не превышающими указанные
• По местоположению — профиль доступен только в указанном местоположении (страна/регион/город)
• По платежным системам — профиль доступен только для указанных платежных систем.
• По публичной части — профиль доступен только в панели администратора.
• По сайтам — профиль доступен только на указанных сайтах.
• По стоимости заказа — профиль доступен в указанном диапазоне суммы заказа.
• По типу плательщика — профиль доступен только для указанных типов плательщика.

Также ограничения можно установить централизованно всю службу доставки: в этом случае ограничения распространяются на все профили в ней.

Работа с отправлениями

Заказы

Создание заказа

Все заказы, созданные через модуль, автоматически формируются в отгрузки и отображаются на вкладке Магазин > Заказы > Отгрузки.

Редактирование заказа

Заказ можно отредактировать:

• До передачи в СберЛогистику — отредактируйте нужные параметры в
  • документе отгрузки — служба доставки, профиль доставки и стоимость;
  • документе заказа — ПВЗ доставки для методов с самовывозом.
• После передачи в СберЛогистику — зайдите в нужный отгрузку, внесите исправления и сохраните изменения. Вернитесь в Магазин > Заказы > Отгрузки и в столбце ID заказа нажмите на ссылку, соответствующую отредактированному отправлению. Откроется окно редактирования связанного заказа. Нажмите Действие и из выпадающего списка выберите SBL обновить RPxxxxxx.

Дождитесь появления информера об успешно завершенной операции.

Редактировать отправления, которые добавлены в курьерский сбор, нельзя.

Передача заказа

Чтобы отправление передалось в ЛК СберЛогистики, нужно разрешить отгрузку. Это можно сделать двумя способами:

• Вручную — перейдите в окно редактирования нужной отгрузки и для Доставка разрешена выберите вариант Доставка разрешена. Нажмите Применить. 

• Автоматически — перейдите в Настройки > Настройки модулей > Интернет-магазин и откройте вкладку Автоматизация процессов. Для поля Разрешать доставку при оплате заказа выберите условие, при котором отгрузка получит статус статус Доставка разрешена.

После передачи в ЛК СберЛогистики отправление получает:

• Статус SBL — текущий внутренний статус заказа в СберЛогистике.
• Трек-номер — номер отслеживания от Shiptor RPxxxxx.

Удаление заказа

Перейдите на вкладку Магазин > Заказы > Отгрузки и выделите нужные отгрузки при помощи чекбоксов. Нажмите Действия внизу страницы и выберите Запретить доставку. Нажмите Применить. 

Можно удалять только те отправления, которые не добавлены в курьерский сбор.

Курьерские сборы

Для отправки посылок в логистический центр СберЛогистики необходимо вызвать курьера — создать курьерский сбор.

Создание курьерского сбора

Чтобы вызвать курьера на созданные отправления, перейдите на вкладку Магазин > Курьерские сборы СБЕРЛОГИСТИКА и нажмите Добавить сбор курьеру.

В открывшемся окне заполните следующие параметры:

• Служба доставки — выберите нужную службу доставки из выпадающего списка.
• Дата визита курьера — укажите желаемую дату визита курьера, который заберет посылки.
• Отправитель — проверьте данные и измените их при необходимости.

Добавьте в сбор необходимые отправления через кнопку Выбрать отправления.

Нажмите Создать сбор.

Редактирование курьерского сбора

Перейдите на вкладку Магазин > Курьерские сборы СБЕРЛОГИСТИКА, найдите нужный сбор и из выпадающего списка выберите Редактировать. Откроется форма редактирования.

Внесите необходимые правки в состав сбора и нажмите Изменить сбор.

Редактирование любых других полей, кроме состава сбора, невозможно.

Удаление курьерского сбора

Перейдите на вкладку Магазин > Курьерские сборы СБЕРЛОГИСТИКА, найдите нужный сбор и из выпадающего списка выберите Отменить сбор.

Нажмите Сохранить.

Печать документов

Печать реестра

Вместе с посылками курьеру СберЛогистики передается подписанный реестр отправлений. Для его печати перейдите на вкладку Магазин > Курьерские сборы СБЕРЛОГИСТИКА, найдите нужный сбор и из выпадающего списка выберите Распечатать реестр.

Реестр печатается в 2 экземплярах: один подписывается и передается курьеру, другой — остается у продавца.

Печать адресного ярлыка

При передаче посылок курьеру СберЛогистики на каждой из них должен быть наклеен адресный ярлык. Его можно распечатать:

• Из курьерского сбора — перейдите на вкладку Магазин >Курьерские сборы СБЕРЛОГИСТИКА, найдите нужный сбор и из выпадающего списка выберите Распечатать штрих-код. Адресные ярлыки всех отправлений, добавленных в курьерский сбор, откроются в новом окне в формате печати.
• Из отгрузки — перейдите в раздел Магазин > Заказы >Отгрузки, выберите нужную отгрузку и нажмите Редактировать в меню. В открывшейся форме нажмите Распечатать и выберите Штрих-код SBL. Адресный ярлык откроется в новом окне в формате для печати.

Отслеживание

Статус заказа или отгрузки обновляется, когда открывается:

• окно редактирования;
• вкладка Магазин > Заказы или Магазин > Заказы > Отгрузки.

Для автоматизации отслеживания настройте агент (как это сделать см. Отслеживание).