Официальный модуль ApiShip для OpenCart

Платформа ApiShip — это бесплатное универсальное, единое интеграционное решение для рынка электронной торговли, которое позволяет интернет-магазинам и сервисам предоставляющим услуги для магазинов беспрепятственно взаимодействовать с логистическими компаниями.

ApiShip — это только передача данных без вмешательства в договорные и финансовые отношения между интернет-магазином, сервисом и курьерской службой.

Модуль интегрирует сервис ApiShip в сайт вашего интернет-магазина, благодаря чему покупатели получают огромный выбор методов доставки, а владелец интернет-магазина максимально автоматизирует процесс доставки заказов до покупателей и управляет доставкой из административной панели, не переходя на сайты служб доставок.

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

Совместимость

• OpenCart 4.1.x — пакет 4.x (архив apiship.ocmod.zip, штатный чекаут OpenCart 4)
• OpenCart 3.x
• OpenCart 2.3
• OpenCart 2.1
• Модуль Simple
• Шаблон Простор
• Шаблон ShowCase
• Шаблон Smartstore
• Шаблон UltraStore
• Шаблон UniShop

Моды для сторонних шаблонов (Simple, Простор, ShowCase, Smartstore, UltraStore, UniShop) относятся к пакетам 2.x/3.x.

Установка на OpenCart 4.1.x

1. make build-oc4 (или скачать релиз) — файл apiship.ocmod.zip. Имя файла менять нельзя: установщик OpenCart 4 берёт код расширения из имени архива.
2. Админка → Расширения → Установщик → загрузить архив → «Установить».
3. Расширения → Расширения → Доставка → ApiShip → «Установить» → «Редактировать».
4. Права. Группе пользователя, ставившего модуль, права на маршрут extension/apiship/sale/order (вкладка «ApiShip» в заказе, ярлыки и акты в списке заказов) выдаются автоматически. Другим группам, которые работают с заказами, выдайте «Доступ» и «Изменение» для этого маршрута в Система → Пользователи → Группы пользователей: без них вкладка покажет предупреждение, а кнопок ярлыков и актов в списке заказов не будет.

Стенд для разработки и приёмки под OpenCart 4.1 — dev/oc4/README.md (make oc4-up).

Cron и действия с заказом на OpenCart 2.1, 2.3 и 3.x

Пакеты 2.1, 2.3 и 3.x (архивы apiship-<версия>_<пакет>.ocmod.zip, make build) ставятся через Установщик расширений как OCMOD.

• Cron. Эндпоинты группового экспорта и импорта статусов принимают только POST, ключ из настроек модуля передаётся заголовком X-Apiship-Key (или POST-полем key). Ключ в адресе и запросы GET отклоняются. Готовая команда есть в настройках модуля, поле «Пример команды cron»:

  curl -X POST -H "X-Apiship-Key: <ключ>" "https://магазин/index.php?route=extension/shipping/apiship/export_orders"
  curl -X POST -H "X-Apiship-Key: <ключ>" "https://магазин/index.php?route=extension/shipping/apiship/import_orders"
  

  Для пакета 2.1 маршрут — shipping/apiship/.... После обновления с версии 1.3 и ниже cron-команды на сервере нужно заменить: старый формат с &key= в адресе больше не работает.

• Права. Выгрузка, отмена, ярлыки и акты из карточки и списка заказов доступны администраторам с правом «Изменение» на sale/order (Система → Пользователи → Группы пользователей). Админка и витрина должны работать на одном домене — сессия администратора общая.

• Кеш. Справочники и расчёты хранятся в кеше OpenCart (system/storage/cache); после смены токена или настроек служб доставки достаточно очистить кеш в панели администратора.

• Проверки для разработчика: make lint-oc3 (синтаксис на PHP 7.4 и 8.3), make test-oc3 (юнит-тесты библиотеки dev/oc3/tests/run.php по всем трём пакетам) и make test-js (хелпер скрипта карты ПВЗ, node).

Список служб доставки

Актуальный список поддерживаемых служб доставки представлен на сайте ApiShip - https://apiship.ru/couriers

Функционал модуля

• Работа по прямым договорам с 40+ службами доставки
• Возможность подключения неограниченного количества служб доставки и договоров (разные юрлица)
• Автоматический расчет стоимости доставки с учетом габаритов, веса заказа, персональных скидок и тарифов служб доставки
• Гибкая настройка тарифов для каждой службы доставки
• Автоматическая отправка информации о заказе в службу доставки
• Отслеживание статуса доставки
• Отображение единой карты с ПВЗ
• Формирование этикеток и накладных в административной панели магазина

Документация

Документация по модулю находится в справочном центре ApiShip

• Установка модуля
• Настройка модуля
• Обновление модуля
• Создание заказа

Примеры интернет-магазинов, которые используют модуль

• https://posudaideal.ru
• https://becherry.ru

Техническая поддержка

Консультации по работе сервисов Платформы APISHIP доступны в рамках единой Службы поддержки. Для создания заявки в службу поддержки необходимо воспользоваться формой в Личном кабинете «Нужна помощь» или создать обращение на адрес электронной почты: support@apiship.ru

• Время обработки поступающих обращений службой поддержки: 8x5 (10:00-18:00 MSK, Пн-Пт).
• Все заявки обрабатываются в порядке очереди и приоритетности вопроса. Срок ответа на запрос может быть в течении 2 (двух) рабочих дней.
• В зависимости от типа задачи, решение может потребовать дополнительной работы и времени на реализацию конкретной задачи.

Обсудить различные вопросы по модулю можно в чате - https://t.me/apiship_chat/2534