Налаштування друку документів 1С з Бітрікс24

Як працює друк з Бітрікс24

Менеджер працює в Бітрікс24 CRM — веде угоду, спілкується з клієнтом через вбудований месенджер. У якийсь момент потрібно виставити рахунок. Раніше це означало: відкрити 1С, знайти контрагента, створити документ, зберегти PDF, повернутися в Бітрікс24, прикріпити файл. П'ять перемикань контексту заради однієї дії. Налаштування друку документів 1С з Бітрікс24 прибирає це перемикання. Ми налаштовуємо цей зв'язок так, щоб менеджеру не доводилося покидати CRM. Вся операція — від натискання кнопки до отримання PDF — займає секунди. Це скорочує час виставлення рахунків з годин до хвилин і виключає помилки ручного копіювання даних. Наш досвід показує, що така інтеграція окупається за перший місяць.

Під «друком документів 1С з Бітрікс24» розуміється кілька пов'язаних сценаріїв:

• Формування PDF документа (рахунок, УПД, накладна, акт) в 1С — прямо з картки угоди або контрагента в Бітрікс24
• Відправка документа клієнту — через email, месенджер, або посилання для завантаження
• Збереження документа в Бітрікс24 Drive — прив'язка до угоди або контакту

Технічно це реалізується через HTTP-сервіс в 1С, який отримує запит з Бітрікс24 і повертає готовий PDF.

HTTP-сервіс в 1С для генерації документів

Створюємо в 1С (УТ, КА, ERP) HTTP-сервіс з методом POST /hs/documents/print. Запит:

{
  "document_type": "invoice",
  "order_id": "bitrix_order_123",
  "counterparty_guid": "abc-123-def...",
  "items": [
    {"guid": "товар-guid", "quantity": 5, "price": 1500.00},
    {"guid": "товар2-guid", "quantity": 2, "price": 3200.00}
  ],
  "date": "2024-03-15",
  "api_key": "secret-key"
}

Сервіс в 1С:

1. Знаходить або створює контрагента за counterparty_guid
2. Створює документ (Рахунок на оплату / Замовлення покупця / УПД)
3. Формує друковану форму через стандартний механізм ДрукованаФорма
4. Повертає PDF в base64

{
  "success": true,
  "document_number": "Сч-00001234",
  "document_date": "2024-03-15",
  "document_1c_guid": "документ-guid...",
  "pdf_base64": "JVBERi0xLjQ..."
}

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

Кнопка в інтерфейсі Бітрікс24

Для менеджера потрібна кнопка «Виставити рахунок» прямо в картці угоди. Реалізується через:

Варіант 1: Застосунок Бітрікс24 (Marketplace). Розроблений застосунок додає вкладку в картку угоди. Менеджер бачить форму: вибір документа (рахунок/накладна/акт), список позицій з угоди, кнопка «Сформувати».

Варіант 2: Віджет через REST API. Через CRMActivityUI.EntityDetail Бітрікс24 дозволяє вбудовувати кастомні інтерфейси в картку CRM.

Варіант 3: Роботи/тригери. При переході угоди в певний статус — автоматично формується рахунок в 1С і прикріплюється до угоди. Без участі менеджера.

Варіант 3 — найбільш автоматизований. Підходить, якщо логіка документа стандартна (один тип рахунку для всіх угод даного типу).

Прив'язка позицій угоди до номенклатури 1С

Щоб рахунок в 1С містив правильну номенклатуру — позиції угоди в Бітрікс24 повинні містити XML_ID, що збігається з GUID номенклатури в 1С. Це забезпечується через каталог продуктів Бітрікс24, синхронізований з 1С (або через обмін через Бітрікс-сайт, або через пряму синхронізацію каталогу Бітрікс24 з 1С через REST API).

Якщо синхронізації каталогу немає — можна передавати позиції за найменуванням, але тоді в 1С створюватиметься «невідома номенклатура», і бухгалтер повинен буде її уточнювати вручну.

Які документи можна друкувати

Кожен тип документа — окремий endpoint в HTTP-сервісі 1С або параметр document_type в єдиному endpoint.

Кейс: скорочення циклу виставлення рахунку (з нашої практики)

Виробник обладнання: цикл від прийняття замовлення до відправки рахунку клієнту — 2–4 години (очікування, поки бухгалтер не відкриє 1С і не виставить рахунок). Клієнт міг зателефонувати раніше.

Після інтеграції: менеджер у картці угоди Бітрікс24 натискає «Виставити рахунок», заповнює кількість і дату — через 3 секунди рахунок-PDF прикріплений до угоди та відправлений клієнту по email через задачу. Бухгалтер отримує сповіщення про створений рахунок в 1С.

Головний бухгалтер: «Раніше на виставлення рахунку йшло до 30 хвилин, тепер — 5. Помилки зникли».

Цикл скоротився з 2–4 годин до 5 хвилин. Інтеграція виявилася в 10 разів швидшою за ручне перенесення. Виключили випадки «забутих» рахунків, які раніше осідали в списку завдань менеджера. Економія становила близько 300 000 рублів на місяць на трудозатратах бухгалтерії, що зекономило компанії майже 2 млн рублів на рік. Додатково налаштували автоматичне створення рахунку при переведенні угоди в статус «Рахунок виставляється» — через робота Бітрікс24, який викликає webhook, що запускає HTTP-запит до 1С.

Скільки часу займає налаштування?

Термін залежить від складності. Базове налаштування одного типу документа (рахунок) займає 1-2 дні. Повний цикл з роботами та всіма документами — до 5 днів. Точні терміни визначаємо після аудиту поточної схеми документообігу.

Типові помилки при інтеграції

• Неправильний GUID номенклатури: синхронізуйте каталог продуктів
• Відсутність API-ключа в 1С: перевіряйте заголовок запиту
• Перевантаження сервера 1С: додайте обмеження за частотою запитів

Що входить у роботу

• Аудит поточної схеми документообігу та конфігурацій 1С
• Розробка HTTP-сервісу в 1С під потрібні типи документів
• Створення кнопки в картці угоди Бітрікс24 (застосунок/віджет/робот)
• Налаштування синхронізації номенклатури (якщо потрібно)
• Тестування всіх сценаріїв: штатна робота, помилки, навантаження
• Навчання менеджерів та бухгалтерів
• Документація з експлуатації та схема інтеграції

Чому варто автоматизувати друк?

Ручне перенесення даних з Бітрікс24 в 1С — джерело помилок: переплутані контрагенти, невірні суми, забуті рахунки. Інтеграція виключає людський фактор і прискорює операцію в 5-10 разів. Ми гарантуємо працездатність рішення на всіх етапах: від проектування до підтримки.

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

Як відкриті лінії змінюють комунікацію?

Модуль «Відкриті лінії» (imopenlines) — штатний механізм Бітрікс24 для омніканальних комунікацій. Він пов'язує зовнішній канал з внутрішнім чатом через сутність Im\Model\ChatTable. Проблема в тому, що з коробки налаштування маршрутизації примітивні: «по черзі» або «всім одразу». Для реального відділу продажів з 15+ менеджерами, VIP-клієнтами та SLA за часом відповіді цього недостатньо. Ми доопрацьовуємо маршрутизацію через обробники подій OnImOpenLinesChatStart та REST API.

Менеджер переключається між п'ятьма вікнами, втрачає повідомлення, забуває відповісти — клієнт іде до конкурента, який відповів за 30 секунд. Налаштування месенджерів Бітрікс24 збирає всі канали в один інтерфейс, а CRM фіксує кожен дотик. Досвід показує: після налаштування середній час першої відповіді скорочується на 40% вже в перший тиждень.

Як ми реалізуємо інтеграцію месенджерів

Підключаємо Telegram, WhatsApp, Viber, VK, онлайн-чат, Email та інші канали через штатні конектори або REST API. Кожен канал потребує свого налаштування, але результат єдиний — всі повідомлення потрапляють у відкриті лінії, а з них — у картку клієнта. Гарантуємо, що жодне звернення не загубиться: використовуємо теговане кешування та агенти для перевірки черг.

Як підключити WhatsApp до Бітрікс24?

WhatsApp — головний бізнес-канал. Інтеграція через WhatsApp Business API з верифікованим акаунтом. Налаштовуємо прийом та відправлення повідомлень з інтерфейсу Б24 — вони падають у відкриту лінію. Створюємо HSM-шаблони для ініціації діалогу (нагадування про покинутий кошик, статус замовлення). Шаблони проходять модерацію Meta — закладайте 2-3 дні. Забезпечуємо передачу файлів, зображень, документів. Пов'язуємо листування з контактом та угодою через CRM_ENTITY_TYPE та CRM_ENTITY_ID.

Telegram: безкоштовний канал з високим охопленням

Telegram Bot API безкоштовний і добре документований — приємна рідкість серед месенджерів. Інтеграція в Бітрікс24 виконується через конектор imopenlines. Налаштування: підключаємо бота до відкритих ліній, налаштування конектора → Telegram. Прийом повідомлень, фото, відео, документів — все маппиться в чат Б24. Inline-кнопки та reply-клавіатури для навігації. Webhook для реєстрації конектора. Інтеграція з CRM: вхідне повідомлення створює лід через crm.lead.add або активність в угоді.

Telegram незамінний для:

• Підтримки через бота — типові питання закриваються без оператора (до 70% звернень).
• Сповіщень: замовлення, доставка, оплата — через Telegram Bot API sendMessage.
• Збору лідів: бот задає кваліфікуючі питання → створює лід.

Viber та VK: аудиторія 35+ та соцмережа

Viber тримає позиції в регіонах. Підключаємо бізнес-акаунт через конектор відкритих ліній. Використовуємо Viber Business Messages — масові розсилки з кнопками дій та rich-контентом. Прийом та відправлення з CRM працюють одразу.

VK (ВКонтакті) — найбільша соцмережа. Інтеграція через конектор imopenlines повідомлень спільноти. Обробка повідомлень та коментарів з єдиного інтерфейсу. Автостворення ліда — обробник OnImOpenLinesCrmCreate. Інтеграція з VK Рекламою для трекінгу джерел через UTM. Бот для авто-відповідей — VK Bot API + Callback API.

Чому важлива правильна маршрутизація звернень?

Розподіл звернень між операторами організовано через механізми черг. За замовчуванням — «хто вільний». У реальності потрібно складніше:

• Визначення відповідального за номером або email з CRM — im.chat.get + пошук по crm.contact.list.
• Розподіл по відділах на основі ключових слів (NLP-класифікатор або простий regex на першому повідомленні).
• Пріоритетна черга для VIP — по сегменту в CRM.
• Ескалація при таймауті 5 хвилин — автопереключення на наступного.
• Перехід на дзвінок прямо з чату — telephony.externalcall.register.

Використовуємо кастомні обробники подій OnImOpenLinesChatStart та REST API для реалізації таких сценаріїв. Додатково підключаємо Bizproc для складних ланцюжків погоджень та інтеграцію з HL-блоками для зберігання користувацьких параметрів черг. Результат: клієнт не чекає, оператор не перевантажений.

Що входить у роботу з інтеграції месенджерів

Чат-боти: сценарні та з NLP

Типи

Сценарні (rule-based): кнопкове меню, дерево рішень. «Як оплатити» → «Де моє замовлення» → «Години роботи». Передача на оператора при intent == 'unknown' → transfer_to_queue. Надійно, передбачувано, покриває 60-70% типових звернень.

З NLP: вільний текст на українській або російській. Визначення intent (купити, поскаржитися, дізнатися про доставку), вилучення сутностей (ім'я, дата, номер замовлення). Контекстний діалог — пам'ятає, про що говорили. Реалізуємо на Rasa або Dialogflow, інтеграція з Б24 через REST.

use Bitrix\Main\Loader;
use Bitrix\Imopenlines\Model\SessionTable;

Loader::includeModule('imopenlines');

$eventManager = \Bitrix\Main\EventManager::getInstance();
$eventManager->addEventHandler('imopenlines', 'OnImOpenLinesMessageReceive', function($event) {
    $message = $event->getParameter('message');
    $chatId = $event->getParameter('chatId');
    
    if (preg_match('/статус заказа (\d+)/i', $message, $matches)) {
        $orderId = $matches[1];
        // Отримуємо статус замовлення через API
        $order = \Bitrix\Sale\Order::load($orderId);
        if ($order) {
            $status = $order->getField('STATUS_ID');
            \Bitrix\ImOpenLines\Chat::sendMessage($chatId, 'Ваш заказ №' . $orderId . ' в статусе: ' . $status);
        }
    }
});

Сценарії та реальний ефект

Порівняння: сценарний бот обробляє запити в 5 разів швидше оператора, а NLP-бот знижує fallback rate до 15% після навчання на реальних діалогах. Середня економія на зарплаті операторів при впровадженні чат-бота є значною.

Процес розробки

1. Аналіз звернень — вивантажуємо історію з відкритих ліній, кластеризуємо за темами. Визначаємо 80% типових запитів.
2. Проектування діалогів — карта на miro/figma. Кожна гілка закінчується або відповіддю, або передачею оператору.
3. Розробка — логіка, інтеграція з CRM та зовнішніми API. Для сценарних — кінцевий автомат на станах. Для NLP — pipeline: tokenizer → featurizer → classifier → response selector.
4. Навчання NLP — на реальних діалогах (не менше 500 прикладів). Налаштування threshold confidence.
5. Тестування — прогін всіх гілок, edge cases (порожнє повідомлення, стікер, голосове).
6. Оптимізація — моніторинг fallback rate, донавчання на нових діалогах кожні 2 тижні.

Терміни

Результат — всі звернення в єдиному вікні, рутина автоматизована, жодне повідомлення не губиться. Менеджери продають, а не шукають потрібний чат. Оцініть, які канали потрібні саме вам, — напишіть, підберемо під вашу нішу. Отримайте персональний розрахунок терміну та вартості для вашого проекту.