Синхронизация Opencart и Мой Склад v2.3.5 SyncMS new API VIP
После 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 есть товары или категории дубликаты, так как из-за дублей могут происходить обновления не тех товаров/категорий. Решением является установка уникальных значений полям, которые выбраны для связывания или выбор других полей для связывания
Установка
Установка данного модуля может осуществляться двумя способами (автоматически и вручную):
- Через функцию «Установка расширений». Необходимо перейти Модули/Расширения -> Установка расширений, нажать на «Загрузить файл» и выбрать архив с модулем (архив с расширением ocmod.zip)
- Перенести содержимое архива с модулем (папки admin и catalog) в корневую папку сайта
Обновление версии модуля
Обновление версии модуля осуществляется также как и установка: необходимо загрузить архив с новой версией модуля через Установщик расширений или перенести содержимое архива с новой версией модуля в корневую папку сайта. После обновления версии необходимо сохранить настройки модуля.
Первые шаги при работе с модулем
- Ввод данных от Моего Склада (логин и пароль или токен доступа, который генерируется в настройках Моего Склада) на вкладке Настройки
- Выбор настроек модуля (выбор вида связи товаров, выбор вида связи категорий, полей товаров для синхронизации, цены продажи, склада для выгрузки остатков, организации и склада в заказах и т.д.)
- Выполнять синхронизацию можно: 1) вручную, нажимая на кнопки или 2) автоматически, добавив команды для планировщика Cron и задав время их выполнения.
Работа с Cron (автоматическое выполнение синхронизации)
1. Перейти на вкладку Cron в панели управления хостингом
2. Нажать «Добавить команду»
3. Вставить команду для крона из модуля
4. Выбрать интервал выполнения команды (рекомендуется не ставить выполнение большого количества команд в одно и то же время)
5. Сохранить команду
Повторить вышеперечисленные действия для всех нужных команд
Установка
Установка данного модуля происходит через функцию «Установка расширений» в Opencart. Все что требуется — нажать на «Загрузить файл» и выбрать архив с модулем (архив с расширением ocmod.zip)
Обновление
Для обновления версии модуля достаточно загрузить архив с новой версией через установщик дополнений, все настройки будут сохранены. После обновления версии обязательно сохраните настройки модуля, чтобы все правильно обновилось.
Работа с модулем
- Ввод данных от Моего Склада (логин и пароль или токен доступа, который генерируется в настройках Моего Склада)
- Выбор настроек модуля (выбор вида связи товаров, полей для синхронизации товаров, цены продажи и т.д.)
- Выполнять синхронизацию можно: 1) в ручную (нажимая на кнопки для добавления/обновления) или 2) автоматически (добавив команды для планировщика Cron и задав период выполнения)
Работа с Cron (автоматическое выполнение синхронизации)
1. Перейти на вкладку крон на хостинге
2. Нажать «добавить команду»
3. Вставить команду для крона из модуля
4. Выбрать интервал выполнения команды
5. Сохранить команду
Повторить ниже перечисленные действия для всех нужных команд
Демонстрационный сайт
Перейти на сайт
Логин и пароль — demo.
Обновления 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 не будут учитываться при поиске и создании контрагента в Моем Складе
После 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.ru2) Добавить после строки curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); строку curl_setopt($ch, CURLOPT_ENCODING, "gzip ''");После внесения изменений в файлы любым из способов выше сбросятся некоторые настройки модуля: "Склад" и "Организация" в разделе "Синхронизация заказов" и склады, выбранные в настройке "Выгружать остатки из".После внесения изменений в файлы любым из способов выше нужно сохранить настройки модуля!Также для обновления файлов можно обратиться к автору модуля (для этого потребуются доступы к админ-панели сайта и/или ftp)Возможности модуля (краткое описание)
-
Скачивание доступно подписчикам. Некоторые ресурсы доступны с подпиской VIP, Если вы оплатили LITE вы не увидите вип ресурсы
Download is available to subscribers. Some resources are available with a VIP subscription. If you paid for LITE, you will not see the VIP resources.
Leave a reply
You must login or register to add a new comment .