Документация модуля СДЭК для opencart

Общие сведения - Лицезия cdek.im

Для работы модулей необходимо зарегистрироваться на сайте https://cdek.im/signup. Подтверждённые регистрационные данные нужно ввести на странице "Лицензия" в настройках модулей.

Общие сведения - API ключи

API ключи вы можете заказать в личном кабинете СДЭК https://lk.cdek.ru/user/login в разделе Интеграция

Общие сведения - Использование модуля

Разработчик не гарантирует работу модуля с отличными от классической корзинами и системами оформления заказа.
Для модулей Simple Checkout, Ajax Quick Checkout и других систем оформления заказов требуется доработка.

Техническая поддержка осуществляется в тикет системе.
Доработка модуля под вашу систему оформления заказа платная.

Модуль СДЭК разрабатывался для версий PHP 5.4-5.6. С более поздними версиями PHP полного тестирования не производилось.

OpenCart 3.x - Загрузка

Скачать:

Демонстрация:

OpenCart 3.x - Установка

Установка:

  • После того, как вы скачаете архив с модулем, нужно зайти в административную часть сайта в раздел Модули > Установка расширений. Важно: Перед установкой самого модуля нужно скачать и установить фикс, решающий проблему установки расширений из админской части в Opencart3. (В этом разделе нужно нажать кнопку Загрузить и выбрать скачанный архив и нажать продолжить.) После установки фикса необходимо зайти в раздел Модули/Расширения > Модификаторы и нажать кнопку Обновить уже после этого можно будет таким же образом установить сам модуль.
  • После удачной загрузки файлов модуля в разделе Модули/Расширения > Модификаторы необходимо нажать кнопку Обновить, чтобы обновить кэш модификаторов. В верхней части меню появится раздел со всеми настройками модуля.
  • Для управления модулями необходимо активировать каждый из них в разделе Модули/Расширения > Модули расширения, нажав на соответствующую кнопку рядом с ним
    Модуль расчета доставки находится в разделе "Доставка"
    Модуль отгрузки находится в разделе "Модули"
    Модуль оплаты наложенным платежом находится в разделе "Оплата"
    Модуль учитывать в заказе активируется автоматически при включении наложенного платежа.
  • Важно: после активации модулей необходимо задать права для просмотра и редактирования страниц модуля группе пользователей, к которой относится пользователь, под которым вы зашли в админку. Как правило, это Administrator. Находится данная страница админки здесь После этого необходимо выбрать свою группу пользователей (в большинстве случаев, это Administrator) и нажать на кнопку "редактировать" Затем выставить права для редактирования и просмотра, нажав "Выделить все" (либо же конкретным страницам модуля), далее нажать на кнопку "сохранить" вверху экрана
  • После активации модулей и настройки прав можно будет редактировать их настройки из раздела "CDEK", без необходимости заходить в меню "Модули"

OpenCart 3.x - Применение изменений при обновлении модуля

  • Важно: в случае, если в модуль сдек у вас на сайте вносились правки в код (доработка под simple или какие-либо свои доработки), лучше обратиться к вашему веб-мастеру для установки. В случае особо важных обновлений, на данном сайте будем выкладывать инструкции для ручного обновления модуля.
  • При обновлении модуля необходимо повторить процесс установки.

OpenCart 3.x - Лицензия

1. Ввод лицензии https://cdek.im/signup

Получить лицензию

2. Ввод api-ключей в модуле доставки.

Получить API ключи

2. Ввод api-ключей в модуле отгрузки.

Получить API ключи

OpenCart 3.x - Расчет доставки

Нужно ввести api ключи

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

Во вкладке "Тарифы" нужно добавить желаемые тарифы для расчета стоиомсти доставки. Рекумендую также добавить тариф "Тяжеловесы" для тестирования веса и размера отправления.

"Вывод результатов:" если "Наиболее приоритетный" - будут выведены самый дешевые тарифы для каждого типа тарифов (до двери, до склада), иначе будут выведены все доступные тарифы для направления.

Во вкладе "Данные" нужно задать вес и размер по умолчанию. Эти данные нужны для расчета стоимости доставки в случае, если в корзине у пользователя находится товар, размеры или вес у которого не заданы. Например размер: габариты, 10х10х10, Если значение не заполнено; вес: 1кг, Если значение не заполнено;

Пункт "Учитывать регион при определении города доставки по России". Поиск города будет происходить по базе городов СДЭК

Пункт "Учитывать почтовый индекс при определении города". Будет произведена дополнительная проверка на существования почтового индекса в выбранном пользователем городе. Если есть несколько городов с одинаковыми (или похожими) названиями - выберется тот город, в котором есть указанный индекс.

OpenCart 3.x - Оплата

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

В настройках модуля оплаты нужно задать заголовок, который будет отображаться в способах оплаты, а также наценку за наложенный платеж. Наценка для Интернет магазинов обычно составляет 3% от общей суммы, но лучше узнать стоимость наценки у менеджера.

OpenCart 3.x - Отгрузка

Нужно ввести api ключи

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

OpenCart 2.x - Загрузка

Скачать:

Демонстрация:

OpenCart 2.x - Установка

Установка:

  • После того, как вы скачаете архив с модулем, нужно зайти в административную часть сайта в раздел Модули > Установка расширений. В этом разделе нужно нажать кнопку Загрузить и выбрать скачанный архив и нажать продолжить. Для корректной установки модуля необходимо в настройках магазина (вкладка сервер) необходимо включить и настроить FTP доступ.
  • После удачной загрузки файлов в разделе Модули > Модификаторы необходимо нажать кнопку Обновить, чтобы обновить кэш модификаторов. В верхней части меню появится раздел со всеми настройками модуля.
  • Для доступа к настройкам модуля необходимо выставить права доступа в разделе Система > Пользователи > Группы пользователей для группы администраторов.

OpenCart 2.x - Применение изменений при обновлении модуля

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

OpenCart 2.x - Лицензия

1. Ввод лицензии https://cdek.im/signup

Получить лицензию

2. Ввод api-ключей в модуле доставки.

Получить API ключи

2. Ввод api-ключей в модуле отгрузки.

Получить API ключи

OpenCart 2.x - Расчет доставки

Нужно ввести api ключи

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

Во вкладке "Тарифы" нужно добавить желаемые тарифы для расчета стоиомсти доставки. Рекумендую также добавить тариф "Тяжеловесы" для тестирования веса и размера отправления.

"Вывод результатов:" если "Наиболее приоритетный" - будут выведены самый дешевые тарифы для каждого типа тарифов (до двери, до склада), иначе будут выведены все доступные тарифы для направления.

Во вкладе "Данные" нужно задать вес и размер по умолчанию. Эти данные нужны для расчета стоимости доставки в случае, если в корзине у пользователя находится товар, размеры или вес у которого не заданы. Например размер: габариты, 10х10х10, Если значение не заполнено; вес: 1кг, Если значение не заполнено;

Пункт "Учитывать регион при определении города доставки по России". Поиск города будет происходить по базе городов СДЭК (импортируется из файла cdek_city.sql).

Пункт "Учитывать почтовый индекс при определении города". Будет произведена дополнительная проверка на существования почтового индекса в выбранном пользователем городе. Если есть несколько городов с одинаковыми (или похожими) названиями - выберется тот город, в котором есть указанный индекс.

OpenCart 2.x - Оплата

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

В настройках модуля оплаты нужно задать заголовок, который будет отображаться в способах оплаты, а также наценку за наложенный платеж. Наценка для Интернет магазинов обычно составляет 3% от общей суммы, но лучше узнать стоимость наценки у менеджера.

OpenCart 2.x - Отгрузка

Нужно ввести api ключи

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

Автоматическая синхронизация заказов через CRON

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

Команда будет следующего вида:

cd полный_путь_к_директории_с_сайтом_на_сервере/admin;
php cdek_integrator_cron.php;

Пример команды:

cd /var/www/user999/data/www/mysite.com/admin; php cdek_integrator_cron.php;

Поcле настроки крона на сервере, необходимо в настройках модуля включить выполнение крона.
Вкладка "Дополнительно" поле "Использовать cron для автоматического обновления отправлений".
1) За один запуск крона, обновляется несколько отправлений.
2) Сначала выбираются заказы с самым поздним временем обновления.
3) Один и тот-же заказ обновляется не раньше чем ерез 6 часов после последнего обновления.
4) Не обновляются заказы со статусами: Вручен, Не вручен, возврат, Возвращен на склад отправителя, Удален.
Внимание. Частота обращения настраивается произвольно, но слишком часто не рекомендуется т.к. будет создаваться черезмерная нагрузка как на ваш сайт так и на сервера СДЭК.

OpenCart 1.x - Загрузка

Скачать:

Демонстрация:

OpenCart 1.x - Установка

1) Из директории upload скопировать всё в корень сайта
2) Установить модуль и выставить права доступа в панели администратора (Система → Пользователи → Группы пользователей)
3) Выполнить импорт файла cdek_city.sql в базу данных через phpMyAdmin. Название базы данных есть в файле config.php в корне сайта (DB_DATABASE). Если вы используете префикс таблиц в базе данных, то отредактируйте его в файле cdek_city.sql
4) Установить доставку (Дополнения -> Доставка -> Доставка транспортной компанией «СДЭК»), оплату (Дополнения -> Оплата -> Наложенный платеж, Дополнения -> Оплата -> Наложенный платеж) и выставить права доступа в панели администратора (Система → Пользователи → Группы пользователей)
5) Настроить модуль

Автоматическая синхронизация заказов через CRON

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

Команда будет следующего вида:

cd полный_путь_к_директории_с_сайтом_на_сервере;
php cdek_integrator_cron.php;

Пример команды:

cd /var/www/user999/data/www/mysite.com/; php cdek_integrator_cron.php;

Поcле настроки крона на сервере, необходимо в настройках модуля включить выполнение крона.
Вкладка "Дополнительно" поле "Использовать cron для автоматического обновления отправлений".
1) За один запуск крона, обновляется несколько отправлений.
2) Сначала выбираются заказы с самым поздним временем обновления.
3) Один и тот-же заказ обновляется не раньше чем ерез 6 часов после последнего обновления.
4) Не обновляются заказы со статусами: Вручен, Не вручен, возврат, Возвращен на склад отправителя, Удален.
Внимание. Частота обращения настраивается произвольно, но слишком часто не рекомендуется т.к. будет создаваться черезмерная нагрузка как на ваш сайт так и на сервера СДЭК.

OpenCart 1.x - Лицензия

1. Ввод лицензии https://cdek.im/signup

Получить лицензию

2. Ввод api-ключей в модуле доставки.

Получить API ключи

2. Ввод api-ключей в модуле отгрузки.

Получить API ключи

OpenCart 1.x - Расчет доставки

Нужно ввести api ключи

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

Во вкладке "Тарифы" нужно добавить желаемые тарифы для расчета стоиомсти доставки. Рекумендую также добавить тариф "Тяжеловесы" для тестирования веса и размера отправления.

"Вывод результатов:" если "Наиболее приоритетный" - будут выведены самый дешевые тарифы для каждого типа тарифов (до двери, до склада), иначе будут выведены все доступные тарифы для направления.

Во вкладе "Данные" нужно задать вес и размер по умолчанию. Эти данные нужны для расчета стоимости доставки в случае, если в корзине у пользователя находится товар, размеры или вес у которого не заданы. Например размер: габариты, 10х10х10, Если значение не заполнено; вес: 1кг, Если значение не заполнено;

Пункт "Учитывать регион при определении города доставки по России". Поиск города будет происходить по базе городов СДЭК (импортируется из файла cdek_city.sql).

Пункт "Учитывать почтовый индекс при определении города". Будет произведена дополнительная проверка на существования почтового индекса в выбранном пользователем городе. Если есть несколько городов с одинаковыми (или похожими) названиями - выберется тот город, в котором есть указанный индекс.

OpenCart 1.x - Оплата

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

В настройках модуля оплаты нужно задать заголовок, который будет отображаться в способах оплаты, а также наценку за наложенный платеж. Наценка для Интернет магазинов обычно составляет 3% от общей суммы, но лучше узнать стоимость наценки у менеджера.

OpenCart 1.x - Отгрузка

Нужно ввести api ключи

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


Инструкция по эксплуатации модуля (на примере версии для 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 integrator@cdek.im.

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


Вкладка "Тарифы"

Пункт «Вывод результатов» позволяет выбрать два способа вывода тарифов: «Все доступные тарифы», «Наиболее приоритетные тарифы(склад и дверь)».

При выборе «Все доступные тарифы» на странице оформления заказа будут выведены все доступные тарифы доставки.

При выборе «Наиболее приоритетные тарифы(склад и дверь)» на странице оформления заказа будут выведены самые дешевые варианты для каждого типа тарифов(До двери, до ПВЗ, до Постамата), более дорогие варианты будут игнорироваться.

Далее идет таблица с тарифами доставки. Добавление тарифа осуществляется посредством выбора тарифа в пункте «Выберите тариф». Варианты возможных доставок на странице оформления заказа формируются непосредственно из числа тарифов в этой таблице.

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

Следует обратить внимание на то, что вес и размер товара, а так же данные веса по умолчанию влияют на выбор модулем тарифа при отображении вариантов доставки на странице оформления заказа. Для товара с большими габаритами и весом, вероятнее всего, не будет возможна доставка Экспресс-Лайт, Посылкой и т. п.

Также актуальным в модуле не является тариф СДЭК Экспресс, вместо него необходимо использовать тарифы Посылка или Экспресс-лайт.


Скидка/Наценки

В данной вкладке, при необходимости, можно задать скидку либо наценку при сумме товаров в корзине покупателя, начинающейся с определенного значения. Для этого необходимо выбрать сумму начиная с которой будет работать правило, указать значение «-» или «+» и цифровое значение скидки, либо наценки.

Если ни один тариф не отмечен, то правило применяется ко все тарифам доставки.

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

С версии модуля 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://cdek.opencart.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 на файл из архива последней версии


Часто задаваемые вопросы

Работает ли модуль в оффлайн режиме?

Нет

Есть ли в модуле автозаполнение отгрузки?

Нет, но планируется выпустить в новых обновлениях модуля

Можно ли разделить на карте ПВЗ постоматы и пункты выдачи

Нет