1С-Битрикс 11-16: инструкция по подключению модуля доставки eDost.ru
Для работы модуля, интернет-магазин необходимо подключить к системе eDost.
Предупреждение!!!
1. Чтобы рассчиталась доставка, у всех товаров в корзине должен быть задан вес!
2. Чтобы в расчете доставки учитывались габариты посылки, у каждого товара должны быть прописаны его размеры (длина, ширина, высота).
3. Обязательно задайте компании, через которые будет производиться расчет доставки
личном кабинете eDost в настройках магазина).
4. Магазин кэширует результаты расчетов, поэтому, после изменения настроек в личном кабинете, для пересчета доставки в магазине необходимо сбросить кэш.
1. Установка модуля eDost
Запустите установку модуля через Marketplace, и завершите установку в админке магазина:
2. Настройка модуля eDost
3. Загрузка списка местоположений
Для корректной работы калькулятора доставки рекомендуется установить список местоположений, соответствующий стандарту системы eDost.
Предупреждение!!!
1. Новый список местоположений заменяет уже существующий, поэтому в старых заказах и в личных данных зарегистрированных покупателей местоположения сбрасываются.
2. Если магазин работает на местоположениях 2.0, но используется старый список (Россия без федеральных округов), тогда сначала импортируйте дефолтные местоположения, чтобы в базах битрикса прописались все необходимые поля.
Удалите старый список с местоположениями России:
Выберите в архиве подходящий для вашего магазина список, и импортируйте согласно инструкции:
Сбросьте кэш магазина:
4. Учет габаритов
Для точного расчета доставки у товаров должны быть заданы габаритные размеры (длина, ширина, высота).
Предупреждение!!!
1. Без учета габаритов стоимость доставки может получиться намного МЕНЬШЕ реальной!
2. Если габариты не заданы, тогда доставка рассчитывается только по весу.
3. Если у вас в магазине представлены исключительно мелкие товары (например, парфюмерия), тогда габариты можно не указывать.
4. Чтобы габариты учитывались в расчетах, необходимо в личном кабинете eDost в настройках магазина поставить галочку Учитывать в расчетах габариты груза, и выбрать единицу измерения габаритов (метры, дециметры, сантиметры, миллиметры). Единица измерения в личном кабинете должна совпадать с единицей измерения магазина!
В bitrix 14 габариты задаются в настройках товара в стандартных полях:


В bitrix 12 (и меньше) поля для габартов необходимо добавить самостоятельно
показать
5. Установка шаблона
Шаблон необходим для включения дополнительного функционала модуля (отображение иконок тарифов, выбор пунктов выдачи, вывод предупреждений калькулятора и т.д.).
Предупреждение!!!
1. Шаблон совместим только со стандартным одношаговым оформлением заказа (sale.order.ajax).
2. Если вам требуется только обычный расчет доставки (без иконок, выбора пунктов выдачи и т.д.), тогда устанавливать шаблон не нужно.
3. Если у вас нет опыта в данной области, тогда не рекомендуем самостоятельно устанавливать шаблон (иначе можно случайно вывести из строя весь магазин!). Все необходимые исправления могут внести наши специалисты (просто подайте заявку на info@edost.ru).
Скачайте архив с подходящим шаблоном:
шаблон eDost шаблон Visual (bitrix)
Особенности:
1. Внешний вид и названия тарифов меняются в зависимости от типа доставки и настроек модуля.
2. Объединение тарифов по типу доставки.
3. Выбор постаматов и пунктов выдачи на общей карте.
4. Вывод стоимости доставки при наложенном платеже в отдельной колонке или отдельным тарифом.
5. Результаты всех модулей доставки приведены к одному внешнему виду с возможностью общей сортировки.
Предупреждение!!!
Это НЕ стандартный шаблон, поэтому дополнительные функции bitrix НЕ поддерживаются (такие, как выбор складов в настраиваемых доставках или экстра параметры доставки "ExtraParams" из стандартного модуля ПЭК).
Особенности:
1. Все тарифы выводятся, как есть, без модификаций.
2. Большие иконки.
3. Нет точек выбора (radio).
4. Срок и стоимость доставки в одной строке.
5. Выбор пунктов выдачи в выпадающем списке (кроме PickPoint - используется фирменный виджет компании).
6. Это стандартный шаблон с небольшими модификациями, поэтому поддерживаются все функции bitrix.
Предупреждение!!!
Данный шаблон совместим только со стандартным шаблоном Visual одностраничного оформления заказа (в последних версиях bitrix шаблон Visual идет, как дефолтный, без подписи "Visual").

Скопируйте из архива файлы delivery.php и paysystem.php в папку шаблона оформления заказа:
bitrix/templates/шаблон магазина/components/bitrix/sale.order.ajax/шаблон компоненты/
Внимание!
Новый шаблон оформления заказа (битрикс 16 версии, выглядит как многошаговый) НЕ совместим с шаблоном eDost и Visual, поэтому требуется восстановить все файлы старого шаблона - смотрите в архиве папку с подписью "полный".
Предупреждение!!!
1. Перед копированием рекомендуется сделать бэкап оригинальных файлов магазина, чтобы при необходимости можно было все восстановить.
2. Если в шаблоне нет папки sale.order.ajax, тогда необходимо копировать файлы в базовый шаблон компоненты: bitrix/components/bitrix/sale.order.ajax/templates/.default/
Базовый шаблон может быть заменен новой версией при обновлении магазина!
Чтобы этого избежать, рекомендуется создать на основе базового шаблона новый, а уже его редактировать и использовать в магазине.
6. Изменение названий тарифов
7. Наложенный платеж
Наложенный платеж - это способ оплаты за заказ наличными в момент вручения (например, оплата в почтовом отделении при получении посылки, или оплата наличными курьеру при вручении заказа).

Функциональные возможности системы наложенного платежа eDost:
1. Управление из личного кабинета eDost.
2. Включение в заказ наценок наложенного платежа.
3. На странице оформления заказа способ оплаты "Наложенный платеж" появляется только при выборе тарифов доставки, для которых наложенный платеж включен в личном кабинете и доступен по параметрам заказа, настройкам и ограничениям перевозчиков.
Предупреждение!!!
1. Отображение наценок наложенного платежа реализовано только для одношагового оформления заказа (sale.order.ajax).
2. Обязательно включите наложенный платеж в личном кабинете eDost в настройках магазина (внизу страницы с настройками).
3. В магазине должна быть только одна платежная система с обработчиком "edostpaycod".
4. В админке магазина НЕ нужно привязывать наложенный платеж к способам доставки.
5. В настройках страницы оформления заказа должна быть установлена последовательность оформления "Доставка -> Оплата".
6. После любых изменений в настройках платежных систем, обязательно пересохраняйте привязки к оплате в настройках модуля eDost.
Добавьте новую платежную систему:

Установите параметры в соответствии со скриншотами:

Отображение модуля "Наложенный платеж" в заказе:
Стоимость доставки увеличится на - это наценка на доставку при наложенном платеже (включается в заказ - прибавляется к стоимости доставки).
+ доплатить при получении за денежный перевод - это сумма, которую оплачивает получатель на почте в момент вручения за перевод денежных средств, ОТДЕЛЬНО от стоимости заказа, указанной в бланке наложенного платежа (в заказ НЕ включается, выводится только для информации).
Пример:
1. Цена товара: 1 000 руб.
2. Цена доставки: 200 руб.
3. Наценка на доставку при наложенном платеже: 140 руб.
Итоговая стоимость заказа: 1 340 руб.

Магазин:
1. Оплачивает доставку 340 руб. = 200 руб. (цена доставки) + 140 руб. (наценка на доставку при наложенном платеже)
2. Указывает в бланке сумму наложенного платежа равную стоимости заказа: 1 340 руб.

Покупатель:
При получении посылки оплачивает 1 489 руб. = 1 340 руб. (стоимость заказа) + 149 руб. (за услугу по переводу денежных средств) - в итоге покупателю заказ обойдется на 289 руб. дороже, по сравнению с покупкой без наложенного платежа.

Служба доставки:
1. Берет с покупателя 1 489 руб.
2. Возвращает продавцу полностью всю стоимость заказа: 1 340 руб.
3. Оставляет себе за услугу перевода 149 руб.
8. Постаматы и пункты выдачи
В модуле eDost реализована возможность выбора покупателем постамата, пункта выдачи или терминала доставки.
Предупреждение!!!
1. Должен быть установлен шаблон (5-й пункт инструкции).
2. В админке магазина в настройках модуля должна стоять галочка "Включить выбор постаматов и пунктов выдачи на карте" (только при выборе на карте).
3. В свойствах заказа должно быть поле Адрес доставки (мнемонический код: ADDRESS,
тип: TEXT или TEXTAREA, включен параметр "Входит в профиль", привязка свойства: "Все").
Выбранная точка выдачи переносится в поле Адрес доставки, и это поле блокируется:

9. Расчет по индексу
Почтовый индекс служит для уточнения местоположения и точного расчета доставки.
Например, для расчета доставки в поселок Дубки в Ярославской области, при оформлении заказа необходимо выбрать регион "Ярославская область", город "Нет в списке" и указать индекс "150545".

Расчет по индексу действует только для Почты (наземная посылка) и EMS.
Предупреждение!!!
1. Расчет по индексу включается в админке магазина в настройках модуля eDost.
2. В свойствах заказа должно быть поле Индекс (мнемонический код: ZIP,
включен параметр "Использовать как почтовый индекс").
Если указан НЕ существующий индекс (или индекс НЕ принадлежит выбранному региону), тогда расчет НЕ производится и калькулятор выдает соответствующее предупреждение (для вывода предупреждений требуется установка шаблона - 5-й пункт инструкции).
10. Печать бланков
Модуль eDost позволяет создавать бланки для посылок и отправлений 1-го класса.

Бланки создаются автоматически в соответствии с параметрами заказа и настройками модуля (т.е. для посылки печатается ф.116, для наложки ф.112эп, а для 1-го класса без наложки вообще ничего не печатается).

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

Чтобы распечатать бланки, зайдите в админку магазина, перейдите на страницу eDost, выделите необходимые заказы и нажмите кнопку Создать почтовые бланки.

Чтобы скрыть уже выполненные/отгруженные заказы используйте настройки печати (справа-вверху кнопка "Настройки").
Предупреждение!!!
1. Если после нажатия кнопки "Создать почтовые бланки" ничего не происходит, значит в вашем браузере заблокированы всплывающие окна – кликните по системному предупреждению браузера (обычно отображается в углах окна), и задайте там соответствующее разрешение.
2. На почте могут НЕ принять самостоятельно распечатанные бланки!!! Рекомендуется уточнять данный вопрос непосредственно в почтовом отделении, в котором сдаете посылки.

Заполните данные отправителя (магазина) и получателя (если свойства заказа отличаются от стандартных):
11. Контроль заказов
Функция контроля заказов позволяет администратору магазина отслеживать состояние заказа с момента передачи отправления в службу доставки и до момента вручения покупателю.

Функциональные возможности:
1. Вывод текущего статуса заказа и просмотр детальной информации по всем статусам доставки (в админке магазина и в личном кабинете покупателя).
2. Предупреждение администратора о новых важных статусах - в админке отметка или
новый

После ознакомления с важным статусом, чтобы в дальнейшем данный заказ не выделялся, следует снять отметку (нажать соответствующую кнопку или кликнуть по ).
3. Заказ можно поставить на особый контроль, тогда система будет сообщать о любом изменении статуса, как о важном, и выделять такие заказы в отдельный блок с отметкой
на особом контроле
Предупреждение!!!
1. Настройте параметры контроля в личном кабинете eDost и в админке битрикса.
2. Для постановки заказа на контроль у отгрузки в магазине должна быть разрешена доставка и указан идентификатор отправления (присваивается службой доставки при приемке отправления).
3. Для контроля наложки должен быть настроен наложенный платеж.
4. Информация по статусам заказов обновляется примерно раз в день, а в выходные и федеральные праздники задержки могут доходить до недели!!!
5. Реальный статус отправления может отличаться от статуса в системе: информация еще не обновилась, работник службы доставки забыл внести данные, партнер не обновил свою базу, сбой на сервере службы доставки, и т.д.
12. Мои заказы
При использовании функции контроля, в шапку сайта (или любое другое место) можно добавить блок "мои заказы" со списком текущих заказов покупателя.
Интеграция блока "мои заказы" в шапку сайта:
bitrix/templates/шаблон магазина/header.php
Предупреждение!!!
1. Перед редактированием рекомендуется сделать бэкап оригинального файла магазина, чтобы при необходимости можно было все восстановить.
2. Модифицированный файл может быть заменен новой версией при обновлении шаблона/магазина, тогда все правки сбросятся!
Вставьте в файл код, выделенный зеленым:
...
...
                </span>
                <?$APPLICATION->ShowProperty("CATALOG_COMPARE_LIST", "");?>

<?
// блок "мои заказы" со статусами текущих заказов покупателя
if (CModule::IncludeModule('edost.delivery'))
    $GLOBALS['APPLICATION']->IncludeComponent('edost:delivery', '', array(
        'MODE' => 'user_order',
        'PARAM' => array(
            'div_style' => 'padding: 5px 0 5px 0; font-size: 12px;',
            'a_style' => 'font-size: 12px;',
//            'user_order_head' => 'мой заказ:', // название заголовка для одного заказа
//            'user_order_head2' => 'мои заказы:', // название заголовка для нескольких заказов
            'user_order_max' => 2, // ограничение количества заказов
            'user_order_string_length' => 15, // максимальная длина строки статуса (все, что больше, будет обрезано и заменено на '...')
//            'user_order_number_hide' => true, // скрыть номер заказа
//            'order_detail_link' => '/personal/order/detail/%order_id%/', // ссылка на страницу с детальной информацией о заказе ('%order_id%' - ид заказа, '%order_number%' - номер заказа)
//            'test' => 100, // тестовый вывод (для отладки положения и стилей, 100 - номер заказа)
        ),
    ), null, array('HIDE_ICONS' => 'Y'));
?>

            </div>
            <div class="brand">
...
...
13. Личный кабинет покупателя
При использовании функции контроля, для вывода текущего статуса заказа и подробной информации по доставке в личном кабинете покупателя, необходимо модифицировать шаблон.
Интеграция в шаблон "Подробная информация о заказе (bitrix:sale.personal.order.detail)":
bitrix/templates/шаблон магазина/components/bitrix/sale.personal.order.detail/шаблон компоненты/template.php
Предупреждение!!!
1. Перед редактированием рекомендуется сделать бэкап оригинального файла магазина, чтобы при необходимости можно было все восстановить.
2. Если в шаблоне нет папки sale.personal.order.detail, тогда необходимо редактировать базовый шаблон компоненты: bitrix/components/bitrix/sale.personal.order.detail/templates/.default/
Базовый шаблон может быть заменен новой версией при обновлении магазина!
Чтобы этого избежать, рекомендуется создать на основе базового шаблона новый, а уже его редактировать и использовать в магазине.
В начале сразу после строчки "<?if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();?>", добавьте:
<?
// обработка данных страницы "Подробная информация о заказе"
if (CModule::IncludeModule('edost.delivery')) {
    $ar = $GLOBALS['APPLICATION']->IncludeComponent('edost:delivery', '', array(
        'MODE' => 'sale.personal.order.detail',
        'PARAM' => array(
//            'loading' => 'loading_small_f2.gif', // иконка загрузки детальной информации по статусам заказа
        ),
        'RESULT' => $arResult,
    ), null, array('HIDE_ICONS' => 'Y'));
    if (!empty($ar)) $arResult = $ar;
}
?>
14. Разработчикам
В коде модуля прописаны события, используя которые можно модифицировать входные параметры заказа и результаты расчета (например, заблокировать модуль в городе магазина, или заменить рассчитанную стоимость доставки своим значением).
Предупреждение!!!
Если у Вас нет опыта программирования и знаний по внутренней работе bitrix, тогда не рекомендуем самостоятельно вносить какие-либо изменения (иначе можно получить непредсказуемый результат!).
Подключение:
в файле с константами модуля: bitrix/modules/edost.delivery/classes/general/edost_const.php
установите: define('DELIVERY_EDOST_FUNCTION', 'Y');

Файл с функциями событий:
bitrix/modules/edost.delivery/classes/general/edost_function.php

События:
BeforeCalculate(&$order, &$config) - вызывается перед расчетом доставки
BeforeCalculateRequest(&$order, &$config) - вызывается после обработки параметров заказа и перед запросом на сервер eDost
AfterCalculate($order, $config, &$result) - вызывается после расчета доставки
AfterGetOffice($order, &$result) - вызывается после загрузки данных по пунктам выдачи
AfterGetDocument($setting, &$result) - вызывается после загрузки документов (почтовые бланки, шаблоны для печати и т.д.)
15. Переход на битрикс 16
Это новая система управления заказами битрикса, также называется "конвертация магазина".
Предупреждение!!!
После конвертации, настройки и других действий по обновлению, в старых и текущих заказах могут сброситься выбранные тарифы доставки, местоположения, скидки и т.д., поэтому рекомендуется заранее обработать все текущие заказы (или переписать куда-нибудь все данные по текущим заказам, чтобы потом можно было их восстановить).
1. Обязательно создайте резервную копию системы
Админка > Настройки > Инструменты > Резервное копирование > Создание резервной копии

2. Обновите битрикс до последней версии (со всеми системными модулями!!!)
Админка > Marketplace > Обновление платформы

3. Обновите модуль edost.delivery до последней версии
Админка > Marketplace > Обновление решений > закладка "Список обновлений"

4. Переконвертируйте магазин
Админка > Магазин > Конвертация магазина

5. Еще раз обновите битрикс до последней версии (обязательно!!!)
Админка > Marketplace > Обновление платформы

6. Пересохраните настройки модуля eDost и привязку к оплате
Магазин > eDost

7. Если у вас в магазине используется модуль местоположений edost.locations версии 1.x.x или 2.0.0 установленный до 04.07.2016, тогда необходимо этот модуль "Удалить", "Стереть" (обязательно!!!), затем заново загрузить и установить
Админка > Marketplace > Установленные решения

8. Если у вас в магазине используется модуль расчета в карточке edost.catalogdelivery версии 1.x.x, тогда необходимо этот модуль "Удалить", "Стереть" (обязательно!!!), затем заново загрузить и установить
Админка > Marketplace > Установленные решения

Внимание!!!
Если у вас в магазине на странице оформления заказа тарифы доставки двоятся (троятся и т.д.), значит была попытка работы на незавершенной версии битрикса и старой версии модуля. Чтобы это исправить, в базе "b_sale_delivery_srv" необходимо удалить все записи, у которых "CODE", начинается на "edost...". И после этого обязательно обновить битрикс и все модули до последних версий, и заново настроить модуль доставки в админке магазина в закладке “eDost".

Внимание!!!
Версия 2.0.0 модуля местоположений и модуля расчета в карточке - это НЕ просто новые версии, а абсолютно другие модули, как по функционалу, так и по коду, поэтому перед обновлением обязательно ознакомьтесь со следующими пунктами:
1. Если вы самостоятельно модифицировали модуль, шаблон, или используете прямое обращение к функциям из кода модуля, то после обновления, они работать НЕ будут.

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

2. Интеграцию новой версии модуля местоположений необходимо проводить заново (инструкция).

3. Для работы модуля местоположений обязательно должны быть установлены местоположения 2.0 и новый список России стандарта eDost (инструкция).

4. В новой версии модуля местоположений больше НЕ поддерживается определение местоположений по IP через сайт ipgeobase.ru
info@edost.ru

© ООО "Айсден", 2006-2016. Все права защищены.