Синхронизация Opencart и Мой Склад

Внимание!
После 1 декабря 2023 года модуль (в случае если он был скачан и установлен до обновления 11.11.2023) может перестать работать из-за переезда API сервиса МойСклад на новый домен. Чтобы модуль продолжал работать необходимо обновить файлы модуля и сохранить после этого настройки модуля. Обновить файлы можно 3-мя способами:
1. Если никаких доработок модуля не выполнялось, то можно заново скачать архив с модулем на сайте и установить модуль по новой. Все файлы модуля обновятся автоматически.
2. Если выполнялись доработки модуля, то есть возможность установить отдельный мини-модуль (модификатор), который можно скачать на вкладке "Файлы". Он автоматически внесет в файлы модуля все необходимые изменения. 
3. Также можно внести изменения в файлы модуля вручную с помощью инструкции ниже.
В файлах admin/controller/extension/module/syncms.php и catalog/controller/extension/module/syncms.php необходимо:
1) Заменить online.moysklad.ru на api.moysklad.ru
2) Добавить после строки curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); строку curl_setopt($ch, CURLOPT_ENCODING, "gzip ''");
После внесения изменений в файлы любым из способов выше сбросятся некоторые настройки модуля: "Склад" и "Организация" в разделе "Синхронизация заказов" и склады, выбранные в настройке "Выгружать остатки из".
После внесения изменений в файлы любым из способов выше нужно сохранить настройки модуля!
Также для обновления файлов можно обратиться к автору модуля (для этого потребуются доступы к админ-панели сайта и/или ftp)

Возможности модуля (краткое описание)

• Добавление категорий в Opencart
  
• Обновление категорий в Opencart
  
• Добавление товаров в Opencart
  
• Обновление товаров в Opencart
  
• Обновление остатков товаров в Opencart
  
• Обновление цен товаров в Opencart
  
• Удаление/обновление лишних товаров Opencart
  
• Добавление/обновление изображений у товаров в Opencart
  
• Обновление заказов в Opencart
  
• Добавление заказов в Мой Склад
  
• Обновление заказов в Моем Складе
  
• Добавление товаров в Мой Склад
• Добавление категорий в Мой Склад
• Выполнение всех вышеперечисленных действия автоматически через Cron (планировщик заданий)

Возможности модуля (подробное описание)

• Добавление категорий в Opencart - перенос категорий (групп) из Моего Склада в Opencart. Переносятся следующие данные категорий: Наименование, Родительская категория. При добавлении категорий можно включить заполнение следующих полей: URL категории (генерируется из наименования товара), Meta-title, Meta-description, Meta-keyword. Возможные виды связывания категорий: по Наименованиям, по ID из Моего Склада. При выборе связи по ID из Моего Склада категории добавленные не через модуль синхронизироваться не будут!
• Обновление категорий в Opencart - обновление данных у категорий в Opencart в соответствии с группами в Моем Складе. Обновляются следующие данные категорий: Наименование, Родительская категория, Meta-title, Meta-description, Meta-keyword.
• Добавление товаров в Opencart - перенос товаров (комплектов) из Моего Склада в Opencart. Есть возможность переносить следующие данные товаров: Наименование, Описание, Категория (Группа), Цена (можно выбрать цену в Моем Складе), Количество (можно выбрать Склад в Моем Складе), Артикул, Модель (Код товара), Вес, Производитель (нужно дополнительное поле в Моем Складе). При добавлении товаров можно включить заполнение следующих полей: URL товара (генерируется из наименования товара), Статус при отсутствии на складе, Вычитать со склада, Единица измерения веса, Meta-title, Meta-description, Meta-keyword. Возможные виды связывания товаров (Opencart - Мой Склад): Модель (Код товара) - Код, Модель (Код товара) - Внешний код, Модель (Код товара) - Артикул, Артикул - Артикул, Артикул - Код, Артикул - Внешний код. Также товары можно дополнительно связывать по Наименованию. Из Моего Склада переносятся только Товары и Комплекты, Услуги не переносятся. Комплекты переносятся в Opencart как обычные товары.
• Обновление товаров в Opencart - обновление данных у товаров в Opencart в соответствии с товарами (комплектами) в Моем Складе. Есть возможность обновлять следующие данные товаров: Наименование, Описание, Категория (Группа), Артикул, Модель (Код товара), Вес, Производитель (нужно дополнительное поле в Моем Складе), Статус при отсутствии на складе, Вычитать со склада, Единица измерения веса, Meta-title, Meta-description, Meta-keyword.
• Обновление остатков товаров в Opencart - обновление остатков у товаров в Opencart в соответствии с остатками товаров (комплектов) в Моем Складе. Остатки из Моего Склада берутся с учетом резерва, то есть из поля Доступно. Остатки Комплектов вычисляются на основании остатков Компонентов (товаров входящих в Комплект). Есть возможность указать Склад в Моем Складе, из которого будут браться остатки товаров.
• Обновление цен товаров в Opencart - обновление цен у товаров в Opencart в соответствии с ценами товаров (комплектов) в Моем Складе. Есть возможность указать цену из Моего Склада, которая будет переноситься товарам в Opencart. Также есть возможность переносить и обновлять сразу несколько видов цен из Моего Склада для различных групп клиентов в Opencart (Отдельные цены для групп клиентов).
• Удаление/обновление лишних товаров Opencart -  удаление или обновление товаров в Opencart, которые не были найдены в Моем Складе (поиск осуществляется исходя из выбранного вида связывания товаров). Есть возможность выбрать действие, которое будет осуществляться с лишними товарами: Удалять/Обнулять остатки/Обнулять остатки и ставить статус "Нет в наличии".
  
• Добавление/обновление изображений у товаров в Opencart - перенос и обновление изображений у товаров Opencart в соответствии с изображениями товаров в Моем Складе. Синхронизируются все изображения товаров, а не только первые. Изображения скачиваются и хранятся в директории /image/catalog/demo/syncms. Есть возможность включить удаление изображений товаров в Opencart, если у соответствующих им товаров в Моем Складе изображения отсутствуют. Скачивание большого количества изображений на север может занять много времени. Файлам изображений присваиваются названия, состоящие из id товара в Opencart и порядкового номера изображения. Порядок изображений из Моего Склада также передается в Opencart (с помощью поля Порядок сортировки)
  
• Добавление/обновление атрибутов и опций у товаров в Opencart - перенос или обновление опций и атрибутов товаров в Opencart в соответствии с модификациями и дополнительными полями товаров в Моем Складе. Опциям товаров в Opencart соответствуют только модификации товаров в Моем Складе, при обновлении происходит обновление цен и остатков опций. Атрибутам могут соответствовать как модификации, в описании которых указано слово Атрибут так и дополнительные поля товаров, названия которых указаны в настройках модуля (Названия дополнительных полей с атрибутами). При обновлении происходит обновление значений атрибутов. Есть следующие дополнительные возможности: рассчитывать цену опции как разницу между ценой модификации и ценой товара и заносить в остатки товаров суммы остатков их опций. Добавленные опции не являются связанными, поэтому можно будет выбрать любое сочетание опций. Связывание опций и атрибутов с модификациями осуществляется только по наименованию.
• Обновление заказов в Opencart -  обновление статусов заказов в Opencart в соответствии со статусами заказов в Моем Складе. Если статус заказа из Моего Склада будет отсутствовать в Opencart, то он будет создан.
• Добавление заказов в Мой Склад - перенос заказов из Opencart в Мой Склад. Возможные виды связывания заказов: № заказа в Opencart - № заказа в Моем Складе, № заказа в Opencart - Комментарий заказа в Моем Складе. Если выбрана связь через комментарий заказа, то в комментарий заказа можно дописывать текст через пробел или перенос строки после номера заказа. Есть следующие возможности: 1) Выбрать организацию и склад, которые будут указаны в заказах в Моем Складе. 2) Указать префикс для номера заказа, который будет указан у заказов в Моем Складе. 3) Добавлять и обновлять только заказы, которые были добавлены за последние n дней (количество дней можно указать в настройках модуля). 4) Ставить товары в заказе в резерв. 5) Добавлять услугу доставки в заказ (если услуги с названием доставки не будет в Моем Складе, то она будет создана). 6) Проводить заказы. 7) Использовать оперативный режим (оперативный режим ускоряет добавление заказов в случае если заказы выгружаются регулярно в небольших количествах. Если в заказе Opencart  будут присутствовать товары, которые не будут найдены в Моем Складе (поиск осуществляется исходя из выбранного вида связывания товаров), то этот заказ не будет добавлен в Мой Склад.
• Обновление заказов в Моем Складе -  обновление статусов заказов в Моем Складе в соответствии со статусами заказов в Opencart. Если статус заказа из Opencart будет отсутствовать в Моем Складе, то он будет создан.
• Добавление товаров в Мой Склад - перенос товаров из Opencart в Мой Склад. Есть возможность переносить следующие данные товаров: Наименование, Описание, Категория (Группа), Цена (можно выбрать цену в Моем Складе), Количество (нужно указать внешний код поставщика, в результате переноса будет создана приемка с остатками товаров из Opencart, организация и склад будут взяты настроек модуля), Артикул, Код товара, Внешний код, Вес, Производитель (нужно дополнительное поле в Моем Складе), Изображения, Опции. Возможные виды связывания товаров (Opencart - Мой Склад): Модель (Код товара) - Код, Модель (Код товара) - Внешний код, Модель (Код товара) - Артикул, Артикул - Артикул, Артикул - Код. Также товары можно дополнительно связывать по Наименованию.
• Добавление категорий в Мой Склад  - перенос категорий из Opencart в Мой Склад. Переносятся следующие данные: наименование, родительская категория. Поиск категорий в Моем Складе осуществляется по наименованию категорий.
• Выполнение всех вышеперечисленных действия автоматически через Cron (планировщик заданий)

Информация о модуле

• Название модуля в Opencart: Синхронизация с Мой Склад [by Sa1det]
• Обмен данными происходит через API Моего Склада (JSON API 1.2)
• Модуль имеет открытый код
• После любых изменений настроек модуля необходимо выполнить их сохранение
• На вкладке Лог можно посмотреть подробную информацию о результатах выполнения каждой синхронизации (операции), при этом выводится только часть файла с логами (последний записи). Расположение файла с логами: catalog/controller/extension/module/syncms_log.txt

Ошибки

• При большом количестве сущностей: товаров, модификаций, заказов, категорий и т.д. или при скачивании большого количества изображений из-за долгого выполнения синхронизации может возникать ошибка 504 Gateway Time Out, если на хостинге есть ограничение на время выполнения скриптов. В таком случае необходимо обратиться в техподдержку хостинга с просьбой увеличить значение max_execution_time для php (максимальное время выполнения скрипта) или сделать это самостоятельно в панели управления хостингом (если есть такая возможность)
• При большом количестве сущностей: товаров, модификаций, заказов, категорий и т.д. из-за недостаточного объема выделенной на сервере памяти может возникать ошибка Fatal error: Allowed memory size of [доступнйы объем памяти] bytes exhausted (tried to allocate [память, которое не хватает] bytes). В таком случае необходимо обратиться в техподдержку хостинга с просьбой увеличить значение memory_limit для php (максимальная выделяемая память) или сделать это самостоятельно в панели управления хостингом (если есть такая возможность).
  
• Ошибка! В Моем Складе есть товары/категории дубликаты - данная ошибка возникает, когда в Моем Складе было обнаружено несколько товаров/категорий с одинаковыми значениями в полях, выбранных для связывания (наименование, код товара, внешний код, артикул и т.д.). После двоеточия выводятся товары/категории, которые являются дубликатами. Модуль не будет работать в случае, когда в Моем Складе есть товары или категории дубликаты, так как из-за дублей могут происходить обновления не тех товаров/категорий. Решением является установка уникальных значений полям, которые выбраны для связывания или выбор других полей для связывания
• Ошибка! В Opencart есть товары/категории дубликаты - данная ошибка возникает, когда в Opencart было обнаружено несколько товаров/категорий с одинаковыми значениями в полях, выбранных для связывания (наименование, код товара, внешний код, артикул и т.д.). После двоеточия выводятся товары/категории, которые являются дубликатами. Также данная ошибка может возникнуть в случае когда один товар входит в несколько категорий (для решения можно отключить обновление категорий или оставить у товара только одну категорию). Модуль не будет работать в случае, когда в Opencart есть товары или категории дубликаты, так как из-за дублей могут происходить обновления не тех товаров/категорий. Решением является установка уникальных значений полям, которые выбраны для связывания или выбор других полей для связывания

Установка
Установка данного модуля может осуществляться двумя способами (автоматически и вручную):

1. Через функцию "Установка расширений". Необходимо перейти Модули/Расширения -> Установка расширений, нажать на "Загрузить файл" и выбрать архив с модулем (архив с расширением ocmod.zip)
2. Перенести содержимое архива с модулем (папки admin и catalog) в корневую папку сайта

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

1. Ввод данных от Моего Склада (логин и пароль или токен доступа, который генерируется в настройках Моего Склада) на вкладке Настройки
2. Выбор настроек модуля (выбор вида связи товаров, выбор вида связи категорий, полей товаров для синхронизации, цены продажи, склада для выгрузки остатков, организации и склада в заказах и т.д.)
3. Выполнять синхронизацию можно: 1) вручную, нажимая на кнопки или 2) автоматически, добавив команды для планировщика Cron и задав время их выполнения.

Работа с Cron (автоматическое выполнение синхронизации)
1. Перейти на вкладку Cron в панели управления хостингом
2. Нажать "Добавить команду"
3. Вставить команду для крона из модуля
4. Выбрать интервал выполнения команды (рекомендуется не ставить выполнение большого количества команд в одно и то же время)
5. Сохранить команду
Повторить вышеперечисленные действия для всех нужных команд
Требования
Модуль работает на версиях: Opencart (OcStore) 2.3 - 3.0
Демонстрационный сайт
Перейти на сайт
Логин и пароль от Opencart:
demo
demo
Логин и пароль от Мой Склад:
admin@syncms
syncms_demo
Тип лицензии
На один домен и поддомены
Доработка
Есть возможность доработки модуля на платной основе, по поводу доработки можно обращаться в личные сообщения
Поддержка
По всем возникающим вопросам можно обращаться через личные сообщения или в теме обсуждения

Обновления
v 2.3.6 (от 20.04.2024)

• Добавлена возможность использовать настройки "Синхронизировать товары и категории из групп" и "Не синхронизировать товары и категории из групп" вместе (ранее можно было использовать только одну из настроек)

v 2.3.5 (от 12.04.2024)

• Добавлена возможность выбрать значение поля "Вычитать со склада" для опций
• Добавлена возможность выбрать тип контрагента
• Добавлена возможность выбрать вид связи способов доставки: по названиям или по кодам
• Добавлена возможность выводить информацию о заказе в комментарий к заказу при добавлении заказов в МойСклад. В комментарий к заказу будет выводиться следующая информация: номер заказа, имя, телефон, email, адрес, способ доставки, способ оплаты, комментарий.
• Добавлена возможность включить выгрузку в МойСклад заказов, в которых не был найден товар из заказа. Не найденные в МойСклад товары будут выводиться в комментарий заказа.
• Добавлена возможность синхронизировать только те категории и товары, которые были изменены в МойСклад за последние минуты. Кол-во минут можно указать.

v 2.3.4 (от 21.03.2024)

• Добавлена возможность не синхронизировать категории и товары из указанных категорий
• Добавлена возможность не добавлять в Opencart товары с нулевым остатком

v 2.3.3 (от 23.02.2024)

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

v 2.3.2 (от 06.02.2024)

• Добавлен новый вид связи товаров: SKU OC - Внешний код МС

v 2.3.1 (от 01.02.2024)

• Добавлена возможность указать значения email по умолчанию - те, которые заполняются, если покупатель не указал email при оформлении заказа. Указанные email не будут учитываться при поиске и создании контрагента в Моем Складе

v 2.3 (от 13.04.2022)

• Добавлена возможность выгружать и обновлять EAN товаров
• Добавлена возможность выгружать и обновлять цены товаров по акции
• Теперь при добавлении товаров и обновлении остатков товаров учитываются остатки серий
• Теперь при добавлении заказов в Мой Склад в случае если имя и фамилия покупателя не заполнены, то в качестве имени в Моем Складе будет использоваться значение "Неизвестно"
• Ускорена синхронизация товаров из определенных групп
• Теперь по умолчанию не синхронизируются товары с незаполненным (пустым) полем в Моем Складе, которое выбрано для связи (Код/Внешний код/Артикул). В настройках модуля можно включить синхронизацию таких товаров
• Добавлена возможность выгружать опции товаров как модификации при Добавлении товаров в Мой Склад
• Добавлена возможность указать данные, которые будут выгружены при Добавлении товаров в Мой Склад
• Добавлена возможность выгружать категории из Opencart в Мой Склад
• Добавлена возможность рассчитывать цену опции как разницу между ценой модификации и ценой товара
• Теперь категории и товары дубликаты не прерывают синхронизацию, а игнорируются
• Теперь при наличии нескольких категорий у товара при обновлении товаров в Opencart (в случае если отключена опция "Добавлять товары в родительские категории") и добавлении товаров в Мой Склад будет браться первая категория товара (ранее выводилась ошибка)
• Теперь комментарий заказа при выборе связи № заказа ОС - Комментарий МС можно дополнять не только через пробел, но и через перенос строки
• Добавлена возможность выбирать Канал продаж, который будет указываться при Добавлении заказов в Мой Склад

v 2.2 (от 23.12.2022)

• Добавлена возможность синхронизировать только заказы, созданные за последние дни (созданные недавно)
• Добавлена возможность обновлять статусы заказов Opencart
• Улучшена синхронизация изображений
• Добавлена возможность переносить товары из Opencart в Мой Склад
• Добавлена возможность переносить дополнительные поля товаров как атрибуты
• Названия изображений теперь генерируются модулем на основании внешнего кода товаров
• Добавлена возможность включить оперативный режим добавления заказов, который ускоряет добавлении заказов в случае регулярной выгрузке в небольших количествах
• Добавлена возможность выгружать отдельные цены для групп клиентов
• Добавлена возможность дописывать информацию в комментарии заказов при выборе связи № заказа ОС - Комментарий заказа МС
• Категории теперь сразу добавляются с иерархией
• Добавлена возможность включить/отключить удаление изображений из opencart
• Добавлена возможность синхронизировать товары и категории из нескольких указанных групп
• Добавлена возможность дополнительно заносить товар в его родительские категории
• Добавлена возможность удалять лишние категории (категории, которые не были найдены в Моем Складе) из Opencart
• Добавлена возможность указывать НДС для товаров в заказе при добавлении заказов в Мой Склад
• Были исправлены баги (ошибки) в работе модуля

v 2.1 (от 18.11.2022)

• Добавлена возможность синхронизировать товары и категории только из определенной группы и ее подгрупп
• Добавлена возможность связывать заказы по: № заказа ОС - № заказа МС
• Добавлен новый вид связи товаров - "SKU - Код"
• Добавлена возможность обновлять поле товаров "Вычитать со склада"
  
• Добавлена возможность включать и выключать следующие опции при добавлении заказов: "Ставить товары в резерв", "Добавлять услугу доставки" и "Проводить заказ"
• Добавлена возможность синхронизировать сразу все товары, категории и модификации при нажатии по кнопкам (вручную)
• Добавлена возможность синхронизировать категории по ID из Моего Склада
• Были исправлены баги (ошибки) в работе модуля
• Была выполнена оптимизация кода модуля

v 2.0 (от 08.09.2022)

• Добавлена возможность ставить нулевую цену опциям, если цены опций равны цене товара (или не заполнены)
• Добавлена возможность включить занесение в поле "количество" товаров сумму остатков их опций

v 1.9 (от 14.08.2022)

• Добавлена возможность использовать вид связи SKU (Opencart) - Артикул (Мой Склад) для синхронизации товаров
• Теперь при переносе заказов из Opencart в Мой Склад также будут переноситься статусы заказов
• Добавлена возможность обновлять статусы заказов в Моем Складе
• Была выполнена оптимизация кода

v 1.8 (от 06.08.2022)

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

v 1.7 (от 22.07.2022)

• Добавлена возможность добавлять/обновлять следующие поля товаров: Артикул (SKU), Вес и Производитель (нужно дополнительное поле в Моем Складе)
• Была выполнена оптимизация программного кода
• Были исправлены баги (ошибки) в работе модуля
• Добавлена возможность использовать токен доступа вместо логина и пароля

v 1.6 (от 21.06.2022)

• Добавлена возможность отключать и включать поля товаров, которые будут обновляться. К таким полям относятся: наименование, описание, URL и категория (количество доступных для обновления полей товаров будет увеличиваться в дальнейшем)
• Добавлена возможность выбирать склад из Моего Склада, из которого будут браться остатки товаров (можно выбрать выгрузку остатков из всех складов сразу)
• Были исправлены баги (ошибки) в работе модуля

v 1.5 (от 02.06.2022)

• Обновление цены товаров вынесено на отдельную кнопку
• Добавлена возможность просматривать лог-файл с информацией о работе модуля

v 1.4 (от 22.04.2022)

• Добавлена возможность синхронизации заказов (перенос заказов из Opencart в Мой Склад). При отсутствии контрагента или услуги доставки они будут добавлены в Мой Склад. Услуга доставки добавляется в заказ последней позицией. Товары в заказе ставятся в резерв. В настройках модуля можно выбрать организацию и склад, которые будут в заказах, а также статусы заказов после их создания.

v 1.3 (от 15.04.2022)

• Добавлена возможность синхронизации опций товаров (модификации в Моем Складе)
• Добавлена возможность отключить обновление описания товаров

v 1.2 (от 23.03.2022)

• Добавлена возможность удалять лишние товары (товары, которые есть в Opencart, но отсутствуют в Моем Складе)
• Добавлена возможность более строгого связывания товаров по Наименованию + Коду/Артикулу/Внешнему коду (в случае если коды товаров в Моем Складе не уникальны)
• Добавлена возможность обновлять meta-теги товаров и категорий
• Были исправлены баги (ошибки) в работе модуля
• Выполнена оптимизация программного кода

v 1.1 (от 15.02.2022)

• Добавлена возможность выбирать цену продажи
• Добавлена возможность выбора полей, по которым будет выполнятся связывание товаров ("Код" -> "Модель", "Внешний код" -> "Модель", "Артикул" -> "Модель")
• Добавлена возможность обнулять остатки и обновлять статус ("Нет в наличии") товаров, которые присутствуют в Opencart, но отсутствуют в Моем Складе
• Были исправлены баги (ошибки) в работе модуля

v 1.0 (от 28.01.2022)

• Добавлена возможность добавлять товары и категории
• Добавлена возможность обновлять информацию о товарах и категориях
• Добавлена возможность обновлять изображения и атрибуты товаров
• Добавлена возможность работы с Cron (планировщиком заданий

Написать

Ваше Имя:


Ваш отзыв: Внимание: HTML не поддерживается! Используйте обычный текст.

Оценка: Плохо           Хорошо

Введите код, указанный на картинке:

Файлы будут доступны после покупки