Интеграция

Совместимость и требования

Модуль протестирован на совместимость с Opencart и OcStore версий 1.5.6, 2.0, 2.1, 2.2, 2.3 и 3.0 без установки дополнительных модулей и шаблонов. Поддерживает работу с модификатором оформления заказа SimpleCheckout.

При использовании других модификаторов формы оформления заказа могут возникать конфликты совместимости и нестандартное поведение модуля!

Модуль опирается на корректно настроенный магазин, поэтому проверьте достоверность следующих параметров:

• локализация — единицы измерения — значение;
• локализация — вес — значение;
• локализация — валюты — знаков после запятой

Возможности

• Автоматический расчет стоимости доставки по России, Казахстану и Беларуси при работе через склад Shiptor.
• Автоматический расчет стоимости доставки по России при отгрузке из регионов (только для Opencart 2.0-3.0).
• Перерасчет стоимости доставки в зависимости от выбранного способа оплаты с учетом всех комиссий.
• Отображение карты выбора пунктов самовывоза и постаматов.
• Скрытие отдельных способов доставки или установка для них правил по отдельным регионам.
• Увеличение отображаемого времени доставки.
• Поддержка мультимагазина.
• Выгрузка товарной номенклатуры в Shiptor (только для Opencart 2.0-3.0).
• Поддержка опций товаров при расчете доставки и добавлении заказа в Shiptor (только для Opencart 2.0-3.0).
• Поддержка скидочных купонов (только для Opencart 2.0-3.0).
• Использование веса из карточки товара для расчета доставки.
• Использование габаритов из карточки товара для расчета стоимости доставки.
• Демонстрация подсказок при вводе названия населенного пункта и автовыбор региона.
• Передача заказов в ЛК вместе с описью номенклатуры товаров и услуг..
• Передача заказов с наложенным платежом, в т.ч. с оплатой по карте или без него.
• Автоматическая и пакетная передача заказов.
• Использование города по умолчанию из модулей Simple и GeoIP (только для Opencart 2.0-3.0).
• Отображение трек-номера и внутренних статусов заказа от Shiptor.
• Ассоциация внутренних статусов заказа от Shiptor со статусами заказа OpenCart.
• Отображение трек-номера и статуса заказа от курьерской службы.
• Логирование операций обмена данными с Shiptor.
• Установка правил по каждому способу доставки:
  • наценка в %;
  • наценка в ₽;
  • бесплатная доставка;
  • фиксированная цена;
  • фиксированная цена в зависимости от веса;
  • минимальный и максимальный вес корзины для доставки;
  • минимальная и максимальная сумма корзины для доставки.

Обратите внимание, что для стандартной версии и с модулем Simple нужны разные файлы ocmod! После установки обновления необходимо пересохранить настройки модуля для обновления таблиц в БД.

Версия 2.X — 3.0

1. Убедитесь, что сайт соответствует требованиям модуля: страница оформления заказа «Cтандартная» или изменена модулем «Simple - простая регистрация заказа». Корректная работа с любыми другими модулями оформления заказа не гарантируется. 
2. Скачайте архив с модулем под версию своего OpenCart или OcStore (например, 2.0, 2.1, 2.3 ...) и разархивируйте его в папку на своем компьютере.
3. В админпанели сайта перейдите в Дополнения > Менеджер дополнений и удалите модификаторы Shiptor, если они были ранее загружены. Для этого сделайте активными чек-боксы и нажмите кнопку . После этого страница должна иметь вид:
   
4. Не выходя из раздела «Менеджер дополнений» админпанели сайта обновите кеш.
   
5. Загрузите по FTP содержимое трёх папок extension из архива модуля в корень сайта с заменой всех файлов. Не сами папки extension! Чтобы передать точно в корень сайта, выделите содержимое каждой папки, щелкните правой кнопкой мыши и в выпадающем меню выберите «Закачать на сервер».
   
6. Загрузите по FTP файл shiptor_admin_order.ocmod.xml из папки ocmod в папку system в корне вашего сайта с заменой, если потребуется. При этом shiptor_admin_order.ocmod.xml обязателен, а shiptor_default_opencart.ocmod.xml нужен, если у вас стоит «Cтандартное» оформление заказа. Если используется модуль «Simple - простая регистрация заказа», тогда загружайте shiptor_simple_opencart.ocmod.xml. В папке system должно быть только ДВА файла ocmod от нашего модуля!
   
7. В админпанели сайта перейдите в Дополнения > Менеджер дополнений и ещё раз обновите кеш.
   
8. Проверьте логи модификатора на отсутствие конфликтов (сообщений типа NOT FOUND). Для этого в разделе сайта Дополнения > Менеджер дополнений перейдите на вкладку «Лог» и нажмите кнопку «Обновить».
   
9. В панели управления администратор должен выбрать Система > Пользователи > Группы пользователей и выставить разрешения для пользователей.
   
   Каждая группа имеет свои возможности просмотра и редактирования, а также перечень скрываемых дополнений.
10. Перейдите в раздел Дополнения > Платежи и установите модуль «Shiptor — Оплата наличными при получении» и «Shiptor — Оплата картой при получении». Нажмите кнопку «Редактировать» и в поле «Статус» укажите «Включено». Также необходимо установить актуальное значение для поля «Статус заказа после оплаты». Не забудьте нажать кнопку «Сохранить», чтобы внесенные изменения вступили в силу.
    
11. Перейдите в раздел Дополнения > Учитывать в заказе и установите модуль «Shiptor - Recalculate». Нажмите кнопку «Редактировать» и для поля «Статус» выберите «Включено». Нажмите «Сохранить». 
12. Перейдите в раздел Дополнения > Доставка и установите модуль «Shiptor — Агрегатор служб доставки». Нажмите «Редактировать» и настройте модуль в соответствии с документацией. Включите необходимые виды доставок.

Версия 1.5 (поддержка не осуществляется)

1. Загрузите по FTP содержимое папок extension из архива с заменой всех файлов.
2. Загрузите по FTP файл siphtor_admin_order_1.5.xml из папки vqmod архива в папку vqmod/xml своего сайта с заменой, если потребуется. 
3. В зависимости от версии страницы checkout загрузите по FTP файл shiptor_default_opencart_1.5.xml или shiptor_simple_opencart_1.5.xml из папки vqmod архива в папку vqmod/xml своего сайта с заменой если потребуется. В папке vqmod должно быть только ДВА файла vqmod от нашего модуля!
4. Очистите содержимое папки vqcache. В панели управления установите разрешения для группа пользователей.
5. В разделе дополнений «Оплата» установите модули «Shiptor — Оплата наличными при получении» и «Shiptor — Оплата картой при получении», выставите «Включено», а после этого — необходимый «Статус заказа».
6. В разделе дополнений «Учитывать в заказе» установите модуль «Shiptor — Учет суммы наложенного платежа» и выставите статус «Включено».
7. В разделе дополнений «Доставка» установите модуль «Shiptor — Агрегатор служб доставки».
8. Введите API-ключ и нажмите «Активировать». Настройте модуль согласно документации и включите необходимые виды доставок.

Мы постарались максимально упростить шаги по настройке. Однако если вы видите что-то, что поможет большинству пользователей модуля быстрее запустить работу с Shiptor, напишите нам на integration@shiptor.ru с пометкой «OpenCart — Быстрый старт». 

Подготовка модуля к работе включает следующие этапы:

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

• Скопируйте первый "API токен для интеграции" из личного кабинета Shiptor.
• Укажите параметры посылки по умолчанию и статусы заказа для передачи в Shiptor (подробнее).
• Активируйте и настройте необходимые методы доставки (подробнее).
• Активируйте методы оплаты Shiptor для работы с наложенным платежом, если подключены к Shiptor как юридическое лицо и предоставляете такую услугу покупателям. Включите перерасчет в зависимости от метода оплаты. (подробнее).

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

2. Настройка модуль Simple и GeoIP

Основные этапы настройки читайте в инструкции.

3. Выгрузка номенклатуры

О том, как это сделать, читайте в инструкции. Только для клиентов на фулфилменте!

4. Тестовый заказ

Проверяя правильность расчета, проверяется корректность настройки системы OpenCart — модуль Shiptor. Получившийся результат нужно сравнивать с калькулятором. Если в оформлении заказа отображаются корректные суммы и заказ после оформления корректно передался в ЛК Shiptor, то дальнейшая настройка модуля не требуется.

Успешно переданные из модуля заказы отображаются на вкладке «Посылки». Для них могут понадобиться дальнейшие действия в личном кабинете Shiptor в зависимости от принятой схемы работы.

Заказ на доставку готовой посылки от склада Shiptor

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

Заказ на доставку посылки от склада Shiptor со сборкой на фулфилменте

В этом случае дополнительных манипуляций с заказом не требуется. При наличии товара на складе посылка будет автоматически собрана и отправлена, если не стоит флаг паузы («не собирать посылку»). Как привезти товары и добавить номенклатуру на склад фулфилмента, можно прочитать в базе знаний.

Рекомендация по добавлению номенклатуры:
Чтобы избежать ошибок, не добавляйте номенклатуру вручную. Вместо этого воспользуйтесь опцией «Выгрузить данные по товарам в Shiptor».

Заказ на прямую доставку готовой посылки из региона

Если отгрузка не подтверждалась при передаче в Shiptor, то необходимо проверить и подтвердить форму отправления в разделе «Отгрузки». После этого самостоятельно отвезите посылки на ПВЗ или передайте их курьеру. Подготовительный этап подробно описано в базе знаний.