Налаштування друку документів 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 разів. Ми гарантуємо працездатність рішення на всіх етапах: від проектування до підтримки.

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