Меню

Настройка узла обмена с сайтом битрикс

Протокол обмена с сайтом

Данный открытый протокол разработан компаниями «1С» и «1С-Битрикс».

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

Первый блок обеспечивает публикацию на сайте каталога номенклатурных позиций и данных. Второй блок необходим для передачи с сайта в систему «1С: Предприятие» информации о заказах интернет-магазина, и дальнейшую синхронизацию статусов и параметров заказов.

В обоих случаях инициатором обмена выступает система «1С: Предприятие». Обмен электронными документами осуществляется в соответствии с правилами и форматами, описанными в стандарте CommerceML 2.

При инициализации взаимодействия устанавливается HTTP соединение. Система «1С: Предприятие» запрашивает у сайта необходимые параметры, такие, как максимальный объем пакета, поддержка сжатия и др. На основании этих данных система 1С: Предприятие формирует XML сообщения и передает их на сайт.

Выгрузка на сайт

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

A. Начало сеанса

Выгрузка данных начинается с того, что система «1С: Предприятие» отправляет http-запрос следующего вида:
http:// / /1c_exchange.php? type=catalog& mode=checkauth.

Примечание. Все последующие запросы к системе управления сайтом со стороны «1С: Предприятия» содержат в заголовке запроса имя и значение Cookie.

B. Запрос параметров от сайта

Далее следует запрос следующего вида:
http:// / /1c_exchange.php? type=catalog& mode=init

C. Выгрузка на сайт файлов обмена

Затем «1С: Предприятие» запросами с параметрами вида
http:// / /1c_exchange.php? type=catalog& mode=file& filename=
выгружает на сайт файлы обмена в формате CommerceML 2, посылая содержимое файла или его части в виде POST.

В случае успешной записи файла система управления сайтом выдает строку «success».

D. Пошаговая загрузка данных

На последнем шаге по запросу из «1С: Предприятия» производится пошаговая загрузка данных по запросу с параметрами вида http:// / /1c_exchange.php? type=catalog& mode=import& filename=

Примечание. Если в ходе какого-либо запроса произошла ошибка, то в первой строке ответа системы управления сайтом будет содержаться слово «failure», а в следующих строках — описание ошибки, произошедшей в процессе обработки запроса. Если произошла необрабатываемая ошибка уровня ядра продукта или sql-запроса, то будет возвращен html-код.

Примеры файлов выгрузки

Обмен информацией о заказах

Заказы, оформленные на сайте, загружаются в систему «1С: Предприятие».

A. Начало сеанса

Выгрузка данных начинается с того, что система «1С: Предприятие» отправляет http-запрос следующего вида:
http:// / /1c_exchange.php? type=sale& mode=checkauth.

Примечание. Все последующие запросы к системе управления сайтом со стороны «1С: Предприятия» содержат в заголовке запроса имя и значение Cookie.

B. Уточнение параметров сеанса

Далее следует запрос следующего вида:
http:// / /1c_exchange.php? type=sale& mode=init

C. Получение файла обмена с сайта

Затем на сайт отправляется запрос вида
http:// / /1c_exchange.php? type=sale& mode=query.

Сайт передает сведения о заказах в формате CommerceML 2. В случае успешного получения и записи заказов «1С: Предприятие» передает на сайт запрос вида
http:// / /1c_exchange.php? type=sale& mode=success

D. Отправка файла обмена на сайт

В случае успешной записи файла система управления сайтом передает строку со словом «success». Дополнительно на следующих строчках могут содержаться замечания по загрузке.

Примечание. Если в ходе какого-либо запроса произошла ошибка, то в первой строке ответа системы управления сайтом будет содержаться слово «failure», а в следующих строках — описание ошибки, произошедшей в процессе обработки запроса.
Если произошла необрабатываемая ошибка уровня ядра продукта или sql-запроса, то будет возвращен html-код.

Источник

Руководство пользователя по работе с модулем обмена 1С Битрикс

Руководство пользователя по работе с модулем обмена 1С Битрикс

1. Порядок установки модуля обмена 3

2. Работа с модулем обмена 6

2.1. Список узлов обмена 6

2.2. Настройка узла обмена 8

2.2.1. Обмен товарами 10

2.2.2. Обмен заказами 14

2.2.3. Обмен пользовательских справочников 18

2.3 Просмотр и редактирование зарегистрированных изменения 19

2.4 Редактирования кодов Битрикс у объектов 1С 20

2.5 Загрузка номенклатуры с сайта 21

2.6 Установка соответствий платежных систем и касс 23

2.7 Настройка автообмена 24

2.8 Создание пользовательского дерева групп 25

Порядок установки модуля обмена
Установить скаченный установщик модуля обмена; Запустить систему 1С:Предприятие в режиме «Конфигуратор». Сделать архивную копию информационной базы. Для этого в меню «Администрирование» выбрать пункт «Выгрузка информационной базы» и в открывшемся диалоге указать имя файла, в который будут записаны данные.

Читайте также:  Гугл хром не удается получить настройки

Открыть конфигурацию, для этого в меню «Конфигурация» выбрать пункт «Открыть конфигурацию». Включить возможность изменения объектов конфигурации, для этого в меню «Конфигурация» выбрать «Поддержка», затем «Настройка поддержки». В открывшемся окне нажать кнопку «Включить возможность изменения». В окне «Настройка правил поддержки» выбрать дважды «Объект поставщика редактируется с сохранением поддержки», нажать «ОК». Сохранить конфигурацию.

Вызвать режим «Сравнить, объединить с конфигурацией из файла» из меню «Конфигурация». В этом режиме будут показаны только различающиеся объекты дополнения и используемой конфигурации, поэтому полностью идентичные объекты могут отсутствовать в окне сравнения-объединения. Также может отсутствовать флажок включения таких объектов в объединение. В диалоге выбора указать файл конфигурации «XXX. cf». По умолчанию он лежит по следующему адресу: C:\Users\. \AppData\Roaming\1C\1Cv82\tmplts\1С-Битрикс\ОбменССайтом\(конфигурация 1С). Исключить из объединения все объекты конфигурации. Нажать кнопку «Действия» – «Отметить по подсистемам файла». Установить флажок напротив пункта: «Битрикс» и нажать «Установить».

10. Выполнить сравнение и объединение конфигураций (кнопка «Выполнить»).

11. Сохранить конфигурацию и обновить конфигурацию базы данных.

2. Работа с модулем обмена

2.1. Список узлов обмена

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

При нажатии на кнопку «Операции» отобразится всплывающее меню со следующими пунктами меню:

При нажатии на кнопку меню «Запустить обмен в режиме реального времени» будет запущен режим в котором сеанс 1С постоянно мониторит команду с сайта. В этом режиме сеанс 1С будет недоступен для работы. Для разблокировки необходимо нажать на комбинацию клавиш Ctrl + Break. Кнопка активна только для файлового варианта работы 1С.

При нажатии на кнопку «Перейти» отобразится всплывающее меню, с помощью которого можно перейти в служебный регистр сведений «Пакетный Обмен для CMS 1С-Битрикс», который необходим для пакетного обмена. В нем хранятся выгружаемые пакеты. Они хранятся до тех пор, пока сайт не загрузит их.

2.2. Настройка узла обмена

При создании/редактировании узла обмена появляется форма узла обмена

На вкладке «Основные» задаются основные настройки обмена.

Главные флажки обмена:

    Установленный флажок «Обмен товарами» означает, что должны выгружаться товары и информация по ним. При установке флажка появляется соответствующая вкладка «Обмен товарами»; Установленный флажок «Обмен заказами» означает, что должны загружаться с сайта заказы и выгружаться на сайт из 1С. При установке флажка появляется соответствующая вкладка «Обмен заказами»; Установленный флажок «Обмен пользовательскими справочниками» означает, что должны выгружаться пользовательские справочники из 1С. При установке флажка появляется соответствующая вкладка «Обмен польз. справочников»; Установленный флажок «Используется в режиме реального времени» означает, что настройка обмена используется при обмене в реальном времени. Только в одной настройке может стоять этот признак.

    Если стоит «Полная выгрузка», тогда выгружаться из 1С будут все данные, удовлетворяющие заданным отборам. Если данных в базе много, то обмен может выполняться продолжительное время; Если стоит «Только изменения», тогда выгружаться из 1С будут только те данные, которые изменились. Если установить режим обмена «Только изменения» скорость обмена существенно повышается.

    Если стоит «Выгрузка на сайт», тогда данные будут выгружаться на сайт, настройки подключения к которому, задаются в соответствующих полях(Адрес сайта, пользователь, пароль). При нажатии на кнопку «Проверить», происходит проверка подключения к сайту; Если стоит «Выгрузка в каталог», тогда данные будут выгружаться в каталог на диске. Каталог обмена и файл загрузки заказов задаются в соответствующих полях.

Реквизит «Каталог лога»

В поле «Каталог лога» задается каталог, в котором будет храниться лог файл обмена. Логи хранятся в разрезе дня в подчиненной папке «reports».

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

Реквизит «Группа для новых товаров»

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

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

    В поле «Число повторов при неудачно отправленных пакетах» задается значение, сколько раз обмен должен пытаться отправить пакет с данными, при неудачной отправке пакета; В поле «Таймаут между повторами неудачно отправленных пакетах» задается значение, сколько секунд должно пройти, перед тем как обмен снова пошлет неудачно отправленный пакет данных; Если стоит флажок «Продолжить отправку неудачно отправленных пакетов при следующем обмене», то если есть часть неотправленных пакетов, при следующем обмене, перед тем как произойдет обмен, произойдет довыгрузка неотправленных пакетов.
Читайте также:  Настройка зажигания мопеда альфа видео

Если стоит флажок «Использовать периодический обмен данными», то обмен будет выполняться по заданному расписанию. В зависимости от того, база 1С в файловом или клиент – серверном варианте, настройка автообмена отличается. Более подробно в п. 2.7.

2.2.1. Обмен товарами

На вкладке «Обмен товарами» настраивается обмен информации о товарах с сайтом.

2.2.1.1. Основные настройки

На вкладке товаров «Основные настройки» задается, какая информация о номенклатуре должна быть выгружена, и куда загружена на сайте.

Выгрузка справочных данных

    Если стоит флажок «Товары», тогда будут выгружена информация о товарах; Если стоит флажок «Свойства товаров», тогда будут выгружены как сами свойства, так и заполненные свойства у товаров; Если стоит флажок «Картинки и файлы», тогда будут выгружены картинки и файлы товаров. Картинки и файлы выгружаются только новые или измененные; Флажок «Принудительная полная выгрузка картинок и файлов» означает, что нужно выгрузить все картинки, не важно, есть ли они на сайте. Обмен с этой опцией можно сделать только ручным способом. Если стоит флажок «Выгружать штрихкоды», тогда для товаров и его предложений будут выгружены их 1 штрих код. Если штрих коды не используются, то лучше флажок этот не ставить, т. к. это замедлит работу выгрузки;

Выгрузка регистровых данных

    Если стоит флажок «Выгружать цены», то для выгружаемых товаров будут выгружены цены. Цены выгружаются только для тех типов цен, которые удовлетворяют условию. Если стоит флажок «Выгружать остатки», то для выгружаемых товаров будут выгружены остатки. Остатки выгружаются только по тем складам, которые удовлетворяют условию. Если стоит флажок «Выгружать остатки по складам», то на сайте остатки будут вестись в разрезе складов.

Если стоит флажок «Классифицировать номенклатуру по ценовым группам» то, группами номенклатуры будут ценовые зоны.

    Имя каталога – название инфоблока на сайте; Список групп – список групп товаров. Который должны быть выгружен в указанный инфоблок; Дерево групп – произвольное дерево групп, созданное пользователем, которое будет использовано в иерархии товаров. Выгружены будут только те товары, которые указаны в дереве групп. GUID каталога – код инфоблока.

2.2.1.2. Отбор и сортировка

На вкладке товаров «Отбор и сортировка», задаются отборы для справочных данных:

    Номенклатура – отбор по самой номенклатуре или группе; Тип цен – отбор по выгружаемым типам цен, и, соответственно, ценам товаров; Остатки по складам – отбор по выгружаемым складам. Остатки товара будут только по тем складам, которые удовлетворяют условию; Остаток – отбор по выгружаемым товарам. Если количества товара(по всем выгружаемым складам), будет меньше заданного количества – товар не выгрузится; Свойство номенклатуры – отбор по свойствам номенклатуры. Будут выгружены только те свойства, которые удовлетворяют условию отбора; Категория номенклатуры – отбор номенклатуры по категориям товаров.

2.2.1.3. Настройка свойств товаров

На вкладке можно указать, какие свойства товаров будут храниться в хайлоад инфоблоках и какие свойства влияют на цену.

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

2.2.2. Обмен заказами

На вкладке «Обмен заказами» настраивается обмен информации о заказах и клиентах.

2.2.2.1. Обмен заказами

На вкладке товаров «Обмен заказами» указывается, как заказы должны выгружаться, с какими параметрами загружаться.

Выгрузка заказов из 1С

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

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

Параметры создания документов

«Организация», «Ответственный», «Подразделения» – данные, которые подставляются в новые/отредактированные документы, пришедшие с сайта;

Если заполнен «Общий контрагент «физлицо»» и «Договор контрагента «физлицо»», то в новые заказы будет подставляться этот контрагент, когда у клиента с сайта стоит признак «физическое лицо».

Действия с документами, пришедшими с WEB-сайта

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

2.2.2.2. Обмен контрагентами

На вкладке заказов «Обмен контрагентами» указываются настройки по выгрузке/загрузке контрагентов. Информация о контрагентах с сайта выгружается вместе с документами.

Читайте также:  Настройка цифровых каналов россии

Выгрузка контрагентов из 1С

    При установке флажка «Контрагенты», из 1С будут выгружены контрагенты, удовлетворяющие условию по указанным отборам; В поле «Количество контрагентов в пакете» задается число контрагентов, которые будут выгружаться в одном пакете.

Загрузка контрагентов в 1С

    В поле «Идентификация контрагентов» указывается, как будут искаться контрагенты по базе, если контрагент не найдет по уникальному идентификатору или коду с сайта. Поиск контрагентов может быть или по наименованию или по ИНН; В поле «Группа для новых контрагентов» указывается группа контрагентов, в которую попадут новые контрагенты, сделанные модулем обмен с этой настройкой обмена.

2.2.2.3. Отбор и сортировка

На вкладке заказов «Отбор и сортировка», задаются отборы для выгружаемых заказов и контрагентов. Заказы, помимо точки актуальности, можно ограничить по организациям, а контрагенты по контрагентам и категориям контрагентов.

2.2.3. Обмен пользовательских справочников

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

2.3 Просмотр и редактирование зарегистрированных изменения

При нажатии на пункт меню «Открыть список изменений» откроется окно позволяющее посмотреть все зарегистрированные изменения узла обмена. Посмотреть зарегистрированные изменения можно вплоть до элементов, разворачивая их в дереве.

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

2.4 Редактирования кодов Битрикс у объектов 1С

При нажатии на пункт меню «Редактировать коды Битрикс у объектов 1С» откроется окно, в котором можно посмотреть/отредактировать коды Битрикс объектов 1С.

В поле «Тип объекта 1С» указывается тип объекта 1С, для которого нужно посмотреть/редактировать коды. Тип может быть:

    Справочник Документ План видов характеристик

В поле «Объект 1С» указывается объект, коды элементов которые необходимо посмотреть/отредактировать. Список объектов, которые можно выбрать, формируется в зависимости от указанного типа объекта 1С.

Указать объекты 1С можно только те, которые могут хранить коды Битрикс.

При нажатии на кнопку «Записать изменения» измененные коды элементов будут перезаписаны в элементе 1С.

2.5 Загрузка номенклатуры с сайта

При нажатии на пункт меню «Загрузить номенклатуру с сайта» откроется окно загрузки товаров с сайта.

На первом шаге задаются настройки подключения к сайту и интервал отправки запросов.

На втором шаге задаются настройки загрузки товаров

На третьем шаге производится загрузка данных.

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

2.6 Установка соответствий платежных систем и касс

При нажатии на пункт меню «Установка соответствий платежных систем и касс» откроется окно установки соответствий.

При нажатии на кнопку «Загрузить платежные системы с сайта» будут загружены данные о платежных системах в указанный узел обмена. В списке записей регистра сведений нужно указать, какая касса соответствует платежной системе. Именно по этой связке будет определяться, какая касса должна подставляться в ПКО, на основании платежной системы.

2.7 Настройка автообмена

При указании флажка «Использовать периодический обмен данными» в узле обмена, появится окошко с указанием расписания.

В окне расписания задается время начала и завершения обмена, дата начала и дата завершения, периодичность. Для того, чтобы расписание выполнялось каждый день, должен стоять значение «Повторять каждые» 1 день.

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

2.8 Создание пользовательского дерева групп

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

Вызвать форму создания/редактирования пользовательских групп можно на вкладке «Основные настройки» обмена товаров, нажав на ссылку «изменить» у дерева групп.

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

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

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

Источник