Обмен с 1С · CommerceML

Сначала проверка, затем применение

Загрузите XML или ZIP до 50 МБ: с устройства, перетаскиванием, из буфера или по общедоступной HTTPS-ссылке. Обработчик поддерживает CommerceML 2.08, 2.09 и 2.10: объединенные предложения и отдельные файлы номенклатуры, цен и остатков. Чужие форматы и неподдерживаемая валюта отклоняются с отчетом.

Сопоставьте неизвестные варианты, склады и типы цен по внешним идентификаторам. Совпадение названий не создает связь. Новый товар создается черновиком. Проверьте «Было → Станет», затем примените пакет. Ошибка любой строки отменяет применение всего пакета.

Физические остатки и область обновления

Первый профиль ожидает физический остаток, а не свободный. Резервы сайта учитываются отдельно. Частичная выгрузка не обнуляет отсутствующие строки. Для полной замены выберите склады и артикулы явно: добавленные нулевые строки появятся в предпросмотре.

После локальной отгрузки или другой складской операции импорт соответствующего остатка блокируется до сверки. Подтверждайте сверку только когда учетная система уже приняла эти движения — это защищает от повторного появления проданного товара.

POST /api/v1/admin/inventory/command
{"generationId":"FROM_SESSION","idempotencyKey":"apply-001","action":"import.apply","id":"IMPORT_ID","revision":1}

Подключение по HTTP

Адрес: /api/v1/integrations/1c/exchange. Последовательность каталога: checkauth → init → file → import. Отправка заказов: type=sale, mode=query; подтверждение приема: mode=success. checkauth использует Basic Auth и возвращает cookie rr_1c для следующих запросов. Один фрагмент файла — до 5 МБ.

Для реального подключения задаются отдельные серверные INVENTORY_1C_USER и INVENTORY_1C_PASSWORD. Автоприменение включается INVENTORY_1C_AUTO_APPLY=true только после сопоставления и проверки источника. Без этих данных протокол сообщает, что подключение не настроено; загрузка файла в админке продолжает работать.

Файловый обработчик и протокол реализованы в магазине. Конкретная конфигурация 1С пока не предоставлена: проверка ее выгрузок, статусов заказов и производственного обмена выполняется при подключении.

GET /api/v1/integrations/1c/exchange?type=catalog&mode=checkauth
GET /api/v1/integrations/1c/exchange?type=catalog&mode=init
POST /api/v1/integrations/1c/exchange?type=catalog&mode=file&filename=offers.xml
GET /api/v1/integrations/1c/exchange?type=catalog&mode=import&filename=offers.xml

Повтор, конфликт и запоздалая выгрузка

Одинаковый исходный файл распознается по контрольной сумме. Повтор не создает движений. Если после предпросмотра кто-то изменил цену или остаток, применение возвращает конфликт: обновите проверку и оцените разницу заново.

Дата выгрузки сравнивается с уже принятым источником. Старый пакет не заменяет более новые данные. Сеанс обмена связан с текущим часом демо; после сброса повторная авторизация обязательна.