Инструкция по установке модуля Bitrix автоматизированной службы доставки «GRASTIN»

Общее описание

Предупреждение!!!

  1. Чтобы рассчиталась доставка, у всех товаров в корзине должен быть задан вес!;
  2. Обязательно задайте компании, через которые будет производиться расчет доставки (в личном кабинете eDost в настройках магазина);
  3. Магазин кэширует результаты расчетов, поэтому, после изменения настроек в личном кабинете, для пересчета доставки в магазине необходимо сбросить кэш;
  4. После установки модуля обязательно проведите синхронизацию ПВЗ(пункты самовывоза). Если данный процесс не будет произведен, то ПВЗ не будет доступных при оформлении заказа;
  5. Для способов доставки не требуется накладывать дополнительных ограничений, все ограничения контролируются на стороне рассчета стоимости доставки.

Установка модуля

Запустите установку модуля черезе marketplace и завершите установку в админке Вашего сайта. После установки необходимо перейти к настройкам модуля.

Настройка модуля

            Для того чтобы перейти к настройкам модуля необходимо перейти в админку сайта на страницу с настройками модуля. Настройки - Настройки продукта - Настройки модуля - Служба доставки Grastin

Основная форма с настройками разбита на 4 вкладки:

  1. общие настройки;
  2. автоматизация процесса;
  3. услуги;
  4. шаблоны документов
  5. профиль обмена.

Общие настройки модуля

Для того чтобы начать использовать модуль Вам необходимо заключить договор с курьерской службой (для заключения договора и получения информации по тарифам обратитесь на почту msk@grastin.ru или по контактным телефонам указанном на сайте grastin.ru) и получить ключ доступа к Rest Api. Для тестирования модуля Вы можете использовать демо ключ - 024840a2-8800-474a-bd75-39407b93cd90.

Ключ доступа необходимо указать в настройках модуля.

При установке ключа можно создать службу доставки. Для этого надо отметить признак “Создать службу доставки”. Если признак отмечен, то после сохранения автоматически создается новая служба доставки в разделе Магазин - Службы доставки. Если данный признак не указан, то создать службу доставки требуется вручную. Механизм создания службы доставки описан более подробнее в курсе - Администратор. Бизнес”

После установки ключа доступа, будут доступны полные настройки модуля.

Вкладка “Общие настройки модуля” содержит следующие параметры:

  1. Ключ доступа к REST API - ключ доступа к REST API, используется при обращении к функциям REST:
  2. Отключить - признак используется для того чтобы сменить ключ доступа:
  3. Использовать prefix/postfix - данный признак используется если вы хотите отправлять заявки в курьерскую службу со своим уникальным префиксом или постфиксом;
  4. Тестовый режим работы - признак позволяет включение/отключение тестового режима использования REST API;
  5. Активные договора - список заключенных договоров между интернет магазином и Grastin (на данный момент не используется, в дальнейшем будет использоваться при выводе доступных способов доставки);
  6. Склад приемки - склад с которого предполагается отправка товара. Данный параметр будет указываться в необходимых методах REST API;
  7. Записывать ошибки в журнал событий - признак позволяет записывать все возникающие в процессе работы модуля ошибки.

Вкладка «Автоматизация процесса»

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

Список доступных настроек:

  • Стартовый статус заказа – статус, при котором надо создавать заявку в Grastin. При переходе заказа в данный статус система автоматически будет создавать заявку в курьерскую службу на основе данных из заказа;
  • Финальный статус заказа - статус заказа, после которого не надо получать информацию по заявке со стороны Grastin;
  • Статус заказа “заявка создана” - статус заказа в который надо переводить заказ, после того как была успешно создана заявка в Grastin;
  • Таблица соответствия между статусами на стороне сайта и в Grastin;
  • Период обновления статусов по заявке – частота запросов к сервису Grastin для получения статуса по заявке. Значение указывается в секундах. При изменении данного параметра обновляется/создается агент для обновления статуса.

Вкладка «Услуги»

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

Вкладка «Шаблоны документов»

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

Список доступных настроек:

  • Наименование договора - наименование договора между интернет-магазином и службой доставки, который будет выводится в печатной форме;
  • Дата договора - дата договора между интернет-магазином и службой доставки, которая будет выводится в печатной форме;
  • Должность - должность, занимаемая ответственным лицом со стороны интернет-магазина;
  • ФИО ответственного лица со стороны интернет-магазина;
  • Наименование организации - владельца интернет-магазина;
  • Город составления акта.

Вкладка «Профиль обмена»

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

Очень важно настроить корректно соответствия между данными которые передаются в курьерскую службу и данными на сайте. Для начала необходимо установить соответствие между типами покупателей (физическое или юридическое лицо) на сайте и курьерской службой. Типы покупателей (их название) в разных магазинах могут быть свои.

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

  • Общие поля - содержат общие поля для всех типов покупателей;
  • Разделение по типу покупателя (физическое лицо, юридическое лицо) - поля, которые специфичны, и заполняются отдельно для каждого типа покупателей.

            Данный механизм позволяет настроить очень гибко источник хранения данных на сайте. В левой части указан список доступных полей в заявке для курьерской службы, в правой части указан источник хранения данных на стороне сайта. Модуль позволяет получать данные из следующих источников:

  1. значение - поле для заполнения значения вручную. В этом случае указанное значение будет передаваться в неизменном виде;
  2. пользователь - данные берутся из пользователя, который оформил заказ;
  3. заказ - данные берутся из полей заказа;
  4. свойства заказа - данные берутся из свойств заказа;
  5. отгрузка - данные берутся из полей отгрузки, которая была создана при оформлении заказа.

Дополнительные настройки

Дополнительные настройки позволяют выполнить следующие действия:

  1. Загрузка списка ПВЗ
  2. Создание заявки на забор товара
  3. Проверить почтовый баланс

Загрузка списка ПВЗ

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

Импорт происходит в автоматическом режиме. Если импорт прошел успешно, то пользователь увидит сообщение об успешной загрузке. Если же в процессе загрузки ПВЗ возникли ошибки, то необходимо изучить возникшую ошибку и повторить процесс заново. Для того, чтобы изучить ошибки детально, необходимо убедиться, что в настройках модуля установлен признак “Записывать ошибки в журнал событий”. Если данный признак отмечен, то все ошибки, возникшие в модуле, будут записываться в журнал событий.

Заявка на забор товара

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

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

  1. Регион – регион, в котором происходит забор товара. Необходимо выбрать наиболее подходящий для Вас регион;
  2. Время забора – промежутки времени, в которое необходимо забрать товар;
  3. Объем заказа – список со следующим набором доступных вариантов: До 0.3 м3, До 0.6 м3, Более 0.7 м3;

Проверка почтового баланса

Почтовый баланс позволяет проверить состояние почтового баланса. Блок содержит кнопку, при нажатии на которую отправляется запрос на проверку состояния баланса в Grastin.

Создания заявки в сервисе курьерской службы

Заявка создается в автоматическом режиме при переходе заявки в определенный статус. Статус при котором должна формироваться заявка определяется в настройках модуля (описан выше). Если заявка успешно оформилась в детальном описании заказа будет информация о текущем статусе.

Модуль также позволяет оформить заявку в ручном режиме. Запустить его можно из списка заказов, расположенного в административной панели сайта, раздел “Магазин” - “Заказы”. В данном списке для заказов, у которых выбран способ доставки “Курьерская служба Grastin”, в контекстном меню будет присутствовать дополнительный пункт - “Заявка в Grastin”. При выборе данного пункта запустится механизм создания заявки по описанному ниже алгоритму.

Сопроводительные документы

Для формирования сопроводительных документов администратору сайта необходимо перейти к списку заказов в разделе «Магазин» - «Заказы». При переходе в данный раздел администратор сайта сможет отметить заказы, по которым требуется сформировать документы и выбрать в списке групповых действий одно из двух действий: «Сформировать акт приема-передачи» или «Сформировать маркировку». После этого система отправит запрос в Grastin на формирование документов. Если при обработке запроса произошла ошибка, то система выдаст пользователю информационное сообщение с текстом ошибки, в противном случае произойдет скачивание сформированного документа.