Налаштування 1С-Битрикс з офлайн-касою: фіскалізація

Клієнт оформлює замовлення в інтернет-магазині на Бітрікс, обирає «оплата при отриманні». Кур'єр привозить товар, пробиває чек на мобільній касі АТОЛ або Евотер. Фіскальний чек видано, але замовлення в системі зависає в статусі «очікує оплати». Склад не списує позиції, бухгалтерія не бачить факту оплати — знайома проблема? Ми стикаємося з нею регулярно і знаємо, як її вирішити. Збої в синхронізації призводять до подвоєння залишків, штрафів від ФНС та втрати клієнтів. За рік ми виправили більше 50 таких кейсів. Інтеграція онлайн-магазину з офлайн-касою — це не лише фіскалізація згідно 54-ФЗ, а й повноцінна синхронізація стану замовлень та залишків. У цій статті розберемо технічну реалізацію зв'язки Бітрікс з офлайн-касою на прикладі REST API.

Схема фіскалізації оплат

Згідно 54-ФЗ, кожен розрахунок вимагає чека. У Бітрікс модуль salescenter і компонент bitrix:salescenter.cashbox інтегруються з онлайн-касами через ОФД. Для офлайн-каси схема інша: чек видається фізичним апаратом (АТОЛ, Евотер, Штрих-М), а Бітрікс повинен отримати підтвердження.

Два напрямки даних:

1. Бітрікс → каса: дані замовлення (позиції, суми, ПДВ) для формування чека
2. Каса → Бітрікс: підтвердження з номером та фіскальною ознакою

Інтеграція через API касового ПЗ

Більшість сучасних кас мають REST API або webhook. Евотер — Cloud API, АТОЛ — свій протокол. У Бітрікс обробник зміни статусу замовлення відправляє дані:

AddEventHandler('sale', 'OnSaleStatusOrderChange', function(\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); $status = $order->getField('STATUS_ID'); if ($status !== 'DE') { return; } $items = []; foreach ($order->getBasket() as $item) { $items[] = [ 'name' => $item->getField('NAME'), 'quantity' => $item->getQuantity(), 'price' => $item->getPrice(), 'vat' => getVatTag($item->getField('VAT_RATE')), ]; } $evotorApi->sendReceipt($order->getId(), $items, $order->getPrice()); }); 

Отримання підтвердження від каси

Каса шле webhook при успішному чеку. Endpoint у Бітрікс:

$data = json_decode(file_get_contents('php://input'), true); if ($data['event'] === 'receipt.created') { $orderId = $data['external_id']; $fiscalSign = $data['fiscal_document_number']; $order = \Bitrix\Sale\Order::load($orderId); if ($order) { $payment = $order->getPaymentCollection()->current(); $payment->setField('PAID', 'Y'); $payment->setField('EXTERNAL_PAYMENT', $fiscalSign); $order->setField('STATUS_ID', 'F'); $order->save(); } } 

Як синхронізувати залишки при офлайн-продажах?

Продаж у фізичному магазині товару, який є в онлайн-замовленні, повинен зменшувати залишки. Є два підходи:

Пряма інтеграція в 3 рази швидша і виключає ризик подвійного продажу. Ми реалізуємо обидва варіанти, але рекомендуємо другий. Типова економія часу бухгалтера — 2 години щоденно за рахунок автоматизації.

Чому маппінг ПДВ критичний?

Помилка в ставці ПДВ при відправці на касу — порушення 54-ФЗ. Ставки в Бітрікс зберігаються в b_catalog_vat. Маппінг для фіскального чека:

• VAT_RATE = 20 → тег 1105 (ПДВ 20%)
• VAT_RATE = 10 → тег 1104 (ПДВ 10%)
• VAT_RATE = 0 → тег 1106 (ПДВ 0%)
• VAT_INCLUDE = N → тег 1107 (ПДВ не обкладається)

Ми враховуємо всі нюанси — аж до ПДВ 20/120, щоб фіскальні дані відповідали законодавству. Це дозволяє скоротити помилки фіскалізації на 95%.

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

1. Аналіз — вивчаємо поточні налаштування каси та Бітрікс, виявляємо несумісності.
2. Проектування — обираємо протокол (REST або webhook), визначаємо маппінг полів.
3. Реалізація — пишемо обробники подій, ендпоінт та логіку синхронізації.
4. Тестування — перевіряємо на тестовій касі до 100 чеків, виправляємо помилки.
5. Деплой — викатуємо на бойовий контур, налаштовуємо моніторинг.

Порівняння протоколів кас

Вибір протоколу залежить від каси та сценарію. Ми підберемо оптимальний.

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

Ми підготовлюємо:

• Обробник OnSaleStatusOrderChange для відправки даних у касову систему
• Webhook-endpoint для отримання підтвердження фіскалізації
• Маппінг ставок ПДВ між Бітрікс та касою
• Оновлення статусу оплати та поля фіскальної ознаки
• Механізм синхронізації залишків
• Логування всіх транзакцій для діагностики

Додатково:

• Тестування інтеграції на тестовій касі
• Документація по API та схемі роботи
• Підтримка після запуску

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

Більше 20 інтеграцій з офлайн-касами на Бітрікс — наш досвід гарантує стабільну роботу.