91 слов | 1 минута

Протокол обмена данными между 1С и 1С-Битрикс

Описание последовательности HTTP-запросов при обмене заказами между 1С:Предприятие и 1С-Битрикс: Управление сайтом.

Последовательность запросов

1. Авторизация (checkauth)

1С отправляет запрос с HTTP-авторизацией:

GET /bitrix/admin/1c_exchange.php?type=sale&mode=checkauth

Битрикс возвращает три строки (разделитель \n):

success
<имя Cookie>
<значение Cookie>

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

2. Инициализация (init)

GET /bitrix/admin/1c_exchange.php?type=sale&mode=init

Битрикс возвращает:

zip=yes           # или zip=no, если ZIP не поддерживается
file_limit=<байт> # максимальный размер файла за один запрос

Если zip=yes — файлы передаются в ZIP-архиве. Если файл превышает file_limit — делится на части.

3. Выгрузка заказов (query)

GET /bitrix/admin/1c_exchange.php?type=sale&mode=query

Битрикс отдаёт заказы в формате CML 2. После успешного получения и записи в 1С отправляется подтверждение:

GET /bitrix/admin/1c_exchange.php?type=sale&mode=success

4. Загрузка файла обмена (file)

POST /bitrix/admin/1c_exchange.php?type=sale&mode=file&filename=<имя файла>

Содержимое файла передаётся в теле POST-запроса.