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

Полное руководство по установке, настройке и использованию модулей OCX SOFT

Установка модуля

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

Перед установкой убедитесь, что ваш сервер соответствует следующим требованиям:

  • PHP 7.2 или выше
  • OpenCart 2.x, 3.x или 4.x
  • MySQL 5.6 или выше (или MariaDB 10.0+)
  • cURL и fsockopen функции включены
  • Доступ по SFTP или FTP к файлам сервера

Пошаговая установка

Шаг 1: Скачайте модуль из личного кабинета
ocxsoft_moysklad_sync.zip
Шаг 2: Распакуйте архив в корневую директорию OpenCart

Все файлы из архива должны быть распакованы в папку /admin/, /catalog/ и /system/

Шаг 3: Очистите кеш магазина

Удалите все файлы из папки /system/storage/cache/

Шаг 4: Откройте административную панель OpenCart

Перейдите в разделы Расширения → Модули (Extensions → Modules)

Шаг 5: Установите модуль

Найдите модуль "OCX SOFT - МойСклад Синхронизация" и нажмите кнопку "Установить"

Проверка установки

Если установка пройдена успешно, вы увидите:

  • Модуль в списке установленных модулей
  • Новое меню "МойСклад" в административной панели
  • Возможность перейти в настройки модуля

Активация лицензии

Получение ключа лицензии

После покупки лицензии вы получите ключ лицензии. Сохраните его в безопасном месте:

OCXSOFT-XXXXXXXXXXXXXXXXXXXXXXXXXXXX

Активация в административной панели

  1. Откройте административную панель OpenCart
  2. Перейдите в МойСклад → Настройки
  3. Вставьте ключ лицензии в поле "Ключ лицензии"
  4. Нажмите кнопку "Активировать"
  5. Дождитесь подтверждения активации

Активация в личном кабинете

Альтернативный способ - активировать лицензию через личный кабинет:

  1. Перейдите в личный кабинет
  2. Введите ключ лицензии
  3. Проверьте статус лицензии
  4. Скачайте модули

Поддержка нескольких доменов

При наличии лицензии на несколько доменов:

  • Каждый домен должен быть активирован отдельно
  • Используйте один ключ лицензии для всех доменов
  • Количество активаций зависит от тарифа лицензии

Настройка синхронизации

Подключение к МойСклад

Для работы модуля необходимо подключить его к вашему аккаунту МойСклад:

Шаг 1: Получите учетные данные МойСклад

Перейдите в МойСклад → Настройки → Интеграция → REST API и создайте токен доступа

Шаг 2: Скопируйте токен

Скопируйте полученный токен (он начинается с "nQ" для облачной версии)

Шаг 3: Вставьте в настройки модуля

В административной панели OpenCart вставьте токен в поле "API токен МойСклад"

Настройка параметров синхронизации

После подключения настройте следующие параметры:

Синхронизация товаров

  • Автоматическая синхронизация: Включите для автоматического обновления
  • Интервал синхронизации: Установите в минутах (рекомендуется 30-60)
  • Синхронизация категорий: Выберите способ связи категорий

Синхронизация остатков

  • Склад по умолчанию: Выберите основной склад для синхронизации
  • Использовать все склады: Суммировать остатки со всех складов
  • Минимальное количество: Не синхронизировать товары с остатком ниже

Ручная синхронизация

Для принудительной синхронизации:

  1. Откройте раздел "МойСклад" в административной панели
  2. Нажмите кнопку "Синхронизировать сейчас"
  3. Дождитесь завершения процесса
  4. Проверьте логи для подтверждения

Решение проблем

Модуль не отображается в списке

Решение:

  • Проверьте все ли файлы распакованы корректно
  • Очистите кеш: удалите содержимое папки /system/storage/cache/
  • Проверьте права доступа на директории (755 для папок, 644 для файлов)
  • Убедитесь, что PHP версия 7.2 или выше

Ошибка при активации лицензии

Решение:

  • Проверьте корректность введенного ключа
  • Убедитесь, что домен совпадает с зарегистрированным при покупке
  • Проверьте подключение к интернету и функцию cURL
  • Свяжитесь с поддержкой, если проблема сохраняется

Синхронизация не работает

Решение:

  • Проверьте токен API МойСклад (должен быть активным)
  • Убедитесь, что указан правильный URL МойСклад
  • Проверьте права доступа токена (должны быть включены товары и остатки)
  • Посмотрите логи синхронизации для ошибок

Страница администратора загружается медленно

Решение:

  • Отключите автоматическую синхронизацию на время диагностики
  • Сократите интервал выборки товаров в настройках
  • Удалите старые логи из базы данных
  • Обновите индексы базы данных

API документация

Общая информация

API OCX SOFT позволяет интегрировать функционал модулей с вашими собственными приложениями и сервисами.

Проверка лицензии

Endpoint: POST /api/license/check.php

Параметры:

{ "key": "OCXSOFT-XXXXXXXXXXXXXXXXXXXXXXXXXXXX", "domain": "example.com" }

Ответ (успех):

{ "status": "success", "valid": true, "domain": "example.com", "expires": "2025-12-31T23:59:59Z", "modules": [...] }

Ответ (ошибка):

{ "status": "error", "valid": false, "message": "License key not found" }

Получение информации о модуле

Endpoint: GET /api/modules/info.php?module=moysklad_sync

Ответ:

{ "name": "МойСклад Синхронизация", "version": "1.0.0", "compatibility": ["2.0", "3.0", "4.0"], "size": "2.4 MB", "download_url": "/downloads/moysklad_sync.zip" }

Обработка ошибок

Все ошибки API возвращают HTTP статус 400 или 500 с описанием проблемы в поле message.

Примеры использования

JavaScript/Fetch:

fetch('/api/license/check.php', { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify({key: "...", domain: "..."}) }).then(r => r.json()) .then(data => console.log(data))

PHP/cURL:

$ch = curl_init('/api/license/check.php'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); $response = curl_exec($ch);

Не нашли ответ?

Наша команда поддержки всегда готова помочь вам