Налаштування формування рахунків-фактур із Бітрікс24 у 1С
Класичний біль: менеджер закриває угоду в Бітрікс24, а бухгалтер чекає, поки йому пересилають дані поштою або записують у загальний файл. Рахунок-фактура створюється вручну в 1С з помилками — ІПН не той, найменування товару написано інакше, сума розходиться через округлення. Налаштування автоматичного формування рахунків-фактур із Бітрікс24 у 1С закриває цей розрив.
Як дані передаються з Бітрікс24 у 1С
Бітрікс24 не генерує рахунок-фактуру безпосередньо — це завдання 1С як облікової системи. Бітрікс24 передає дані угоди, на основі яких 1С формує документ. Передача відбувається одним із двох шляхів:
Стандартний модуль синхронізації — Бітрікс24 ↔ 1С через REST API або COM-з'єднання. Модуль входить до коробкового Бітрікс24 (crm.requisite, crm.invoice). При закритті угоди або виставленні рахунку в CRM дані реплікуються в 1С.
Пряма інтеграція через REST API — webhook на подію OnCrmInvoiceAdd/OnCrmInvoiceUpdate викликає обробник, який формує в 1С документ «Рахунок-фактура виданий» через OData-сервіс або XML-обмін.
Для більшості компаній працює перший варіант при коректному налаштуванні реквізитів.
Що потрібно налаштувати в Бітрікс24 перед запуском
Реквізити контрагентів. Рахунок-фактура без ІПН і КПП покупця — недійсний документ. У CRM → Реквізити кожен контакт і компанія мають мати заповнені поля: ІПН, КПП, юридична адреса. Якщо дані тягнуться зі сторонніх джерел (сайт, лід-форма) — налаштовується автозаповнення через ФПС (dadata або аналог).
Номенклатура. Товари в каталозі Бітрікс24 мають мати прив'язку до номенклатурних позицій 1С. Це XML ID або зовнішній код товару. Без цього 1С не зрозуміє, що створювати в рядках рахунку-фактури.
Ставки ПДВ. У налаштуваннях каталогу Бітрікс24 для кожного товару вказується ставка ПДВ (0%, 10%, 20%, без ПДВ). Це поле має точно відповідати налаштуванням у 1С — інакше суми в рахунку-фактурі будуть розходитися.
Налаштування зв'язку Бітрікс24 → 1С для документів
У 1С (на прикладі 1С:Бухгалтерія 3.0) налаштовується план обміну БітрікcCRM або використовується зовнішня обробка завантаження.
Ключові параметри обробки:
| Параметр | Опис |
|---|---|
| Джерело даних | REST API Бітрікс24 (URL + ключ застосунку) |
| Тип документа | «Рахунок-фактура виданий» |
| Правила маппінгу | Поле CRM → Реквізит 1С |
| Умова запуску | Статус угоди = «Перемога» або окремий статус рахунку |
| Режим дублів | Перевірка за номером рахунку з CRM |
Маппінг реквізитів — найбільш трудомістке місце. Типова таблиця відповідностей:
| Поле Бітрікс24 | Реквізит 1С |
|---|---|
COMPANY_ID → ІПН |
Контрагент (пошук за ІПН) |
OPPORTUNITY |
Сума документа |
PRODUCT_ROWS[].PRICE |
Ціна в рядку |
PRODUCT_ROWS[].TAX_RATE |
Ставка ПДВ |
DATE_CLOSE |
Дата документа |
Кейс: виробнича компанія, 40 угод на місяць
Компанія займається постачанням промислового обладнання. До автоматизації бухгалтер витрачала 2–3 години на день на ручне введення рахунків-фактур у 1С за даними з Бітрікс24. Помилки в ІПН контрагентів виникали в середньому по 2–3 документи на місяць — це затримки оплати і зайві переговори з контрагентами.
Після налаштування інтеграції: при переведенні угоди в статус «Рахунок виставлено» в Бітрікс24 запускається webhook, обробник на PHP викликає OData-сервіс 1С і створює чернетку «Рахунку-фактури виданого». Бухгалтер бачить документ у статусі «До перевірки», переглядає і проводить одним кліком. Час на обробку одного документа скоротився з 7 хвилин до 40 секунд.
Строк реалізації під ключ: 3–5 робочих днів — включаючи налаштування маппінгу, тестування на реальних даних і навчання бухгалтера.
Типові проблеми
Рахунок-фактура створюється з порожнім покупцем — у CRM у угоди не заповнено контрагент, або ІПН у реквізитах написано з пробілами. Перед передачею в 1С додається валідація через регулярний вираз: ІПН має бути 10 або 12 цифр без пробілів.
Дублювання документів — якщо webhook спрацьовує кілька разів (повторна зміна статусу, оновлення суми), у 1С з'являються дублі. Вирішується перевіркою унікальності за зовнішнім кодом документа перед створенням.
Розходження ПДВ на копійки — через різний порядок округлення в Бітрікс24 і 1С. Бітрікс24 рахує ПДВ з кожного рядка, 1С може рахувати інакше. Фіксується явною передачею суми ПДВ порядково, а не суми для перерахунку.