ECommerce: различия между версиями

Материал из Учеткин.by Wiki
Перейти к навигации Перейти к поиску
 
(не показано 55 промежуточных версий этого же участника)
Строка 5: Строка 5:
 
Сервис Учеткин.by позволяет обмениваться информацией с интернет-магазинами и другими программами/сервисами через универсальный формат CommerceML (CML).  
 
Сервис Учеткин.by позволяет обмениваться информацией с интернет-магазинами и другими программами/сервисами через универсальный формат CommerceML (CML).  
 
<br>
 
<br>
−
Для обмена данными с интернет-магазином следует приобрести тариф «Бизнесмен + Ecommerce» или тариф «Профи».
+
<div style="margin-left:8px; margin-right:8px; padding-left:4px; border: #D1CCBF 1px dotted; padding: 4px; background-color:#f7f5e8;">
−
<br>
+
Для обмена данными с интернет-магазином следует приобрести тариф «Бизнесмен + ECommerce» или тариф «Профи».
 +
</div>
 
<br>
 
<br>
−
Формат CommerceML (CML) поддерживают ряд сервисов:
+
Формат CommerceML (CML) поддерживают ряд сервисов и программ учета:
 
<ul>
 
<ul>
 
<li>Магазины на движке WebAsyst (shop-script.ru)</li>
 
<li>Магазины на движке WebAsyst (shop-script.ru)</li>
 +
<li>Магазины на движке ReadyScript (см. https://readyscript.ru/manual/catalog_ut10_1c_settings.html)</li>
 
<li>Расширение VirtuMart для Joomla (с плагином CML)</li>
 
<li>Расширение VirtuMart для Joomla (с плагином CML)</li>
 +
<li>Магазины на движке OpenCart (см. модуль https://opencartforum.com/files/file/3123-modul-obmena-dlya-opencart-v23-s-uchetnoy-sistemoy-po-standartu-commerceml/) и https://github.com/KirilLoveVE/opencart2-exchange1c</li>
 
<li>Сервис МойСклад</li>
 
<li>Сервис МойСклад</li>
 
<li>1С:Управление Торговлей</li>
 
<li>1С:Управление Торговлей</li>
−
<li>1С:Управление Небольшой Фирмой (Управление Небольшой Компанией) </li>
+
<li>1С:Управление Небольшой Фирмой (Управление Небольшой Компанией)</li>
 
</ul>
 
</ul>
 
<i>(список дополняется)</i>
 
<i>(список дополняется)</i>
Строка 28: Строка 31:
 
==Приготовления к правильному обмену==
 
==Приготовления к правильному обмену==
 
<div style="font-size:1.2em">
 
<div style="font-size:1.2em">
−
Очень важно, что бы обе базы (база данных Учеткин и база данных Вашего магазина) были синхронизированы по уникальному ключу.  
+
Очень важно, что бы обе базы (база данных Учеткин и база данных Вашего магазина) были синхронизированы по <b>уникальному ключу</b>.  
 +
 
 +
<div style="margin-left:8px; margin-right:8px; padding-left:4px; border: #D1CCBF 1px dotted; padding: 4px; background-color:#f7f5e8;">
 +
<b style="color:red;">Важно!</b>  Ни в коем случае, <b>НЕ начинайте синхронизацию</b>, пока Вы не будете уверены, что обе базы имеют одинаковые уникальные значения ключевых полей (например – товары едины по штрихкодам)!
 +
<br>
 +
В противном случае Вам придется многое исправлять руками!
 +
 
 +
<ul>
 +
<li>Базу <b>товаров</b> лучше всего синхронизировать по уникальному значению <b>артикула или штрихкода</b>.
 +
<p style="font-size:0.9em;">
 +
Это означает, что карточки товаров на стороне Учеткин.by и интернет-магазина должны содержать ОДИНАКОВЫЕ значения штрихкодов или артикулов.
 +
<br>
 +
Самый крайний случай – обмен может производится по наименованию товара/клиента. Однако это не желательно, т.к. малейшая орфографическая ошибка может привести к созданию дубликата товарной позиции.
 +
</p>
 +
</li>
 +
<li>Базу <b>клиентов</b> лучше всего синхронизировать по значению <b>телефона или наименования</b></li>
 +
</ul>
 +
 
 +
</div>
 +
 
 +
</div>
  
 +
==Сценарий правильного начала работы==
 +
<div style="font-size:1.2em">
 +
Нижеописанный сценарий следует применять только в самом <b>начале работы</b> - в момент настройки обмена между системами.
 +
<br>
 +
После того, как Вы лично убедитесь в том, что Учеткин.by и магазин правильно обмениваются товарами и клиентами (имеющиеся в базе Учеткин.by товары используются при формировании товаров, а не существующие - создаются), можно приступать у рутинному обмену данными между магазином и Учеткин.by, без особых приготовлений.
 +
<br>
 
<div style="margin-left:8px; margin-right:8px; padding-left:4px; border: #D1CCBF 1px dotted; padding: 4px; background-color:#f7f5e8;">
 
<div style="margin-left:8px; margin-right:8px; padding-left:4px; border: #D1CCBF 1px dotted; padding: 4px; background-color:#f7f5e8;">
−
<b style="color:red;">Важно!</b> Ни в коем случае, НЕ начинайте синхронизацию, пока Вы не будете уверены, что обе базы имеют одинаковые уникальные значения ключевых полей (например – товары едины по штрихкодам)! В противном случае Вам придется многое исправлять руками!
+
<b style="color:red;">Важно!</b> Ввиду того, что интернет-магазин и Учеткин.by - сложные системы с различной структурой данных, у пользователя <b>НЕТ отмены</b> неверного действия. Поэтому, потратьте достаточно времени, загружая XML-файл в режиме «<i>Проверочный̆ запуск</i>» (описано ниже) и изучая лог, для того чтобы пресечь все ошибки "человеческого фактора", до того, как они испортят Вашу базу лишними, задублированными позициями. Самое главное: чтобы первая синхронизация «на живую» была проведена уже с правильными и проверенными данными.
 +
<br>
 +
<b>Корректность</b> результата обмена данных определить может только владелец информации, т.е. - Вы.
 
</div>
 
</div>
 +
<br>
 +
Порядок действий пользователя в процессе настройки обмена:
 +
<ol>
 +
<li>Привести базу товаров к единым уникальным значениям  (как на стороне Учеткин, так и на стороне интернет-магазина)</li>
 +
<li>Привести базу клиентов к единым уникальным значениям</li>
 +
<li>Выгрузить пробный файл с заказами из магазина (см. пункт "Ручной обмен" ниже)</li>
 +
<li>Откройте Личный кабинет в Учеткин.by и перейдите в раздел «<i>Дерево данных – Сервис – Обмен данными – Обмен ECommerce</i>»</li>
 +
<li>Укажите файл, который Вы получили из интернет-магазина
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/handy_cml.png
 +
</li>
 +
<li>В пункте «<i>Режим импорта данных из файла</i>» выбираете нужный режим:
 +
<ul>
 +
<li><b>Все данные</b> – загрузятся каталог товаров, документы и контрагенты в документах</li>
 +
<li><b>Только каталог товаров</b> – загрузится только ВЕСЬ каталог товаров из интернет-магазина</li>
 +
<li><b>Только документы</b> – загрузятся заказы, товары ТОЛЬКО из документов (минуя весь каталог) и контрагенты из этих документов</li>
 +
</ul>
 +
</li>
 +
<li>Указываете свою организацию, на которую будут созданы документы-заказы</li>
 +
<li>Указываете <b>правило поиска контрагентов</b> по Вашей базе Учеткин (по какому уникальному полю будут искаться клиенты). Если клиент не найден – он будет создан на стороне Учеткин.by</li>
 +
<li>Указываете <b>правило поиска товаров</b> по Вашей базе Учеткин (по какому уникальному полю будут искаться товары).</li>
 +
<li>Указываете базовые параметры по-умолчанию для создания новых товаров.
 +
<br>
 +
<div style="margin-left:8px; margin-right:8px; padding-left:4px; border: #D1CCBF 1px dotted; padding: 4px; background-color:#f7f5e8;">
 +
<b>Примечание:</b> Если установить галочку «Заменять цены», то импорт должен заменить цены товаров в базе, взяв цены из файла интернет-магазина (тут следует быть внимательным, изменяются цена без НДС и цена с НДС, без пересчета)
 +
</div>
 +
https://www.uchetkin.by/images/wiki/ECommerce/import_setup.png
 +
</li>
  
 +
<li><b style="color:red;">Важно!</b> УСТАНОВИТЬ ГАЛОЧКУ «ПРОВЕРОЧНЫЙ ЗАПУСК»</li>
 +
<li>Нажать на «Выполнить импорт»</li>
 +
<li>После завершения импорта переходите во вкладку «Результат исполнения».
 +
Там необходимо изучить древовидный лог исполнения операции:
 
<ul>
 
<ul>
−
<li>Базу товаров лучше всего синхронизировать по уникальному значению артикула или штрихкода</li>
+
<li>Префиксом «++» обозначаются созданные позиции – ВИЗУАЛЬНО ПРОВЕРЯЙТЕ, чтобы система лишнего не создала!
−
<li>Базу данных клиентов лучше всего синхронизировать по значению телефона или наименования</li>
+
<br>
 +
<div style="margin-left:8px; margin-right:8px; padding-left:4px; border: #D1CCBF 1px dotted; padding: 4px; background-color:#f7f5e8;">
 +
<b style="color:red;">Важно!</b> Если в процессе тестового импорта в Учеткин.by создается товар, который уже существовал в справочнике "Товары и услуги", то это означает, что продублированный товар не приведен к единому <b>уникальному ключу</b> в базе Учеткин.by.
 +
После проверки и исправления карточки найденного товара, необходимо повторить импорт с проверочным запуском, пока обе базы не будут корректно синхронизированы!
 +
</div>
 +
</li>
 +
<li>Префиксом «-» обозначаются найденные позиции</li>
 +
<li>Префиксом «+» - обновленные</li>
 
</ul>
 
</ul>
 +
</li>
 +
<li> После успешного приведения баз к единому знаменателю, снимаете галочку «Проверочный̆ запуск» и импортируете данные уже «на живую».</li>
 +
</ol>
 +
 +
</div>
  
−
Это означает, что карточки товаров на стороне Учеткин.by должны содержать значения штрихкодов или артикулов. На стороне базы данных магазина должно быть тоже самое! Самый крайний случай – обмен может производится по наименованию товара/клиента. Однако это не желательно, т.к. малейшая орфографическая ошибка может привести к созданию дубликата товарной позиции.
+
==Движок магазина WebAsyst / shop-script==
 +
 
 +
<div style="font-size:1.2em">
 +
Обмен с интернет-магазинами на данном движке происходит по направлению: Магазин -> Учеткин.
 +
<br>
 +
Т.е. система Учеткин получает информацию о произведенных заказах на стороне интернет-магазина. Обмен данными может производится автоматически, либо из указанного файла.
 +
<br>
 +
===Автоматизированный обмен===
 +
Для настройки автоматизированного обмена следует выполнить следующие действия:
 +
<ol>
 +
<li>Войти в панель администратора магазина WebAsyst</li>
 +
<li>Вверху выбрать пункт «Магазин»
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/webasyst_import.png
 +
</li>
 +
<li>В появившейся панели нажать на кнопку «Импорт/Экспорт»</li>
 +
<li>Слева, на панели, выбрать пункт «1С(CommerceML)». Если данного пункта нет, то следует установить плагин «1С(CommerceML)».
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/webasyst_cml_panel.png
 +
<br>
 +
Таким образом Вы войдете в настройки плагина.
 +
<br>
 +
На панели настроек плагина 1С (CommerceML) следует выполнить следующие:
 +
<ol>
 +
<li>На вкладке «Автоматический обмен» включить тумблер «Автоматический обмен»</li>
 +
<li>Скопировать в буфер обмена ссылку «Скрипт синхронизации», позже ее необходимо добавить в Учеткине в пункте <i>Дерево данных – Сервис – Обмен данными – Обмен ECommerce</i>
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/webasyst_exch.png
 +
</li>
 +
<li>Настроить пункт «Обмен данными». В основном, никаких изменений производить не требуется.
 +
<br>
 +
<p>
 +
На рисунке ниже показаны лишь Важные моменты:
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/webasyst_setup_1.png
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/webasyst_setup_2.png
 +
</p>
 +
</li>
 +
<li><b>Обязательно</b> укажите единую кодировку файла как в магазине, так и на стороне Учеткин.by. Это очень важно, т.к. если указать неверные значения, товары из магазина загрузятся в виде «крокозяблов»
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/webasyst_export.png
 +
</li>
 +
<li>Перейти в настройки обмена EComerce в Личном кабинете Учеткин.by: <i>Дерево данных – Сервис – Обмен данными – Обмен ECommerce</i></li>
 +
<li>В появившейся вкладке, в списке "<b>Режим обмена</b>" указать значение "<i>Интернет-магазин с поддержкой CommerceML</i>" </li>
 +
<li>В пункте "<b>Движок интернет-магазина</b>" указать "<i>Webasyst (shop-script)</i>"</li>
 +
<li>В появившейся панели указать <b>URL-скрипта магазина</b> (см. п.2 - "Скрипт синхронизации")</li>
 +
<li>Указать параметры авторизации и нажать на кнопку "Авторизовать".
 +
<br>
 +
Если все указано верно, система попытается соединится с интернет-магазином и получить файл обмена (без запуска процессы синхронизации).
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/auto_import.png
 +
</li>
 +
</ol>
 +
</li>
 +
</ol>
 +
<br>
 +
<br>
 +
В результате настроек, пользователь создаст "мост" между своим интернет-магазином и сервисом Учеткин.by. После этого, можно загружать заказы клиентов магазина нажатием кнопки "ECM" в журнале "Счета на оплату и Заказы".
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/invoice_import.png
 +
<br>
  
 +
===Ручной обмен (через файл)===
 +
<ol>
 +
<li>Войти в панель администратора магазина WebAsyst</li>
 +
<li>Вверху выбрать пункт «Магазин»
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/webasyst_import.png
 +
</li>
 +
<li>В появившейся панели нажать на кнопку «Импорт/Экспорт»</li>
 +
<li>Слева, на панели, выбрать пункт «1С(CommerceML)». Если данного пункта нет, то следует установить плагин «1С(CommerceML)» </li>
 +
<li>Перейдите на вкладку «Ручной обмен»</li>
 +
<li>В пункте «Экспортировать в файл» укажите объекты экспорта (что выгрузить)
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/webasyst_handy.png
 +
</li>
 +
<li>Нажмите кнопку «Экспортировать»</li>
 +
</ol>
 +
В результате операции, Вы получите XML-файл, который можно загрузить в Личном кабинете Учеткин.by: <i>Дерево данных – Сервис – Обмен данными – Обмен ECommerce</i>, в <b>режиме обмена</b> "<i>XML-файл в формате CommerceML 2.x</i>"
 +
<br>
 +
https://www.uchetkin.by/images/wiki/ECommerce/handy_cml.png
 
</div>
 
</div>

Текущая версия от 09:19, 14 декабря 2019

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

    import_setup.png

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

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

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

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

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

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

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

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

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

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



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

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

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

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

Источник — http://wiki.uchetkin.by/index.php?title=ECommerce&oldid=3369