Налаштування обміну угод Бітрікс24 і 1С: покрокове керівництво

Синхронізація угод між Бітрікс24 та 1С — класичне завдання, яке перетворюється на головний біль, якщо не продумати архітектуру обміну. Типова помилка — прямий обмін через COM-з'єднання без REST, що призводить до втрат даних при розсинхронізації каталогів. Ми налаштовуємо двосторонній обмін так, щоб менеджер працював у CRM, а бухгалтер — у 1С, без ручного перенесення даних. Економія часу на ручному введенні — до 20 годин на місяць. В основі — подієва модель: зміна стадії угоди в Бітрікс24 тригерить створення замовлення в 1С через REST API, а проведення рахунку в 1С оновлює статус у CRM через crm.deal.update. Наш досвід понад 50 проєктів з інтеграції гарантує надійність.

Типовий сценарій роботи

1. Менеджер створює угоду в Бітрікс24, додає товари з каталогу (продукти CRM).
2. При переході на стадію «Узгоджено» — угода автоматично потрапляє до 1С як замовлення покупця.
3. У 1С бухгалтер створює рахунок, проводить реалізацію.
4. Рахунок та статус оплати повертаються до Бітрікс24 — менеджер бачить, чи оплачена угода.

Коли потрібна допомога в налаштуванні обміну угод?

Якщо у вас нестандартна бізнес-логіка — наприклад, кілька статусів оплати або складний мапінг користувацьких полів — самостійне налаштування може затягнутися на тижні. Ми беремо такі проєкти під ключ і вкладаємося в 2–5 днів. Офіційна документація по REST API Бітрікс24

Як налаштувати обмін угод між Бітрікс24 та 1С?

Реалізація залежить від напрямку синхронізації. Розглянемо обидва.

Бітрікс24 → 1С: вебхук або бізнес-процес

Обмін ініціюється подією в Бітрікс24. Два підходи:

Перший — через вебхук на зміну стадії. У налаштуваннях вихідних вебхуків підписуємося на подію ONCRMDEALSTAGECHAGE. При переході угоди на потрібну стадію — POST на обробник.

Другий — через бізнес-процес. Шаблон БП у Бітрікс24 налаштовується на стадію «В роботу». Дія «REST» у БП відправляє дані до HTTP-сервісу 1С. Зручніше для складних умов (наприклад, тільки якщо сума > N гривень).

Отримання повних даних угоди: crm.deal.get → crm.deal.productrows.get → crm.contact.get / crm.company.get. Передача до 1С — через HTTP POST до HTTP-сервісу конфігурації. У 1С створюється «Замовлення покупця» зі складом продуктів угоди.

1С → Бітрікс24: REST API

При зміні статусу замовлення або створенні рахунку в 1С — обробка відправляє дані в Бітрікс24:

// В 1С при проведенні рахунку ДанныеЗапроса = Новый Соответствие; ДанныеЗапроса.Вставить("DEAL_ID", IDСделкиБиткрикс24); ДанныеЗапроса.Вставить("UF_CRM_INVOICE_NUMBER", НомерСчёта); ДанныеЗапроса.Вставить("UF_CRM_INVOICE_URL", URLПDFСчёта); // HTTP-запит до crm.deal.update 

Статус оплати — через crm.deal.update на поле UF_CRM_PAYMENT_STATUS (користувацьке поле, створене заздалегідь). Якщо потрібен PDF рахунку в картці угоди, 1С завантажує його на Бітрікс.Диск і прикріплює до угоди.

Чому важливий мапінг продуктів?

Продукти в каталозі CRM Бітрікс24 та номенклатура 1С — дві різні бази. Варіанти синхронізації:

• Простий мапінг за артикулом. При передачі угоди шукаємо номенклатуру в 1С за артикулом з поля PROPERTY_ARTNUMBER продукту CRM.
• Синхронізований каталог. Номенклатура 1С вивантажується в каталог CRM Бітрікс24 через REST API crm.product.add. XML_ID продукту CRM = ID номенклатури 1С. При передачі угоди — прямий мапінг за XML_ID.

Другий варіант надійніший, але вимагає налаштування синхронізації каталогу. Ми в проєктах завжди використовуємо його, щоб уникнути помилок.

Як уникнути дублів при синхронізації?

При двосторонньому обміні важливо зберігати перехресні ідентифікатори:

• В угоді Бітрікс24 — користувацьке поле UF_CRM_1C_ORDER_ID з ID замовлення 1С
• В замовленні 1С — реквізит «ID угоди Бітрікс24»

Це дозволяє при повторній синхронізації оновити існуюче замовлення, а не створювати нове. Додатково налаштовуємо логування та сповіщення про помилки.

Порівняння підходів до ініціалізації обміну

Що входить у налаштування обміну

Замовте налаштування інтеграції під ключ — ми оцінимо ваш проєкт за 1 день та гарантуємо коректну роботу обміну. Зв'яжіться з нами для розрахунку строків.