Налаштування обміну документами між 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 дні.