Обмен с сайтом 1С
Содержание
- Настройка обмена данными
- Создание узла обмена с веб-сайтом
- Настройка выгрузки товаров
- Настройка обмена заказами
- Выполнение обмена данными
- Выгрузка на сайт
- Обмен информацией о заказах
- Создание узла обмена с 1С в HostCMS
- Импорт цен из 1С
- Наиболее частые проблемы при автоматическом обмене с 1С
- Группы номенклатуры
- Ограничение на импортируемые поля товаров
- Ограничение на импортируемые поля групп
- Управление полями, по которым осуществляется поиск товара
- Импорт ярлыков
- Импорт основных свойств товара, не предусмотренных в 1С
- Импорт веса, длины, ширины, высоты
- Загрузка заказов с сайта
- Загрузка заказов из 1С
- Интеграция УНФ с сайтом позволяет:
- Варианты обмена
- Настройка обмена
- Создание нового обмена
- Настройки при использовании варианта обмена через web-сервис
Настройка обмена данными
Для включения обмена данными с сайтом перейдите в Администрирование — Обмен данными и отметьте флажок «Обмен данными с сайтами”.
Рис. 1. Обмен данными с сайтами.
Далее нужно включить использование заказов клиентов. Для этого перейдите в Администрирование — Продажи и в разделе «Оптовые продажи” отметьте флажок «Заказы клиентов”.
Рис. 2. Заказы клиентов.
После чего создайте типовое соглашение для выгрузки цен. Перейдите в Маркетинг — Типовые соглашения с клиентами. Создайте новое или измените существующее соглашение. Соглашение должно быть действующим, с пустым сегментом партнёров и доступно внешним пользователям.
Рис. 3. Создание типового соглашения.
Создание узла обмена с веб-сайтом
Чтобы создать узел обмена с сайтом, перейдите в Администрирование — Обмен данными и кликните ссылку «Узлы обмена с сайтами”. В открывшемся окне нажмите кнопку «Создать”.
Рис. 4. Создание узла обмена с сайтом.
Поля «Наименование” и «Код узла” заполняются автоматически при сохранении. При необходимости их можно задать самостоятельно. Следует отметить флажок «Выгрузка товаров”, если планируется выгрузка товаров на сайт и флажок «Обмен заказами”, если планируется загрузка заказов с сайта. Далее нужно указать адрес сайта, имя пользователя и пароль. Адрес сайта должен быть в следующем формате: «http://ваш_сайт/admin/exchange/auto/” (важно убедиться, что после слова «auto” стоит «/”).
Для проверки соединения можно воспользоваться кнопкой «Проверить соединение…”. Если все параметры указаны верно, то появится сообщение «Соединение успешно установлено”. В противном случае — нужно проверить правильность адреса и параметров доступа.
После того как будет сделана проверка соединения — укажите режим контроля изменений. В режиме «Полная выгрузка” выгружаются все товары и заказы, соответствующие условиям выгрузки. Режим «Выгружать только изменённые объекты” проводит автоматический контроль изменений, произошедших с момента последней удачной выгрузки. Все изменения выгружаются на сайт.
Рис. 5. Параметры узла обмена с сайтом.
При необходимости можно настроить периодический обмен данными. Для этого установите флажок «Использовать периодический обмен данными”. После установки флажка автоматически откроется форма настройки расписания обмена:
Рис. 6. Расписание обмена.
Если флажки «Выгрузка товаров” и «Обмен заказами” отмечены — необходимо провести настройку выгрузки товаров и обмена заказами соответственно.
Настройка выгрузки товаров
Перейдите на вкладку «Выгрузка товаров” (данная вкладка доступна, если отмечен флажок «Выгрузка товаров” на вкладке «Основные настройки”).
Рис. 7. Флажок «Выгрузка товаров”.
На вкладке укажите организацию — владельца каталога (это организация, от имени которой происходит выгрузка на сайт) и коэффициент перерасчёта веса (используется при перерасчёта веса товаров из единиц, в которых указан вес в УТ в единицы, в которых вес учитывается на сайте). Установите флажок «Выгружать файлы изображений”, если планируется выгрузка картинок товаров на сайт. Если будет производиться выгрузка произвольных файлов, присоединённых к номенклатуре — установите флажок «Выгружать прочие файлы”. При необходимости построить классификатор групп товаров по справочнику «Виды номенклатуры” — установите флажок «Классифицировать по видам номенклатуры”. При не установленном флажке группы будут выгружаться из справочника «Номенклатура”.
Таблица каталогов заполняется также по необходимости. В ней содержатся строки, соответствующие информационному блоку на сайте.
Рис. 8. Таблица каталогов.
В колонках «Каталог” и «Группы номенклатуры” задайте имя каталога и фильтр выгрузки групп соответственно. Состав выбираемых групп зависит от флажка «Классифицировать по видам номенклатуры”. Если данный флажок установлен, то группы выбираются из справочника «Виды номенклатуры”. Иначе, выбор происходит из справочника «Номенклатура”. В случае, если конкретные группы не выбраны (указано «Все”) — выгружаются все группы. Колонка «Идентификатор каталога” задаёт идентификатор, по которому устанавливается связь выгружаемых данных с конкретным информационным блоком на сайте.
Если требуется настроить отбор, нажмите кнопку «Настроить отбор”. При этом откроется форма настройки отбора для выбранного каталога. С помощью отбора устанавливаются ограничения по выгрузке товаров.
Рис. 9. Настройка отбора.
Настройка обмена заказами
Перейдите на вкладку «Обмен заказами” (данная вкладка доступна, если отмечен флажок «Обмен заказами” на вкладке «Основные настройки”).
Рис. 10. Флажок «Обмен заказами”.
Настройте способ идентификации контрагентов — это режим поиска контрагентов при загрузке заказов на сайт. Предоставляется два варианта поиска: по наименованию и по комбинации ИНН + КПП.
Внимание: По умолчанию в системе работает поиск по наименованию. Если Вам нужно сделать поиск по комбинации ИНН + КПП, то для обеспечения такой логики придётся кастомизировать шаблон выгрузки заказов.
Укажите виды номенклатуры Товар (с этим видом номенклатуры будут записываться новые товары) и Услуга (с этим видом номенклатуры будут записываться новые услуги). Укажите единицу измерения для новой номенклатуры. Создаваемые товары записываются с этой единицей измерения. По необходимости — заполните группу новой номенклатуры. В эту группу помещаются товары и услуги, создаваемые при загрузке заказов с сайта. Укажите соглашение, с которым будут создаваться документы «Заказ клиента”. Если это требуется — укажите организацию и менеджера, от имени которых будут создаваться данные документы.
Дополнительные параметры обмена заказами настраиваются на вкладке «Дополнительно”.
Рис. 11. Вкладка «Дополнительно”.
На данной вкладке Вы можете:
- установить режим записи и проведения документов «Заказ клиента”;
- настроить параметры отмены заказов (если заказ отменён, то соответствующая информация появится в УТ).
Параметры отмены заказов:
- статус заказа «Отменён” — это значение статуса, получаемого с сайта (обычно равно «Отменён”);
- поле «Причина отмены заказа” (содержит причину отмены, которая заполняется в соответствующем поле документа «Заказ клиента”);
- соответствие статусов заказа (если соответствия настроены, при загрузке заказов будет проводиться попытка установки соответствующего статуса документа «Заказ клиента”).
Внимание: При каждом изменении статуса заказа в UMI.CMS для этого заказа устанавливается флаг «Выгружать заказ в 1С при следующем сеансе связи». При синхронизации выгружаются только заказы, для которых этот флаг установлен true. После выгрузки флаг снимается. При необходимости можно поставить флаг для заказа в модуле «Интернет-магазин» на вкладке Заказы, предварительно добавив отображение этого свойства в таблицу заказов.
Выполнение обмена данными
Запустить обмен данными вручную, можно нажав кнопку «Выполнить обмен данными” в форме узла, либо в форме списка узлов. По его окончании будет выдано соответствующее сообщение.
Рис. 12. Кнопка «Выполнить обмен данными”.
Чтобы процесс обмена запускался автоматически, настройте расписание автоматического обмена и сохраните настройки узла обмена данными. В том случае, если на сервере «1С: Предприятия” включено выполнение регламентных заданий, обмен будет происходить автоматически, по установленному расписанию. Если используется файловый вариант работы УТ, то для выполнения автоматического обмена должен быть запущен специальный сеанс, обрабатывающий регламентные задания.
Данный открытый протокол разработан компаниями «1С» и «1С-Битрикс».
Протокол используется штатной процедурой обмена коммерческими данными между системой «1С: Предприятие», с одной стороны, и системой управления сайтом, с другой стороны.
Функционально обмен делится на два блока:
- выгрузка на сайт торговых предложений (каталогов продукции), данных об остатках на складах (с разбивкой и сводно), данных только о ценах и остатках (без описания номенклатуры);
- обмен информацией о заказах.
Первый блок обеспечивает публикацию на сайте каталога номенклатурных позиций и данных. Второй блок необходим для передачи с сайта в систему «1С: Предприятие» информации о заказах интернет-магазина, и дальнейшую синхронизацию статусов и параметров заказов.
В обоих случаях инициатором обмена выступает система «1С: Предприятие». Обмен электронными документами осуществляется в соответствии с правилами и форматами, описанными в стандарте CommerceML 2.
При инициализации взаимодействия устанавливается HTTP соединение. Система «1С: Предприятие» запрашивает у сайта необходимые параметры, такие, как максимальный объем пакета, поддержка сжатия и др. На основании этих данных система 1С: Предприятие формирует XML сообщения и передает их на сайт.
Выгрузка на сайт
Данные для публикации на сайте выгружаются одним пакетом.
A. Начало сеанса
В ответ система управления сайтом передает системе «1С: Предприятие» три строки (используется разделитель строк «\n»):
- слово «success»;
- имя Cookie;
- значение Cookie.
Примечание. Все последующие запросы к системе управления сайтом со стороны «1С: Предприятия» содержат в заголовке запроса имя и значение Cookie.
B. Запрос параметров от сайта
Далее следует запрос следующего вида:
http:/// /1c_exchange.php? type=catalog& mode=init
В ответ система управления сайтом передает две строки:
- zip=yes, если сервер поддерживает обмен в zip-формате — в этом случае на следующем шаге файлы должны быть упакованы в zip-формате
или
zip=no — в этом случае на следующем шаге файлы не упаковываются и передаются каждый по отдельности. - file_limit=, где — максимально допустимый размер файла в байтах для передачи за один запрос. Если системе «1С: Предприятие» понадобится передать файл большего размера, его следует разделить на фрагменты.
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=
Во время загрузки система управления сайтом может отвечать в одном из следующих вариантов.
- Если в первой строке содержится слово «progress» — это означает необходимость послать тот же запрос еще раз. В этом случае во второй строке будет возвращен текущий статус обработки, объем загруженных данных, статус импорта и т. д.
- Если в ответ передается строка со словом «success», то это будет означать сообщение об успешном окончании обработки файла.
Примечание. Если в ходе какого-либо запроса произошла ошибка, то в первой строке ответа системы управления сайтом будет содержаться слово «failure», а в следующих строках — описание ошибки, произошедшей в процессе обработки запроса. Если произошла необрабатываемая ошибка уровня ядра продукта или sql-запроса, то будет возвращен html-код.
Примеры файлов выгрузки
Сведения о товарах в формате XML. 20Ид> 20Номер> 2007-10-16Дата> Заказ товараХозОперация> ПродавецРоль> RUBВалюта> 1Курс> 9683.42Сумма> 1#admin#Петров Петр Ид> Петр ПетровНаименование> ПокупательРоль> Петр ПетровПолноеНаименование> ПетровФамилия>ПетрИмя> 87698Представление> Почтовый индексТип> 6546Значение> АдресноеПоле> УлицаТип> 87698Значение> АдресноеПоле> АдресРегистрации> Контакты> Контактное лицоОтношение> ab7399a8aa62c20e0e9f3ea53c6dac81Ид> Петр ПетровНаименование> Контрагент> Представитель> Представители> Контрагент> Контрагенты> 15:40:40Время> Комментарий> ORDER_DELIVERYИд> Доставка заказаНаименование> штБазоваяЕдиница> 348.00ЦенаЗаЕдиницу> 1Количество> 348.00Сумма> ВидНоменклатурыНаименование> УслугаЗначение> ЗначениеРеквизита> ТипНоменклатурыНаименование> УслугаЗначение> ЗначениеРеквизита> ЗначенияРеквизитов> Товар> cbcf498f-55bc-11d9-848a-00112f43529aИд> bd72d8f9-55bc-11d9-848a-00112f43529aИдКаталога> Комбайн MOULINEX A77 4CНаименование> штБазоваяЕдиница> 9335.42ЦенаЗаЕдиницу> 1.00Количество> 9335.42Сумма> ВидНоменклатурыНаименование> ТоварЗначение> ЗначениеРеквизита> ТипНоменклатурыНаименование> ТоварЗначение> ЗначениеРеквизита> ЗначенияРеквизитов> Товар> Товары> Дата оплатыНаименование> 2007-10-16 15:44:47Значение> ЗначениеРеквизита> Номер платежного документаНаименование> ТК000000026Значение> ЗначениеРеквизита> Метод оплатыНаименование> Наличный расчетЗначение> ЗначениеРеквизита> Дата разрешения доставкиНаименование> 2007-10-16 15:51:27Значение> ЗначениеРеквизита> Заказ оплаченНаименование> trueЗначение> ЗначениеРеквизита> Доставка разрешенаНаименование> trueЗначение> ЗначениеРеквизита> ОтмененНаименование> falseЗначение> ЗначениеРеквизита> Финальный статусНаименование> trueЗначение> ЗначениеРеквизита> Статус заказаНаименование> ДоставленЗначение> ЗначениеРеквизита> Дата изменения статусаНаименование> 2007-10-16 15:51:58Значение> ЗначениеРеквизита> ЗначенияРеквизитов> Документ> КоммерческаяИнформация>
Обмен информацией о заказах
Заказы, оформленные на сайте, загружаются в систему «1С: Предприятие».
Последовательность действий при работе с заказом:
- Заказ оформляется на сайте
- При передаче в систему «1С: Предприятие» в заказе устанавливается категория «Заказ с сайта».
При формировании заказа в системе «1С: Предприятие» записываются номер и дата заказа, с которыми он оформлен на сайте. Поиск контрагента осуществляется по ИНН или наименованию, в зависимости от указанных настроек. - При загрузке заказа производится поиск договора с контрагентом. Договор ищется среди существующих договоров с клиентом, с признаком ведения взаиморасчетов по заказам (по указанной в настройках загрузки Организации). Если не находится ни один договор, то создается новый.
- При загрузке заказа загружаются все его свойства, переданные с сайта. Свойства ищутся в системе «1С: Предприятие» по наименованию. Если с таким наименованием свойства нет, то заводится новое свойство со значениями типа строка или число.
- Заказ может модифицироваться в системе «1С: Предприятие», при этом его изменения будут выгружаться на сайт
- Если заказ оплачивается или отгружается в системе «1С: Предприятие», то состояния заказа по оплате и по отгрузке выгружаются на сайт только при полном выполнении операции (полной оплате и полной отгрузке). До этого момента заказ считается не оплаченным и не отгруженным.
- При попытке в системе «1С: Предприятие» изменить заказ, по которому произведена оплата или отгрузка, заказ на сайт не загрузится как измененный. При этом пользователь получит об этом сообщение.
- После каждой выгрузка заказа на сайт, на стороне сайта определяются значения его категорий (ссылка на категории). Эти значения устанавливаются в системе «1С: Предприятие» так, как они присвоены заказу на сайте
В ответ система управления сайтом передает системе «1С: Предприятие» три строки (используется разделитель строк «\n»):
- слово «success»;
- имя Cookie;
- значение Cookie.
Примечание. Все последующие запросы к системе управления сайтом со стороны «1С: Предприятия» содержат в заголовке запроса имя и значение Cookie.
B. Уточнение параметров сеанса
Далее следует запрос следующего вида:
http:/// /1c_exchange.php? type=sale& mode=init
В ответ система управления сайтом передает две строки:
- zip=yes, если сервер поддерживает обмен в zip-формате — в этом случае на следующем шаге файлы должны быть упакованы в zip-формате
или
zip=no — в этом случае на следующем шаге файлы не упаковываются и передаются каждый по отдельности. - file_limit=, где — максимально допустимый размер файла в байтах для передачи за один запрос. Если системе «1С: Предприятие» понадобится передать файл большего размера, его следует разделить на фрагменты.
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-код.
Примеры файлов обмена информацией
Заказ на сайт в формате XML 20 20 2007-10-16 Заказ товара Продавец RUB 1 9683.42 1#admin#Петров Петр Петр Петров Покупатель Петр Петров ПетровПетр 87698 Почтовый индекс 6546 Улица 87698 Контактное лицо ab7399a8aa62c20e0e9f3ea53c6dac81 Петр Петров 15:40:40 ORDER_DELIVERY Доставка заказа шт 348.00 1 348.00 ВидНоменклатуры Услуга ТипНоменклатуры Услуга cbcf498f-55bc-11d9-848a-00112f43529a bd72d8f9-55bc-11d9-848a-00112f43529a Комбайн MOULINEX A77 4C шт 9335.42 1.00 9335.42 ВидНоменклатуры Товар ТипНоменклатуры Товар Дата оплаты 2007-10-16 15:44:47 Номер платежного документа ТК000000026 Метод оплаты Наличный расчет Дата разрешения доставки 2007-10-16 15:51:27 Заказ оплачен true Доставка разрешена true Отменен false Финальный статус true Статус заказа Доставлен Дата изменения статуса 2007-10-16 15:51:58 Заказ с сайта в формате XML 36 36 2007-10-30 Заказ товара Продавец руб 1 6734.47 1#admin# admin admin Покупатель admin Иванов admin ггг Почтовый индекс 1111 Улица ггг Контактное лицо b342955a9185c40132d4c1df6b30af2f admin 15:19:27 ORDER_DELIVERY Доставка заказа шт 340.00 1 340.00 ВидНоменклатуры Услуга ТипНоменклатуры Услуга dee6e19a-55bc-11d9-848a-00112f43529a bd72d8f9-55bc-11d9-848a-00112f43529a Телевизор «JVC» шт 6394.47 1.00 6394.47 ВидНоменклатуры Товар ТипНоменклатуры Товар Метод оплаты Наличный расчет Заказ оплачен false Доставка разрешена false Отменен false Финальный статус false Статус заказа Принят Дата изменения статуса 2007-10-30 15:19:27
Представленный протокол используется для интеграции системы «1С: Предприятие» с системами «1С-Битрикс: Управление сайтом», «UMI.CMS» и другими.
Выгрузка каталога товаров на сайт и загрузка заказов из интернет-магазина позволяет автоматизировать обмен между интернет-магазином и 1С:Управление торговлей. Обмен данными происходит в формате CommerceML. Специальных знаний для настройки обмена не требуется.
Обмен в системе «1С:Предприятие» реализован, в частности, в следующих конфигурациях (список не является исчерпывающим):
Создание узла обмена с 1С в HostCMS
В центре администрирования HostCMS в структуре сайта проверьте существование узла /shop/1c/, если узел отсутствует — создайте его:
Интернациональное название валюты в HostCMS должно совпадать с названием валюты в 1С, в противном случае будут возникать ошибки вида «Ошибка в значении узла <Документ>.<Валюта> документа CML (RUR).»
Настройка обмена данными в 1С:Управление торговлей 10.3
В меню «1С:Управление торговлей» выберите Сервис → Обмен данными с WEB-сайтом → Настроить обмен данными с WEB-сайтом.
В открывшемся окне выберите «Создать новую настройку обмена с WEB-сайтом» или «Изменить существующую настройку обмена с WEB-сайтом» и нажмите кнопку Далее.
В окне «Настройка обмена данными с WEB-сайтом» заполните необходимые поля:
В поле «Адрес сайта» введите http://www.mysite.ru/shop/1c/, заменив www.mysite.ru на адрес вашего сайта. В поле «Пользователь» и «Пароль» введите логин и пароль пользователя из центра администрирования HostCMS, от имени которого будет осуществляться обмен. Для проверки соединения нажмите «Проверить».
На следующих шагах задайте имя каталога, установите опции выгрузки картинок и файлов, коэффициент пересчета веса товаров в граммы, выберите экспортируемый на сайт тип цен и склад, настройте действия с поступающими с WEB-сайта документами.
Укажите режим обмена: «Полная выгрузка данных» или «Выгружать только измененные объекты с момента последнего обмена».
После завершения настроек 1С предложит выполнить обмен.
Настройка обмена данными в 1С:Управление торговлей 11
В верхнем меню с пиктограммами (Рабочий стол, Маркетинг …) выберите Администрирование → Настройки синхронизации данных. Установите опции Синхронизация данных и Обмен данными с сайтами.
Для передачи в магазин цен на товары необходимо создать и настроить Типовое соглашение с клиентом в разделе Маркетинг и планирование → Типовые соглашения с клиентами.
Перейдите в типовое соглашение с клиентом (отредактируйте существующее или создайте новое), установите организацию и вид цен, включите опцию Доступно внешним пользователям на вкладке Условия продаж (пролистните все окно до конца).
Если опция Доступно внешним пользователям отсутствует, то необходимо настроить параметры учёта, для этого:
- В верхнем меню с пиктограммами (Рабочий стол, Маркетинг …) выбираем Администрирование.
- В подменю выбираем Настройка → Настройка параметров учета.
- Во всплывшем окне выбираем пункт Обмен данными.
- Включаем опцию Использовать обмен с сайтами.
- В панели инструментов нажимаем кнопку Сохранить.
Создайте или отредактируйте узел обмена с сайтом в разделе Администрирование → Настройки синхронизации данных → Узлы обмена с сайтами.
В поле «Адрес сайта» введите http://www.mysite.ru/shop/1c/, заменив www.mysite.ru на адрес вашего сайта. В поле «Имя пользователя» и «Пароль» введите логин и пароль пользователя из центра администрирования HostCMS, от имени которого будет осуществляться обмен.
Для проверки соединения нажмите «Проверить».
Товар в процессе импорта может быть найден по CML ID товара, штрихкоду, артикулу товара.
Импорт цен из 1С
Выгрузка из 1С может содержать множество цен, стандартно HostCMS в основную цену импортирует цену с названием «Розничная», все остальные цены загружаются в цены для групп клиентов.
Если цена из 1С подставляется во вновь созданное поле, а основная цена нулевая, необходимо в центре администрирования в разделе Справочники → Цены скопировать название цены и удалить созданную при обмене цену в разделе Справочники → Цены, далее создать (отредактировать) активную константу SHOP_DEFAULT_CML_CURRENCY_NAME и прописать в ее значение название скопированный в предыдущем шаге цены.
Например, в файле offers.xml цена называется «Розничная цена» (а не просто «Розничная»), тогда создаем (если не создана) константу с названием SHOP_DEFAULT_CML_CURRENCY_NAME и значением Розничная цена. Очень важно удалить цену с названием «Розничная цена» из справочника цен. Если при первом импорте описанной выше константы не существовало, либо её значение не совпадало со значением «Розничная цена», создается цена в справочнике цен с названием «Розничная 100500». Если её не удалить из справочника, создание константы не поможет.
Наиболее частые проблемы при автоматическом обмене с 1С
- Если не выгружаются цены и остатки товаров в 1С:УТ с версии 11.0.6.7 необходимо открыть «Маркетинг» → «Типовое соглашение с клиентом» и установить вид цены, условие продажи (оптовая, розничная и т.п.) и галочку «Доступность внешним пользователям». В настройке обмена в «Выгрузка данных» → «Настроить обмен» указываете это соглашение.
- При возникновении ошибки вида «failed sending data to the peer», проверьте наличие прокси-сервера в настройках браузера Internet Explorer. Если прокси-сервер указан, удалите его.
- При возникновении ошибки вида «Соединение с сайтом не установлено», проверьте наличие закрывающего слеша в поле «Адрес сайта», например:
http://site.ru/shop/1c — неверно,
http://site.ru/shop/1c/ — верно. - При возникновении ошибки вида «Ошибка в значении узла <Документ>.<Валюта> документа CML», убедитесь, что интернациональное название валюты в HostCMS равно названию валюты в 1С.
- При возникновении ошибки вида «Изменения товаров не зарегистрированы. Выгрузка товаров не произведена.», убедитесь, что в меню «Справочник» — «Номенклатура» — «Виды номенклатур» у наименования «Товар», установлен тип номенклатуры «Товар». Также проверьте корректно ли настроен фильтр выгрузки. Существуют ли товары, попадающие под условия фильтра. Убедитесь, что у всех, отмеченных галочкой, условий фильтра указаны, собственно, условия.
- Ошибка «Не удалось определить юр./физ. лицо контрагента» говорит о наличии заказа с пустыми данными (Фамилия, Имя, Отчество или Компания). Заполните данные контрагента у заказов.
Группы номенклатуры
При экспорте дополнительных групп номенклатуры, такие группы импортируются не в корневую директорию, а в соответствующий раздел. Импорт в корень осуществляется при указании каталога как ‘Основной каталог товаров’ или ‘Каталог товаров’.
Допускается внесение в конфигурационный файл modules/shop/config/cml.php других названий разделов, которые будут приниматься за корневой каталог.
return array(
‘predefinedAdditionalProperties’ => array(),
‘catalogName’ => array(‘Основной каталог товаров’, ‘Каталог товаров’, ‘Мой каталог’)
);
Ограничение на импортируемые поля товаров
Контроллер импорта из CML имеет свойство updateFields, принимающее массив атрибутов товаров, подлежащих обновлению в процессе обмена. Позволяет ограничить перечень обновляемых полей и дать приоритет данным, содержащимся в системе управления.
В код настроек ТДС обмена с 1С вы можете внести опцию с указанием перечня полей, которые следует обновлять и удалить из того списка те поля, которые обновлять не следует.
$oShop_Item_Import_Cml_Controller->updateFields = array(‘marking’, ‘name’, ‘shop_group_id’, ‘text’, ‘description’, ‘images’, ‘taxes’, ‘shop_producer_id’, ‘prices’, ‘warehouses’);
$oShop_Item_Import_Cml_Controller->import();
Ограничение на импортируемые поля групп
Контроллер импорта из CML имеет свойство updateGroupFields, принимающее массив атрибутов групп, подлежащих обновлению в процессе обмена. Позволяет ограничить перечень обновляемых полей и дать приоритет данным, содержащимся в системе управления. Доступно с версии 6.9.2.
В код настроек ТДС обмена с 1С вы можете внести опцию с указанием перечня полей, которые следует обновлять и удалить из того списка те поля, которые обновлять не следует.
$oShop_Item_Import_Cml_Controller->updateGroupFields = array(‘name’, ‘description’, ‘parent_id’);
$oShop_Item_Import_Cml_Controller->import();
Управление полями, по которым осуществляется поиск товара
Контроллер импорта из CML имеет свойство itemSearchFields, принимающее массив полей, по которым товар может быть найден. В код настроек ТДС обмена с 1С вы можете внести опцию с указанием перечня полей. Доступно с версии 6.9.1.
$oShop_Item_Import_Cml_Controller->itemSearchFields = array(‘cml_id’, ‘marking’, ‘barcode’);
$oShop_Item_Import_Cml_Controller->import();
Импорт ярлыков
Для товара допускается указание нескольких CML ID группы, при этом сам товар будет помещен в первую указанную группу, а в другие указанные группы будут помещены ярлыки на этот товар.
<Товар>
<Ид>365b2cc7-7d8f-10e2-bf4b-f33e468030d2</Ид>
<Артикул>1000265478</Артикул>
<Наименование>Bla-bla-bla товар</Наименование>
<Группы>
<Ид>c42399e2-b263-11e0-a67f-f4ce468038d0</Ид>
<Ид>b05597e0-dcaa-00ae-a00f-ac38d0ce4680</Ид>
</Группы>
…
</Товар>
Импорт основных свойств товара, не предусмотренных в 1С
Добавлена возможность указать значения некоторых основных свойств товара через дополнительные свойства в системе 1С. Соответствие названия дополнительного свойства 1С и основного свойство товара в HostCMS:
HOSTCMS_TITLE | Заголовок (title) SEO |
HOSTCMS_DESCRIPTION | Описание (description) SEO |
HOSTCMS_KEYWORDS | Ключевые слова (keywords) SEO |
HOSTCMS_МЕТКИ | Метки (теги) |
ПРОИЗВОДИТЕЛЬ | Производителя товара |
АКТИВНОСТЬ | Активность товара |
ПРОДАВЕЦ | Название продавца |
YANDEX_MARKET | Экспортировать в Яндекс.Маркет |
Импорт веса, длины, ширины, высоты
Импорт веса и габаритов осуществляется из тегов ЗначенияРеквизитов/ЗначениеРеквизита. ЗначениеРеквизита/Наименование должно иметь одно из следующих значений: Вес, Длина, Ширина, Высота.
Загрузка заказов с сайта
При обменен с 1С система управления выгружает новые заказы. Новыми заказами считается те заказы, которые ранее не были выгружены или отредактированные после выгрузки заказы.
Проверить выгружаемую информацию вы можете через браузер, перейдя на страницу http://вашсайт/shop/1c/?type=sale&mode=query (необходимо ввести логин и пароль в открывшемся окне).
Пометить все заказы как невыгруженные вы можете SQL-запросом:
UPDATE `shop_orders` SET `unloaded` = 0 WHERE `shop_id` = 1;
заменив 1 на идентификатор вашего магазина.
Загрузка заказов из 1С
При выгрузке из 1С для заказа реквизита «ПометкаУдаления», такой заказ помечается удаленным.
Не нашли ответ на свой вопрос в документации? Направьте обращение в или онлайн чат. Только авторизованные пользователи могут оставлять комментарии.
-
Без темы
Можно сюда файлы ТДС актуальной версии?
07.12.2017 16:37:56 EZ-Web
Программу 1С:Управление нашей фирмой (УНФ) можно легко интегрировать с сайтами (интернет-магазинами), поддерживающими обмен данными по стандарту CommerceML 2.05 или открытый протокол обмена с сайтом .
Интеграция подразумевает выгрузку на сайт товаров и загрузку обратно заказов покупателей. Настройка выполняется «из коробки» с популярными системами управления сайтами (CMS): 1С-Битрикс, UMI.CMS, InSales, HostCMS, Rugento, Diafan.CMS. Для «самописных» сайтов или работающих на других движках необходимо будет разработать выгрузку в указанных форматах, или использовать обмен через Web-сервисы (см. далее).
Интеграция УНФ с сайтом позволяет:
- работать по всем заказам (сделанным на сайте, оформленным по телефону или в магазине) централизованно;
- поддерживать актуальность информации по товарам, представленной на сайте;
- исключить дополнительные затраты на дублирование информации и настройку коммуникации между сайтом и учетной системой;
- исключить дополнительные затраты на персонал для управления интернет-магазином.
Общая схема взаимодействия с сайтом
- Выгрузка на сайт информации о товарах, остатках и ценах
- Регистрация на сайте заказов покупателей
- Загрузка зарегистрированных заказов и их обработка в приложении УНФ
- Передача изменений и статусов заказов (оплачен, отгружен и т.д.) на сайт
Варианты обмена
Обмен через Интернет по протоколу HTTP
При таком варианте настройка и инициализация обмена производятся в УНФ. При этом, интеграция возможна с интернет-магазинами, поддерживающими обмен по стандарту CommerceML 2.05 и открытый протокол обмена с сайтом.
Интеграция функционально делится на два блока:
- Выгрузка на сайт товарных предложений. Обеспечивает публикацию на сайте каталога номенклатурных позиций и информации о наличии товаров и ценах.
- Обмен информацией о заказах. Позволяет загружать с сайта в УНФ данные о заказах покупателей и производить дальнейшую синхронизацию состава и статусов заказов.
Запуск обмена может выполняться, как интерактивно (вручную), так и автоматически, по установленному расписанию. При этом, из приложения УНФ возможен, как полный объем выгрузки, так и только выгрузка последних изменений.
Обмен через web-сервис
При использовании данного варианта, обмен настраивается и производится на стороне сайта. В его основе лежит использование web-сервиса, позволяющего получать данные информационной базы.
Такой вариант является дополнительной возможностью, позволяющей интегрировать с приложением УНФ сайты, которые не поддерживают обмен по протоколу обмена с сайтами.
Настройка обмена
Общие настройки
Для начала использования функционала интеграции с сайтами необходимо перейти в раздел Компания — Интеграция с др. программами — Обмен с сайтом и установить опцию Обмен с сайтом. После этого станет доступна ссылка Настройка обмена с сайтом, при нажатии на которую открывается форма Узлы обмена с сайтами.
Рассмотрим порядок настройки обмена при использовании первого варианта (Обмен через интернет по протоколу HTTP).
Создание нового обмена
В форме Узлы обмена с сайтами, нажмите кнопку Создать, откроется Помощник по созданию обмена данными с web-сайтом.
Пройдем необходимые шаги настройки вместе.
Настройка режима обмена данными
На первом шаге помощника следует отметить пункты Выгружать товары и (или) Обмениваться заказами.
После выбора режима обмена данными нажмите Далее.
Установка настроек для подключения к web-сайту
На втором шаге помощника необходимо отметить пункт Обмен через интернет и указать адрес для подключения к сайту, имя и пароль пользователя. После этого можно проверить настройку соединения, нажав на кнопку Проверить соединение.
Настройка выгрузки номенклатуры
На третьем шаге помощника необходимо задать настройки для выгрузки номенклатуры (данная настройка отображается, если на первом шаге установлен флажок Выгружать товары).
На этом шаге помощника нужно указать виды цен и группы номенклатуры, которые будут выгружаться на сайт.
Флажок Выгружать остатки по складам отвечает за передачу на сайт информации об остатках товаров в разрезе складов.
Если установить флажок Выгружать изображения номенклатуры, вместе с номенклатурой будут выгружены присоединенные изображения товаров.
Кроме этого, можно задать дополнительные отборы. Например, можно установить отбор по полю Остаток больше 0 и на сайт будут выгружаться только те товары, которые есть на остатках.
Настройки для обмена заказами покупателей
На четвертом шаге нужно указать настройки для обмена заказами (настройка отображается, если на первом шаге установлен флажок Обмениваться заказами).
Дата начала выгрузки заказов определит дату, с которой заказы, которые уже есть в базе будут выгружаться на сайт.
При загрузке заказов покупателей с сайта, новые контрагенты идентифицируются в соответствии с установленным Способом загрузки контрагентов.
Контрагентов можно искать:
- по Наименованию
- по ИНН + КПП
При этом, если контрагент не найден, он создается.
Если нет необходимости создавать новых контрагентов при загрузке заказов с сайта, в качестве значения поля Способ загрузки контрагентов можно указать Не создавать и в появившемся поле выбрать контрагента, который будет подставляться во все загруженные заказы. При этом контактная информация покупателя будет записываться в заказ.
В поле Состояние необходимо указать состояние, которое будет присвоено всем новым заказам, загруженным с сайта.
Если в базе ведется несколько организаций, не забудьте уточнить Организацию для подстановки в заказы.
Кроме этого, в полях Группа для новой номенклатуры и Группа для новых контрагентов можно указать группы, в которые будут загружены ненайденная номенклатура и контрагенты.
Настройка расписания для автоматического обмена
На последнем шаге можно установить флажок использования автоматического обмена и задать расписание в открывшейся форме. Если автоматический обмен не требуется, никаких настроек делать не нужно.
После нажатия на кнопку Готово будет создан новый узел обмена с сайтом. При этом, если установлен флажок Выполнить обмен с web-сайтом при нажатии на кнопку «Готово”, будет автоматически запущен сеанс обмена с сайтом. Также Вы можете запустить его вручную.
Настройки при использовании варианта обмена через web-сервис
При использовании обмена через web-сервис, настройки со стороны приложения УНФ сводятся к получению адреса опубликованного web-сервиса.
Внимание! Механизм взаимодействия с web-сервисом должен быть реализован на стороне сайта.
Для получения адреса web-сервиса необходимо на втором шаге помощника установить значение переключателя Обмен через web-сервис и скопировать содержимое поля Адрес для подключения к web-сервису.