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

Данный открытый протокол разработан компаниями «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</Код>
                <Наименование>Лак мебельный</Наименование>
                <БазоваяЕдиница Код="625" НаименованиеПолное="Лист" МеждународноеСокращение="LEF"/>
                <Группы>
                    <Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                </Группы>
                <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Категория>
                <Описание/>
                <СтавкиНалогов>
                    <СтавкаНалога>
                        <Наименование>НДС</Наименование>
                        <Ставка>20</Ставка>
                    </СтавкаНалога>
                </СтавкиНалогов>
                <ЗначенияРеквизитов>
                    <ЗначениеРеквизита>
                        <Наименование>ВидНоменклатуры</Наименование>
                        <Значение>Товар</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>ТипНоменклатуры</Наименование>
                        <Значение>Запас</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>Полное наименование</Наименование>
                        <Значение>Лак мебельный</Значение>
                    </ЗначениеРеквизита>
                </ЗначенияРеквизитов>
            </Товар>
            <Товар>
                <Ид>f8c9ef4c-47e1-11e5-8073-74d02b7dfd8c</Ид>
                <Артикул/>
                <Код>ФР-00000224</Код>
                <Наименование>Клей ПВА столярный</Наименование>
                <БазоваяЕдиница Код="166" НаименованиеПолное="Килограмм" МеждународноеСокращение="KGM"/>
                <Группы>
                    <Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                </Группы>
                <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Категория>
                <Описание/>
                <СтавкиНалогов>
                    <СтавкаНалога>
                        <Наименование>НДС</Наименование>
                        <Ставка>20</Ставка>
                    </СтавкаНалога>
                </СтавкиНалогов>
                <ЗначенияРеквизитов>
                    <ЗначениеРеквизита>
                        <Наименование>ВидНоменклатуры</Наименование>
                        <Значение>Товар</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>ТипНоменклатуры</Наименование>
                        <Значение>Запас</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>Полное наименование</Наименование>
                        <Значение>Клей ПВА столярный</Значение>
                    </ЗначениеРеквизита>
                </ЗначенияРеквизитов>
            </Товар>
            <Товар>
                <Ид>f8c9ef5f-47e1-11e5-8073-74d02b7dfd8c</Ид>
                <Артикул/>
                <Код>ФР-00000226</Код>
                <Наименование>Гелькоут</Наименование>
                <БазоваяЕдиница Код="166" НаименованиеПолное="Килограмм" МеждународноеСокращение="KGM"/>
                <Группы>
                    <Ид>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</Код>
                <Наименование>Жидкий гранит (наполнитель)</Наименование>
                <БазоваяЕдиница Код="166" НаименованиеПолное="Килограмм" МеждународноеСокращение="KGM"/>
                <Группы>
                    <Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                </Группы>
                <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Категория>
                <Описание/>
                <СтавкиНалогов>
                    <СтавкаНалога>
                        <Наименование>НДС</Наименование>
                        <Ставка>20</Ставка>
                    </СтавкаНалога>
                </СтавкиНалогов>
                <ЗначенияРеквизитов>
                    <ЗначениеРеквизита>
                        <Наименование>ВидНоменклатуры</Наименование>
                        <Значение>Товар</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>ТипНоменклатуры</Наименование>
                        <Значение>Запас</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>Полное наименование</Наименование>
                        <Значение>Жидкий гранит (наполнитель)</Значение>
                    </ЗначениеРеквизита>
                </ЗначенияРеквизитов>
            </Товар>
            <Товар>
                <Ид>f8c9ef61-47e1-11e5-8073-74d02b7dfd8c</Ид>
                <Артикул/>
                <Код>ФР-00000228</Код>
                <Наименование>Отвердитель</Наименование>
                <БазоваяЕдиница Код="166" НаименованиеПолное="Килограмм" МеждународноеСокращение="KGM"/>
                <Группы>
                    <Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                </Группы>
                <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Категория>
                <Описание/>
                <СтавкиНалогов>
                    <СтавкаНалога>
                        <Наименование>НДС</Наименование>
                        <Ставка>20</Ставка>
                    </СтавкаНалога>
                </СтавкиНалогов>
                <ЗначенияРеквизитов>
                    <ЗначениеРеквизита>
                        <Наименование>ВидНоменклатуры</Наименование>
                        <Значение>Товар</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>ТипНоменклатуры</Наименование>
                        <Значение>Запас</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>Полное наименование</Наименование>
                        <Значение>Отвердитель</Значение>
                    </ЗначениеРеквизита>
                </ЗначенияРеквизитов>
            </Товар>
            <Товар>
                <Ид>429c2703-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                <Артикул>503</Артикул>
                <Код>ФР-00000021</Код>
                <Наименование>Пластик ПВХ</Наименование>
                <БазоваяЕдиница Код="625" НаименованиеПолное="Лист" МеждународноеСокращение="LEF"/>
                <Группы>
                    <Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                </Группы>
                <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Категория>
                <Описание/>
                <Страна>РОССИЯ</Страна>
                <СтавкиНалогов>
                    <СтавкаНалога>
                        <Наименование>НДС</Наименование>
                        <Ставка>20</Ставка>
                    </СтавкаНалога>
                </СтавкиНалогов>
                <ЗначенияРеквизитов>
                    <ЗначениеРеквизита>
                        <Наименование>ВидНоменклатуры</Наименование>
                        <Значение>Товар</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>ТипНоменклатуры</Наименование>
                        <Значение>Запас</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>Полное наименование</Наименование>
                        <Значение>Пластик ПВХ</Значение>
                    </ЗначениеРеквизита>
                </ЗначенияРеквизитов>
            </Товар>
            <Товар>
                <Ид>429c2704-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                <Артикул>504</Артикул>
                <Код>ФР-00000022</Код>
                <Наименование>Пластиковая кромка</Наименование>
                <БазоваяЕдиница Код="616" НаименованиеПолное="Бобина" МеждународноеСокращение="NBB"/>
                <Группы>
                    <Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                </Группы>
                <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Категория>
                <Описание/>
                <Страна>РОССИЯ</Страна>
                <СтавкиНалогов>
                    <СтавкаНалога>
                        <Наименование>НДС</Наименование>
                        <Ставка>20</Ставка>
                    </СтавкаНалога>
                </СтавкиНалогов>
                <ЗначенияРеквизитов>
                    <ЗначениеРеквизита>
                        <Наименование>ВидНоменклатуры</Наименование>
                        <Значение>Товар</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>ТипНоменклатуры</Наименование>
                        <Значение>Запас</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>Полное наименование</Наименование>
                        <Значение>Пластиковая кромка</Значение>
                    </ЗначениеРеквизита>
                </ЗначенияРеквизитов>
            </Товар>
            <Товар>
                <Ид>429c2705-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                <Артикул>505</Артикул>
                <Код>ФР-00000023</Код>
                <Наименование>Клей ПВХ</Наименование>
                <БазоваяЕдиница Код="166" НаименованиеПолное="Килограмм" МеждународноеСокращение="KGM"/>
                <Группы>
                    <Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                </Группы>
                <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Категория>
                <Описание/>
                <Страна>РОССИЯ</Страна>
                <СтавкиНалогов>
                    <СтавкаНалога>
                        <Наименование>НДС</Наименование>
                        <Ставка>20</Ставка>
                    </СтавкаНалога>
                </СтавкиНалогов>
                <ЗначенияРеквизитов>
                    <ЗначениеРеквизита>
                        <Наименование>ВидНоменклатуры</Наименование>
                        <Значение>Товар</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>ТипНоменклатуры</Наименование>
                        <Значение>Запас</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>Полное наименование</Наименование>
                        <Значение>Клей ПВХ</Значение>
                    </ЗначениеРеквизита>
                </ЗначенияРеквизитов>
            </Товар>
            <Товар>
                <Ид>429c2706-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                <Артикул>506</Артикул>
                <Код>ФР-00000024</Код>
                <Наименование>Пленка ПВХ </Наименование>
                <БазоваяЕдиница Код="006" НаименованиеПолное="Метр" МеждународноеСокращение="MTR"/>
                <Группы>
                    <Ид>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                </Группы>
                <Категория>429c26e0-b5b9-11e4-8355-74d02b7dfd8c</Категория>
                <Описание/>
                <Страна>РОССИЯ</Страна>
                <СтавкиНалогов>
                    <СтавкаНалога>
                        <Наименование>НДС</Наименование>
                        <Ставка>20</Ставка>
                    </СтавкаНалога>
                </СтавкиНалогов>
                <ЗначенияРеквизитов>
                    <ЗначениеРеквизита>
                        <Наименование>ВидНоменклатуры</Наименование>
                        <Значение>Товар</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>ТипНоменклатуры</Наименование>
                        <Значение>Запас</Значение>
                    </ЗначениеРеквизита>
                    <ЗначениеРеквизита>
                        <Наименование>Полное наименование</Наименование>
                        <Значение>Пленка ПВХ</Значение>
                    </ЗначениеРеквизита>
                </ЗначенияРеквизитов>
            </Товар>
            <Товар>
                <Ид>429c2707-b5b9-11e4-8355-74d02b7dfd8c</Ид>
                <Артикул>507</Артикул>
                <Код>ФР-00000025</Код>
                <Наименование>Столешница</Наименование>
                <БазоваяЕдиница Код="055" НаименованиеПолное="Квадратный метр" МеждународноеСокращение="MTK"/>
                <Группы>
                    <Ид>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</Код>
                <Наименование>Доводчик двери</Наименование>
                <БазоваяЕдиница Код="796" НаименованиеПолное="Штука" МеждународноеСокращение="PCE"/>
                <Группы>
                    <Ид>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.

слово «success»;
имя Cookie;
значение 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» и другими.