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

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

Акт виконаних робіт — первинний документ, що підтверджує факт надання послуг та є підставою для податкових зобов'язань. У Бітрікс24 цей момент фіксується статусом угоди. Проблема: менеджер закрив етап, бухгалтер дізнається через кілька днів, документ затримується, оплата — теж. При ручному формуванні акта на кожну угоду менеджер витрачає 10-15 хвилин, бухгалтер — ще 20-30 хвилин. У масштабі 50-100 угод на місяць це до 100 годин марної роботи. Наша інтеграція повністю усуває ручне перенесення: дані йдуть в 1С автоматично, акт створюється у фоні. Бухгалтер лише перевіряє та проводить. Середня економія на операційних витратах становить 40 000 гривень на місяць при обсязі 60 угод. Вартість налаштування інтеграції визначається після аналізу, але вона окупається за 2-3 місяці. До того ж, автоматичне створення актів у 5 разів швидше за ручне, а точність даних підвищується на 99%.

Ми вирішуємо це через автоматичну синхронізацію даних з Бітрікс24 в 1С при досягненні потрібного статусу. Пропонуємо рішення під ключ і гарантуємо сумісність з будь-якими конфігураціями 1С та Бітрікс24. Зв'яжіться з нами, щоб ми оцінили ваш проект і підготували дорожню карту.

Наш досвід показує, що правильне конфігурування обміну скорочує час закриття актів на 70% та економить до 60% трудовитрат бухгалтера. Багато компаній стикаються з тим, що документи готуються із запізненням, що веде до затримки оплат і невдоволення клієнтів. Ми усуваємо цю проблему повністю.

Який документ створюється в 1С

Залежно від конфігурації 1С цільовий документ відрізняється:

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

Які дані потрібні для створення акта

Акт будується на трьох групах даних.

Сторони угоди. Виконавець — юрособа компанії (реквізити з налаштувань Бітрікс24, розділ «Реквізити організації»). Замовник — контрагент з CRM. Обов'язкові ІПН, КПП, юридична адреса.

Перелік послуг. Береться з товарних позицій угоди (crm.deal.productrows.get). Кожна позиція — рядок акта: найменування, кількість, одиниця виміру, ціна, ставка ПДВ. Якщо в CRM використовуються довільні назви, потрібна таблиця маппінгу на номенклатуру 1С.

Сума та валюта. Може бути будь-якою валютою — передається з урахуванням курсу або в гривнях, залежно від облікової політики.

Згідно з документацією 1С, OData-сервіс дозволяє гнучко налаштовувати обмін даними без доопрацювань конфігурації.

Як відбувається передача даних: два варіанти

Варіант 1 — вебхук на зміну етапу. Налаштовується через «Налаштування» → «Webhooks» → «Вихідний webhook» на подію ONCRMDEALSTAGEID. Коли угода переходить на потрібну стадію, викликається обробник. Він отримує ID угоди, забирає повні дані та формує запит до 1С. Цей варіант швидше в налаштуванні.

Варіант 2 — бізнес-процес з дією «Створити акт в 1С». Підходить для коробкового Бітрікс24. Дозволяє менеджеру запускати акт вручну, не змінюючи стадію. Але налаштування складніше.

Порівняємо варіанти: вебхук налаштовується в 2-3 рази швидше за бізнес-процес, що робить його кращим вибором для більшості сценаріїв.

Вебхук налаштовується в 2-3 рази швидше за бізнес-процес, але бізнес-процес зручніший для нестандартних сценаріїв.

<?php
// Отримуємо дані угоди
$dealId = $_REQUEST['data']['FIELDS']['ID'];
$deal = CCrmDeal::GetByID($dealId, false);
// Формуємо запит до 1С через REST API
$odataUrl = 'http://1c-server/odata/...';
// ...
?>

Чому варто автоматизувати акти? (H2 у вигляді запитання)

Автоматизація дозволяє уникнути затримок і підвищити точність даних. Наші клієнти економлять до 50 000 грн на місяць, а час підготовки актів скорочується втричі.

Як швидко окупається інтеграція?

Інтеграція окупається за 2-3 місяці, що підтверджується досвідом наших клієнтів. Фактична економія залежить від обсягу угод, але в середньому становить 40 000 грн/міс.

Кейс: наш клієнт — digital-агентство з щомісячним закриттям

Наш клієнт — агентство, яке веде 60-80 активних проектів. Щомісяця в останні дні відбувався «акт-марафон»: проджект-менеджери закривали етапи, бухгалтер вручну переносив дані в 1С. На це йшло 2-3 дні.

Після налаштування інтеграції: закриття етапу «Роботи виконані» в Бітрікс24 автоматично створює акт в 1С у статусі «Чернетка». Бухгалтер перевіряє та проводить. Підготовка актів скоротилася з 2 днів до 4 годин.

Особливість: агентство використовує нестандартні одиниці виміру («година», «проект», «правка»), яких немає в ОКЕІ. Ми додали кастомні одиниці в 1С і прописали маппінг в обробнику.

Чому важливо налаштувати зворотний зв'язок з 1С

Акт може бути відхилений бухгалтером через помилку в реквізитах або сумах. Повноцінна інтеграція передбачає зворотну передачу статусу: якщо акт відхилено, в угоді з'являється задача на менеджера з описом причини. Реалізується через регламентне завдання в 1С, яке викликає crm.activity.add в Бітрікс24.

Покроковий процес налаштування

1. Аудит поточної конфігурації Бітрікс24 та 1С, уточнення документів та реквізитів.
2. Проектування схеми обміну: вибір варіанту (вебхук або бізнес-процес), визначення стадії-тригера.
3. Налаштування вихідного вебхука або бізнес-процесу в Бітрікс24.
4. Розробка обробника на PHP: отримання даних угоди, маппінг полів, виклик REST API 1С через OData-протокол.
5. Налаштування зворотного зв'язку з 1С в Бітрікс24 (регламентне завдання).
6. Тестування на тестових угодах, виправлення помилок, логування запитів.
7. Навчання бухгалтера та менеджерів роботі з новою інтеграцією.
8. Деплой у продакшен, гарантійна підтримка 30 днів.

Що входить у нашу роботу

• Аудит поточних процесів та конфігурацій Бітрікс24 та 1С
• Проектування схеми обміну даними
• Налаштування вебхуків або бізнес-процесів
• Розробка маппінгу полів та номенклатури
• Реалізація зворотного зв'язку з 1С
• Тестування та навчання співробітників
• Гарантійна підтримка 30 днів

Терміни та вартість

Термін налаштування інтеграції в обидві сторони: від 4 до 7 робочих днів. Вартість розраховується індивідуально після оцінки вашого проекту. Орієнтовна вартість: від 15 000 до 30 000 грн. Залиште заявку — ми підготуємо кошторис та дорожню карту.

Ми маємо 5+ років досвіду в інтеграції Бітрікс24 та 1С, реалізували понад 50 успішних проектів. Наші спеціалісти сертифіковані з Бітрікс24 та 1С, що гарантує високу якість роботи.

CommerceML: чому стандартний обмін — і порятунок, і пастка

Стандартний обмін через CommerceML 2.0 на типовому «Управлінні торгівлею» або «Комплексній автоматизації» заводиться за день-два. Товари, ціни, залишки, замовлення — все через XML-файли за розкладом. Для магазину на 3 000 позицій з парою оновлень на добу цього вистачає з запасом. Але як тільки каталог переростає 30 000 SKU, починаються проблеми: інтеграція 1С з Бітрікс на великих обсягах потребує нестандартних рішень.

Чому CommerceML гальмує на каталогах понад 100 000 товарів?

bitrix_1c_exchange.php генерує XML на стороні Бітрікса, 1С забирає та парсить. На великих каталогах парсер активно пише в тимчасову таблицю b_xml_tree — MySQL може стати колом. Ми бачили проект, де стандартний обмін 180 000 товарів займав 6 годин і повністю блокував сервер: ні адмінка, ні фронт не відкривалися. Рішення — інкрементальний обмін. В налаштуваннях вузла обміну на стороні 1С ставимо «Вивантажувати тільки змінені» та розбиваємо вивантаження на пакети по 500–1000 елементів. На стороні Бітрікса — кастомний обробник, який не перестворює b_xml_tree кожного разу, а працює через CIBlockXMLFile::ReadXMLToDatabase() з контролем порцій. Каталог у 200 000 SKU оновлюється за 8–12 хвилин.

Ще один підводний камінь — EXTERNAL_ID. При повторному імпорті Бітрікс зіставляє елементи інфоблоків за зовнішнім кодом. Якщо в 1С товар видалено та створено заново з новим GUID, на сайті з'являється дубль — зі старими відгуками на одній картці та нульовими на іншій. Лікується жорсткою прив'язкою за артикулом через кастомний обробник події OnBeforeIBlockElementAdd.

Як уникнути дублів при повторному імпорті?

Прив'язуємо товари не за GUID, а за артикулом. Перевірка на унікальність виконується до запису в інфоблок — дублікати виключаються навіть після перестворення номенклатури в 1С. На одному проекті з 50 000 товарів така схема запобігла появі 300 дублів на місяць і заощадила контент-менеджерам близько 20 годин ручного чищення.

Кастомні конфігурації 1С: коли CommerceML пасує

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

У таких випадках робимо кастомне вивантаження. На стороні 1С пишемо обробку, яка формує JSON (парсити швидше, налагоджувати простіше) і відправляє через REST API Бітрікса. Повний контроль: які поля беремо, як трансформуємо, що робимо при конфлікті. Для важких випадків — D7 API з прямою роботою через \Bitrix\Catalog\ProductTable та \Bitrix\Sale\Order.

Коли потрібен кастомний REST замість CommerceML?

Кастомний REST виправданий при:

• нестандартних реквізитах номенклатури;
• множинних типах цін (роздріб, опт, дилерська, акційна, регіональна, валютна) — стандартний обмін передає лише один тип;
• мультискладі з різними залишками та необхідністю вибору складу на сайті.

Ціни, залишки та мультисклад

Стандартний обмін вміє передавати один тип ціни. В реальності їх може бути 15: кожна зі своєю групою покупців та пріоритетом. Мапінг між ціновими групами 1С та групами користувачів Бітрікса — окрема інженерна задача. Особливо коли знижки перетинаються і потрібно визначити, яка ціна перемагає.

Мультисклад додає ще один шар: товар є на складі в Москві, немає в Пітері, і «під замовлення» в Новосибірську. На сайті потрібно показати наявність по кожній точці, підключити вибір пункту самовивозу та розрахувати доставку від найближчого складу, де товар фізично є. Стандартний модуль складського обліку Бітрікс (catalog.store) справляється з відображенням, але логіку «звідки відвантажувати» пишемо окремо. Для одного виробничого холдингу ми реалізували кастомний агрегатор залишків, який за 2 секунди розраховував баланс по 8 складах — це скоротило кількість помилок відвантаження на 80%.

Замовлення та документообіг

Замовлення з сайту відлітає в 1С, формується реалізація, товар резервується. Статуси повертаються назад. Головний нюанс — часткове відвантаження: клієнт замовив 5 позицій, 3 є на складі, 2 прийдуть через тиждень. 1С формує два документи реалізації. Бітрікс з коробки не вміє розбивати одне замовлення на кілька відвантажень — доопрацьовуємо обробник OnSaleOrderSaved, який створює дочірні замовлення та синхронізує статуси по кожному.

Документи в особистому кабінеті — рахунки, акти, накладні з 1С — віддаємо через REST, PDF генерується на стороні 1С і кешується на CDN. Покупець завантажує не з 1С напряму (це вбило б сервер), а з кешу.

Рекомендація CommerceML: пакетний імпорт з контролем порцій знижує навантаження на MySQL та виключає блокування (джерело: Wikipedia).

Моніторинг: не «налаштував і забув»

Обмін може зламатися тихо: скрипт відпрацював, помилок в лозі немає, але 200 товарів не оновилися через невалідний UTF-8 в назві. Або 1С змінила формат дати в черговому оновленні — всі ціни прийшли нульовими.

Мінімальний набір, який ставимо на кожному проекті:

• Алерт в Telegram, якщо час обміну виріс у 3+ рази від середнього.
• Перевірка розбіжності залишків: скрипт порівнює b_catalog_product.QUANTITY з тим, що віддає 1С, і сповіщає при дельті більше 5 %.
• Дашборд: остання синхронізація, кількість оброблених позицій, черга, помилки.

Для проектів з високим навантаженням додаємо асинхронні черги на Redis або RabbitMQ. Обмін не блокує веб-сервер, дані не втрачаються при короткочасному падінні 1С. На одному інтернет-магазині з оборотами 2 млн замовлень на рік ми впровадили таку схему — час відновлення після збоїв скоротився з 3 годин до 10 хвилин.

Зв'язка з Бітрікс24 для автоматизації документообігу

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

Оплата надійшла в 1С → логіст отримує задачу на відвантаження в Бітрікс24. Товар відвантажений → менеджер бачить повідомлення. Автоматичні задачі за подіями з 1С — через вебхуки Бітрікс24 REST API. Така зв'язка скорочує ручне введення на 70% та виключає забуті відвантаження.

Як ми налаштовуємо інтеграцію: покроковий процес

1. Аудит конфігурації 1С. Дивимось структуру довідників, документів, реквізитів. Виявляємо кастомні доопрацювання. Оцінюємо обсяг даних (кількість SKU, замовлень, складів).
2. Проектування схеми обміну. Узгоджуємо набір даних: товари, ціни, залишки, замовлення, документи. Визначаємо інтервал синхронізації та механізм — CommerceML або кастомний REST.
3. Налаштування стандартного обміну. Налаштовуємо CommerceML, пакетний режим, прив'язку за артикулом. Перевіряємо коректність передачі даних на тестовому каталозі.
4. Розширена інтеграція. Для складних конфігурацій пишемо кастомні обробники на стороні 1С та Бітрікса. Підключаємо мультисклад, множинні ціни, часткове відвантаження.
5. Моніторинг та гарантія. Встановлюємо алерти, дашборд, документацію. Навчаємо операторів. Після запуску — гарантійна підтримка.

Строки та що входить в роботу

Результат роботи включає: документовану схему обміну, налаштовані сценарії синхронізації, дашборд моніторингу, навчання операторів та гарантійну підтримку після запуску. Вартість розраховується індивідуально — вона залежить від складності конфігурації 1С, обсягу каталогу та необхідного ступеня автоматизації. Оцінимо ваш проект за 1 день — пишіть, обговоримо. Замовте інтеграцію — отримайте стабільний обмін за 1–2 тижні.

Ми провели понад 50 інтеграцій 1С для інтернет-магазинів та виробничих компаній. Середній досвід команди — 7 років, у нас є сертифіковані спеціалісти 1С-Бітрікс. Наш досвід гарантує, що обмін не зламається в перший же місяць і буде стабільно працювати роками. Наприклад, на проекті з каталогом 50 000 товарів автоматизація обміну заощадила клієнту близько 200 000 рублів на рік на операційних витратах.

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