Инструкции по внешнему обработчику 1С
Описание модуля синхронизации внешним обработчиком PHPShop_Exchange_XX.epf
Last updated
Описание модуля синхронизации внешним обработчиком PHPShop_Exchange_XX.epf
Last updated
Если структура каталогов 1С отличается от нужной вам структуры магазина, нужно сначала выгрузить товары в магазин, и после экспорта из 1С, поменять структуру папок, как хотите. Чтобы, при очередной выгрузке из 1С, структура не поменялась, в настройках Обмен данными в админпанели снимите галочку ☑️ Родительская категория. При следующей синхронизации, товары останутся там, где вы их определили в магазине. Если после этого выгружаете еще новые товары, то они попадут в папку Неопределенные - Загруженные из CRM.
В модуле связи с 1С настройка выгрузки товаров указывается в разделе Основные настройки. На стороне магазина параметры указываются в разделе Настройки →Обмен данными.
В поле Вид цен №1 выберите тип выгружаемых цен, который будет отображается на сайте по умолчанию для всех товаров. Другие виды цен связываются с колонками цен, для разных статусов пользователей, например Оптовик поле регистрации будет видеть другие цены.
Если у вас в 1С все артикулы уникальные, в поле Выгружать как артикул на сайт укажите Артикул. Если артикул не уникальный, рекомендуется выбиратьКод товара в 1С.
Настройка замены символов в именах товаров и каталогов необходима для замены ненужных (технических) символов в именах.
Для выгрузки изображений товаров, поставьте галочку Выгружать изображения.
Для выгрузки товаров, поставьте галочку Создавать новые товары и Создавать новые каталоги. При включенной опции Автоматически выгружать товары на сайт будет использована настройка Выполнить экспорт товаров на сайт через каждые N часов.
Если галочки Создавать новые товары и каталоги не стоят, то на сайт новые товары не выгрузятся, а только произойдет обновление ранее загруженных товаров. При первичной синхронизации данных эта опция должна быть обязательно включена.
В дополнительных параметрах выбирается версия API. При выборе 6 версии, будет использован режим Мультисклада. В режиме 5 версии будет выгружаться только один склад.
Опция Выружать только измененные данные позволяет сокращать время и объем передаваемой информации между 1С и интернет-магазином. Не измененные товары не будут попадать в выгрузку.
Опция Выгружать только пути к картинкам добавляет в выгрузку только пути без выгрузки самих картинок, позволяет существенно сэкономить время выгрузки и используется для тестирования платформы и в прочих ситуациях.
При включенной галочке Вести лог выгруженных файлов на FTP производится запись выгрузки файлов в журнал. При повторной выгрузке, уже выгруженные изображения выгружаться не будут, что сокращает время и трафик передаваемой информации. Кнопка Открыть лог открывает журнал выгрузки, он необходим для технической поддержки при решении вопросов с проблемами в выгрузке.
При проблемах с выгрузкой изображений рекомендуется удалить файл Лог выгрузки.
Опция Архивировать файлы картинок позволяет передать большое количество изображений разом в виде архива и автоматически распаковать его на сервере.
При проблемах с выгрузкой изображений по FTP, из-за частого разрыва связи с сервером или проблемами с интернетом, рекомендуется включить настройку Архивации файлов картинок.
Опция Изменять размеры картинок включает режим автоматического преобразования размера картинок под указанные размеры для картинок. При использовании функции watermark, на изображение накладывается картинка с логотипом.
Конвертация изображений возможна с помощью штатной утилиты в обработчике, так и с помощью сторонней более продвинутой ImageMagick. При выборе второго варианта открывается окно с текстом консольной команды обработки изображений. Вы можете задать свои правила конвертации.
При использовании 1С в режиме 64 бита функции наложения watermark с помощью штатных средств 1С не работают (отсутствие такой функции в 1С). Необходимо переключение в режим работы с ImageMagick при необходимости наложения защитных картинок.
Наименование родительской группы номенклатуры в 1С при выгрузке выступает как название каталог картинки на сайте. Поэтому, при изменении наименования групп в 1С Вам необходимо выполнять повторную выгрузку товаров с картинками на сайт (при этом в настройках обязательно отключать флаг логирования картинок) - у товаров прописывается путь к картинкам на ftp с учетом каталога, новые каталоги с картинками будут созданы.
В дополнительных настройках задаются параметры выгрузки свойств и характеристик.
В таблице доступных свойств выбираются свойства для выгрузки в виде фильтров (характеристик) или опций (подтипов). Для опции, можно сразу отметить, в какой параметр на сайте она попадет, будет это цвет или размер (параметр 1 или параметр 2). Название и тип параметров можно задать для каждого каталога на сайте в разделе Товары - Варианты подтипов.
Для выгрузки подтипов по характеристикам, должна быть включена галочка Создавать подтипы товаров (по характеристикам). Также можно задать правило наименования товара-подтипа на основе имени товара и имени подтипа.
Для настройки выгрузки произвольных реквизитов в виде характеристик, используется кнопка Настроить список.
В таблице выражений для выгрузки данных на сайт, можно задать свое правило поиска дополнительных данных в 1С, например, штрихкода или персонального свойства товара.
Формула генерации имен дополнительных опций (подтипов товаров) задается по кнопке Правило наименования.
В настройках выгрузки товаров вкладке Дополнительно необходимо поставить флаг Создавать добавочные опции (по характеристикам) и по кнопке Правила наименования подчиненных товаров настроить порядок именования подтипов.
Здесь настраиваются соответствия полей наименования и описания товара с реквизитами в 1С.
Здесь настраиваются соответствия валют сайта и 1С.
ISO валют должно совпадать. Настройка валют на сайте задается в меню Настройка - Валюты. При выгрузке товара из 1С, передается код ISO валюты и товар заносится в базу сайта в нужной валюте. Валюты товара могут быть разные, на сайте они все приводятся к общей валюте вывода на основе курса валют.
При выгрузке категорий товаров, должно выполняться правило передачи CatalogID и Родителя в виде целого числа 1 - 100000000. Однако, если в базе 1С используются префиксы, то, вместо числа, передается строка ЦУ-10000 (задается самой 1С). Поэтому, для корректного перевода строки в целое число используется механизм замены префиксов, при котором строка ЦУ-10000 будет заменена на 110000.
Подлежат замены префиксы только у категорий, на товары это правило не распространяется.
Если, при синхронизации каждый раз дублируются категории, то это верный признак присутствия префиксов в Ид категорий. Требуется настройка замены префиксов.
Для быстрого поиска и замены префиксов, нужно проанализировать на FTP файл выгрузки категорий /1cManager/sklad/дата_выгрузки/tree.csv
В файле присутствует строка ЛК в поле CatalogID – нужно добавить правило замены префиксов ЛК00000 на 7, чтобы получилось в итоге цифра 71348. После замены и новой выгрузки, файл tree.csv примет правильный формат:
Настройки данных, которые будет принимать сайт от 1С, находятся в админ панели, в меню Настройки - Обмен данными.
Настройка Статус заказа позволяет выбрать определенный статус заказа, при котором заказ будет поступать в 1С.
✅ Когда в 1С поступает заказ, то в магазине меняется статус на Отправлен в учетную систему. Далее, когда заказ сформирован, 1с формирует счет и загружает в магазин, статус заказа меняется на Доступны бухгалтеские документы.
Требуется указать серийный ключ лицензии. Если у Вас есть файл лицензии PHPShop «****.lic» — достаточно указать его по кнопке LIC на форме, что избавит от ручного ввода данных имени домена и серийного ключа. Также серийный ключ доступен в админ панели сайта, через меню Справка - О программе. Указывается пользователь и пароль от админ панели сайта.
Имя сайта должно быть в формате https://имя_сайта/1cManager/
Если сайт использует SSL протокол, то имя домена указывается с HTTPS, например https://demo.phpshop.ru/1cManager/, иначе синхронизация не будет работать.
В настройках указываются параметры доступа к FTP сайту и путь к папкам с данными. Для получения верных путей к данным, рекомендуется подключится к FTP через файловый менеджер (FileZilla и т.д.) и скопировать правильный путь через него. Порт для FTP, по умолчанию, обычно 21, если не задан другой порт вашим хостингом.
Формат папок на FTP:
Папка с данными на ftp: корень сайта/1cManager/
Папка картинок на ftp: корень сайта/UserFiles/Image/
Галочка Выполнять выгрузку на ftp включает режим передачи данных на сайт через FTP и активирует настройку полей доступа к FTP. При выключенной галочке, включается режим локального тестирования, для ввода путей локальных папок, для тестирования в эмуляторе OpenServer.
В общих настройках задается цепочка документов, при создании нового заказа в 1С, и статус нового заказа.
В дополнительных настройках указывается параметр заказа от частного лица и вариант генерации номера заказа.
Параметр автовыполнения задает интервал опроса сайта для загрузки новых заказов в минутах. Также, можно включить автоматическую загрузку новых заказов в 1С без участия оператора.
В настройках автоподстановки задается правило привязки способа оплаты к юридическому лицу в 1С. Для разных вариантов оплаты можно настроить разные выходные формы.
В настройках выходных форм указывается печать и подписи руководителя и гл. бухгалтера, которые будут использоваться в печатных документах заказа, отправляемых на сайт и доступные в личном кабинете покупателя. Там же выбираются форматы сохранения бланков документов, доступны: HTML, XLS и PDF (по умолчанию).
В настройках доставки сопоставляются имена доставок на сайте с услугами в 1С. Необходимо соблюдать точность в названии доставки на сайте.
При загрузке товаров в 1С данные по подтипам товаров с сайта не переносятся.
Загрузка товаров с сайта происходит в 2 этапа – загрузка каталогов и загрузка товаров через CSV файлы.
Для получения CSV файлов с сайта, выполните экспорт данных в админ панели в меню База - Экспорт данных. Здесь нужно скачать 2 файла экспорта: каталогов и товаров.
Далее, полученные CSV файлы нужно загрузить в меню модуля 1С – Загрузка товаров. Там же, настраивается таблица соответствий полей в CSV файле с полями в 1С, и типы цен.
После настроек выгрузки товаров, можно выполнить саму выгрузку товаров из 1С на сайт через меню База - Импорт данных.
Выгрузка настраивается в модуле 1С , в закладке Выгрузка на сайт - Выгрузка товаров. Здесь, на основе штатных 1С фильтров отбора, нужно заполнить фильтр отбора номенклатуры.
Для выгрузки товаров из определенной группы, используется правило Номенклатура - В группе - Имя категории. Если требуется выбрать несколько групп, то Номенклатура - В группе из списка - Имена категорий.
После заполнения фильтра отбора, нажимаем кнопку Выгрузить товары.
Выгрузка категорий/контрагентов/складов служит для выгрузки в CSV файл и последующей его загрузки в админ панель сайта, через База - Импорт данных.
Выгрузка прайс-листа служит для выгрузки интерактивного прайс листа с макросами в формате XLS и загрузки его на сайт в раздел Прайс-лист - Интерактивный прайс-лист.
Загрузка заказов выполняется после заполнения настроек в закладке в 1С модуле Заказы с сайта.
Кнопка Прочитать заказы активирует режим загрузки заказов сайта и предлагает выбрать период времени , за который будет произведен запрос на сайт о новых заказах.
Кнопка Загрузить заказы загружает выбранные на предыдущем шаге заказа в базу 1С.
На основе настройки статуса заказа для загрузки, в 1С будут отображаться новые заказы, с возможностью принять их и загрузить в 1С.
Загруженный заказ из магазина, можно предварительно откорректировать, добавить или удалить товары из корзины, через вкладку Корзина заказа.
Для организации выгрузки на сайт товаров и загрузки заказов в автоматическом режиме необходимо выполнить следующие настойки.
Настроить условия выгрузки для автоматической выгрузки товаров (или импорта заказов), указав отборы на основной форме обработки обмена.
Открыть форму выбора Вариантов настроек, создав новый или выбрав существующий отметить флагом Для автовыполнения.
В 1С НСИ и администрирование/Администрирование открыть раздел Печатные формы, отчеты и обработки
Создать новый элемент по кнопке Добавить из файла и выбрать актуальный файл обработки обмена PHPShop_Exchange_83.epf
Настроить расписание обмена с сайтом для вида операции, а также размещение вызова обработки в разделах 1С.
Настройка выгрузки только измененных в 1С товаров на примере конфигурации "Управление торговлей, редакция 11".
Открыть форму настройки обменов с сайтом из раздела НСИ и администрирование/Настройка интеграции/Обмен с сайтом
Установить флаг Использовать обмен с сайтом и открыть список настроек обмен.
По кнопке Создать создать новую настройку обмена с сайтом, заполнив только необходимые поля – все прочие настройки выполняются из обработки обмена.
В способах обмена данными пароль указывать не нужно. Кнопку проверки соединения нажимать не нужно.
В обработке обмена открыть настройки выгрузки товаров, в разделе Основные настройки/Общие/Дополнительные параметры выбрать значение плана обменов Обмен с сайтом и созданный в предыдущем шаге узел обмена.
Если требуется открывать обработку обмена при запуске 1С, то следует прописать полный путь до файла обработчика в поле Дополнительные параметры запуска в настройках запуска 1С.
Во время синхронизации данных номенклатуры ведется журнал Обмена данными, доступный через меню Настройка - Обмен данными. В нем сохраняется информация по времени выполнении запроса и обновляемом файле.
Кнопка Выполнить в столбце операции позволяет выполнить еще раз действие обновления данных из выбранного файла. Это полезная функциях при поиске возможных проблем при синхронизации данных.
При клике на выполнить откроется страница с ссылкой вида:
и содержанием:
где:
10 - количество созданных новых товаров
500 - количество обновленных товаров
3 - количество созданных новых категорий
При добавлении в ссылку запроса https://имя_сайта/1cManager/result.php?***** параметра debug=true, будет выведен SQL запрос к базе данных с возможностью более детального изучения обновляемых данных (для разработчиков или техподдержки).
Журнал Обмена данными так же ведется при синхронизации по протоколу CommerceML.
Если нужно проверить правильность передачи информации от 1С к сайту, то можно проанализировать транспортные файлы на FTP и проверить данные.
1С в автоматическом режиме синхронизации передает все файлы по FTP на сайт в папку 1cManager/sklad/дата-выгрузки/upload_{0-100}.csv. Файлов upload_x.csv может быть несколько, зависит от настроек количества строк в передаваемом файле.
Пример транспортного файла upload_0.csv файла:
Первой строкой идут заголовки полей, далее строки с данными по товарами. Найти нужный товар можно по столбцу Артикул. Так же этот файл можно открыть через Excel для удобства поиска.
Если в транспортных файлах не обнаружен искомый товар, значит фильтр выборки отбора товара для выгрузки настроен так, что искомый товар в него не попадает. Следует проверить отбор по фильтру, особенно учитывать настройку отбора по определенному складу, если она задействована.
При желании, можно перейти с внешнего обработчика на встроенный типовой обмен CommerceML. Для этого:
Включите типовой обмен по инструкции.
Выключите в настройках создание новых каталогов и товаров.
В качестве артикула на сайте выберите Артикул.
Включите выгрузку данных по номенклатуре в типовом обмене в 1С и выгрузите данные по всем товарам.
После выгрузки на сайте ничего не поменяется, но будут созданы файлы csv с данными связки артикула и внешнего кода товара в 1С по адресу 1cManager/sklad/дата-выгрузки/upload_{0-100}.csv. Файлов upload_x.csv может быть несколько.
Загрузите CSV файлы штатным способом через меню База - Импорт данных. Выберите действие - Обновление, остальные настройки без изменений.
В результате товарам проставится поле "Внешний код" по совпадению "Артикула".
Проверить поле внешнего кода можно в закладке Дополнительно - Интеграция.
В настройках Обмена данными можно включить опции создания новых товаров, если это требуется и использовать далее только встроенный типовой обмен для выгрузки номенклатуры из 1С на сайт и загрузки заказов с сайта в 1С.
Если ранее во внешнем обработчике 1С использовался Код 1С товара в качестве ключа обновления, а не Артикул, то при переходе на типовой обмен может возникнуть проблема из-за отсутствия поля Код 1С в типовой выгрузке (зависит от конфигурации 1С).
В таком случаи в качестве ключа обмена используется Наименование товара.
