Инструкции по 1С
Описание модуля синхронизации платформы PHPShop с 1С
Если структура каталогов 1С отличается от нужной вам стру ктуры магазина, нужно сначала выгрузить товары в магазин, и после экспорта из 1С, поменять структуру папок, как хотите. Чтобы, при очередной выгрузке из 1С, структура не поменялась, в настройках Документооборота в админпанели снимите галочку ☑️ Родительская категория.
При следующей синхронизации, товары останутся там, где вы их определили в магазине. Если после этого выгружаете еще новые товары, то они попадут в папку Неопределенные - Загруженные из CRM.
В модуле связи с 1С настройка выгрузки товаров указывается в разделе
Основные настройки. На стороне магазина параметры указываются в разделе Настройки → Документооборот (CRM).В поле Вид цен №1 выберите тип выгружаемых цен, который будет отображается на сайте по умолчанию для всех товаров. Другие виды цен связываются с колонками цен, для разных статусов пользователей, например Оптовик поле регистрации будет видеть другие цены.
Если у вас в 1С все артикулы уникальные, в поле
Выгружать как артикул на сайт укажите Артикул. Если артикул не уникальный, рекомендуется выбиратьКод товара в 1С.Настройка замены символов в именах товаров и каталогов необходима для замены ненужных (технических) символов в именах.
Для выгрузки изображений товаров, поставьте галочку
Выгружать изображения.Для выгрузки товаров, поставьте галочку
Создавать новые товары и Создавать новые каталоги. При включенной опции Автоматически выгружать товары на сайт будет использована настр ойка Выполнить экспорт товаров на сайт через каждые N часов.Если галочки Создавать новые товары и каталоги не стоят, то на сайт новые товары не выгрузятся, а только произойдет обновление ранее загруженных товаров. При первичной синхронизации данных эта опция должна быть обязательно включена.
В дополнительных параметрах выбирается версия API. При выборе 6 версии, будет использован режим Мультисклада. В режиме 5 версии будет выгружаться только один склад.
Опция
Выружать только измененные данные позволяет сокращать время и объем передаваемой информации между 1С и интернет-магазином. Не измененные товары не будут попадать в выгрузку.
Опция
Выгружать только пути к картинкам добавляет в выгрузку только пути без выгрузки самих картинок, позволяет существенно сэкономить время выгрузки и используется для тестирования платформы и в прочих ситуациях.При включенной галочке
Вести лог выгруженных файлов на FTP производится запись выгрузки файлов в журнал. При повторной выгрузке, уже выгруженные изображения выгружаться не будут, что сокращает время и трафик передаваемой информации. Кнопка Открыть лог открывает журнал выгрузки, он необходим для техни ческой поддержки при решении вопросов с проблемами в выгрузке. При проблемах с выгрузкой изображений рекомендуется удалить файл Лог выгрузки.
Опция
Архивировать файлы картинок позволяет передать большое количество изображений разом в виде архива и автоматически распаковать его на сервере.При проблемах с выгрузкой изображений по FTP, из-за частого разрыва связи с сервером или проблемами с интернетом, рекомендуется включить настройку
Архивации файлов картинок.Опция
Изменять размеры картинок включает режим автоматического преобразования размера картинок под указанные размеры для картинок. При использовании функции watermark, на изображение накладывается картинка с логотипом.Конвертация изображений возможна с помощью штатной утилиты в обработчике, так и с помощью сторонней более продвинутой ImageMagick. При выборе второго варианта открывается окно с текстом консольной команды обработки изображений. Вы можете задать свои правила конвертации.
@echo off
cd /D "%КаталогИсполнения%"
set file1=%ПутьКФайлу1%
set file2=%ПутьКФайлу2%
set file3=%ПутьКФайлу3%
for /f "tokens=*" %%i in (%file3%) do (
"%ПутьКComposite%" -dissolve %Прозрачность% -gravity "%Расположение%" "%Логотип%" %%i %%i)
"%ПутьКMogrify%" -resize %ШиринаБольшойКартинки%x%ВысотаБольшойкартинки% @%file1%
"%ПутьКMogrify%" -resize %ШиринаМаленькойКартинки%x%ВысотаМаленькойКартинки% @%file2%
exit
При использовании 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.csvCatalogID;Name;Parent;
ЛК000001348;Масло моторное;2594;
2594;Масло;7165;
7165;Химия;0;
В файле присутствует строка ЛК в поле
CatalogID – нужно добавить правило замены префиксов ЛК00000 на 7, чтобы получилось в итоге цифра 71348. После замены и новой выгрузки, файл tree.csv примет правильный формат:CatalogID;Name;Parent;
71348;Масло моторное;2594;
2594;Масло;7165;
7165;Химия;0;
Настройки данных, которые будет принимать сайт от 1С, находятся в админ панели, в меню
Настройки - Документооборот.
Настройка
Статус заказа позволяет выбрать определенный статус заказа, при котором заказ будет поступать в 1С.1С 8.3
1С 8.2
1С 8.0 - 8.1
1С 7.7
Требуется указать серийный ключ лицензии. Если у Вас есть файл лицензии PHPShop «****.lic» — достаточно указать его по кнопке LIC на форме, что избавит от ручного ввода данных имени домена и серийного ключа. Также серийный ключ доступен в админ панели сайта, через меню
Справка - О программе. Указывается пользователь и пароль от админ панели сайта.Имя сайта должно быть в формате
https://имя_сайта/1cManager/Если сайт использует SSL протокол, то имя домена указывается с HTTPS, например https://demo.phpshop.ru/1cManager/, иначе синхронизация не будет работать.
В настройках указываются параметры доступа к FTP сайту и путь к папкам с данными. Для получения верных путей к данным, рекомендуется подключится к FTP через файловый менеджер (FileZilla и т.д.) и скопировать правильный путь через него. Порт для FTP, по умолчанию, обычно 21, если не задан другой порт вашим хостингом.
Формат папок на FTP:
- 1.Папка с данными на ftp: корень сайта/1cManager/
- 2.Папка картинок на ftp: корень сайта/UserFiles/Image/
Галочка
Выполнять выгрузку на ftp включает режим передачи данных на сайт через FTP и активирует настройку полей доступа к FTP. При выключенной галочке, включается режим локального тестирования, для ввода путей локальных папок, для тестирования в эмуляторе OpenServer.
1С 8.3
1С 8.2
В общих настройках задается цепочка документов, при создании нового заказа в 1С, и статус нового заказа.
В дополнительных настройках указывается параметр заказа от частного лица и вариант генерации номера заказа.
Параметр автовыполнения задает интервал опроса сайта для загрузки новых заказов в минутах. Также, можно включить автоматическую загрузку новых заказов в 1С без участия оператора.
В настройках автоподстановки задается правило привязки способа оплаты к юридическому лицу в 1С. Для разных вариантов оплаты можно настроить разные выходные формы.
В настройках выходных форм указывается печать и подписи руководителя и гл. бухгалтера, которые будут использоваться в печатных документах заказа, отправляемых на сайт и доступные в личном кабинете покупателя. Там же выбираются форматы сохранения бланков документов, доступны: HTML, XLS и PDF (по умолчанию).
В настройках доставки сопоставляются имена доставок на сайте с услугами в 1С. Необходимо соблюдать точность в названии доставки на сайте.
1С 8.3
1С 8.2
При загрузке товаров в 1С данные по подтипам товаров с сайта не переносятся.
Загрузка товаров с сайта происходит в 2 этапа – загрузка каталогов и загрузка товаров через CSV файлы.
Для получения CSV файлов с сайта, выполните экспорт данных в админ панели в меню
База - Экспорт данных. Здесь нужно скачать 2 файла экспорта: каталогов и товаров.
Далее, полученные CSV файлы нужно загрузить в меню модуля 1С –
Загрузка товаров. Там же, настраивается таблица соответствий полей в CSV файле с полями в 1С, и типы цен.
1С 8.3
1С 8.2
После настроек выгрузки товаров, можно выполнить саму выгрузку товаров из 1С на сайт через меню
База - Импорт данных. Выгрузка настраивается в модуле 1С , в закладке
Выгрузка на сайт - Выгрузка товаров. Здесь, на основе штатных 1С фильтров отбора, нужно заполнить фильтр отбора номенклатуры.Для выгрузки товаров из определенной группы, используется правило
Номенклатура - В группе - Имя категории. Если требуется выбрать несколько групп, то Номенклатура - В группе из списка - Имена категорий.После заполнения фильтра отбора, нажимаем кнопку
Выгрузить товары.Выгрузка категорий/контрагентов/складов служит для выгрузки в CSV файл и последующей его загрузки в админ панель сайта, через База - Импорт данных. Выгрузка прайс-листа служит для выгрузки интерактивного прайс листа с макросами в формате XLS и загрузки его на сайт в раздел Прайс-лист - Интерактивный прайс-лист.
1С 8.3
1С 8.2
Загрузка заказов выполняется после заполнения настроек в закладке в 1С модуле
Заказы с сайта. Кнопка
Прочитать заказы активирует режим загрузки заказов сайта и предлагает выбрать период времени , за который будет произведен запрос на сайт о новых заказах. Кнопка
Загрузить заказы загружает выбранные на предыдущем шаге заказа в базу 1С.
На основе настройки статуса заказа для загрузки, в 1С будут отображать ся новые заказы, с возможностью принять их и загрузить в 1С.
1С 8.3
1С 8.2
1С 8.1 - 8.0
Загруженный заказ из магазина, можно предварительно откорректировать, добавить или удалить товары из корзины, через вкладку
Корзина заказа.1С 8.3
1С 8.2
Для организации выгрузки на сайт товаров и загрузки заказов в автоматическом режиме необходимо выполнить следующие настойки.
Настроить условия выгрузки для автоматической выгрузки товаров (или импорта заказов), указав отборы на основной форме обработки обмена.
Открыть форму выбора
Вариантов настроек, создав новый или выбрав существующий отметить флагом Для автовыполнения.
В 1С
НСИ и администрирование/Администрирование открыть раздел Печатные формы, отчеты и обработки
Создать новый элемент по кнопке
Добавить из файла и выбрать актуальный файл обработки обмена PHPShop_Exchange_83.epf
Настроить расписание обмена с сайтом для вида операции, а также размещение вызова обработки в разделах 1С.
Настройка выгрузки только измененных в 1С товаров на примере конфигурации "Управление торговлей, редакция 11".
Открыть форму настройки обменов с сайтом из раздела
НСИ и администрирование/Настройка интеграции/Обмен с сайтом
Установить флаг
Использовать обмен с сайтом и открыть список настроек обмен.
По кнопке
Создать создать новую настройку обмена с сайтом, заполнив только необходимые поля – все прочие настройки выполняются из обработки обмена.
В способах обмена данными пароль указывать не нужно. Кнопку проверки соединения нажимать не нужно.
В обработке обмена открыть настройки выгрузки товаров, в разделе
Основные настройки/Общие/Дополнительные параметры выбрать значение плана обменов Обмен с сайтом и созданный в предыдущем шаге узел обмена.
Если требуется открывать обработку обмена при запуске 1С, то следует прописать полный путь до файла обработчика в поле
Дополнительные параметры запуска в настройках запуска 1С.
CommerceML нужен, когда у вас есть программист, и вы хотите сами управлять логикой загрузки/выгрузки данных из 1С. В этом случае, вы можете дописывать типовой обмен с 1С обработчик, как хотите, т. к. исходный код открыт.
Поддерживается обмен данными по стандарту CommerceML, используемый типовым обменом с 1С. Для обмена по CML устанавливать обработчик
PHPShop_Exchange_XX.epf не требуется.Следует использовать только типовой стандартный модуль обмена с сайтом в 1С. Расширенный модуль обмена для Битрикс не поддерживается.
Для настройки CommerceML, в 1С перейдите в раздел
Обмен с сайтом, выберите галочку Использовать обмен с сайтом, затем перейдите в Настройки обмена с сайтом и кликните Создать.
На стороне учетной системы для настройки обмена информацией следует указать:
- 1.Адрес магазина -
https://имя_сайта/1cManager/ - 2.Логин - логин администратора магазина
- 3.Пароль - пароль администратора магазина
- 4.При нажатии кнопки
Проверить соединениепроисходит проверка соединения.
Поддержка типового обмена с сайтом на основе CommerceML есть в следующих конфигурациях, а так же в конфигурациях, созданных на их основе:
- 1.Управление торговлей, редакция 10.3
- 2.Управление торговлей, редакция 11 для РФ
- 3.Комплексная автоматизация, редакция 2.0
- 4.Розница, редакция 2.2
- 5.Розница, редакция 2.3
- 6.Управление нашей фирмой, редакция 1.6
На сайте ядро PHP должно раб отать в режиме модуля Apache. В режиме CGI/Fast CGI авторизация по протоколу Basic HTTP Authentication не поддерживается, используйте авторизацию в режиме Имя файла.
Отключение режима CGI на хостинге Бегет
Обмен с CommerceML доступен для версии PHPShop 6.1.3 и выше.
Во время синхронизации данных номенклатуры ведется журнал документооборота, доступный через меню
Настройка - Документооборот. В нем сохраняется информация по времени выполнении запроса и обновляемом файле.Кнопка
Выполнить в столбце операции позволяет выполнить еще раз действие обновления данных из выбранного файла. Это полезная функциях при поиске возможных проблем при синхронизации данных.
При клике на выполнить откроется страница с ссылкой вида:
https://имя_сайта/1cManager/result.php?date=дата&log=****&pas=****&files=upload_1.csv&create=true&create_category=false
и содержанием:
дата;upload_1.csv;10;500;3;
где:
- 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 файла:"Артикул";"Наименование";"Краткое описание";"Имя картинки";"Подробное описание";"Кол-во картинок";"Остаток";"Цена1";"Цена2";"Цена3";"Цена4";"Цена5";"Вес";"Ед.измерения";"ISO";"Category ID";"Parent";"Характеристика";"Значение"
"NI464AMBXF07";"Ботинки NIKE HOODLAND SUEDE";"Ботинки NIKE HOODLAND SUEDE";"Obuv/Ni464ambxf07";"Трекинговые ботинки Nike. Модель выполнена из спилка со стойким влагоотталкивающим покрытием, материал подкладки и стельки - текстиль. Детали функциональная шнуровка, подошва - филон.";"1";"239";"0";"0";"0";"0";"0";"";"шт";"RUB";"25";"e3edf54d-fdab-11e7-82dd-3010b3ebd474,e3edf54e-fdab-11e7-82dd-3010b3ebd474,e3edf54f-fdab-11e7-82dd-3010b3ebd474";"Производитель";"Nike";"Модель";"ботинки";"Стиль";"спортивный";"Сезон";"веснаосень";"Материал верха";"натуральный нубук";"Материал подкладки";"текстиль";"Материал подошвы";"резина";""
"e3edf54d-fdab-11e7-82dd-3010b3ebd474";"[email protected]бежевый";"";"";"";"";"100";"4540.00";"";"";"";"";"";"шт";"RUB";"25";"[email protected]бежевый";""
"e3edf54e-fdab-11e7-82dd-3010b3ebd474";"[email protected]желтый";"";"";"";"";"60";"4540.00";"";"";"";"";"";"шт";"RUB";"25";"[email protected]желтый";""
"e3edf54f-fdab-11e7-82dd-3010b3ebd474";"[email protected]коричневый";"";"";"";"";"79";"5000.00";"";"";"";"";"";"шт";"RUB";"25";"[email protected]коричневый";""
"УНФ123";"Кондиционер Самсунг";"Кондиционер Самсунг";"Produkciya_tovary/Unf123";"";"1";"5";"30000.00";"30000.00";"0";"0";"0";"";"шт";"RUB";"173";"";"Производитель";"Samsung";""
Первой строкой идут заголовки полей, далее строки с данными по товарами. Найти нужный товар можно по столбцу
Артикул. Так же этот файл можно открыть через Excel для удобства поиска.
Если в транспортных файлах не обнаружен искомый товар, значит фильтр выборки отбора товара для выгрузки настроен так, что искомый товар в него не попадает. Следует проверить отбор по фильтру, особенно учитывать настройку отбора по определенному складу, если она задействована.
Last modified 1yr ago