Инструкции по 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.csv
CatalogID;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