ECommerce

Подключение и работа с интернет-магазином

Сервис Учеткин.by позволяет обмениваться информацией с интернет-магазинами и другими программами/сервисами через универсальный формат CommerceML (CML).

Для обмена данными с интернет-магазином следует приобрести тариф «Бизнесмен + ECommerce» или тариф «Профи».

Формат CommerceML (CML) поддерживают ряд сервисов и программ учета:

• Магазины на движке WebAsyst (shop-script.ru)
• Магазины на движке ReadyScript (см. https://readyscript.ru/manual/catalog_ut10_1c_settings.html)
• Расширение VirtuMart для Joomla (с плагином CML)
• Магазины на движке OpenCart (см. модуль https://opencartforum.com/files/file/3123-modul-obmena-dlya-opencart-v23-s-uchetnoy-sistemoy-po-standartu-commerceml/) и https://github.com/KirilLoveVE/opencart2-exchange1c
• Сервис МойСклад
• 1С:Управление Торговлей
• 1С:Управление Небольшой Фирмой (Управление Небольшой Компанией)

(список дополняется)

Важно! Ввиду разности структуры данных, каждый сервис / программа имеет свою индивидуальную настройку и свой пользовательский интерфейс.
В большинстве случаев Вам следует единожды разобраться с трудностями пользовательского интерфейса админки интернет-магазина, произвести настройку, и после чего - работать по шаблону, не меняя настроек.

Приготовления к правильному обмену

Очень важно, что бы обе базы (база данных Учеткин и база данных Вашего магазина) были синхронизированы по уникальному ключу.

Важно! Ни в коем случае, НЕ начинайте синхронизацию, пока Вы не будете уверены, что обе базы имеют одинаковые уникальные значения ключевых полей (например – товары едины по штрихкодам)!
В противном случае Вам придется многое исправлять руками!

• Базу товаров лучше всего синхронизировать по уникальному значению артикула или штрихкода.

  Это означает, что карточки товаров на стороне Учеткин.by и интернет-магазина должны содержать ОДИНАКОВЫЕ значения штрихкодов или артикулов.
  Самый крайний случай – обмен может производится по наименованию товара/клиента. Однако это не желательно, т.к. малейшая орфографическая ошибка может привести к созданию дубликата товарной позиции.

• Базу клиентов лучше всего синхронизировать по значению телефона или наименования

Сценарий правильного начала работы

Нижеописанный сценарий следует применять только в самом начале работы - в момент настройки обмена между системами.
После того, как Вы лично убедитесь в том, что Учеткин.by и магазин правильно обмениваются товарами и клиентами (имеющиеся в базе Учеткин.by товары используются при формировании товаров, а не существующие - создаются), можно приступать у рутинному обмену данными между магазином и Учеткин.by, без особых приготовлений.

Важно! Ввиду того, что интернет-магазин и Учеткин.by - сложные системы с различной структурой данных, у пользователя НЕТ отмены неверного действия. Поэтому, потратьте достаточно времени, загружая XML-файл в режиме «Проверочный̆ запуск» (описано ниже) и изучая лог, для того чтобы пресечь все ошибки "человеческого фактора", до того, как они испортят Вашу базу лишними, задублированными позициями. Самое главное: чтобы первая синхронизация «на живую» была проведена уже с правильными и проверенными данными.
Корректность результата обмена данных определить может только владелец информации, т.е. - Вы.

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

1. Привести базу товаров к единым уникальным значениям (как на стороне Учеткин, так и на стороне интернет-магазина)
2. Привести базу клиентов к единым уникальным значениям
3. Выгрузить пробный файл с заказами из магазина (см. пункт "Ручной обмен" ниже)
4. Откройте Личный кабинет в Учеткин.by и перейдите в раздел «Дерево данных – Сервис – Обмен данными – Обмен ECommerce»
5. Укажите файл, который Вы получили из интернет-магазина
   
6. В пункте «Режим импорта данных из файла» выбираете нужный режим:
   • Все данные – загрузятся каталог товаров, документы и контрагенты в документах
   • Только каталог товаров – загрузится только ВЕСЬ каталог товаров из интернет-магазина
   • Только документы – загрузятся заказы, товары ТОЛЬКО из документов (минуя весь каталог) и контрагенты из этих документов
7. Указываете свою организацию, на которую будут созданы документы-заказы
8. Указываете правило поиска контрагентов по Вашей базе Учеткин (по какому уникальному полю будут искаться клиенты). Если клиент не найден – он будет создан на стороне Учеткин.by
9. Указываете правило поиска товаров по Вашей базе Учеткин (по какому уникальному полю будут искаться товары).
10. Указываете базовые параметры по-умолчанию для создания новых товаров.
    

    Примечание: Если установить галочку «Заменять цены», то импорт должен заменить цены товаров в базе, взяв цены из файла интернет-магазина (тут следует быть внимательным, изменяются цена без НДС и цена с НДС, без пересчета)

    

11. Важно! УСТАНОВИТЬ ГАЛОЧКУ «ПРОВЕРОЧНЫЙ ЗАПУСК»
12. Нажать на «Выполнить импорт»
13. После завершения импорта переходите во вкладку «Результат исполнения». Там необходимо изучить древовидный лог исполнения операции:
    • Префиксом «++» обозначаются созданные позиции – ВИЗУАЛЬНО ПРОВЕРЯЙТЕ, чтобы система лишнего не создала!
      

      Важно! Если в процессе тестового импорта в Учеткин.by создается товар, который уже существовал в справочнике "Товары и услуги", то это означает, что продублированный товар не приведен к единому уникальному ключу в базе Учеткин.by. После проверки и исправления карточки найденного товара, необходимо повторить импорт с проверочным запуском, пока обе базы не будут корректно синхронизированы!

    • Префиксом «-» обозначаются найденные позиции
    • Префиксом «+» - обновленные
14. После успешного приведения баз к единому знаменателю, снимаете галочку «Проверочный̆ запуск» и импортируете данные уже «на живую».

Движок магазина WebAsyst / shop-script

Обмен с интернет-магазинами на данном движке происходит по направлению: Магазин -> Учеткин.
Т.е. система Учеткин получает информацию о произведенных заказах на стороне интернет-магазина. Обмен данными может производится автоматически, либо из указанного файла.

Автоматизированный обмен

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

1. Войти в панель администратора магазина WebAsyst
2. Вверху выбрать пункт «Магазин»
   
3. В появившейся панели нажать на кнопку «Импорт/Экспорт»
4. Слева, на панели, выбрать пункт «1С(CommerceML)». Если данного пункта нет, то следует установить плагин «1С(CommerceML)».
   
   Таким образом Вы войдете в настройки плагина.
   На панели настроек плагина 1С (CommerceML) следует выполнить следующие:
   1. На вкладке «Автоматический обмен» включить тумблер «Автоматический обмен»
   2. Скопировать в буфер обмена ссылку «Скрипт синхронизации», позже ее необходимо добавить в Учеткине в пункте Дерево данных – Сервис – Обмен данными – Обмен ECommerce
      
   3. Настроить пункт «Обмен данными». В основном, никаких изменений производить не требуется.
      

      На рисунке ниже показаны лишь Важные моменты:
      
      

   4. Обязательно укажите единую кодировку файла как в магазине, так и на стороне Учеткин.by. Это очень важно, т.к. если указать неверные значения, товары из магазина загрузятся в виде «крокозяблов»
      
   5. Перейти в настройки обмена EComerce в Личном кабинете Учеткин.by: Дерево данных – Сервис – Обмен данными – Обмен ECommerce
   6. В появившейся вкладке, в списке "Режим обмена" указать значение "Интернет-магазин с поддержкой CommerceML"
   7. В пункте "Движок интернет-магазина" указать "Webasyst (shop-script)"
   8. В появившейся панели указать URL-скрипта магазина (см. п.2 - "Скрипт синхронизации")
   9. Указать параметры авторизации и нажать на кнопку "Авторизовать".
      Если все указано верно, система попытается соединится с интернет-магазином и получить файл обмена (без запуска процессы синхронизации).
      

В результате настроек, пользователь создаст "мост" между своим интернет-магазином и сервисом Учеткин.by. После этого, можно загружать заказы клиентов магазина нажатием кнопки "ECM" в журнале "Счета на оплату и Заказы".

Ручной обмен (через файл)

1. Войти в панель администратора магазина WebAsyst
2. Вверху выбрать пункт «Магазин»
   
3. В появившейся панели нажать на кнопку «Импорт/Экспорт»
4. Слева, на панели, выбрать пункт «1С(CommerceML)». Если данного пункта нет, то следует установить плагин «1С(CommerceML)»
5. Перейдите на вкладку «Ручной обмен»
6. В пункте «Экспортировать в файл» укажите объекты экспорта (что выгрузить)
   
7. Нажмите кнопку «Экспортировать»

В результате операции, Вы получите XML-файл, который можно загрузить в Личном кабинете Учеткин.by: Дерево данных – Сервис – Обмен данными – Обмен ECommerce, в режиме обмена "XML-файл в формате CommerceML 2.x"