Настройка обмена документами между 1С и 1С-Битрикс
Под «обменом документами» понимают передачу на сайт счетов, актов, накладных, сформированных в 1С — чтобы клиент мог скачать их из личного кабинета. Стандартный CommerceML для этого не предназначен, поэтому реализация всегда кастомная.
Архитектура: как передаются документы
Два основных подхода:
1. 1С генерирует PDF → сохраняет файл → Битрикс забирает по расписанию. 1С формирует печатную форму документа, сохраняет PDF в сетевую папку или на FTP. Битрикс по крону сканирует папку, привязывает файлы к заказам по номеру.
2. Битрикс запрашивает документ у 1С через REST API по требованию. Покупатель нажимает «Скачать счёт» → Битрикс делает HTTP-запрос к публикации 1С → 1С возвращает PDF-файл. Документ не хранится на сайте постоянно.
Второй подход предпочтительнее: актуальная версия документа всегда из 1С, нет проблем с синхронизацией.
Привязка документов к заказам
Для связки документа с заказом нужен общий идентификатор. В 1С это номер документа «Заказ покупателя», на сайте — ACCOUNT_NUMBER заказа. При настройке обмена убедиться, что номера совпадают (не ID Битрикс, а ACCOUNT_NUMBER).
Хранение документов в личном кабинете
Если выбран подход с хранением файлов на сайте — привязка к заказу через highload-блок:
| Поле | Описание |
|---|---|
UF_ORDER_ID |
ID заказа в Битрикс |
UF_DOC_TYPE |
Тип: счёт / акт / накладная |
UF_DOC_NUMBER |
Номер документа |
UF_DOC_DATE |
Дата документа |
UF_FILE |
Файл (тип File) |
Права доступа
Покупатель должен видеть только свои документы. В компоненте личного кабинета фильтрация по UF_ORDER_ID с проверкой, что заказ принадлежит текущему пользователю.
Сроки настройки
Реализация выгрузки документов через REST API 1С — 2–4 дня. Через файловый обмен с привязкой по номеру — 1–2 дня.