Синхронизация с интернет-магазином Prestashop

Материал из Mr.Doc
Перейти к: навигация, поиск

Важно!

Перед синхронизацией данных с Prestashop настоятельно рекомендуется:

  • внимательно прочитать данное руководство;
  • сделать архивную копию данных сайта;
  • (желательно) проверить синхронизацию на отдельной копии вашего сайта.

Компания "КлаудТим" не несет ответственности за любые проблемы, прямо или косвенно связанные с синхронизацией. Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации, однако Prestashop имеет много подверсий и модулей с различным количеством проблем и ошибок. Поэтому протестировать все их сочетания не представляется возможным.

Возможности

Между MrDoc и сайтом синхронизируются товары, категории, покупатели и их заказы. Также поддерживается выгрузка на сайт цен и складских остатков товаров.

Существует возможность ограничить список синхронизируемых объектов (например, синхронизировать только справочник товаров).

Поддерживаемые версии PrestaShop: 1.5, 1.6.

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

Соответствие объектов
Объект на сайте Объект в MrDoc
Товар Элемент справочника "Номенклатура"
Комбинация товара Элемент справочника "Модификации номенклатуры"
Категория товаров Группа справочника "Номенклатура"
Производитель Элемент справочника "Производители"
Поставщик Элемент справочника "Контрагенты"
Покупатель Элемент справочника "Контрагенты"

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

Порядок первоначальной синхронизации товаров при настройке обмена с сайтом:

  • Сначала с сайта загружаются все товары, их комбинации, а также все категории. При загрузке товаров и категорий система сразу пытается связать их с уже существующими товарами и категориями по наименованию, тем самым исключая дублирование товаров/категорий, вручную занесенных в MrDoc. При загрузке комбинаций система не пытается связывать их с уже существующими в MrDoc модификациями, за исключением комбинации по умолчанию - она всегда связывается с базовой модификацией товара.
  • Затем на сайт выгружаются все товары и категории, отсутствующие на сайте (за исключением помеченных на удаление). При этом модификации для таких товаров на сайт не выгружаются.

Порядок последующей синхронизации товаров:

  • Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "Настройка обмена").
  • Система регистрирует изменения справочника "Номенклатура", тем самым формируя список товаров/категорий, которые необходимо выгрузить на сайт при очередной синхронизации.
  • Также регистрация изменений товаров/комбинаций/категорий происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "Настройка обмена").
  • При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда товар был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.
Соответствие реквизитов товара
Реквизит на сайте Реквизит в MrDoc Особенности
Наименование Наименование Максимальная длина 100 символов.
Тип Вид номенклатуры Виртуальные товары загружаются в виде услуг, остальные типы - в виде товаров.
Артикул Артикул базовой модификации Максимальная длина 100 символов.
Штрихкод Штрихкод EAN13 для базовой модификации товара
Производитель Производитель
Категория по умолчанию Родительская группа Если у товара на сайте есть связи с несколькими категориями, то при смене категории в MrDoc все эти связи на сайте сохраняются. Если у товара на сайте есть связь только с одной категорией (основной), то при изменении категории в MrDoc товар потеряет связь с прошлой категорией.
Налоговые правила Ставка НДС Соответствие ставок НДС налоговым правилам осуществляется при первоначальной настройке обмена (см. раздел "Настройка обмена").
Комбинация по умолчанию Базовая модификация Выгрузка новых модификаций на сайт не поддерживается. Новый товар всегда выгружается без модификаций.
Артикулы поставщиков Артикулы поставщиков

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

Новые товары всегда выгружаются на сайт со статусом "Запрещен" и видимостью "Нигде". При дальнейшей синхронизации статус товара не изменяется, то есть статус в Prestashop не зависит от статуса товара в MrDoc.

Для новых товаров, загруженных с сайта, автоматически устанавливается комментарий "Товар загружен с сайта Prestashop".

Соответствие реквизитов группы (категории)
Реквизит на сайте Реквизит в MrDoc Особенности
Наименование Наименование Максимальная длина 100 символов.
Родительская категория Родительская группа
Отображено Статус Отображение на сайте включается только для групп со статусом "Активен".

Для новых групп (категорий), загруженных с сайта, автоматически устанавливается комментарий "Категория загружена с сайта Prestashop".

Соответствие реквизитов модификации (комбинации)
Реквизит на сайте Реквизит в MrDoc Особенности
Наименование Значения свойств комбинации Наименование модификации формируется из значений её свойств при загрузке с сайта.
Артикул Артикул

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

Для новых модификаций (комбинаций), загруженных с сайта, автоматически устанавливается комментарий "Модификация товара загружена с сайта Prestashop".

Синхронизация производителей

Порядок первоначальной синхронизации производителей при настройке обмена с сайтом:

  • Сначала с сайта загружаются все производители. При загрузке производителей система сразу пытается связать их с уже существующими производителями по наименованию, тем самым исключая дублирование производителей, вручную занесенных в MrDoc.
  • Затем на сайт выгружаются все производители, отсутствующие на сайте (за исключением помеченных на удаление).

Порядок последующей синхронизации производителей:

  • Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "Настройка обмена").
  • Система регистрирует изменения справочника "Производители", тем самым формируя список производителей, которые необходимо выгрузить на сайт при очередной синхронизации.
  • Также регистрация изменений производителей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "Настройка обмена").
  • При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда производитель был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.
Соответствие реквизитов производителя
Реквизит на сайте Реквизит в MrDoc Особенности
Наименование Наименование Максимальная длина 100 символов.
Включено Статус На сайте включаются только производители со статусом "Активен".

Для новых производителей, загруженных с сайта, автоматически устанавливается комментарий "Производитель загружен с сайта Prestashop".

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

Порядок первоначальной синхронизации поставщиков при настройке обмена с сайтом:

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

Порядок последующей синхронизации поставщиков:

  • Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "Настройка обмена").
  • Регистрация изменений поставщиков происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "Настройка обмена").
  • Новые поставщики на сайт выгружаются только при выгрузке артикулов поставщиков для товаров.
Соответствие реквизитов поставщика
Реквизит на сайте Реквизит в MrDoc Особенности
Наименование Наименование Максимальная длина 100 символов.
Телефон Телефон Длина телефона должна быть ровно 11 символов.
Страна, город, почтовый индекс, адрес Фактический адрес
Включено Статус На сайте включаются только производители со статусом "Активен".

Для новых поставщиков, загруженных с сайта, автоматически устанавливается комментарий "Поставщик загружен с сайта Prestashop".

Синхронизация покупателей

Порядок первоначальной синхронизации покупателей при настройке обмена с сайтом:

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

Порядок последующей синхронизации покупателей:

  • Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "Настройка обмена").
  • Регистрация изменений покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "Настройка обмена").
  • Новые покупатели на сайт выгружаются только при выгрузке заказов покупателей. Для выгрузки нового покупателя на сайт у него должны быть заполнены следующие реквизиты: имя, фамилия, email.
  • Обратите внимание, что при стандартных настройках PrestaShop новому покупателю будет отправлено письмо с регистрационными данными.
Соответствие реквизитов покупателя
Реквизит на сайте Реквизит в MrDoc Особенности
Имя Имя Максимальная длина 100 символов. Обязательно к заполнению.
Фамилия Фамилия Максимальная длина 100 символов. Обязательно к заполнению.
Email Email Максимальная длина 100 символов. Обязательно к заполнению.
Телефон Телефон Длина телефона должна быть ровно 11 символов.
Адрес доставки Фактический адрес
Статус Статус На сайте разрешен вход только для покупателей со статусом "Активен".

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

  • наименование (фамилия + имя);
  • тип "Физическое лицо";
  • комментарий "Покупатель загружен с сайта Prestashop".

Синхронизация заказов покупателей

Порядок первоначальной синхронизации заказов покупателей при настройке обмена с сайтом:

  • С сайта загружаются все заказы покупателей с датой больше даты начала обмена. При загрузке новых заказов система не пытается связать их с уже существующими в MrDoc заказами.
  • Заказы покупателей, отсутствующие на сайте и с датой больше даты начала обмена, автоматически выгружаются на сайт. Вместе с заказами будут выгружаться и отсутствующие на сайте покупатели.

Порядок последующей синхронизации заказов покупателей:

  • Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "Настройка обмена").
  • Регистрация изменений заказов покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "Настройка обмена").
  • Новые заказы покупателей будут выгружаться на сайт только в том случае, если их дата больше даты начала обмена.
Соответствие реквизитов заказа
Реквизит на сайте Реквизит в MrDoc Особенности
Номер заказа Внешний номер Внешний номер заказа отображается на вкладке "Дополнительно" в форме заказа.
Дата Дата
Клиент Покупатель
Статус Дополнительный статус Дополнительный статус в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "Настройка обмена").
Валюта Валюта
Итого Сумма
Доставка Услуга в табличной части "Услуги" Услуга в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "Настройка обмена").
Товары Товары в табличной части "Товары"

Для новых заказов, загруженных с сайта, автоматически устанавливаются реквизиты:

  • организация, указанная в настройке обмена;
  • тип цен, указанный в настройке обмена;
  • комментарий вида "Заказ загружен из интернет-магазина PrestaShop (заказ PXIHJXKOZ)".

При загрузке заказа покупателя с сайта система пытается зарезервировать товары, указанные в заказе. Для этого автоматически оформляется или перезаполняется документ "Резервирование товаров". Если зарезервировать товар не удалось, то это не считается ошибкой, так как на сайте может быть выключен контроль складских остатков.

При выгрузке заказа покупателя на сайт в качестве услуги доставки используется первая услуга, для которой указано соответствие в настройке обмена (см. раздел "Настройка обмена"). При этом стоимость данной услуги будет являться стоимостью доставки, а адрес оказания данной услуги - адресом доставки.

Обновление цен на сайте

Цена товара на сайте обновляется в следующих случаях:

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

Цены на сайт выгружаются в валюте, указанной в настройке обмена.

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

Обновление складских остатков на сайте

Складские остатки выгружаются на сайт в следующих случаях:

  • При первоначальной настройке обмена (выгружаются складские остатки по всем синхронизированным товарам);
  • При изменении остатка товара.

Вместе со складскими остатками выгружаются данные о наличии товаров у поставщиков. Эти данные используются для вычисления доступности товара для заказа.

Изменение складского остатка товара влияет на реквизиты товара "Доступен для заказа" и "Показать цену". Эти флажки устанавливаются, если товар есть на складе или есть в наличии у одного из поставщиков. В противном случае эти флажки снимаются.

Обновление курсов валют на сайте

Курсы валют выгружаются на сайт в следующих случаях:

  • При первоначальной настройке обмена (выгружаются курсы валют по всем синхронизированным валютам);
  • При изменении курса валюты.

Настройка обмена

Сначала необходимо включить опцию "Интеграция с Prestashop" в разделе "Настройки" личного кабинета на сайте MrDoc.org.

Включение модуля в личном кабинете

Затем необходимо установить модуль для обмена на сайте. Для этого необходимо открыть журнал настроек обмена "Сервис - Настройки обмена с Prestashop" и скачать модуль, соответствующий версии Prestashop, с помощью кнопок на верхней панели.

Модуль для установки на сайте

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

Установка модуля на сайте (шаг 1)

Установка модуля на сайте (шаг 2)

Установка модуля на сайте (шаг 3)

Установка модуля на сайте (шаг 4)

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

Настройка модуля на сайте (шаг 1)

Параметры настройки:

  • Наименование - наименование настройки, носит чисто информационный характер;
  • Ключ авторизации - ключ, который необходимо указать в MrDoc для подключения к сайту (генерируется автоматически, его не нужно менять);
  • Пункт выдачи - пункт выдачи, адрес которого будет в качестве адреса доставки для заказов без доставки, выгружаемых из MrDoc;
  • Способ доставки - способ доставки, который будет подставляться в заказы без доставки, выгружаемые из MrDoc;
  • Вид оплаты - вид оплаты, который будет подставляться в заказы, выгружаемые из MrDoc;

Настройка модуля на сайте (шаг 2)

После установки и настройки модуля на сайте необходимо настроить обмен в MrDoc. Для этого в создаем новую настройку обмена в журнале "Сервис - Настройки обмена с Prestashop".

Параметры настройки:

  • Наименование - наименование настройки, носит чисто информационный характер;
  • Статус - можно временно выключить обмен данными с сайтом, установив статус "Помечен на удаление";
  • Дата начала обмена - заказы покупателей старше этой даты не будут синхронизироваться с сайтом;
  • Организация для заказов с сайта - организация, которая будет подставляться в заказы, выгружаемые с сайта;
  • Валюта сайта - валюта, которая будет подставляться в заказы, выгружаемые с сайта, а также используемая при выгрузке цен товаров;
  • Тип продажных цен - тип цен, который будет подставляться в заказы, выгружаемые с сайта, а также используемый при выгрузке продажных цен товаров;
  • Тип закупочных цен - тип цен, который будет использоваться при выгрузке закупочных цен товаров. Если не указан, то закупочные цены на сайте не будут изменяться. Если вы работаете с несколькими поставщиками, то для расчета итоговой закупочной цены необходимо создать новый тип цен, который будет рассчитываться на основании закупочных цен всех поставщиков.
  • Адрес сайта - адрес сайта интернет-магазина;
  • Ключ авторизации - ключ авторизации, указанный в модуле обмена на стороне сайта;
  • Периодичность обмена - насколько часто будет запускаться задача синхронизации с сайтом;
  • Блок Родительские группы для новых объектов, загруженных с сайта - родительские группы соответствующих справочников для создания в них новых объектов, загруженных с сайта;
  • Блок Настройки синхронизации - здесь можно указать, какие объекты нужно синхронизировать с сайтом;

Создание настройки обмена в MrDoc (шаг 1)

После указания необходимых параметров необходимо нажать кнопку "Далее" для перехода к настройке соответствий ставок НДС, способов доставки и статусов заказов. На каждой вкладке присутствует кнопка "Обновить ставки (способы доставки, статусы) c сайта", позволяющая заново запросить у сайта список вариантов.

Создание настройки обмена в MrDoc (шаг 2)

Создание настройки обмена в MrDoc (шаг 3)

Создание настройки обмена в MrDoc (шаг 4)

Контроль состояния обмена

Контроль состояния обмена осуществляется следующими способами:

  • Состояние задачи синхронизации и ее результаты отражаются в отчете "Запланированные задачи";
  • Подробные описания ошибок обмена выводятся в отчете "Ошибки обмена".

Кроме того, существует отчет "Оплаты по заказам на сайте", в котором отражаются все оплаты заказов, оформленные на сайте. Сами оплаты в системе никак не отражаются.

Отчет "Запланированные задачи"

Отчет доступен через главное меню "Отчеты - Запланированные задачи".

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

Задача обмена в отчете "Запланированные задачи"

Результаты успешного выполнения задачи обмена

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

Ошибка выполнения обмена, связанная с необходимостью обновления модуля на сайте

Отчет "Ошибки обмена"

Отчет открывается с помощью кнопки "Ошибки обмена" в форме настройки обмена.

Кнопка для открытия отчета "Ошибки обмена"

Отчет состоит из двух вкладок: ошибки загрузки (с сайта в MrDoc) и ошибки выгрузки (из MrDoc на сайт).

Колонки отчета на вкладке "Ошибки загрузки":

  • Дата - дата фиксирования ошибки;
  • Тип объекта во внешней системе - (category - категория, product - товар, combination - модификация, customer - покупатель, order - заказ покупателя, manufacturer - производитель, supplier - поставщик);
  • ID объекта во внешней системе - ID объекта на сайте;
  • Текст ошибки - описание ошибки.

Колонки отчета на вкладке "Ошибки выгрузки":

  • Дата - дата фиксирования ошибки;
  • Тип объекта - Тип объекта в MrDoc;
  • ID объекта - ID объекта в MrDoc;
  • Текст ошибки - описание ошибки.

Отчет "Ошибки обмена"

Отчет "Оплаты по заказам на сайте"

Отчет открывается с помощью кнопки "Оплаты по заказам на сайте" в форме настройки обмена.

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

Кнопка для открытия отчета "Оплаты по заказам на сайте"

Отчет "Оплаты по заказам на сайте"