Инструкции по внешнему обработчику 1С (для старых версий 1С)

Настройка выгрузки товаров

В модуле связи с 1С настройка выгрузки товаров указывается в разделе Основные настройки. На стороне магазина параметры указываются в разделе Настройки →Обмен данными.

Основные настройки модуля

Виды цен

В поле Вид цен №1 выберите тип выгружаемых цен, который будет отображается на сайте по умолчанию для всех товаров. Другие виды цен связываются с колонками цен, для разных статусов пользователей, например Оптовик поле регистрации будет видеть другие цены.

Основные параметры

Если у вас в 1С все артикулы уникальные, в поле Выгружать как артикул на сайт укажите Артикул. Если артикул не уникальный, рекомендуется выбиратьКод товара в 1С.

Настройка замены символов в именах товаров и каталогов необходима для замены ненужных (технических) символов в именах.

Для выгрузки изображений товаров, поставьте галочку Выгружать изображения.

Параметры автоматической загрузки товаров на сайт

Для выгрузки товаров, поставьте галочку Создавать новые товары и Создавать новые каталоги. При включенной опции Автоматически выгружать товары на сайт будет использована настройка Выполнить экспорт товаров на сайт через каждые N часов.

Дополнительные параметры

В дополнительных параметрах выбирается версия API. При выборе 6 версии, будет использован режим Мультисклада. В режиме 5 версии будет выгружаться только один склад.

Опция Выружать только измененные данные позволяет сокращать время и объем передаваемой информации между 1С и интернет-магазином. Не измененные товары не будут попадать в выгрузку.

Опции изображений

Опция Выгружать только пути к картинкам добавляет в выгрузку только пути без выгрузки самих картинок, позволяет существенно сэкономить время выгрузки и используется для тестирования платформы и в прочих ситуациях.

При включенной галочке Вести лог выгруженных файлов на 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

Дополнительные

Настройки характеристик и опций в УТ 11.3

В дополнительных настройках задаются параметры выгрузки свойств и характеристик.

В таблице доступных свойств выбираются свойства для выгрузки в виде фильтров (характеристик) или опций (подтипов). Для опции, можно сразу отметить, в какой параметр на сайте она попадет, будет это цвет или размер (параметр 1 или параметр 2). Название и тип параметров можно задать для каждого каталога на сайте в разделе Товары - Варианты подтипов.

Для выгрузки подтипов по характеристикам, должна быть включена галочка Создавать подтипы товаров (по характеристикам). Также можно задать правило наименования товара-подтипа на основе имени товара и имени подтипа.

Для настройки выгрузки произвольных реквизитов в виде характеристик, используется кнопка Настроить список.

В таблице выражений для выгрузки данных на сайт, можно задать свое правило поиска дополнительных данных в 1С, например, штрихкода или персонального свойства товара.

Формула генерации имен дополнительных опций (подтипов товаров) задается по кнопке Правило наименования.

Настройки характеристик и опций в УТ 10.3

В настройках выгрузки товаров вкладке Дополнительно необходимо поставить флаг Создавать добавочные опции (по характеристикам) и по кнопке Правила наименования подчиненных товаров настроить порядок именования подтипов.

Соответствия полей

Здесь настраиваются соответствия полей наименования и описания товара с реквизитами в 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С поступает заказ, то в магазине меняется статус на Отправлен в учетную систему. Далее, когда заказ сформирован, 1с формирует счет и загружает в магазин, статус заказа меняется на Доступны бухгалтеские документы.

Видео-урок

Настройка параметров доступа

Доступ к сайту

Требуется указать серийный ключ лицензии. Если у Вас есть файл лицензии PHPShop «****.lic» — достаточно указать его по кнопке LIC на форме, что избавит от ручного ввода данных имени домена и серийного ключа. Также серийный ключ доступен в админ панели сайта, через меню Справка - О программе. Указывается пользователь и пароль от админ панели сайта.

Доступ к FTP

В настройках указываются параметры доступа к FTP сайту и путь к папкам с данными. Для получения верных путей к данным, рекомендуется подключится к FTP через файловый менеджер (FileZilla и т.д.) и скопировать правильный путь через него. Порт для FTP, по умолчанию, обычно 21, если не задан другой порт вашим хостингом.

Формат папок на FTP:

1. Папка с данными на ftp: корень сайта/1cManager/

2. Папка картинок на 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С , в закладке Выгрузка на сайт - Выгрузка товаров. Здесь, на основе штатных 1С фильтров отбора, нужно заполнить фильтр отбора номенклатуры.

Для выгрузки товаров из определенной группы, используется правило Номенклатура - В группе - Имя категории. Если требуется выбрать несколько групп, то Номенклатура - В группе из списка - Имена категорий.

После заполнения фильтра отбора, нажимаем кнопку Выгрузить товары.

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

Выгрузка прайс-листа служит для выгрузки интерактивного прайс листа с макросами в формате XLS и загрузки его на сайт в раздел Прайс-лист - Интерактивный прайс-лист.

Видео-урок

Загрузка заказов

Загрузка заказов выполняется после заполнения настроек в закладке в 1С модуле Заказы с сайта.

Кнопка Прочитать заказы активирует режим загрузки заказов сайта и предлагает выбрать период времени , за который будет произведен запрос на сайт о новых заказах.

Кнопка Загрузить заказы загружает выбранные на предыдущем шаге заказа в базу 1С.

На основе настройки статуса заказа для загрузки, в 1С будут отображаться новые заказы, с возможностью принять их и загрузить в 1С.

Видео-урок

Изменение корзины заказа

Загруженный заказ из магазина, можно предварительно откорректировать, добавить или удалить товары из корзины, через вкладку Корзина заказа.

Видео-урок

Автоматический режим

Выгрузка товаров и загрузка заказов по расписанию

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

Настроить условия выгрузки для автоматической выгрузки товаров (или импорта заказов), указав отборы на основной форме обработки обмена.

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

В 1С НСИ и администрирование/Администрирование открыть раздел Печатные формы, отчеты и обработки

Создать новый элемент по кнопке Добавить из файла и выбрать актуальный файл обработки обмена PHPShop_Exchange_83.epf

Настроить расписание обмена с сайтом для вида операции, а также размещение вызова обработки в разделах 1С.

Выгрузка только измененных товаров

Настройка выгрузки только измененных в 1С товаров на примере конфигурации "Управление торговлей, редакция 11".

Открыть форму настройки обменов с сайтом из раздела НСИ и администрирование/Настройка интеграции/Обмен с сайтом

Установить флаг Использовать обмен с сайтом и открыть список настроек обмен.

По кнопке Создать создать новую настройку обмена с сайтом, заполнив только необходимые поля – все прочие настройки выполняются из обработки обмена.

В обработке обмена открыть настройки выгрузки товаров, в разделе Основные настройки/Общие/Дополнительные параметры выбрать значение плана обменов Обмен с сайтом и созданный в предыдущем шаге узел обмена.

Автоматическое открытие обработчика

Если требуется открывать обработку обмена при запуске 1С, то следует прописать полный путь до файла обработчика в поле Дополнительные параметры запуска в настройках запуска 1С.

Журнал Обмена данными

Во время синхронизации данных номенклатуры ведется журнал Обмена данными, доступный через меню Настройка - Обмен данными. В нем сохраняется информация по времени выполнении запроса и обновляемом файле.

Кнопка Выполнить в столбце операции позволяет выполнить еще раз действие обновления данных из выбранного файла. Это полезная функциях при поиске возможных проблем при синхронизации данных.

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

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";"40@бежевый";"";"";"";"";"100";"4540.00";"";"";"";"";"";"шт";"RUB";"25";"40@бежевый";""
"e3edf54e-fdab-11e7-82dd-3010b3ebd474";"41@желтый";"";"";"";"";"60";"4540.00";"";"";"";"";"";"шт";"RUB";"25";"41@желтый";""
"e3edf54f-fdab-11e7-82dd-3010b3ebd474";"42@коричневый";"";"";"";"";"79";"5000.00";"";"";"";"";"";"шт";"RUB";"25";"42@коричневый";""
"УНФ123";"Кондиционер Самсунг";"Кондиционер Самсунг";"Produkciya_tovary/Unf123";"";"1";"5";"30000.00";"30000.00";"0";"0";"0";"";"шт";"RUB";"173";"";"Производитель";"Samsung";""

Первой строкой идут заголовки полей, далее строки с данными по товарами. Найти нужный товар можно по столбцу Артикул. Так же этот файл можно открыть через Excel для удобства поиска.

Если в транспортных файлах не обнаружен искомый товар, значит фильтр выборки отбора товара для выгрузки настроен так, что искомый товар в него не попадает. Следует проверить отбор по фильтру, особенно учитывать настройку отбора по определенному складу, если она задействована.

Переход на встроенный типовой обмен CML

При желании, можно перейти с внешнего обработчика на встроенный типовой обмен CommerceML. Для этого:

1. Включите типовой обмен по инструкции.

2. Выключите в настройках создание новых каталогов и товаров.

3. В качестве артикула на сайте выберите Артикул.

1. Включите выгрузку данных по номенклатуре в типовом обмене в 1С и выгрузите данные по всем товарам.

2. После выгрузки на сайте ничего не поменяется, но будут созданы файлы csv с данными связки артикула и внешнего кода товара в 1С по адресу 1cManager/sklad/дата-выгрузки/upload_{0-100}.csv. Файлов upload_x.csv может быть несколько.

3. Загрузите CSV файлы штатным способом через меню База - Импорт данных. Выберите действие - Обновление, остальные настройки без изменений.

В результате товарам проставится поле "Внешний код" по совпадению "Артикула".

Проверить поле внешнего кода можно в закладке Дополнительно - Интеграция.

В настройках Обмена данными можно включить опции создания новых товаров, если это требуется и использовать далее только встроенный типовой обмен для выгрузки номенклатуры из 1С на сайт и загрузки заказов с сайта в 1С.

Использование Кода 1С

Если ранее во внешнем обработчике 1С использовался Код 1С товара в качестве ключа обновления, а не Артикул, то при переходе на типовой обмен может возникнуть проблема из-за отсутствия поля Код 1С в типовой выгрузке (зависит от конфигурации 1С).

В таком случаи в качестве ключа обмена используется Наименование товара.