3.1 KiB
Обмен с 1С (CommerceML)
Модуль commerceml принимает стандартный HTTP-обмен 1С и потоково разбирает
XML через XMLReader. Для работы нужны модули Товары и Планировщик.
Это модуль торгового контура: он не публикуется в общем каталоге модулей для
чистой системы.
Безопасный запуск
- Создайте профиль и выберите товарную рубрику.
- Сопоставьте внешний ID, артикул, цену и остаток с реальными полями рубрики.
- Оставьте Создавать неизвестные товары выключенным.
- Загрузите тестовый XML и проверьте журнал.
- После сверки разрешите создание; публикацию новых товаров включайте отдельно.
Адрес обмена: /exchange/1c/<код-профиля>. Для каждого профиля задаются свои
логин и пароль. Пароль хранится в защищённом хранилище секретов и не выводится в
панели. Имена загружаемых файлов нормализуются, разрешён только XML, разбор
выполняется с LIBXML_NONET.
После checkauth сервер создаёт отдельную временную сессию обмена. init,
загрузка частей файла и import принимаются только с выданной cookie
ave_commerceml. Поэтому два последовательных или одновременных обмена не
дописывают XML друг друга. Размер одной части ограничен 20 МБ, общий объём
сессии — 200 МБ. Данные читаются и записываются небольшими блоками, а после
попытки импорта временная сессия удаляется. Незавершённые сессии старше трёх
дней удаляет задание планировщика commerceml.cleanup.
Сначала товар ищется по сохранённой связи внешнего ID, затем по полю артикула. Неизвестная позиция либо пропускается, либо создаётся в выбранной рубрике. Все запуски сохраняют количество обработанных, созданных, обновлённых и ошибочных позиций.
Фильтр commerceml.document.payload позволяет изменить payload перед
сохранением документа. События commerceml.item.failed и
commerceml.import.completed подходят для уведомлений и интеграционного лога.