Инструкция по эксплуатации модуля (на примере версии для opencart 3)
Раздел «расчет доставки»
Вкладка “Основное”
1. Пункт «Заголовок» отвечает за то, какое название для модуля доставки будет отображаться при выборе способов доставки на стороне клиента.
2.Пункт «Налоговые классы» позволяет выбрать определенный тип налогового класса, который может быть настроен в магазине (Система – Локализация – Налоги). Данный пункт можно оставить по умолчанию.
3.Пункт «Режим отладки» отвечает за вывод системной информации о работе модуля (Система — Журнал ошибок). При подключении данной опции, когда клиент заходит на страницу оформления заказа в раздел вывода доставок, в журнал ошибок выводится следующая информация:
- вес заказа в килограммах
- url запроса по определению города доставки
- ответ от api СДЭК запроса по определению города доставки
- Выбранный регион, город доставки
- объем заказа в метрах кубических
- Невозможно осуществить доставку по этому направлению при заданных условиях — данная строка указывает на то, что один из тарифов, выбранных администратором модуля, не может быть выведен клиенту, потому что не подходит по условиям, перечисленным выше. Если несколько тарифов не проходят по условиям, будет выведено несколько таких строк.
- url запроса для получения списков пунктов выдачи заказов для соответствующих тарифов
- ответ от api СДЭК запроса по определению ПВЗ
В случае, если модуль не выводится на странице оформления заказа, подключение режима отладки может помочь выявить проблему.
4.В поле «Магазины» выводится список всех магазинов текущего сайта, для которых может быть включен модуль. Для отображения модуля на странице оформления заказа необходимо отметить текущий магазин.
5.Пункт «Статус» позволяет включать и отключать модуль. Для работы модуля его необходимо включить.
6. Поле «Порядок сортировки» отвечает за приоритетность модуля при отображении на странице. Модуль с приоритетом 1 будет выведен на странице выше чем модуль с приоритетом 2.
Вкладка “Данные”
1.Пункт «Размеры по умолчанию» позволяет задать размеры для товаров, размеры которых не были заданы в меню редактирования товаров. Это необходимо для корректной работы модуля.
Если размер товара не будет указан ни в товаре, не в модуле по умолчанию, для данного товара не будет рассчитываться стоимость доставки СДЭК, поскольку она зависит от веса и объема доставляемых товаров.
Рекомендуется использовать следующие параметры для этого пункта.
В данном случае объем товара будет равен 0.001 кубических метра, в случае если вес не указан напрямую в товаре.
2. Пункт «Вес по умолчанию» по аналогии с пунктом «Размеры по умолчанию» позволяет задать вес для товаров, вес которых не был задан в меню редактирования товаров. Параметры веса по умолчанию так же не рекомендуется оставлять без внимания и задать его дочерним полям соответствующие значения.
3. Пункт «Планируемая дата отправки заказа» учитывается при расчете времени доставки в пользовательской части на странице оформления заказа( если администратор подключил настройку расчета сроков доставки). В качестве параметра принимает количество дней через которое продавец отправит заказ.
4. Пункт «Учитывать ограничения наложенного платежа» при работе модуля доставки позволяет учесть отсутствие возможности наложенного платежа.
5. Пункт «Учитывать ограничения по весу для выдачи в ПВЗ» позволяет принять в расчет ограничения установленные пунктами выдачи по весу товаров. Данные ограничения устанавливаются в каждом отдельном ПВЗ и информацию о них модуль получает от серверов СДЭК.
6. Пункт «Учитывать регион при определении города доставки по России» отвечает за то каким образом будет происходить загрузка списка городов при расчете доставки. Если данная опция подключена, то при наличии в базе городов с одинаковыми названиями, СДЭК отдаст приоритет городу с указанным на странице оформления заказа регионом.
7. Пункт «Учитывать почтовый индекс при определении города» позволяет задать дополнительную проверку на существование почтового индекса в выбранном пользователем городе. Однако если индекс для выбранного города будет указан неверно, то доставка не будет расчитана.
8. Обязательный пункт «Город отправления» устанавливает город из которого будет производиться отправка товаров и соответственно расчет времени доставки в пользовательской части на странице оформления заказа. Его необходимо заполнить при первой настройке модуля.
Данное значение заполняется с помощью автозаполнения, то есть необходимо выбрать из предложенных вариантов города. Если у вас не появляется выпадающий список, возможно проблема в версии модуля, т. к. на более старых версиях автозаполнение могло не подключаться из-за отсутствия SSL-сертификата на сайте.
9. Далее идут два параметра: единица измерения длины и единицы измерения веса. Для работы модуля в настройках магазина должны быть заданы единицы измерения (Система-Локализация-(Единицы измерения, Единицы веса)), соответствующие сантиметрам и килограммам в вашем магазине.
Вкладка “Авторизация”
Вкладка «Авторизация» предназначена для ввода API ключей модуля и авторизации интернет-магазина в системе СДЭК, что, как указано в описании пункта, позволяет учитывать персональные тарифы и скидки, если они есть у интернет магазина (персональные тарифы и скидки возможны только при заключении договора со СДЭК).
API ключи (Учетная запись и секретный код) назначаются СДЭК-ом по запросу ИМ на email [email protected].
При тестировании модуля можно использовать тестовые ключи, указанные в этой же вкладке.
Вкладка “Тарифы”
Пункт «Вывод результатов» позволяет выбрать два способа вывода тарифов: «Все доступные тарифы», «Наиболее приоритетные тарифы(склад и дверь)».
При выборе «Все доступные тарифы» на странице оформления заказа будут выведены все доступные тарифы доставки.
При выборе «Наиболее приоритетные тарифы(склад и дверь)» на странице оформления заказа будут выведены самые дешевые варианты для каждого типа тарифов(До двери, до ПВЗ, до Постамата), более дорогие варианты будут игнорироваться.
Далее идет таблица с тарифами доставки. Добавление тарифа осуществляется посредством выбора тарифа в пункте «Выберите тариф». Варианты возможных доставок на странице оформления заказа формируются непосредственно из числа тарифов в этой таблице.
Для каждого тарифа есть возможность задать ограничения по весу и сумме, группы пользователей и географической зоны.
Следует обратить внимание на то, что вес и размер товара, а так же данные веса по умолчанию влияют на выбор модулем тарифа при отображении вариантов доставки на странице оформления заказа. Для товара с большими габаритами и весом, вероятнее всего, не будет возможна доставка Экспресс-Лайт, Посылкой и т. п.
Также актуальным в модуле не является тариф СДЭК Экспресс, вместо него необходимо использовать тарифы Посылка или Экспресс-лайт.
Скидка/Наценки
В данной вкладке, при необходимости, можно задать скидку либо наценку при сумме товаров в корзине покупателя, начинающейся с определенного значения.
Для этого необходимо выбрать сумму начиная с которой будет работать правило, указать значение «-» или « » и цифровое значение скидки, либо наценки.
Если ни один тариф не отмечен, то правило применяется ко все тарифам доставки.
Так же можно задать налоговый класс, группу покупателей и географическую зону для которой будет доступна скидка/наценка.
С версии модуля 1.5.0.0. появилась возможность сделать скидку фиксированного значения.
Вкладка “Дополнительный вес”
В данной вкладке, при необходимости, можно добавить дополнительный вес, который будет добавлен к весу товара.
Пункт «Минимальный вес упаковки» заполняется в соответствии с весом упаковки для товара, пункт «Дополнительный вес» позволяет задать дополнительный вес для товаров, который будет учитываться при формировании модулем доступных способов доставки исходя из доступных тарифов.
Вкладка “Дополнительно”
1. Пункт «Увеличить срок доставки» позволяет добавить дополнительное количество дней при расчете доставки на странице оформления заказа.
2. Пункт «Показывать сроки доставки» позволяет включить либо отключить отображение сроков доставки на странице оформления заказа.
3. Пункт «Показывать дату планируемой доставки» позволяет включить либо отключить отображение конкретной даты планируемой доставки на странице оформления заказа.
4. Пункт «Доставка с пустым адресом» отвечает за то, будет ли выводиться список тарифов с возможностью доставки «до двери», если пользователь не заполнил поле Адрес. Рекомендуется подключить данную опцию, чтобы тарифы были выведены сразу.
Далее следуют пункты минимального и максимального веса и суммы заказа для которых возможна доставка посредством модуля СДЭК, а так же список городов для которых выводить модуль не нужно.
Вкладка «Заглушка»
Во вкладке «Заглушка» есть возможность указать заглушку с фиксированной стоимостью в случае, если список доставок СДЭК пуст (не подгрузились тарифы).
Для этого нужно в пункте «Выводить заглушку» выбрать вариант «Да», указать Заголовок который будет отображаться на странице оформления товара и стоимость доставки.
Отгрузка сдэк
Для первоначальной работы Отгрузки необходимо произвести настройку- кнопка настройки в верхнем правом углу страницы.
Раздел настройки интегратора.
Вкладка Данные
1. Пункт «Город отправления» определяет отправную точку заказа, т.е. из какого города будет производиться отправка.Его необходимо заполнить при первой настройке модуля.
Данное значение заполняется с помощью автозаполнения, то есть необходимо выбрать из предложенных вариантов города. Если у вас не появляется выпадающий список, возможно проблема в версии модуля, т. к. на более старых версиях автозаполнение могло не подключаться из-за отсутствия SSL-сертификата на сайте.
2. Пункт «Основной город отправления» позволяет включить, либо отключить один основной город отправления для всех товаров. Если функция отключена, то для каждого заказа при создании отгрузки можно задать свой город отправления.
3.«Число копий одной квитанции на листе» позволяет выбрать способ отображения квитаций после создания отгрузки на листах для печати.
4. «Единица измерения веса в граммах», «Единица измерения длины в миллиметрах» – в данных пунктах необходимо указать единицы измерения вашего магазина, которые соответствуют граммам и миллиметрам соответственно.
Вкладка Авторизация
Вкладка «Авторизация» предназначена для ввода API ключей модуля и авторизации интернет-магазина в системе СДЭК. Тут указываются те же ключи, что и в разделе Расчет доставки.
Вкладка Фильтр заказов на отгрузку.
1.Пункт «Статусы заказов для отгрузки» позволяет установить статусы заказов, для которых будет доступна отгрузка, т.е. в отгрузку попадут заказы только с указанными статусами. Если не выбран ни один статус, то в отгрузку попадут все заказы.
2.Пункт «Актуальность заказа» позволяет установить количество дней в течение которых заказ считается актуальным для попадания в список отгрузки.
3.Пункт «Фильтр по способу доставки» позволяет отфильтровать заказы по способу выбранной доставки, которые попадут в отгрузку. Если не выбран ни один способ, то в отгрузку попадут все товары, независимо от выбранного способа доставки.
4.Пункт «Фильтр по способу оплаты» позволяет установить способы оплаты, которые попадут в отгрузку. Если не выбран ни один способ, то в отгрузку попадут все товары, независимо от выбранного способа оплаты.
Вкладка Статус заказа
В данной вкладке есть возможность создать правило для изменения статуса заказов в магазине на основе статуса отправления в системе СДЭК. Для этого необходимо в колонке «Статус заказа в системе СДЭК» выбрать статус отправления, а в колонке «Новый статус заказа» выбрать статус заказа, на который будет изменен текущий статус заказа в магазине.
Например, при статусе в системе СДЭК «отправлен в г. получателя» установить статус заказа «Отправлено». Список статусов заказа можно дополнить в панели управления Система — Локализация — Статус заказов.
Так же, есть возможность уведомить покупателя при смене статуса заказа(будет отправлено письмо о смене статуса заказа), написать комментарий. Используя токен, в комментарий можно вставить номер отправления и номер заказа.
Вкладка Валюта
В данной вкладке можно установить валюту объявленной стоимости заказа.
Пункт «Валюта договора» непосредственно влияет на пункт «Валюта наложенного платежа(Валюта платежа клиента)» на странице создания отгрузки.
Вкладка Дополнительно
1.Пункт «Заменить позиции для отгрузки» позволяет указать название позиции для замены при отгрузке.
2.Пункт «Использовать cron для автоматического обновления отправлений». Cron (Command Run ON) — планировщик задач. Используется для выполнения команд и скриптов на сервере хостинга в определённое время. В контексте работы модуля СДЭК, cron используется для автоматического обновления статусов заказов на сайте. Для этого нужно добавить крон задачу в хостинг панели сайта.
Данная опция не является обязательной, синхронизацию статусов можно проводить в ручном режиме.
Рекомендуется доверить настройку cron вашим программистам.
Пример команды:
«cd /var/www/user999/data/www/mysite.com/admin; php cdek_integrator_cron.php;»
Вкладка “Дополнительно” поле “Использовать cron для автоматического обновления отправлений”.
1) За один запуск крона, обновляется несколько отправлений.
2) Сначала выбираются заказы с самым поздним временем обновления.
3) Один и тот-же заказ обновляется не раньше чем через 6 часов после последнего обновления.
4) Не обновляются заказы со статусами: Вручен, Не вручен, возврат, Возвращен на склад отправителя, Удален.
Внимание. Частота обращения настраивается произвольно, но слишком часто не рекомендуется т.к. будет создаваться черезмерная нагрузка как на ваш сайт так и на сервера СДЭК.
3. Пункт «Наложенный платеж» отвечает за то, будет ли включен наложенный платеж по умолчанию на странице создания отгрузки.
4. Пункт «Дополнительный сбор за доставку, который ИМ берет с получателя». В случае, если услуги доставки СДЭК оплачивает не получатель, а интернет-магазин. Значение отображается в квитанции к заказу в поле «Стоимость доставки», но при этом входит в сумму наложенного платежа и обрабатывается как наложенный платеж. Данный пункт отображается на странице создания отгрузки и может быть задан индивидуально для каждой отгрузки.
5. Пункт «Истинный продавец». Используется при печати заказов для отображения настоящего продавца товара, либо торгового названия. Данный пункт отображается на странице создания отгрузки и может быть задан индивидуально для каждой отгрузки.
6. В пункте «Дополнительные услуги» приведен перечень доступных услуг, которые будут доступны получателю после отправки продавцом товара.
7. Далее идут поля минимальный вес упаковки и дополнительный вес товара. При необходимости можно заполнить данные поля, указанные значения будут добавлены к весу заказа.
Раздел заказы на отгрузку.
При наличии в системе opencart заказов со статусами, которые соответствуют выбранным в настройках СДЭК интегратора, они будут выведены в списке «Заказы на отгрузку», кнопка в правом верхнем меню.
На странице «Заказы на отгрузку» выведется список заказов, на основе которых можно создать отгрузку, после чего информация о них будет отправлена в личный кабинет СДЭК
Для создания отгрузки необходимо нажать на кнопку «Создание отгрузки». По нажатию откроется форма для создания отгрузки.
Вкладка Данные
1.Стоимость заказа, город отправления, Тариф подставляются автоматически на основе настроек и данных о заказе.
2.Далее можно применить использование наложенного платежа, его валюты, а также величину Дополнительного сбора за доставку, который ИМ берет с получателя.В случае, если услуги доставки СДЭК оплачивает не получатель, а интернет-магазин. Значение параметра отображается в квитанции к заказу в поле «Стоимость доставки», но при этом входит в сумму наложенного платежа и обрабатывается как наложенный платеж. Данный параметр по умолчанию будет установлен на значении, выбранном в настройках СДЭК Интегратора.
Вкладка Получатель
1. Поля Имя, email и телефон автоматически заполняются на основе информации из заказа.
2.Информация об адресе заказа выводится над соответствующими полями, но не заполняется автоматически, поскольку чаще всего адрес покупателя заполняется клиентом в одной строчке и автоматизированный разбор данных значений не предусмотрен системой.
Вкладка Вложения
1. В версии модуля начиная с 1.5.0.0. добавлен функционал отгрузки каждого товара в отдельной упаковке. При активации данной опции для каждого товара в составе заказа необходимо будет указать отдельные параметры, такие как Вес заказа и Штрихкод упаковки.
В случае отгрузки всего заказа в одной упаковке, габариты и штрихкод используются только один раз, и соответственно, весь заказ предъявляется в транспортной компании в одной коробке/упаковке.
Вкладка Расписание доставки
1. В случае, если интернет-магазин запрашивает у клиентов расписание для доставки/забора отправления, необходимо использовать опцию Расписание доставки. При нажатии на кнопку Добавить расписание можно указать конкретную дату и время доставки с комментарием для СДЭК.
- На одну дату по одному заказу может быть только одно расписание;
- В один день возможен один временной интервал не менее 3 часов;
- Расписание можно задать только на будущую дату;
- Расписание может быть передано позже.
Вкладка Курьер
1. При осуществлении отправлений с использованием тарифов не со склада, а из дома отправителя, для забора заказа необходимо осуществить вызов курьера.
-Вызов курьера возможно сделать только на будущую дату;
-На один день возможно не более одного вызова курьера на один адрес;
-Диапазон времени для приезда курьера не должен быть меньше 3 часов.
Вкладка Дополнительно
В данной вкладке можно выбрать дополнительные услуги, такие как:
- Доставка в выходной день
- Забор в городе отправителя
- Доставка в городе получателя
- Примерка на дому
- Частичная доставка
- Осмотр вложения
- Страхование
Страхование по умолчанию начисляется автоматически для всех заказов ИМ, его стоимость зависит от стоимости заказа, указанной во вкладке Вложения для создании отгрузки.
По заполнению всех вкладок необходимо нажать на кнопку «Отгрузить», после успешного создания отгрузки она попадет в личный кабинет СДЭК.
Отгрузка появится на странице «Последние отгрузки», при её просмотре ( кнопка «Просмотр»)
Наложенный платеж
Услуга «Наложенный платёж» – это специальный метод оплаты, добавляемый модулем как вариант оплаты на страницу оформления заказа. Он работает следующим образом — Вы отправляете груз получателю с оплатой за товар при получении, это и есть «Наложенный платёж». Получатель оплачивает за товар курьеру СДЭК или в пункте выдачи СДЭК, как наличными, так и банковской картой.
Услуга наложенный платёж доступна только клиентам с договором.
Вкладка “Основное”
1. Пункт «Заголовок» отвечает за название наложенного платежа, которое будет отображаться на странице оформления заказа в блоке способов оплаты.
2. Пункт «Учитывать ограничения наложенного платежа» при работе модуля позволяет учесть отсутствие возможности применить наложенный платеж. Она может отсутствовать в некоторых тарифах, ПВЗ или постоматах.
3. Пункт «Способ отображения» позволяет отображать наложенный платеж либо для всех способов доставки, либо только для доставки транспортной компании СДЭК.
4. Пункт «Назначение» позволяет выбрать тип тарифов, для которых будет доступен наложенный платеж. (Для всех тарифов, для тарифов курьером, для тарифов до ПВЗ).
5. Пункт «Статус заказа после оплаты» определяет, какой статус получит заказ после его оформления клиентом в случае выбора наложенного платежа как метода оплаты. В выпадающем списке следует выбрать наиболее подходящий статус.
6. Пункт «Статус» позволяет включать и отключать возможность использования наложенного платежа. Помимо включения модуля, для его работы необходимо перейти во вкладку «Дополнительно» и в пункте «Магазины» выбрать магазин для которого будет отображаться модуль.
7.Поле «Порядок сортировки» отвечает за приоритет модуля при отображении на странице. Модуль оплаты с приоритетом 1 будет выведен на странице выше чем модуль с приоритетом 2.
Вкладка “Дополнительно”
1. Пункт «Выставлять активным при выборе доставки СДЭК», при нескольких возможных вариантах оплаты, автоматически выставляет в качестве оплаты наложенный платеж, если выбрана доставка транспортной компанией СДЭК.
2. Далее идут поля минимальная и максимальная сумма заказа. При сумме заказа ниже минимальной и выше максимальной возможность оплаты наложенным платежом доступна не будет.
3. Пункт Скидки/Наценки позволяет указать скидку либо наценку для заказа при оплате наложенным платежом. Данная функция была добавлена в обновлении модуля 1.5.0.0
4. Пункт «Географическая зона» отвечает за возможность оплаты наложенным платежом в разных географических зонах. Географические зоны можно указать в панели управления магазином Система — Локализация — Географические зоны.
5. Пункт «Магазины» отвечает за то в каких магазинах будет доступен наложенный платеж.
6.Пункт «Группы покупателей» позволяет указать для каких покупателей будет доступен наложенный платеж (Система-Пользователи-API(необходим API ключ)).
7.Пункт «Список городов для которых выводить модуль не нужно» позволяет указать города, для которых возможность оплаты наложенным платежом доступна не будет, значения необходимо указывать через запятую.
Faq
1. СДЭК не появляется/ не появляется карта с пунктами выдачи
Ответ: Если установлен нестандартный модуль оформления заказа, например simplecheckout или quickcheckout, модулю потребуется адаптация. Это связано с тем, что модификаторы модуля вносят изменения в файлы стандартной страницы оформления заказа, и не будут корректно отрабатывать в файлах сторонних модулей. Проблема выразится в отсутствии возможности выбрать пункты выдачи заказов, будет отсутствовать карта для выбора.Для адаптации необходимо обратиться по адресу https://helpdesk.opencart.ru/
Если не установлен модуль нестандартного оформления заказа, необходимо включить режим отладки в модуле, далее зайти на страницу оформления заказа и дойти до шага выбора доставки. После этого СДЭК выведет в журнал ошибок информацию о проблемах и причинах отсутствия расчета доставки.
Ошибка авторизации может быть связана с отсутствием api – ключей, которые необходимо ввести в административной панели модуля и в настройках СДЭК Интегратора.
Ошибка с нулевым весом/ габаритами может быть связана с отсутствием этих данных в товарах – при этом необходимо заполнить данные о весе и габаритах товара по умолчанию во вкладке Данные в административной панели модуля.
-СДЭК: не определен подходящий город!
Невозможность определить город может быть связана с неверным заполнением поля город, либо с изменением страницы оформления заказа, в данном случае может понадобиться доработка модуля.
2. При активации функции обновления базы городов в админке появляется страница с уведомлениями Notice: Undefined index: region in /home/admin/web/namode.ru/public_html/admin/controller/extension/module/cdek_integrator.php on line 4205
Ответ: Данное уведомление связано с изменением структуры базы городов в СДЭК, поскольку у некоторых городов отсутствуют значения региона. Данное уведомление, при отсутствии других ошибок, не является критическим, база городов все так же обновляется. Однако оно исправлено в свежем архиве модуля и говорит о том, что у вас не самая последняя версия модуля, необходимо обновить модуль, загрузив архив с сайта http://vhod-v-lichnyj-kabinet.ru/
2.1 При активации функции обновления базы городов в админке появляется ошибка warning: Error while sending QUERY packet PID=20000
Ответ: файл с городами, который был выгружен из базы СДЭК, слишком большой для ваших настроек сервера, поэтому он не может записаться в базу. Нужно изменить в ваших настройках сервера размер доступных к приему пакетов, параметр max_allowed_packet, и проблема должна устраниться.
3. Ошибка при создании отгрузки в опенкарт версии 2.3: Parse error: syntax error, unexpected ‘}’, expecting end of file in /admin/view/template/extension/module/cdek_integrator/order_form.tpl on line 418
Ответ: Необходимо загрузить архив с последней версией модуля, ошибка возникла в результате переноса с третьей версии опенкарт и была исправлена
4. Ошибка Нет списка ПВЗ для москвы и санкт-петербурга
Ответ: Нет списка ПВЗ
5. Не выводятся в клиентской части тарифы CDEK Express
Ответ: Данная группа тарифов не является актуальной для использования в модуле, вместо нее необходимо использовать группы тарифов Посылка или Экспресс-Лайт
6. Слишком высокая стоимость страховки после оформления накладной в модуле.
Ответ: Поскольку стоимость страховки зависит от стоимости товаров, для ее изменения необходимо при создании отгрузки во вкладке “Вложения” в списке товаров при заполнении полей “Цена за единицу” необходимо указать стоимость 100 рублей для минимальной цены страховки.
7. Не работает вызов курьера.
Ответ: в модуле начиная с версии 1.5.0.0 введено расширенное логирование при создании отгрузки. Это значит, что все данные о связи с интегратором СДЭК, ответ сервера и информация о вызове курьера выводится в журнал ошибок при формировании отгрузки.
Чаще всего отсутствие вызова происходит из-за ошибки в модуле, которая была исправлена в обновлении 1.4.7.7. Для ее исправления вручную необходимо заменить файл class.orders.php в папке system/library/cdek_integrator/components на файл из архива последней версии
Приложение 3. дополнительные услуги
Код услуги | Название | Описание | |
---|---|---|---|
INSURANCE | СТРАХОВАНИЕ | ||
|
|
| |
TAKE_SENDER | ЗАБОР В ГОРОДЕ ОТПРАВИТЕЛЕ | Дополнительная услуга забора груза в городе отправителя, при условии, что тариф доставки с режимом «от склада» (не доступна для тарифов Посылка) | |
DELIV_RECEIVER | ДОСТАВКА В ГОРОДЕ ПОЛУЧАТЕЛЕ | Дополнительная услуга доставки груза в городе получателя, при условии, что тариф доставки с режимом «до склада» (только для тарифов «Магистральный», «Магистральный супер-экспресс»). | |
TRYING_ON | ПРИМЕРКА | Курьер доставляет покупателю несколько единиц товара (одежда, обувь и пр.) для примерки. | |
PART_DELIV | ЧАСТИЧНАЯ ДОСТАВКА | Во время доставки товара покупатель может отказаться от одной или нескольких позиций, и выкупить только часть заказа. Если в заказе указано одно вложение, услуга не подключается. | |
REVERSE | РЕВЕРС | Обратный заказ на доставку от получателя до отправителя. Например, подписанные документы. | |
DANGER_CARGO | ОПАСНЫЙ ГРУЗ | Кроме обычных документов и грузов, компания СДЭК готова доставить отправления, содержащие опасные грузы (кроме запрещенных к перевозке). В связи с определенным риском стоимость доставки грузов, относящихся к категории опасных, увеличивается в 1,5 раза. | |
SMS | Уведомление о вручении заказа | Компания СДЭК предлагает каждому клиенту оформить услугу “смс-уведомление о доставке”. Отправителю высылается сообщение с датой и временем доставки. Стоимость услуги 10 рублей. Отправитель получает смс-сообщение с информацией о дате/времени доставки и ФИО получателя. При режиме доставки до склада и указании мобильного телефона получателя всем клиентам Компания “СДЭК” предоставляет бесплатную услугу “Смс-уведомление о приходе груза на склад”. Получателю будет отправлено смс-сообщение с информацией об адресе забора отправления и времени работы офиса. | |
THERMAL_MODE | Тепловой режим | Направления, по которым возможна доставка с тепловым режимом: Кемерово-Новокузнецк, Новосибирск-Красноярск, Новосибирск-Кемерово, Новосибирск-Томск, Новосибирск-Омск, Новосибирск-Барнаул, Барнаул-Горно-Алтайск И В ОБРАТНЫХ НАПРАВЛЕНИЯХ! | |
COURIER_PACKAGE_A2 | Пакет курьерский А2 | Стоимость — 70 руб. | |
SECURE_PACKAGE_A2 | Сейф пакет А2 | Стоимость — 40 руб. | |
SECURE_PACKAGE_A3 | Сейф пакет А3 | Стоимость — 40 руб. | |
SECURE_PACKAGE_A4 | Сейф пакет А4 | Стоимость — 35 руб. | |
SECURE_PACKAGE_A5 | Сейф пакет А5 | Стоимость — 35 руб. | |
NOTIFY_ORDER_CREATED | Уведомление о создании заказа в СДЭК | Применяется при создании заказа. Страны города получателя: Россия, Казахстан, Беларусь | |
NOTIFY_ORDER_DELIVERY | Уведомление о приеме заказа на доставку | Применяется при создании заказа. Страны города получателя: Россия, Казахстан, Беларусь | |
CARTON_BOX_XS | Коробка XS (0,5 кг 17х12х9 см) | Коробка из трехслойного гофрокартона размером 170*125*95 мм. Максимальная вместимость – 0,5 кг. Стоимость 1 штуки – 20 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_S | Коробка S (2 кг 21х20х11 см) | Коробка из трехслойного гофрокартона размером 216*200*110 мм. Максимальная вместимость – 2 кг. Стоимость 1 штуки – 40 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_M | Коробка M (5 кг 33х25х15 см) | Коробка из трехслойного гофрокартона размером 330*250*155 мм. Максимальная вместимость – 5 кг. Стоимость 1 штуки – 60 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_L | Коробка L (12 кг 34х33х26 см) | Коробка из трехслойного гофрокартона размером 340*330*264 мм. Максимальная вместимость – 12 кг. Стоимость 1 штуки – 70 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_500GR | Коробка (0,5 кг 17х12х10 см) | Коробка из трехслойного гофрокартона размером 170*120*100 мм. Максимальная вместимость – 0,5 кг. Стоимость 1 штуки – 35 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_1KG | Коробка (1 кг 24х17х10 см) | Коробка из трехслойного гофрокартона размером 240*170*100 мм. Максимальная вместимость – 1 кг. Стоимость 1 штуки – 50 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_2KG | Коробка (2 кг 34х24х10 см) | Коробка из трехслойного гофрокартона размером 340*240*100 мм. Максимальная вместимость – 2 кг. Стоимость 1 штуки – 80 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_3KG | Коробка (3 кг 24х24х21 см) | Коробка из трехслойного гофрокартона размером 240*240*210 мм. Максимальная вместимость – 3 кг. Стоимость 1 штуки – 90 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_5KG | Коробка (5 кг 40х24х21 см) | Коробка из трехслойного гофрокартона размером 400*240*210 мм. Максимальная вместимость – 5 кг. Стоимость 1 штуки – 100 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_10KG | Коробка (10 кг 40х35х28 см) | Коробка из трехслойного гофрокартона размером 400*350*280 мм. Максимальная вместимость – 10 кг. Стоимость 1 штуки – 150 рублей. Доступна для всех тарифов от склада. | |
CARTON_BOX_15KG | Коробка (15 кг 60х35х29 см) | Коробка из трехслойного гофрокартона размером 600*350*290 мм. Максимальная вместимость – 15 кг. Стоимость 1 штуки – 190 рублей. Доступна для всех тарифов от склада (кроме режима “склад-постамат”). | |
CARTON_BOX_20KG | Коробка (20 кг 47х40х43 см) | Коробка из трехслойного гофрокартона размером 470*400*430 мм. Максимальная вместимость – 20 кг. Стоимость 1 штуки – 200 рублей. Доступна для всех тарифов от склада (кроме режима “склад-постамат”). | |
CARTON_BOX_30KG | Коробка (30 кг 69х39х42 см) | Коробка из трехслойного гофрокартона размером 690*390*420 мм. Максимальная вместимость – 30 кг. Стоимость 1 штуки – 250 рублей. Доступна для всех тарифов от склада (кроме режима “склад-постамат”). | |
BUBBLE_WRAP | Воздушно-пузырчатая пленка | Полиэтилен высокого давления, двухслойный. Является дополнительным упаковочным материалом для упаковки отправлений в транспортную упаковку. 1 метр – 55 рублей. Доступна для всех тарифов от склада. | |
WASTE_PAPER | Макулатурная бумага | Упаковочная бумага (макулатурная, класса Е). Ширина 0,42 м. Предназначена для упаковки различных видов отправлений (грузов) и заполнения пустот внутри упаковки 1 метр – 50 рублей. Доступна для всех тарифов от склада. | |
CARTON_FILLER | Прессованный картон “филлер” (55х14х2,3 см) | Вставка защитная из листового прессованного картона. Применяется для: – внутренней обрешетки внутри гофрокороба – оборачивания и разделения вложений внутри гофрокороба – заполнения пустот. Стоимость 1 штуки – 50 рублей. Доступна для всех тарифов от склада. | |
BAN_ATTACHMENT_INSPECTION | Запрет осмотра вложения | Предоставляет возможность запрета осмотра вложения. Предоставляется для интернет-магазинов. | |
PHOTO_OF_DOCUMENTS | Фото документов | Предназначена для выполнения доставок продуктов (грузы, документы), с идентификацией получателя, фотографированием товара клиента/подписанных документов. |
Раздел «расчет доставки»
Вкладка “Основное”
1. Пункт «Заголовок» отвечает за то, какое название для модуля доставки будет отображаться при выборе способов доставки на стороне клиента.
2.Пункт «Налоговые классы» позволяет выбрать определенный тип налогового класса, который может быть настроен в магазине (Система – Локализация – Налоги). Данный пункт можно оставить по умолчанию.
3.Пункт «Режим отладки» отвечает за вывод системной информации о работе модуля (Система — Журнал ошибок). При подключении данной опции, когда клиент заходит на страницу оформления заказа в раздел вывода доставок, в журнал ошибок выводится следующая информация:
- вес заказа в килограммах
- url запроса по определению города доставки
- ответ от api СДЭК запроса по определению города доставки
- Выбранный регион, город доставки
- объем заказа в метрах кубических
- Невозможно осуществить доставку по этому направлению при заданных условиях — данная строка указывает на то, что один из тарифов, выбранных администратором модуля, не может быть выведен клиенту, потому что не подходит по условиям, перечисленным выше. Если несколько тарифов не проходят по условиям, будет выведено несколько таких строк.
- url запроса для получения списков пунктов выдачи заказов для соответствующих тарифов
- ответ от api СДЭК запроса по определению ПВЗ
В случае, если модуль не выводится на странице оформления заказа, подключение режима отладки может помочь выявить проблему.
4.В поле «Магазины» выводится список всех магазинов текущего сайта, для которых может быть включен модуль. Для отображения модуля на странице оформления заказа необходимо отметить текущий магазин.
5.Пункт «Статус» позволяет включать и отключать модуль. Для работы модуля его необходимо включить.
6. Поле «Порядок сортировки» отвечает за приоритетность модуля при отображении на странице. Модуль с приоритетом 1 будет выведен на странице выше чем модуль с приоритетом 2.
Вкладка “Данные”
1.Пункт «Размеры по умолчанию» позволяет задать размеры для товаров, размеры которых не были заданы в меню редактирования товаров. Это необходимо для корректной работы модуля.
Если размер товара не будет указан ни в товаре, не в модуле по умолчанию, для данного товара не будет рассчитываться стоимость доставки СДЭК, поскольку она зависит от веса и объема доставляемых товаров.
2. Пункт «Вес по умолчанию» по аналогии с пунктом «Размеры по умолчанию» позволяет задать вес для товаров, вес которых не был задан в меню редактирования товаров. Параметры веса по умолчанию так же не рекомендуется оставлять без внимания и задать его дочерним полям соответствующие значения.
3. Пункт «Планируемая дата отправки заказа» учитывается при расчете времени доставки в пользовательской части на странице оформления заказа( если администратор подключил настройку расчета сроков доставки). В качестве параметра принимает количество дней через которое продавец отправит заказ.
4. Пункт «Учитывать ограничения наложенного платежа» при работе модуля доставки позволяет учесть отсутствие возможности наложенного платежа.
5. Пункт «Учитывать ограничения по весу для выдачи в ПВЗ» позволяет принять в расчет ограничения установленные пунктами выдачи по весу товаров. Данные ограничения устанавливаются в каждом отдельном ПВЗ и информацию о них модуль получает от серверов СДЭК.
6. Пункт «Учитывать регион при определении города доставки по России» отвечает за то каким образом будет происходить загрузка списка городов при расчете доставки. Если данная опция подключена, то при наличии в базе городов с одинаковыми названиями, СДЭК отдаст приоритет городу с указанным на странице оформления заказа регионом.
7. Пункт «Учитывать почтовый индекс при определении города» позволяет задать дополнительную проверку на существование почтового индекса в выбранном пользователем городе. Однако если индекс для выбранного города будет указан неверно, то доставка не будет расчитана.
8. Обязательный пункт «Город отправления» устанавливает город из которого будет производиться отправка товаров и соответственно расчет времени доставки в пользовательской части на странице оформления заказа. Его необходимо заполнить при первой настройке модуля.
Данное значение заполняется с помощью автозаполнения, то есть необходимо выбрать из предложенных вариантов города. Если у вас не появляется выпадающий список, возможно проблема в версии модуля, т. к. на более старых версиях автозаполнение могло не подключаться из-за отсутствия SSL-сертификата на сайте.
9. Далее идут два параметра: единица измерения длины и единицы измерения веса. Для работы модуля в настройках магазина должны быть заданы единицы измерения (Система-Локализация-(Единицы измерения, Единицы веса)), соответствующие сантиметрам и килограммам в вашем магазине.
Вкладка “Авторизация”
Вкладка «Авторизация» предназначена для ввода API ключей модуля и авторизации интернет-магазина в системе СДЭК, что, как указано в описании пункта, позволяет учитывать персональные тарифы и скидки, если они есть у интернет магазина (персональные тарифы и скидки возможны только при заключении договора со СДЭК).
API ключи (Учетная запись и секретный код) назначаются СДЭК-ом по запросу ИМ на email [email protected].
При тестировании модуля можно использовать тестовые ключи, указанные в этой же вкладке.
Вкладка “Тарифы”
Пункт «Вывод результатов» позволяет выбрать два способа вывода тарифов: «Все доступные тарифы», «Наиболее приоритетные тарифы(склад и дверь)».
При выборе «Все доступные тарифы» на странице оформления заказа будут выведены все доступные тарифы доставки.
При выборе «Наиболее приоритетные тарифы(склад и дверь)» на странице оформления заказа будут выведены самые дешевые варианты для каждого типа тарифов(До двери, до ПВЗ, до Постамата), более дорогие варианты будут игнорироваться.
Далее идет таблица с тарифами доставки. Добавление тарифа осуществляется посредством выбора тарифа в пункте «Выберите тариф». Варианты возможных доставок на странице оформления заказа формируются непосредственно из числа тарифов в этой таблице.
Для каждого тарифа есть возможность задать ограничения по весу и сумме, группы пользователей и географической зоны.
Следует обратить внимание на то, что вес и размер товара, а так же данные веса по умолчанию влияют на выбор модулем тарифа при отображении вариантов доставки на странице оформления заказа. Для товара с большими габаритами и весом, вероятнее всего, не будет возможна доставка Экспресс-Лайт, Посылкой и т. п.
Также актуальным в модуле не является тариф СДЭК Экспресс, вместо него необходимо использовать тарифы Посылка или Экспресс-лайт.
Скидка/Наценки
В данной вкладке, при необходимости, можно задать скидку либо наценку при сумме товаров в корзине покупателя, начинающейся с определенного значения.
Для этого необходимо выбрать сумму начиная с которой будет работать правило, указать значение «-» или « » и цифровое значение скидки, либо наценки.
Если ни один тариф не отмечен, то правило применяется ко все тарифам доставки.
Так же можно задать налоговый класс, группу покупателей и географическую зону для которой будет доступна скидка/наценка.
С версии модуля 1.5.0.0. появилась возможность сделать скидку фиксированного значения.
Вкладка “Дополнительный вес”
В данной вкладке, при необходимости, можно добавить дополнительный вес, который будет добавлен к весу товара.
Пункт «Минимальный вес упаковки» заполняется в соответствии с весом упаковки для товара, пункт «Дополнительный вес» позволяет задать дополнительный вес для товаров, который будет учитываться при формировании модулем доступных способов доставки исходя из доступных тарифов.
Вкладка “Дополнительно”
1. Пункт «Увеличить срок доставки» позволяет добавить дополнительное количество дней при расчете доставки на странице оформления заказа.
2. Пункт «Показывать сроки доставки» позволяет включить либо отключить отображение сроков доставки на странице оформления заказа.
3. Пункт «Показывать дату планируемой доставки» позволяет включить либо отключить отображение конкретной даты планируемой доставки на странице оформления заказа.
4. Пункт «Доставка с пустым адресом» отвечает за то, будет ли выводиться список тарифов с возможностью доставки «до двери», если пользователь не заполнил поле Адрес. Рекомендуется подключить данную опцию, чтобы тарифы были выведены сразу.
Далее следуют пункты минимального и максимального веса и суммы заказа для которых возможна доставка посредством модуля СДЭК, а так же список городов для которых выводить модуль не нужно.
Вкладка «Заглушка»
Во вкладке «Заглушка» есть возможность указать заглушку с фиксированной стоимостью в случае, если список доставок СДЭК пуст (не подгрузились тарифы).
Для этого нужно в пункте «Выводить заглушку» выбрать вариант «Да», указать Заголовок который будет отображаться на странице оформления товара и стоимость доставки.
Сдэк – тарифы – procedure [api_rucdektariff_request]
Для получения стоимости и сроков доставки необходимо отправить json-объект серверу СДЭК.
При передаче json-объекта в заголовке нужно указать соответствующий Content-Type.
Входные данные запроса – параметры процедуры PROCEDURE [api_ruCDEKTariff_request]
№ | Переменная | Тип | Значение по умолчанию | Описание | Примечание |
1 | @dateExecute2 | nvarchar(10) | ” | Планируемая дата отправки заказа в формате “ГГГГ-ММ-ДД | |
2 | @senderCityId | int | 36528 | Код города отправителя из базы СДЭК | |
3 | @receiverCityId | int | 288 | Код города получателя из базы СДЭК | |
4 | @tariffId | int | 1 | Код выбранного тарифа | |
goods Габаритные характеристики упаковки | |||||
5 | @weight | int | 300 | Вес (грамм ) | ПЕРЕСЧЕТ! Вес упаковки (в килограммах) |
6 | @length | int | 5 | Длина упаковки (в сантиметрах) | |
7 | @width | int | 20 | Ширина упаковки (в сантиметрах) | |
@height | int | 10 | Высота упаковки (в сантиметрах) |
Приложение 1. Услуги (тарифы) и режимы доставки СДЭК
Тарифы для обычной доставки
Код | Название тарифа | Режим доставки | Ограничение по весу | Услуга | Описание |
1 | Экспресс лайт дверь-дверь | дверь-дверь (Д-Д) | до 30 кг | Экспресс | Классическая экспресс-доставка по России документов и грузов до 30 кг. |
3 | Супер-экспресс до 18 | дверь-дверь (Д-Д) | до 30 кг | Срочная доставка | Срочная доставка документов и грузов «из рук в руки» по России к определенному часу. |
5 | Экономичный экспресс склад-склад | склад-склад (С-С) | Экономичная доставка | Недорогая доставка грузов по России ЖД и автотранспортом (доставка грузов с увеличением сроков). |
города получателя из базы СДЭК
- Id – Идентификатор города по базе СДЭК (CityCode)
- FullName – Полное название города/населенного пункта включая региональную принадлежность
- CityName – Название города не включает региональную принадлежность
ID | FullName | CityName | OblName |
36528 | 5663234234, Москва | Москва | |
438 | Ростов-на-Дону | Ростов-на-Дону | Ростовская обл. |
402 | Архангельск | Архангельск | Архангельская обл. |
288 | Владивосток | Владивосток | Приморский край |
Тарифы для им
Код | Название тарифа | Режим доставки | Ограничение по весу | Услуга | Описание |
---|---|---|---|---|---|
7 | Международный экспресс документы дверь-дверь | дверь-дверь (Д-Д) | до 5 кг | Международный экспресс | Экспресс-доставка за/из-за границы документов и писем. |
8 | Международный экспресс грузы дверь-дверь | дверь-дверь (Д-Д) | до 30 кг | Международный экспресс | Экспресс-доставка за/из-за границы грузов и посылок до 30 кг. |
136 | Посылка склад-склад | склад-склад (С-С) | до 30 кг | Посылка | Услуга экономичной доставки товаров по России для компаний, осуществляющих дистанционную торговлю. |
137 | Посылка склад-дверь | склад-дверь (С-Д) | |||
138 | Посылка дверь-склад | дверь-склад (Д-С) | |||
139 | Посылка дверь-дверь | дверь-дверь (Д-Д) | |||
до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров по России для компаний, осуществляющих дистанционную торговлю. Услуга действует по направлениям из Москвы в подразделения СДЭК, находящиеся за Уралом и в Крым. | |||
233 | Экономичная посылка склад-дверь | склад-дверь (С-Д) | |||
234 | Экономичная посылка склад-склад | склад-склад (С-С) | |||
291 | CDEK Express склад-склад | склад-склад (С-С) | CDEK Express | Сервис по доставке товаров из-за рубежа в Россию, Украину, Казахстан, Киргизию, Узбекистан с услугами по таможенному оформлению. Предлагается 2 схемы работы: 1) клиент доставляет заказ на таможенный пост в России. Мы встречаем, помогаем с таможней и доставляем адресату; 2) клиент привозит посылки на один из наших складов за рубежом. Мы перевозим их на таможенный пост в Россию, проводим очистку и доставляем получателю. | |
293 | CDEK Express дверь-дверь | дверь-дверь (Д-Д) | |||
294 | CDEK Express склад-дверь | склад-дверь (С-Д) | |||
295 | CDEK Express дверь-склад | дверь-склад (Д-С) | |||
366 | Посылка дверь-постамат | дверь-постамат (Д-П) | до 30 кг | Посылка | Услуга экономичной доставки товаров по России для компаний, осуществляющих дистанционную торговлю. |
368 | Посылка склад-постамат | склад-постамат (С-П) | |||
| до 50 кг | Экономичная посылка | Услуга экономичной наземной доставки товаров по России для компаний, осуществляющих дистанционную торговлю. Услуга действует по направлениям из Москвы в подразделения СДЭК, находящиеся за Уралом и в Крым | ||
378 | Экономичная посылка склад-постамат | склад-постамат (С-П) |