Документация
Полное руководство по установке, настройке и использованию модулей OCX SOFT
Установка модуля
Системные требования
Перед установкой убедитесь, что ваш сервер соответствует следующим требованиям:
- PHP 7.2 или выше
- OpenCart 2.x, 3.x или 4.x
- MySQL 5.6 или выше (или MariaDB 10.0+)
- cURL и fsockopen функции включены
- Доступ по SFTP или FTP к файлам сервера
Пошаговая установка
Все файлы из архива должны быть распакованы в папку /admin/, /catalog/ и /system/
Удалите все файлы из папки /system/storage/cache/
Перейдите в разделы Расширения → Модули (Extensions → Modules)
Найдите модуль "OCX SOFT - МойСклад Синхронизация" и нажмите кнопку "Установить"
Проверка установки
Если установка пройдена успешно, вы увидите:
- Модуль в списке установленных модулей
- Новое меню "МойСклад" в административной панели
- Возможность перейти в настройки модуля
Активация лицензии
Получение ключа лицензии
После покупки лицензии вы получите ключ лицензии. Сохраните его в безопасном месте:
Активация в административной панели
- Откройте административную панель OpenCart
- Перейдите в МойСклад → Настройки
- Вставьте ключ лицензии в поле "Ключ лицензии"
- Нажмите кнопку "Активировать"
- Дождитесь подтверждения активации
Активация в личном кабинете
Альтернативный способ - активировать лицензию через личный кабинет:
- Перейдите в личный кабинет
- Введите ключ лицензии
- Проверьте статус лицензии
- Скачайте модули
Поддержка нескольких доменов
При наличии лицензии на несколько доменов:
- Каждый домен должен быть активирован отдельно
- Используйте один ключ лицензии для всех доменов
- Количество активаций зависит от тарифа лицензии
Настройка синхронизации
Подключение к МойСклад
Для работы модуля необходимо подключить его к вашему аккаунту МойСклад:
Перейдите в МойСклад → Настройки → Интеграция → REST API и создайте токен доступа
Скопируйте полученный токен (он начинается с "nQ" для облачной версии)
В административной панели OpenCart вставьте токен в поле "API токен МойСклад"
Настройка параметров синхронизации
После подключения настройте следующие параметры:
Синхронизация товаров
- Автоматическая синхронизация: Включите для автоматического обновления
- Интервал синхронизации: Установите в минутах (рекомендуется 30-60)
- Синхронизация категорий: Выберите способ связи категорий
Синхронизация остатков
- Склад по умолчанию: Выберите основной склад для синхронизации
- Использовать все склады: Суммировать остатки со всех складов
- Минимальное количество: Не синхронизировать товары с остатком ниже
Ручная синхронизация
Для принудительной синхронизации:
- Откройте раздел "МойСклад" в административной панели
- Нажмите кнопку "Синхронизировать сейчас"
- Дождитесь завершения процесса
- Проверьте логи для подтверждения
Решение проблем
Модуль не отображается в списке
Решение:
- Проверьте все ли файлы распакованы корректно
- Очистите кеш: удалите содержимое папки
/system/storage/cache/ - Проверьте права доступа на директории (755 для папок, 644 для файлов)
- Убедитесь, что PHP версия 7.2 или выше
Ошибка при активации лицензии
Решение:
- Проверьте корректность введенного ключа
- Убедитесь, что домен совпадает с зарегистрированным при покупке
- Проверьте подключение к интернету и функцию cURL
- Свяжитесь с поддержкой, если проблема сохраняется
Синхронизация не работает
Решение:
- Проверьте токен API МойСклад (должен быть активным)
- Убедитесь, что указан правильный URL МойСклад
- Проверьте права доступа токена (должны быть включены товары и остатки)
- Посмотрите логи синхронизации для ошибок
Страница администратора загружается медленно
Решение:
- Отключите автоматическую синхронизацию на время диагностики
- Сократите интервал выборки товаров в настройках
- Удалите старые логи из базы данных
- Обновите индексы базы данных
API документация
Общая информация
API OCX SOFT позволяет интегрировать функционал модулей с вашими собственными приложениями и сервисами.
Проверка лицензии
Endpoint: POST /api/license/check.php
Параметры:
Ответ (успех):
Ответ (ошибка):
Получение информации о модуле
Endpoint: GET /api/modules/info.php?module=moysklad_sync
Ответ:
Обработка ошибок
Все ошибки API возвращают HTTP статус 400 или 500 с описанием проблемы в поле message.
Примеры использования
JavaScript/Fetch:
PHP/cURL:
Не нашли ответ?
Наша команда поддержки всегда готова помочь вам