Протокол обмена с сайтом
Данный открытый протокол разработан компаниями «1С» и «1С-Битрикс».
Протокол используется штатной процедурой обмена коммерческими данными между системой «1С: Предприятие», с одной стороны, и системой управления сайтом, с другой стороны.
Функционально обмен делится на два блока:
- выгрузка на сайт торговых предложений (каталогов продукции), данных об остатках на складах (с разбивкой и сводно), данных только о ценах и остатках (без описания номенклатуры);
- обмен информацией о заказах.
Первый блок обеспечивает публикацию на сайте каталога номенклатурных позиций и данных. Второй блок необходим для передачи с сайта в систему «1С: Предприятие» информации о заказах интернет-магазина, и дальнейшую синхронизацию статусов и параметров заказов.
В обоих случаях инициатором обмена выступает система «1С: Предприятие». Обмен электронными документами осуществляется в соответствии с правилами и форматами, описанными в стандарте CommerceML 2.
При инициализации взаимодействия устанавливается HTTP соединение. Система «1С: Предприятие» запрашивает у сайта необходимые параметры, такие, как максимальный объем пакета, поддержка сжатия и др. На основании этих данных система 1С: Предприятие формирует XML сообщения и передает их на сайт.
Выгрузка на сайт
Данные для публикации на сайте выгружаются одним пакетом.
A. Начало сеанса
Выгрузка данных начинается с того, что система «1С: Предприятие» отправляет http-запрос следующего вида:
http:/// /1c_exchange.php? type=catalog& mode=checkauth.
В ответ система управления сайтом передает системе «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.
<КоммерческаяИнформация xmlns="urn:1C.ru:commerceml_210" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ВерсияСхемы="2.08" ДатаФормирования="2021-02-11T16:24:39"> <Классификатор><Ид>33fc4cb7-9333-45bc-863f-9f7274af7a22 <Наименование>Классификатор (рр) <Владелец><Ид>6e3445bb-b5b8-11e4-8355-74d02b7dfd8c <Наименование>Кухни Ассоль <ОфициальноеНаименование>ООО "Кухни Ассоль" <ИНН>7727233711 <КПП>772701001 <ОКПО>1027739829 <Адрес><Представление>142750, Москва г, Внуковское п, Абабурово п, Майская ул, дом № 10, корпус 3, офис 20 <Группы> <Группа><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Наименование>Материалы <Категории> <Категория><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Наименование>Материалы <ЕдиницыИзмерения> <ЕдиницаИзмерения><Код>625 <НаименованиеПолное>Лист <МеждународноеСокращение>LEF <ЕдиницаИзмерения><Код>166 <НаименованиеПолное>Килограмм <МеждународноеСокращение>KGM <ЕдиницаИзмерения><Код>616 <НаименованиеПолное>Бобина <МеждународноеСокращение>NBB <ЕдиницаИзмерения><Код>006 <НаименованиеПолное>Метр <МеждународноеСокращение>MTR <ЕдиницаИзмерения><Код>055 <НаименованиеПолное>Квадратный метр <МеждународноеСокращение>MTK <ЕдиницаИзмерения><Код>796 <НаименованиеПолное>Штука <МеждународноеСокращение>PCE <Каталог СодержитТолькоИзменения="false"><Ид>33fc4cb7-9333-45bc-863f-9f7274af7a22 <ИдКлассификатора>33fc4cb7-9333-45bc-863f-9f7274af7a22 <Наименование>рр <Владелец><Ид>6e3445bb-b5b8-11e4-8355-74d02b7dfd8c <Наименование>Кухни Ассоль <ОфициальноеНаименование>ООО "Кухни Ассоль" <ИНН>7727233711 <КПП>772701001 <ОКПО>1027739829 <Адрес><Представление>142750, Москва г, Внуковское п, Абабурово п, Майская ул, дом № 10, корпус 3, офис 20 <Товары> <Товар><Ид>f8c9ef49-47e1-11e5-8073-74d02b7dfd8c <Артикул/><Код>ФР-00000223 <Наименование>Лак мебельный <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Лак мебельный <Товар><Ид>f8c9ef4c-47e1-11e5-8073-74d02b7dfd8c <Артикул/><Код>ФР-00000224 <Наименование>Клей ПВА столярный <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Клей ПВА столярный <Товар><Ид>f8c9ef5f-47e1-11e5-8073-74d02b7dfd8c <Артикул/><Код>ФР-00000226 <Наименование>Гелькоут <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Картинка>import_files/f8/f8c9ef5f47e111e5807374d02b7dfd8c_08ba340e6d1411e59811e0cb4ed5f4c3.jpg <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ОписаниеФайла <Значение>import_files/f8/f8c9ef5f47e111e5807374d02b7dfd8c_08ba340e6d1411e59811e0cb4ed5f4c3.jpg#market_yaJmdkbt8OK5aVmAoKq43A_190x250 <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Гелькоут <Товар><Ид>f8c9ef60-47e1-11e5-8073-74d02b7dfd8c <Артикул/><Код>ФР-00000227 <Наименование>Жидкий гранит (наполнитель) <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Жидкий гранит (наполнитель) <Товар><Ид>f8c9ef61-47e1-11e5-8073-74d02b7dfd8c <Артикул/><Код>ФР-00000228 <Наименование>Отвердитель <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Отвердитель <Товар><Ид>429c2703-b5b9-11e4-8355-74d02b7dfd8c <Артикул>503 <Код>ФР-00000021 <Наименование>Пластик ПВХ <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Страна>РОССИЯ <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Пластик ПВХ <Товар><Ид>429c2704-b5b9-11e4-8355-74d02b7dfd8c <Артикул>504 <Код>ФР-00000022 <Наименование>Пластиковая кромка <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Страна>РОССИЯ <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Пластиковая кромка <Товар><Ид>429c2705-b5b9-11e4-8355-74d02b7dfd8c <Артикул>505 <Код>ФР-00000023 <Наименование>Клей ПВХ <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Страна>РОССИЯ <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Клей ПВХ <Товар><Ид>429c2706-b5b9-11e4-8355-74d02b7dfd8c <Артикул>506 <Код>ФР-00000024 <Наименование>Пленка ПВХ <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Страна>РОССИЯ <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Пленка ПВХ <Товар><Ид>429c2707-b5b9-11e4-8355-74d02b7dfd8c <Артикул>507 <Код>ФР-00000025 <Наименование>Столешница <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Картинка>import_files/42/429c2707b5b911e4835574d02b7dfd8c_80eca3a4739b11e88780b06ebf31a92f.png <Страна>РОССИЯ <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ОписаниеФайла <Значение>import_files/42/429c2707b5b911e4835574d02b7dfd8c_80eca3a4739b11e88780b06ebf31a92f.png#Столешница <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Столешница <Товар><Ид>5cb8d101-b78f-11ea-9036-ed187bb1ae53 <Артикул/><Код>ФР-00000248 <Наименование>Доводчик двери <Группы><Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c <СтавкиНалогов> <СтавкаНалога><Наименование>НДС <Ставка>20 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Запас <ЗначениеРеквизита><Наименование>Полное наименование <Значение>Доводчик двери мебельный
Обмен информацией о заказах
Заказы, оформленные на сайте, загружаются в систему «1С: Предприятие».
Последовательность действий при работе с заказом:
- Заказ оформляется на сайте
- При передаче в систему «1С: Предприятие» в заказе устанавливается категория «Заказ с сайта».
При формировании заказа в системе «1С: Предприятие» записываются номер и дата заказа, с которыми он оформлен на сайте. Поиск контрагента осуществляется по ИНН или наименованию, в зависимости от указанных настроек. - При загрузке заказа производится поиск договора с контрагентом. Договор ищется среди существующих договоров с клиентом, с признаком ведения взаиморасчетов по заказам (по указанной в настройках загрузки Организации). Если не находится ни один договор, то создается новый.
- При загрузке заказа загружаются все его свойства, переданные с сайта. Свойства ищутся в системе «1С: Предприятие» по наименованию. Если с таким наименованием свойства нет, то заводится новое свойство со значениями типа строка или число.
- Заказ может модифицироваться в системе «1С: Предприятие», при этом его изменения будут выгружаться на сайт
- Если заказ оплачивается или отгружается в системе «1С: Предприятие», то состояния заказа по оплате и по отгрузке выгружаются на сайт только при полном выполнении операции (полной оплате и полной отгрузке). До этого момента заказ считается не оплаченным и не отгруженным.
- При попытке в системе «1С: Предприятие» изменить заказ, по которому произведена оплата или отгрузка, заказ на сайт не загрузится как измененный. При этом пользователь получит об этом сообщение.
- После каждой выгрузка заказа на сайт, на стороне сайта определяются значения его категорий (ссылка на категории). Эти значения устанавливаются в системе «1С: Предприятие» так, как они присвоены заказу на сайте
A. Начало сеанса
Выгрузка данных начинается с того, что система «1С: Предприятие» отправляет http-запрос следующего вида:
http:/// /1c_exchange.php? type=sale& mode=checkauth.
В ответ система управления сайтом передает системе «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. Отправка файла обмена на сайт
Затем система «1С: Предприятие» отправляет на сайт запрос вида
http:/// /1c_exchange.php? type=sale& mode=file& filename=,
который загружает на сервер файл обмена, посылая содержимое файла в виде POST.
В случае успешной записи файла система управления сайтом передает строку со словом «success». Дополнительно на следующих строчках могут содержаться замечания по загрузке.
Примечание. Если в ходе какого-либо запроса произошла ошибка, то в первой строке ответа системы управления сайтом будет содержаться слово «failure», а в следующих строках — описание ошибки, произошедшей в процессе обработки запроса.
Если произошла необрабатываемая ошибка уровня ядра продукта или sql-запроса, то будет возвращен html-код.
Примеры файлов обмена информацией
Заказ на сайт в формате XML
<КоммерческаяИнформация ВерсияСхемы="2.03" ДатаФормирования="2008-03-28"> <Документ><Ид>20 <Номер>20 <Дата>2007-10-16 <ХозОперация>Заказ товара <Роль>Продавец <Валюта>RUB <Курс>1 <Сумма>9683.42 <Контрагенты> <Контрагент><Ид>1#admin#Петров Петр <Наименование>Петр Петров <Роль>Покупатель <ПолноеНаименование>Петр Петров <Фамилия>Петров <Имя>Петр <АдресРегистрации><Представление>87698 <АдресноеПоле><Тип>Почтовый индекс <Значение>6546 <АдресноеПоле><Тип>Улица <Значение>87698 <Представители> <Представитель> <Контрагент><Отношение>Контактное лицо <Ид>ab7399a8aa62c20e0e9f3ea53c6dac81 <Наименование>Петр Петров <Время>15:40:40 <Товары> <Товар><Ид>ORDER_DELIVERY <Наименование>Доставка заказа <БазоваяЕдиница Код="796" НаименованиеПолное="Штука" МеждународноеСокращение="PCE">шт <ЦенаЗаЕдиницу>348.00 <Количество>1 <Сумма>348.00 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Услуга <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Услуга <Товар><Ид>cbcf498f-55bc-11d9-848a-00112f43529a <ИдКаталога>bd72d8f9-55bc-11d9-848a-00112f43529a <Наименование>Комбайн MOULINEX A77 4C <БазоваяЕдиница Код="796" НаименованиеПолное="Штука" МеждународноеСокращение="PCE">шт <ЦенаЗаЕдиницу>9335.42 <Количество>1.00 <Сумма>9335.42 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Товар <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>Дата оплаты <Значение>2007-10-16 15:44:47 <ЗначениеРеквизита><Наименование>Номер платежного документа <Значение>ТК000000026 <ЗначениеРеквизита><Наименование>Метод оплаты <Значение>Наличный расчет <ЗначениеРеквизита><Наименование>Дата разрешения доставки <Значение>2007-10-16 15:51:27 <ЗначениеРеквизита><Наименование>Заказ оплачен <Значение>true <ЗначениеРеквизита><Наименование>Доставка разрешена <Значение>true <ЗначениеРеквизита><Наименование>Отменен <Значение>false <ЗначениеРеквизита><Наименование>Финальный статус <Значение>true <ЗначениеРеквизита><Наименование>Статус заказа <Значение>[F] Доставлен <ЗначениеРеквизита><Наименование>Дата изменения статуса <Значение>2007-10-16 15:51:58
Заказ с сайта в формате XML
<КоммерческаяИнформация ВерсияСхемы="2.03" ДатаФормирования="2008-03-28"> <Документ><Ид>20 <Номер>20 <Дата>2007-10-16 <ХозОперация>Заказ товара <Роль>Продавец <Валюта>RUB <Курс>1 <Сумма>9683.42 <Контрагенты> <Контрагент><Ид>1#admin#Петров Петр <Наименование>Петр Петров <Роль>Покупатель <ПолноеНаименование>Петр Петров <Фамилия>Петров <Имя>Петр <АдресРегистрации><Представление>87698 <АдресноеПоле><Тип>Почтовый индекс <Значение>6546 <АдресноеПоле><Тип>Улица <Значение>87698 <Представители> <Представитель> <Контрагент><Отношение>Контактное лицо <Ид>ab7399a8aa62c20e0e9f3ea53c6dac81 <Наименование>Петр Петров <Время>15:40:40 <Товары> <Товар><Ид>ORDER_DELIVERY <Наименование>Доставка заказа <БазоваяЕдиница Код="796" НаименованиеПолное="Штука" МеждународноеСокращение="PCE">шт <ЦенаЗаЕдиницу>348.00 <Количество>1 <Сумма>348.00 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Услуга <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Услуга <Товар><Ид>cbcf498f-55bc-11d9-848a-00112f43529a <ИдКаталога>bd72d8f9-55bc-11d9-848a-00112f43529a <Наименование>Комбайн MOULINEX A77 4C <БазоваяЕдиница Код="796" НаименованиеПолное="Штука" МеждународноеСокращение="PCE">шт <ЦенаЗаЕдиницу>9335.42 <Количество>1.00 <Сумма>9335.42 <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>ВидНоменклатуры <Значение>Товар <ЗначениеРеквизита><Наименование>ТипНоменклатуры <Значение>Товар <ЗначенияРеквизитов> <ЗначениеРеквизита><Наименование>Дата оплаты <Значение>2007-10-16 15:44:47 <ЗначениеРеквизита><Наименование>Номер платежного документа <Значение>ТК000000026 <ЗначениеРеквизита><Наименование>Метод оплаты <Значение>Наличный расчет <ЗначениеРеквизита><Наименование>Дата разрешения доставки <Значение>2007-10-16 15:51:27 <ЗначениеРеквизита><Наименование>Заказ оплачен <Значение>true <ЗначениеРеквизита><Наименование>Доставка разрешена <Значение>true <ЗначениеРеквизита><Наименование>Отменен <Значение>false <ЗначениеРеквизита><Наименование>Финальный статус <Значение>true <ЗначениеРеквизита><Наименование>Статус заказа <Значение>[F] Доставлен <ЗначениеРеквизита><Наименование>Дата изменения статуса <Значение>2007-10-16 15:51:58
Представленный протокол используется для интеграции системы «1С: Предприятие» с системами «1С-Битрикс: Управление сайтом», «UMI.CMS» и другими.
Выгрузка на сайт Примеры файлов выгрузки Обмен информацией о заказах Примеры файлов обмена информацией
- Протокол обмена с сайтом
- Стандарты CommerceML
- Стандарт обмена с системами «Клиент банка»
- Стандарт взаимодействия по технологии DirectBank
- Стандарт обмена данными по зарплатным проектам
- Стандарты обмена для государственных (муниципальных) учреждений
- Стандарт обмена данными по операциям эквайринга
- Технология подключения торгового оборудования
- Национальный стандарт штрихкодирования платежных реквизитов
- Стандарт обмена данными по выплатам самозанятым через 1С:ДиректБанк
- Формат EnterpriseData
- Архив cтандартов
Интеграция Битрикс24 и 1С
Работайте на максимальных скоростях! Не нужно вводить данные дважды — больше никаких ошибок и дополнительных затрат.
Совместная работа
Какими данными обмениваются Битрикс24 и 1С
Для облачного и коробочного Битрикс24
Только для коробочного Битрикс24
Возможности интеграции
Облачная и коробочная версии двух программ
1С:Синхронизация
Комплексный двусторонний обмен данными между 1С и Битрикс24 в режиме реального времени. Синхронизировать содержимое можно автоматически, по расписанию или вручную.
- Единая клиентская база
- Банковские счета компаний и контактов
- Сделки и Счета
- Товары и вариации, свойства товаров, единицы измерения, разделы
- Заказы, оплаты, отгрузки
- Прайсы, цены по прайсам и доступный остаток
- Пользовательские поля компаний, контактов, счетов и сделок
Коннектор к 1С
Работайте с 1С внутри Битрикс24 — открывайте документы в сделке CRM одним кликом.
- Единая клиентская база
- Документы
- Справочники
- Отчеты из 1С
- Реестр печатных форм
- «1СПАРК Риски» (оценка надежности контрагента)
- Телефония
Экспорт отчетов и печатных форм
Руководитель может просмотреть любой отчет из 1С в Битрикс24 даже на мобильном телефоне. Интеграция позволяет публиковать отчеты или печатные формы документов из 1С по заданному графику.
- Отчеты и печатные формы
Автоматизация сделок (роботы и триггеры)
Свяжите в единый автоматизированный процесс движение сделки по стадиям в CRM и работу с заказом в 1С. Для тех, кому важно, чтобы «всё само» и за считанные секунды.
- Отгрузка товара в 1С
- Заказ полностью или частично оплачен в 1С
- Изменение документа в 1С
- Проведение документа в 1С
- Отмена проведения документа в 1С
- Подтверждение корректности или некорректности документа в 1С
- Создание в 1С документа на основании ранее созданного
- Печатная форма из 1С с привязкой к таймлайну сделки
- Утверждение документа
- Отклонение документа
Смарт-процессы Битрикс24
Расширяйте возможности интеграции Битрикс24 с 1С с помощью смарт-процессов. Смарт-процессы — это возможность создавать новые разделы внутри CRM и настраивать их как угодно. Синхронизация поддерживает три режима: ручной, по расписанию и в режиме реального времени.
- Документы 1С
- Справочники 1С
Только для коробочного Битрикс24
Выгрузка данных о сотрудниках и другой кадровой информации
Комплексная интеграция с HR-системой компании. Отображаются все кадровые изменения и перестановки сотрудников в рамках компании.
- Структура компании
- Сотрудники компании
- Информация об отсутствиях сотрудников
- Кадровые перестановки
- Расчетные листы по зарплате и остатки отпусков
Конфигурации 1C для интеграции с Битрикс24
Коннектор к 1С 3.0
Коробочная версия 1С
Управление нашей фирмой, ред. 1.6
Бухгалтерия предприятия, ред. 3.0
Бухгалтерия для Беларуси, ред. 2.1
Управление торговлей, ред. 11
Комплексная автоматизация, ред. 2
ERP Управление предприятием, ред. 2
Коробочная версия 1С
Управление компанией для Беларуси, ред. 1.6
Бухгалтерия для Беларуси, ред. 2.1
Управление торговлей для Беларуси, ред. 3.4
Коробочная версия 1С
Бухгалтерия для Казахстана, ред. 3.0
Выгрузка кадровой информации и просмотр расчетных листков
1С:Зарплата и управление персоналом, ред. 3.1
Продукты 1С-Битрикс: Корпоративный портал и 1С:Зарплата и управление персоналом интегрированы в коробочной поставке, что позволяет сразу после приобретения и инсталляции систем приступить к настройке выгрузки данных.
Каждая конфигурация 1С имеет свои особенности обмена данными. Например, 1С:Бухгалтерия обменивается только счетами, а 1С:Управление торговлей обменивается с Битрикс24 сделками и заказами.
Как настроить интеграцию
Самостоятельная настройка
Требуется участие администратора 1С и доступ администратора в вашем Битрикс24
- Гайд по настройке для облачной версии Битрикс24
- Документация для коробочной версии Битрикс24
Следите за обновлениями документации при самостоятельной настройке. За уточнениями обращайтесь в службу поддержки.
Закажите настройку у партнеров Битрикс24
Этот вариант подходит для крупного бизнеса, который работает с большим объемом данных или нуждается в кастомной интеграции.
Более 700 наших партнеров прошли проверку, подтвердили компетенцию «Интеграция с 1С» и помогли многим компаниям вывести работу с данными на другой уровень.
Нужно еще больше инструментов? Попробуйте подписку на Битрикс24 Маркет
Интеграции с соцсетями, отчеты, готовые отраслевые CRM, шаблоны сайтов и еще 1000+ возможностей для вашего бизнеса – в подписке по фиксированной цене!
Tutorial по обмену с 1С. Часть третья: Выжимаем максимум из стандарта. Что мы хотели бы знать 1000 проектов назад
Всем привет! Я Дина, ведущий разработчик личных кабинетов и ecom-систем в ИНТЕРВОЛГЕ. Мы не делаем тривиальных проектов. Все что я буду описывать ниже – уникальные задачи. Однако очень часто мы решаем их стандартными средствами за счет хитрых трюков и опыта.
Disclaimer: «Сайтом» мы называем не homepage, не корпоративную визитку и даже не классический интернет-магазин. Для нас «сайт» – B2B интернет-магазин с кучей складов и типов цен, маркетплейс, личный кабинет документооборота.
В каждом втором проекте надо делать обмен данными между сайтом и чем-то на базе 1С: Предприятие.
В статье я расскажу, как настроить стандартный обмен и добиться от него максимума пользы «почти без кастомизаций».
Настройки сайта в первую очередь рассчитаны на экспорт онлайн заказов в 1С. Корректная отправка данных по онлайн заказам в 1С не гарантирует, что при той же структуре xml-файла данные по оффлайн заказам запишутся в нужные (аналогичные онлайн) поля заказа на сайте. Может потребоваться донастройка профиля обмена или кастомизация импорта (например, по банковским реквизитам, импорт которых для оффлайн заказов штатно не предусматривает).
В настройках каждого профиля обмена формы «Интеграция с 1С» в блоке «1С: Дополнительные параметры» вы можете добавить любое количество дополнительных (в том числе служебных) реквизитов, экспортируемых сайтом по заказам в 1С (данные будут добавлены в узел xml-файла экспорта).
Стоит учесть, что настройка дополнительных реквизитов штатно работает лишь для экспорта заказов, а вот при импорте оффлайн заказов, если вы передадите в xml-файл импорта значения в аналогичные реквизиты, по умолчанию сайт их не распознает и не импортирует (для решения такой задачи потребуется кастомизация импорта заказов).
Статусы заказов
Статусы — это этапы движения заказа (например, «Новый», «Принят», «Отгружен» и т.д.).
Список и последовательность смены статусов должны соответствовать бизнес-логике сайта.
Статусы заказа на стороне сайта настраиваются через Магазин/Настройки/Статусы. Статус может относиться к заказу или документу отгрузки.
В 1С-Битрикс существуют особые статусы заказов и отгрузок заказов, удаление которых невозможно:
N — начальный статус (название по умолчанию — Принят), в который заказ устанавливается при создании;
F — финальный статус (название по умолчанию — Выполнен), в котором заказ считается выполненным (т.е. оплаченным и доставленным).
DN — начальный статус документа отгрузки товаров (название по умолчанию — Ожидает обработки);
DF — финальный статус документа отгрузки товаров (название по умолчанию — Отгружен).
Статусы заказа на сайте могут отличаться от статусов в 1С, в настройках узла обмена на стороне 1С нужно настроить их соответствие.
Удобно, когда за логику смены статусов отвечает 1С, тогда на сайте остается лишь принять из 1С новый статус по заказу и вывести его пользователю (и иногда совершить сопутствующие операции, например, отправить уведомления). В этом случае на стороне сайта не нужно совершать дополнительных настроек (например, вкладка «Автоматизация процессов» модуля «Интернет-магазин») и управлять процессом смены статусов заказов.
Настройки модуля «Интернет-магазин»
Настройка «Статус, начиная с которого можно оплатить заказ» является важной и должна учитывать бизнес-процесс работы с заказами сайта.
Настройка поможет реализовать, например, такой кейс: при создании заказа для него на сайте устанавливается статус «Ожидает подтверждения», оплата в котором пользователю не доступна. После загрузки заказа в 1С и внутрисистемной проверки (автоматической или менеджером 1С), например, на фактическое наличие остатков по всем товарам или на корректность данных контрагента, 1С отдает сайту новый статус заказа, например, «Принят», в котором оплата на сайте уже возможна.
Документы оплат и обмен сайта с 1С
При создании онлайн заказа система 1С-Битрикс автоматически штатно создает документ оплаты. Он содержит информацию о выбранной покупателем платежной системе, статусе оплаты, номере и дате документа прихода.
Без хотя бы одного документа оплаты нельзя оплатить заказ на сайте (например, если удалить штатно созданную оплату).
Если в результате импорта заказов из 1С по онлайн заказу существующий на сайте документ оплаты не приходит, то он автоматически удаляется с сайта.
Документы оплаты могут быть отправлены сайтом в 1С и получены из нее штатными средствами обмена между 1С-Битрикс и 1С, что настраивается в узле обмена с сайтом на стороне 1С: галочки «Загружать оплаты» и «Выгружать оплаты» настроек обмена документами.
Загрузка оплат из 1С на сайт также должна быть разрешена через вышеупомянутую настройку «Создавать новые документы оплаты из 1с» в 1С-Битрикс.
Для корректного сохранения на сайте номера и даты документа оплаты из 1С в xml-файле импорта необходимо наличие реквизитов «Номер оплаты по 1С» и «Дата оплаты по 1С» (этих реквизитов может не быть по умолчанию, нужно донастроить на стороне 1С).
1С-Битрикс не дает изменять уже оплаченные оплаты. 1С-Битрикс не позволяет удалить заказ с оплаченным документом оплаты.
Для изменения/удаления оплаченной оплаты нужно сначала ее отменить (установить статус “Не оплачено”), а затем уже следующим запуском обмена вместе с изменениями оплаты можно снова сделать ее оплаченной.
Если задачей является отмена или изменения заказа, у которого есть оплаченная оплата на сайте, то нужно сначала отменить эту оплату в одном импорте, а в другом уже отменить или удалить заказ с сайта.
Пометка на удаление документа оплаты из 1С приходит как отмена документа оплаты. Чтобы физически удалить документ оплаты с сайта нужно, чтобы оплата была не оплачена, и этот документ оплаты не пришел при очередном импорте заказов из 1С.
Документы отгрузки и обмен сайта с 1С
При оформлении онлайн заказа в 1С-Битрикс автоматически создается документ отгрузки, привязанный к этому заказу.
Документ отгрузки на сайте хранит информацию о выбранной при оформлении заказа службе доставки, составе и количестве товаров в отгрузке, разрешении на доставку, статусе отгрузки, номере и дате документа отгрузки.
В настройках узла обмена на стороне 1С можно управлять загрузкой отгрузок в 1С и их выгрузкой на сайт. Импорт отгрузок из 1С на сайт также должен быть разрешен через настройку «Создавать новый документы доставки из 1с » в 1С-Битрикс.
Если в результате импорта заказов из 1С по онлайн заказу существующий на сайте документ отгрузки не приходит, то он автоматически удаляется с сайта.
Для сохранения у отгрузки на сайте номера и даты документа отгрузки нужно передать соответствующие значения в реквизит «Номер отгрузки по 1С» и узел «Дата1С» (не реквизит) xml-файла обмена.
Реквизит «Метод доставки ИД» xml-файла обмена устанавливает способ доставки, который должен быть выбран для отгрузки, в значении реквизита должен быть ID (целое число) службы доставки с сайта.
Если ваш каталог выгружается из 1С без торговых предложений (SKU), а при обмене онлайн заказами возникает ошибка «Попытка добавить в отгрузку товар, не входящий в состав заказа», можно попробовать удалить из xml-файла обмена (на стороне 1С) реквизиты «СвойствоКорзины#CATALOG.XML_ID » и «#PRODUCT.XML_ID» у товаров в отгрузке, эти реквизиты автоматически генерируются в 1С для работы с SKU, но без торговых предложений могут приводить к ошибке.
Если при обмене по заказам (наблюдали для оффлайн заказа) возникает ошибка «Попытка увеличить количество товара в отгрузке до количества, которое превышает не отгруженное в заказе», возможно, в xml-файле обмена в составе заказа некоторый товар указан несколько раз — с разным количеством заказанных товаров, а в отгрузке только один раз — с суммарным количеством. Нужно на стороне 1С в xml-файле выгрузки для заказа объединить записи по идентичным товарным позициям в одну. Например, если раньше в составе заказа “товар А” был указан дважды с количеством 8 400 шт. и 1 600 шт., а в отгрузке только один раз — с количеством 10 000 шт., то теперь и в заказе, и в отгрузке «товар А» нужно указать только по одному разу с количеством в 10 000 шт.
1С-Битрикс не позволяет изменить отгруженную отгрузку, для внесения изменений нужно сначала сменить статус отгрузки на «Не отгружен» (поле «Отгрузка»).
Если пометить отгрузку на удаление в 1С, но физически из базы 1С не удалять, то ранее отгруженная на сайте отгрузка станет не отгруженной.
Если физически удалить отгрузку из базы 1С, то документ отгрузки просто не придет с заказом (скорее всего потребуется полный обмен, а обмен изменений вообще не подхватит связанный заказ), что удалит отгрузку и на сайте, если она не отгружена.
Вывод и личное мнение
У профессионального разработчика чешутся руки сделать все самому. Однако здравый смысл и опыт показывает, что из базового обмена можно выжать максимум пользы, и только потом переходить к доработкам. Об этом – в других статьях.
Как можно обмениваться документами с 1с битрикс
Текущую редакцию Вашего 1С-Битрикс можно просмотреть на странице Обновление платформы ( Marketplace > Обновление платформы ).
Старт, Стандарт, Энтерпрайз
Обмен документов
На вкладке Обмен документов указывается, как заказы должны выгружаться с сайта, с какими параметрами загружаться на сайт:
Выгрузка заказов из 1С:
- При отмеченной опции Выгружать все заказы будут выгружены все заказы, в том числе и те, которые не были созданы на сайте.
- С помощью поля Точка актуальности выгрузки заказов указывается дата, начиная с которой и по текущий момент заказы будут выгружаться на сайт.
- Если отмечена опция Выгрузка отгрузок заказов, то вместе с заказами будут выгружены их отгрузки.
- В поле Количество заказов в пакете указывается, сколько заказов будет в одном пакете данных.
Загрузка товаров в 1С:
- В поле Группа для новой номенклатуры можно указать группу, в которую будут помещаться товары и услуги, создаваемые при загрузке заказов с сайта.
Соответствия статусов и оплат:
- На вкладках задаются соответствия статусов заказов сайта с 1С и соответствия касс с платежными системами. В зависимости от пришедшего статуса с сайта в документе он будет подставлен по соответствию. Название соответствий и их идентификаторов можно загрузить с сайта, нажав на соответствующую кнопку.
Загрузка заказов в 1С:
- Если отмечена опция Не обновлять документы пришедшие с сайта, то при повторной выгрузке документов с сайта документы в 1С не будут обновляться.
- При отмеченной опции Формирование оплаты, если заказ оплачен для оплаченных заказов будет создан приходный кассовый ордер.
- Если отмечена опция Загрузка отгрузок вместе с заказами, то модуль обмена будет загружать отгрузки, созданные или отредактированные на сайте.
- По кнопке Настроить соответствия полей загружаемых документов открывается окно, в котором настраивается заполнение реквизитов загружаемых документов.
Настройка соответствий загружаемых документов
Заполнение реквизитов загружаемых документов:
- какая дата документа подставляется: дата на момент загрузки документа в 1С или же дата создания документа на сайте;
- откуда берется номер документа: подставляется автоматически из 1С или приходит с сайта;
- режим записи документа: записывать, проводить оперативно, проводить не оперативно;
- действия с отмененными документами: помечать на удаление, отменять проведение, ничего не делать. Если на документ есть ссылки, то документ не будет отменен.
Правая верхняя таблица:
В правой верхней таблице отображаются все реквизиты указанного документа. Для того чтобы реквизиты документа отобразились в таблице, необходимо нажать на кнопку Настроить соответствия реквизитов, которая находится в верхней левой таблице.
Тип данных заполнения реквизита может быть следующим:
- Из поля XML — если выбран этот тип, тогда значение будет найдено по алгоритму, указанному в колонке Значение. Как правило, алгоритмы реализованы на основании данных XML. При указании этого типа в колонке Значение появляется предопределенный список значений алгоритмов.
- Фиксированное значение — если выбран этот тип, тогда в реквизит документа будет подставляться указанное фиксированное значение. При указании этого типа данных тип фиксированного значения определяется автоматически.
- Из дополнительных свойств документа (по наименованию) — при указании этого типа значение реквизита будет искаться по следующему алгоритму:
- Смотрится, есть ли свойство документа (задается в профилях обмена) с указанным наименованием, которое указывается в колонке Значение.
- Если такое свойство есть и оно заполнено, то определяется тип реквизита документа. Если их несколько (составное), то — массив.
- Перебираются все элементы объектов 1С указанного типа объекта (или нескольких). Первый найденный элемент с наименованием, указанным в свойстве заказа, будет подставлен в реквизит.
Левая нижняя таблица:
В нижней левой части документа отображены все заполняемые табличные части указанного документа (добавление новых табличных частей пока отключено). В колонке Поле XML указывается наименование подчиненного элемента, из которого берутся данные. Если значение не заполнено, то будет создана всего одна строка.
Правая нижняя таблица:
В нижней правой части отображаются все реквизиты указанной табличной части документа. Для того чтобы реквизиты документа отобразились в таблице, необходимо нажать на кнопку Настроить соответствия реквизитов, которая находится в нижней левой таблице.
Заполняются реквизиты так же, как и реквизиты документа, с единственным отличием, что у табличной части больше предопределенных алгоритмов.