Модуль обмена с сервисом МойСклад

Модуль обмена с сервисом МойСклад

Нашими клиентами являются малые и средние магазины автозапчастей по всей России и СНГ и практически у каждого из них возникает задача автоматизации складского учета в своих магазинах.

Для решения данной задачи можно пойти следующими путями

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

В итоге мы решили пойти альтернативным путем и создать интеграцию с уже существующей и весьма популярной системой складского учета онлайн МойСклад. Какие плюсы данного решения?

1. Мощный, а главное отработанный функционал, которым пользуются десятки тысяч пользователей
2. Гибкие и доступные тарифы, подходящие как для малых, так и для средних компаний
3. Важно — бесплатный тариф для самых маленьких, при этом на нем работает API
4. Важный момент — базовую интеграцию с МойСклад мы предлагаем бесплатно в рамках развития платформы

Возможности базовой интеграции с Мой Склад.

1. Обмен карточками товаров (с фото) МойСклад -> parts-soft.ru
2. Обмен категориями каталога МойСклад -> parts-soft.ru
3. Обмен карточками контрагентов (клиентов и поставщиков) parts-soft.ru -> МойСклад
4. Обмен остатками в разрезе складов компании МойСклад -> parts-soft.ru
5. Обмен заказами клиентов parts-soft.ru -> МойСклад
6. Обмен заказами поставщиков parts-soft.ru -> МойСклад
7. Удаление позиций заказа из МойСклад при отказе в parts-soft.ru parts-soft.ru -> МойСклад

Как настроить интеграцию интернет-магазина автозапчастей с Мой Склад.

Естественно в первую очередь вам нужно зарегистрироваться в сервисе Мой Склад и получить от него логин и пароль с правами администратора. После этого переходим в панель администрирования parts-soft.ru с правами администратора центрального региона и выбираем в меню раздел Служебные — Справочники — Интеграции — Мой Склад.

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

Заполнили? Нажмите Сохранить. Если вы ввели корректные данные, то у вас в списке Организаций появятся организации созданные в МойСклад. Выберите организацию по которой нужно вести учет в настраиваемом регионе, поставьте галочку Активна и решите нужна ли вам интеграция заказов поставщику, хотите ли вы удалять заказы по которым пришел отказ / снятие.

Основные настройки выполнены.

Как настроить синхронизацию прайс-листа с МойСклад?

Перейдите в форму редактирования прайс-листа Прайсы — Все — нажмите редактировать, переходим к нижней части формы редактирования.

Выберите тот склад, который должен синхронизироваться с остатками в данном прайс-листе. Теперь сохраните прайс-лист. После сохранения в форме редактирования можно настроить частоту синхронизаций прайс-листа с сервисом МойСклад

Принудительно синхронизировать прайс-лист можно в карточке прайс-листа

Результаты обновления будут отображены в логе прайс-листа

Как синхронизируется номенклатура

Синхронизация номенклатуры необходима для создания заказов клиентов и поставщиков из системы parts-soft.ru в сторону moysklad.ru.
Мы выгружаем всю номенклатурную базу из МойСклад в справочник товаров parts-soft.ru. Приоритет изменений у базы МойСклад из нее выгружается название, описание, артикул бренд. Изменения на стороне БД parts-soft.ru затираются. Синхронизация выполняется раз в сутки.

Правила ведения базы номенклатуры

В МойСклад нет отдельного поля Производитель товара, поэтому артикул вместе с производителем вписывается в поле Код в формате Бренд + Артикул, например

1. MAHLE OC90
2. DOLZ C110

Поле Код используется в печатных формах, поэтому именно его используем для хранения брендов.
В поле артикул необходимо вписать только артикул детали, например

1. OC90
2. C110

Написание артикула в поле код и в поле артикул должно совпадать, в противном случае бренд будет не определен и номенклатура не синхронизируется.
Если вы заводите номенклатуру в МойСклад необходимо выполнить полную пересинхронизацию номенклатуры, для предупреждения дублей. Если вы хотите получать фотографии из МойСклад в parts-soft.ru установите соответсвующую галочку в настройках

Полная синхронизация номенклатуры происходит один раз в день — после полуночи.

Синхронизация категорий

Для синхронизации номенклатуры в настройках обмена установите параметры:

• Из какого атрибута брать значение Производителя (1) – только для платных тарифов МойСклад с возможностью создавать дополнительные поля для товара.
• Из какой категории синхронизировать категории(2) – если Вы хотите синхронизировать товары из определенной категории в МойСклад, нужно выбрать ее в данном списке.
  Если не выбрать, будут синхронизированы все категории. Выбрать несколько корневых категорий нельзя.
• Категория на сайте(3) – в какую категорию будут добавлены категории, полученные из МойСклад.
• Включить синхронизацию категорий (4) – если поставить данную опцию, то система после полуночи будет выполнять синхронизацию категорий.

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

Выполняется перед каждой отправкой заказов, необходима для обмены контрагентами между учетными системами. Первичная идентификация контрагентов выполняется по полям в порядке приоритета

1. ИНН
2. Email
3. Телефон (учитывайте, что формат телефона должен совпадать)

После первичной связки идентификация проводится по id системы МойСклад. Если у вас вручную заведены карточки контрагентов и не заполнены данные поля — возникнут дубли. Обратите внимание, в системе parts-soft.ru поставщик не может быть клиентом. Учитывайте это при работе с МойСклад не оформляйте заказы на поставщиков. Создание в системе parts-soft.ru контрагентов созданных в МойСклад не выполняется. Выполняется только связка существующих контрагентов для обмена заказами.

Получение баланса из МойСклад

Если вы используете платные тарифы МойСклад с включенной опцией CRM, то есть возможность отображать на сайте результирующий баланс клиентов из учетного сервиса. Баланс отображается одной строчкой, без детализации. Обновление происходит при наличии активности клиента в личном кабинете не чаще одного раза в 30 минут.

Для активации включите галочку Синхронизировать баланс. С момента установки галочки операции по рассчету баланса на стороне системы будут приостановлены, старые записи — останутся.

Импорт Мой склад

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

Шаг 1

Для подключения магазина в программе «Мой склад» — в правом верхнем углу — нажмите на имя Вашего пользователя, в раскрывшемся выпадающем списке нажмите на пункт «Настройки».

В открывшемся разделе перейдите в пункт «Интернет-магазин», размещённый слева в меню.

Шаг 2

Из выпадающего списка выберите «Обмен по CommerceML».

В списке CMS не будет варианта с нашей системой управления, так как у нас реализована возможность обмена данными по протоколу CommerceML, который и следует выбирать.

Шаг 3

Следующим шагом в системе управления магазином необходимо перейти к окну импорта (вкладка Commerce ML).

Шаг 4

Скопируйте значение из настроек импорта.

И вставьте их в соответствующие поля на стороне «Мой склад».

Шаг 5

Установите необходимые настройки выгрузки.

По завершению настройки параметров выгрузки нажмите кнопку «Сохранить».

Шаг 6

После настройки параметров синхронизации необходимо вернуться в раздел «Обмен данными» -> «Синхронизация».

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

Шаг 7

После того как данные будут выгружены из программы «Мой склад», в системе управления интернет магазином Вам необходимо перейти в раздел Импорт и открыть вкладку Commerce ML для настройки параметров импорта.

Выберите «Режим импорта».

Выбирите, какая из цен, установленных для номенклатур в программе «Мой склад», будет являться основной

Если у Вас в магазине используются «Цена 2», «Цена 3» или «Старая цена», аналогичным образом установите параметры для них.

После настройки всех параметров, нажмите кнопку «Запланировать импорт».

Появится надпись «Импорт запланирован успешно» с указанием кода задачи в очереди заданий. Это означает, что в данный момент происходит импорт товаров в Ваш интернет-магазин.

В очереди заданий появится информация о выполняемой задаче импорта.

После того как статус задачи изменится с «Выполняется» на «Готово», новые товары можно будет наблюдать в каталоге товаров системы управления.

Интеграция

Модуль протестирован на совместимость с Opencart и OcStore версий 1.5.6, 2.0, 2.1, 2.2, 2.3 и 3.0 без установки дополнительных модулей и шаблонов. Поддерживает работу с модификатором оформления заказа SimpleCheckout.

При использовании других модификаторов формы оформления заказа могут возникать конфликты совместимости и нестандартное поведение модуля!

Модуль опирается на корректно настроенный магазин, поэтому проверьте достоверность следующих параметров:

• локализация — единицы измерения — значение;
• локализация — вес — значение;
• локализация — валюты — знаков после запятой

Возможности

• Автоматический расчет стоимости доставки по России, Казахстану и Беларуси при работе через склад Shiptor.
• Автоматический расчет стоимости доставки по России при отгрузке из регионов (только для Opencart 2.0-3.0).
• Перерасчет стоимости доставки в зависимости от выбранного способа оплаты с учетом всех комиссий.
• Отображение карты выбора пунктов самовывоза и постаматов.
• Скрытие отдельных способов доставки или установка для них правил по отдельным регионам.
• Увеличение отображаемого времени доставки.
• Поддержка мультимагазина.
• Выгрузка товарной номенклатуры в Shiptor (только для Opencart 2.0-3.0).
• Поддержка опций товаров при расчете доставки и добавлении заказа в Shiptor (только для Opencart 2.0-3.0).
• Поддержка скидочных купонов (только для Opencart 2.0-3.0).
• Использование веса из карточки товара для расчета доставки.
• Использование габаритов из карточки товара для расчета стоимости доставки.
• Демонстрация подсказок при вводе названия населенного пункта и автовыбор региона.
• Передача заказов в ЛК вместе с описью номенклатуры товаров и услуг..
• Передача заказов с наложенным платежом, в т.ч. с оплатой по карте или без него.
• Автоматическая и пакетная передача заказов.
• Использование города по умолчанию из модулей Simple и GeoIP (только для Opencart 2.0-3.0).
• Отображение трек-номера и внутренних статусов заказа от Shiptor.
• Ассоциация внутренних статусов заказа от Shiptor со статусами заказа OpenCart.
• Отображение трек-номера и статуса заказа от курьерской службы.
• Логирование операций обмена данными с Shiptor.
• Установка правил по каждому способу доставки:
  • наценка в %;
  • наценка в ₽;
  • бесплатная доставка;
  • фиксированная цена;
  • фиксированная цена в зависимости от веса;
  • минимальный и максимальный вес корзины для доставки;
  • минимальная и максимальная сумма корзины для доставки.

  Обратите внимание, что для стандартной версии и с модулем Simple нужны разные файлы ocmod! После установки обновления необходимо пересохранить настройки модуля для обновления таблиц в БД.

  Версия 2.X — 3.0

  1. Убедитесь, что сайт соответствует требованиям модуля: страница оформления заказа «Cтандартная» или изменена модулем «Simple — простая регистрация заказа». Корректная работа с любыми другими модулями оформления заказа не гарантируется. архив с модулем под версию своего OpenCart или OcStore (например, 2.0, 2.1, 2.3 . ) и разархивируйте его в папку на своем компьютере.
  2. В админпанели сайта перейдите в Дополнения > Менеджер дополнений и удалите модификаторы Shiptor, если они были ранее загружены. Для этого сделайте активными чек-боксы и нажмите кнопку . После этого страница должна иметь вид:
     
  3. Не выходя из раздела «Менеджер дополнений» админпанели сайта обновите кеш.
     
  4. Загрузите по FTP содержимое трёх папок extension из архива модуля в корень сайта с заменой всех файлов. Не сами папки extension! Чтобы передать точно в корень сайта, выделите содержимое каждой папки, щелкните правой кнопкой мыши и в выпадающем меню выберите «Закачать на сервер».
     
  5. Загрузите по FTP файл shiptor_admin_order.ocmod.xml из папки ocmod в папку system в корне вашего сайта с заменой, если потребуется. При этом shiptor_admin_order.ocmod.xml обязателен, а shiptor_default_opencart.ocmod.xml нужен, если у вас стоит «Cтандартное» оформление заказа. Если используется модуль «Simple — простая регистрация заказа», тогда загружайте shiptor_simple_opencart.ocmod.xml. В папке system должно быть только ДВА файла ocmod от нашего модуля!
     
  6. В админпанели сайта перейдите в Дополнения > Менеджердополнений и ещё раз обновите кеш.
     
  7. Проверьте логи модификатора на отсутствие конфликтов (сообщений типа NOT FOUND). Для этого в разделе сайта Дополнения > Менеджер дополнений перейдите на вкладку «Лог» и нажмите кнопку «Обновить».
     
  8. В панели управления администратор должен выбрать Система > Пользователи > Группы пользователей и выставить разрешения для пользователей.
     
     Каждая группа имеет свои возможности просмотра и редактирования, а также перечень скрываемых дополнений.
  9. Перейдите в раздел Дополнения > Платежи и установите модуль «Shiptor — Оплата наличными при получении» и «Shiptor — Оплата картой при получении». Нажмите кнопку «Редактировать» и в поле «Статус» укажите «Включено». Также необходимо установить актуальное значение для поля «Статус заказа после оплаты». Не забудьте нажать кнопку «Сохранить», чтобы внесенные изменения вступили в силу.
     
  10. Перейдите в раздел Дополнения > Учитывать в заказе и установите модуль «Shiptor — Recalculate». Нажмите кнопку «Редактировать» и для поля «Статус» выберите «Включено». Нажмите «Сохранить».
  11. Перейдите в раздел Дополнения > Доставка и установите модуль «Shiptor — Агрегатор служб доставки». Нажмите «Редактировать» и настройте модуль в соответствии с документацией. Включите необходимые виды доставок.

  Версия 1.5 (поддержка не осуществляется)

  1. Загрузите по FTP содержимое папок extension из архива с заменой всех файлов.
  2. Загрузите по FTP файл siphtor_admin_order_1.5.xml из папки vqmod архива в папку vqmod/xml своего сайта с заменой, если потребуется.
  3. В зависимости от версии страницы checkout загрузите по FTP файл shiptor_default_opencart_1.5.xml или shiptor_simple_opencart_1.5.xml из папки vqmod архива в папку vqmod/xml своего сайта с заменой если потребуется. В папке vqmod должно быть только ДВА файла vqmod от нашего модуля!
  4. Очистите содержимое папки vqcache. В панели управления установите разрешения для группа пользователей.
  5. В разделе дополнений «Оплата» установите модули «Shiptor — Оплата наличными при получении» и «Shiptor — Оплата картой при получении», выставите «Включено», а после этого — необходимый «Статус заказа».
  6. В разделе дополнений «Учитывать в заказе» установите модуль «Shiptor — Учет суммы наложенного платежа» и выставите статус «Включено».
  7. В разделе дополнений «Доставка» установите модуль «Shiptor — Агрегатор служб доставки».
  8. Введите API-ключ и нажмите «Активировать». Настройте модуль согласно документации и включите необходимые виды доставок.

  Мы постарались максимально упростить шаги по настройке. Однако если вы видите что-то, что поможет большинству пользователей модуля быстрее запустить работу с Shiptor, напишите нам на integration@shiptor.ru с пометкой «OpenCart — Быстрый старт».

  Подготовка модуля к работе включает следующие этапы:

  1. Общая настройка модуля

  • Скопируйте первый"API токен для интеграции" из личного кабинета Shiptor.
  • Укажите параметры посылки по умолчанию и статусы заказа для передачи в Shiptor (подробнее).
  • Активируйте и настройте необходимые методы доставки (подробнее).
  • Активируйте методы оплаты Shiptor для работы с наложенным платежом, если подключены к Shiptor как юридическое лицо и предоставляете такую услугу покупателям. Включите перерасчет в зависимости от метода оплаты. (подробнее).

  Более подробно настройки модуля описаны здесь.

  2. Настройка модуль Simple и GeoIP

  Основные этапы настройки читайте в инструкции.

  3. Выгрузка номенклатуры

  О том, как это сделать, читайте в инструкции. Только для клиентов на фулфилменте!

  4. Тестовый заказ

  Проверяя правильность расчета, проверяется корректность настройки системы OpenCart — модуль Shiptor. Получившийся результат нужно сравнивать с калькулятором. Если в оформлении заказа отображаются корректные суммы и заказ после оформления корректно передался в ЛК Shiptor, то дальнейшая настройка модуля не требуется.

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

  Заказ на доставку готовой посылки от склада Shiptor

  Для отправки посылок потребуется привезти их на склад Shiptor самостоятельно или через забор курьером Shiptor. Как их подготовить, сформировать забор и вызвать курьера, описано в базе знаний.

  Заказ на доставку посылки от склада Shiptor со сборкой на фулфилменте

  В этом случае дополнительных манипуляций с заказом не требуется. При наличии товара на складе посылка будет автоматически собрана и отправлена, если не стоит флаг паузы («не собирать посылку»). Как привезти товары и добавить номенклатуру на склад фулфилмента, можно прочитать в базе знаний.

  Рекомендация по добавлению номенклатуры:
  Чтобы избежать ошибок, не добавляйте номенклатуру вручную. Вместо этого воспользуйтесь опцией «Выгрузить данные по товарам в Shiptor».

  Заказ на прямую доставку готовой посылки из региона

  Если отгрузка не подтверждалась при передаче в Shiptor, то необходимо проверить и подтвердить форму отправления в разделе «Отгрузки». После этого самостоятельно отвезите посылки на ПВЗ или передайте их курьеру. Подготовительный этап подробно описано в базе знаний.

  Система учета "МойСклад"

  "МойСклад" — это система учета, которая позволяет вести складской учет, обрабатывать заказы, работать с контрагентами и многое другое.

  Синхронизация магазина с системой учета "МойСклад" возможна в следующих вариантах:

  Также для работы с МойСклад важно ознакомиться с настройками модуля, за что они отвечают в магазине и на стороне МойСклад, а именно речь пойдет о:

  Кроме передачи остатков и каталога товаров, в магазине можно настроить передачу заказов из магазина в "МойСклад". Передача заказов.

  Более того, работать с покупателями можно не только на стороне магазина, но и на стороне МойСклад. Работа с покупателями.

  На стороне платформы для интеграции с системой "МойСклад" реализован специальный модуль. Модуль "МойСклад" обеспечивает взаимодействие магазина с системой МойСклад и в автоматическом режиме обеспечивает выгрузку данных из системы "МойСклад" в магазин и выгрузку заказов из магазина в систему "МойСклад".

  Для синхронизации магазина и "МойСклад" важно настроить корректно синхронизацию.

  В первую очередь необходимо установить модуль "МойСклад" в разделе "Модули — Магазин модулей" (см. рис. 1).

  
  Рисунок 1.

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

  
  Рисунок 2.

  На открывшейся странице перейти на вкладку "Интернет-магазины — Добавить магазин" – из списка выбрать "AdVantShop"(см. рис. 3).

  
  Рисунок 3.

  Далее в поле адрес сайта указать "домен/Modules/MoySklad/1c_exchange.ashx", например, mysite.com/Modules/MoySklad/1c_exchange.ashx или если нет еще доменного имени, указываем технический адрес магазина http://trial8.on-advantshop.net/1-lqua/Modules/MoySklad/1c_exchange.ashx (1)
  В полях "Логин"(2) и "Пароль"(3) указать данные для входа в панель администрирования интернет-магазина, далее нажать "Проверить соединение"(4) — должна высветиться надпись "Соединение прошло успешно"(5). Затем сохраняем введенные данные, нажав на кнопку "Сохранить"(6)(см. рис. 4).

  
  Рисунок 4.

  Если при синхронизации возникает ошибка или соединение не устанавливается, это может возникать когда:

  голоса

  Рейтинг статьи