Налаштування обміну рахунків Бітрікс24 та 1С

Налаштування обміну рахунків Бітрикс24 та 1С

Бітрикс24 вміє виставляти рахунки прямо з CRM — менеджер натискає кнопку, клієнт отримує PDF. Але бухгалтерія працює у 1С, і рахунок потрібна там теж: для проводки, контролю оплат, формування книги продаж. Копіювати руками — це помилки та трата часу. Завдання синхронізації рахунків — передати документ з CRM у облікову систему автоматично, без подвійного введення даних.

Як влаштований обмін

Стандартний обмін Бітрикса24 з 1С будується на базі модуля crm та протоколу CommerceML (XML-формат для обміну комерційними документами). Для рахунків використовується механізм, відмінний від обміну замовленнями інтернет-магазину: CRM-рахунки передаються через REST API Бітрикса24 або через штатний модуль інтеграції з 1С.

Два варіанти інтеграції:

1. Через REST API (crm.invoice.* або crm.item.* для смарт-рахунків). Сторонній скрипт або модуль 1С запитує Бітрикс24 та отримує нові/змінені рахунки. Гнучко, але вимагає розробки на стороні 1С.

2. Через штатний модуль 1С-Бітрикс24. У Бітриксі24 є вбудований механізм вивантаження даних для 1С (Налаштування → Інтеграція з 1С). Він працює за CommerceML: 1С ініціює сеанс, Бітрикс видає XML з документами.

Рахунки у CRM: старі та смарт

У Бітриксі24 існує дві сутності рахунку:

• Старі рахунки (CRM_INVOICE) — застарілий тип, зберігається у таблиці b_crm_invoice. Доступні через crm.invoice.list, crm.invoice.get.
• Смарт-рахунки (SMART_INVOICE) — сучасний варіант на базі смарт-процесів CRM. Доступні через crm.item.list з entityTypeId = 31.

При налаштуванні обміну важливо розуміти, який тип використовується у конкретному порталі. Якщо перейшли на смарт-рахунки — старі методи не працюють.

Що передається у 1С

Мінімально необхідні дані для проводки у 1С:

Номенклатура у Бітриксі та 1С має мати спільний ідентифікатор — звичайно артикул або XML_ID. Без цього сопоставлення товарних позицій неможливе.

Порядок налаштування

1. Визначити тип рахунків (старі або смарт), вибрати метод передачі (REST або CommerceML).
2. Налаштувати користувача для інтеграції з правами на читання CRM.
3. Налаштувати веб-хук або вхідний вебхук Бітрикса24 для сповіщення 1С про новий рахунок.
4. На стороні 1С налаштувати обмін: додати вузол обміну, вказати адресу Бітрикса24, періодичність.
5. Провести тестову синхронізацію, звірити дані рахунку.
6. Налаштувати зворотну передачу статусу оплати з 1С у Бітрикс24 — щоб менеджер бачив, оплачений рахунок або ні.

Обмін зазвичай налаштовується за 1 робочий день при умові, що у 1С уже є фахівець, який конфігурує сторону 1С.