KSeF для сервисной компании: фактура из CRM, а не из таблицы

С 1 апреля 2026 года каждый действующий плательщик VAT в Польше выставляет счета через KSeF - национальную систему электронных фактур. Гайдов много, но почти все написаны производителями бухгалтерских программ и заканчиваются одинаково: купите нашу программу. Агентство, студия или юридическая фирма со своей CRM, которая выставляет тридцать фактур в месяц по закрытым проектам, ответа на свой вопрос там не находит. А вопрос простой: как сделать, чтобы фактура выходила из того, что уже есть.

Я делаю интеграции и автоматизации, я не бухгалтер и не налоговый консультант. Ниже инженерная сторона: за какими датами следить, где в сервисной компании рождается счёт, как выглядит поток данных из CRM в KSeF и обратно и что делать, когда государственная система не отвечает.

Сроки KSeF и соседняя дата

Главная путаница возникает из-за того, что смешивают две разные обязанности: получать входящие фактуры и выставлять свои. Они стартовали в разные даты и касаются разных групп.

Обе даты по KSeF уже прошли, так что для сервисной компании это вопрос не срока, а процесса. e-Doręczenia я кладу в ту же таблицу, потому что это тот же сдвиг в другом месте: документы переезжают в государственную систему, в которую кто-то обязан регулярно заходить. Письмо там считается доставленным через 14 дней после поступления, даже если ящик никто не открывал.

Приём входящих фактур касается вас, даже если вы ничего не выставляете

Эта часть удивляет чаще всего. Получение электронных фактур через KSeF стало обязательным для всех налогоплательщиков с 1 февраля 2026 года. Неважно, продаёте вы B2B или только физлицам. Если вы покупаете хостинг, лицензии, услуги подрядчиков или аренду офиса, их фактуры приходят в KSeF, а не на почту.

Это меняет расходную часть сильнее, чем продажную. Раньше фактуры падали на почту и кто-то пересылал их бухгалтеру. Теперь их нужно регулярно забирать из системы, привязывать к проектам и статьям затрат и следить, чтобы ничего не осталось неполученным. На практике я ставлю простой процесс на n8n: раз в час опрос KSeF на новые входящие, сохранение XML и PDF в файловое хранилище, запись в CRM с NIP продавца, суммой и сроком оплаты плюс уведомление в Slack или Telegram, когда приходит фактура выше оговорённой суммы. Тот же механизм уведомлений я разбирал в статье про интеграцию CRM с Telegram и WhatsApp.

Где в сервисной компании на самом деле рождается счёт

В интернет-магазине всё просто: фактура следует за заказом, и решение принимает одна система. В сервисной компании не так, и в этом вся сложность.

Типичное состояние, которое я застаю:

• Менеджер переводит сделку в «выиграна», но в карточке нет ни NIP, ни адреса, ни разбивки на позиции.
• Сумма к выставлению лежит в таблице с учётом часов или в договоре в PDF.
• Раз в месяц кто-то перепечатывает всё это в бухгалтерскую программу или отправляет список письмом в бухгалтерию.
• Регулярные счета за абонемент и поддержку выставляются руками, по графику, который есть только в голове владельца.

KSeF это не чинит. Он только сдвигает момент, когда бардак становится виден, потому что теперь фактура формально возникает лишь тогда, когда её приняла система министерства и присвоила номер. До того как трогать API, нужно одно место, где полный набор данных для счёта заполнен и ему можно доверять. Обычно это CRM, иногда таск-трекер. Выбор единого источника правды - половина всего внедрения, подробнее об этом в тексте о том, с чего начинать автоматизацию бизнес-процессов.

Поток данных: сделка выиграна, KSeF, номер обратно в CRM

Так выглядит схема, которую я собираю в сервисной компании. У каждого шага есть названные поля и своя точка отказа.

1. Триггер. Сделка в CRM переходит в статус «выиграна» или проект получает статус «к выставлению», и вебхук уходит в интеграционный слой. Точка отказа: менеджер переключает статус несколько раз подряд и уходят дубли. Решение - ключ идемпотентности по идентификатору сделки.
2. Сбор данных. Из CRM берутся NIP, название и адрес контрагента, позиции услуг, сумма нетто, ставка VAT, срок оплаты, номер заказа или договора. Точка отказа: пустое или неверное поле. Интеграция не должна угадывать, она обязана придержать документ и вернуть задачу ответственному менеджеру.
3. Проверка контрагента. Проверка NIP в реестре налогоплательщиков и, для клиентов из ЕС, в VIES. Точка отказа: контрагент сменил реквизиты, а в CRM лежит адрес двухлетней давности.
4. Сборка документа. Данные уходят в структурированный XML по действующей схеме. Точка отказа: строки из таблицы часов без однозначной ставки VAT или описания длиннее, чем допускает схема.
5. Отправка в KSeF. Аутентификация, сессия, отправка документа. Точка отказа: истёкший токен и сессия, которая не обновилась в фоне.
6. Приём подтверждения. KSeF присваивает номер и выдаёт официальное подтверждение приёма. Точка отказа: документ принят, а подтверждение приходит чуть позже, поэтому процесс не должен считать отсутствие мгновенного ответа ошибкой.
7. Обратная запись в CRM. В карточку сделки возвращаются номер KSeF, статус, дата приёма и ссылки на XML и на визуализацию в PDF. Точка отказа: пропустить этот шаг. Тогда никто в компании не знает, какая фактура ушла, а какая застряла.
8. Отправка клиенту и в бухгалтерию. Письмо с PDF как человекочитаемой визуализацией плюс пакет XML для бухгалтерии. Точка отказа: клиент считает фактурой PDF, хотя юридический документ - это то, что принял KSeF.

Седьмой шаг отличает рабочую интеграцию от демо. Когда номер KSeF лежит в CRM, работа с долгами, отчёты по продажам и разговор с бухгалтером происходят в одном месте, без входа в государственный портал.

Что должно быть в CRM до подключения API

Перед первой строчкой кода я прохожу с клиентом список полей. Без них документ либо не проходит валидацию, либо, что хуже, уходит с неверными данными.

Этот список весит больше, чем выбор инструмента. Код на выставление пишется за несколько дней, а заполнение NIP и адресов в базе контрагентов растягивается на недели, потому что кому-то надо обзвонить клиентов.

Фактуры, которые в KSeF не попадут

KSeF не забирает весь документооборот, и это часто упускают при планировании. Вне системы остаются фактуры от иностранных контрагентов, бумажные документы, сканы и PDF, а также весь архив до перехода. Для сервисной компании с клиентами в Германии или Нидерландах эта часть может быть больше внутренней.

Значит, автоматическое распознавание документов никуда не девается, оно просто переезжает на затраты вне KSeF. Арифметика здесь публичная. Отраслевые бенчмарки дают среднюю стоимость обработки одной фактуры около 10,89 USD, а команды с автоматическим распознаванием и сопоставлением выходят примерно на 2,78 USD, то есть на 74% ниже. Готовые модели распознавания стоят 0,10-0,75 USD за документ, Azure Document Intelligence берёт 10 USD за 1000 страниц по готовой модели фактуры и 30 USD за 1000 страниц при своей схеме, Google Document AI - 1,50 USD за 1000 страниц базового OCR. Это рыночные цифры, а не мои цены. При 300 входящих фактурах в месяц само распознавание стоит несколько евро, а экономия считается в человеко-часах. Это ровно та зона, которую закрывает автоматизация документов.

Когда KSeF не отвечает: очередь вместо ожидания

Внешняя система, на которой держатся ваши продажи, однажды не ответит. Со стороны кода важно одно: интеграция не должна терять документы и не должна блокировать работу менеджера.

Минимально правильная архитектура выглядит так:

• Фактура сохраняется локально с внутренним номером до того, как уйдёт в KSeF.
• Отправка идёт через очередь с повторами и растущим интервалом, а не синхронно с кликом в CRM.
• У каждой попытки есть ключ идемпотентности, чтобы повтор не создал второй счёт.
• Документы в статусе «отправлено, подтверждения нет» видны на одном экране, а не в логах.
• Если документ висит дольше оговорённого времени, уведомление уходит конкретному человеку, а не в общий ящик.

Тот же шаблон я применяю в любой интеграции с государственной системой. Всё, что уходит наружу, идёт через очередь и имеет видимый статус, иначе первый же сбой на стороне ведомства заканчивается тремя днями ручного выставления счетов.

Сколько это стоит и сколько занимает

Рыночные вилки стоит отделять от моих. Польские подрядчики публикуют по внедрениям автоматизаций и агентов широкий диапазон: 3 000-15 000 zł за настройку плюс абонемент, 8 000-20 000 zł за конфигурацию с 200-500 zł в месяц на API и инфраструктуру, и 80 000-250 000 zł за решения, которые пишут данные в CRM и ERP крупной организации. Годовую поддержку обычно считают как 15-25% от стоимости внедрения.

Мои ставки для сервисной компании такие:

Это цены за работу, а не за лицензию. Сверху остаются расходы на сервер и на распознавание того, что приходит вне системы. Более широкое сравнение по стоимости таких проектов я собрал в материале о том, сколько стоит автоматизация на n8n и Make.

Когда это заказывать не надо: если вы выставляете пять одинаковых счетов в месяц, недорогая бухгалтерская программа справится дешевле любой интеграции. Порог окупаемости начинается примерно там, где счетов несколько десятков в месяц, данные для них живут в разных системах, а кто-то в компании тратит на это больше одного рабочего дня в месяц.

Если у вас есть CRM и вы хотите, чтобы фактура выходила из неё сама, напишите мне и опишите, что лежит в CRM, а что в таблице. Отвечу, что можно подключить за две недели, а что требует сначала привести данные в порядок. Более широкий контекст таких задач - на странице про автоматизацию бизнес-процессов.

FAQ

Обязательно ли сервисной компании интегрировать CRM с KSeF, или хватит бухгалтерской программы? Закон требует выставлять структурированные фактуры в KSeF, а не интегрировать CRM, и бухгалтерская программа это требование закрывает. Интеграция с CRM имеет смысл тогда, когда данные для счёта и так рождаются в CRM, а кто-то сегодня перепечатывает их руками. При нескольких десятках счетов в месяц и данных в разных системах перепечатывание стоит дороже, чем подключение API.

С какой даты KSeF обязателен для моей компании? Выставление фактур в KSeF обязательно с 1 февраля 2026 года для компаний с оборотом свыше 200 млн zł за 2024 год и с 1 апреля 2026 года для всех остальных плательщиков VAT. Приём входящих фактур через KSeF охватил всех налогоплательщиков с 1 февраля 2026 года. Это две отдельные обязанности, и вторая касается даже фирмы, которая сама фактуры B2B не выставляет.

Что делать, если KSeF недоступен в момент выставления счёта? Документ попадает в очередь и уходит повторно, когда система вернётся. Правильно собранный процесс сохраняет фактуру локально с внутренним номером, повторяет отправку с растущим интервалом и использует ключ идемпотентности, чтобы не создать дубль. Менеджер вообще не должен ждать ответа KSeF, а документы без подтверждения обязаны быть видны на одном экране.

Проходят ли через KSeF фактуры от иностранных контрагентов? Нет. Документы от контрагентов вне польской системы, бумажные фактуры, сканы и PDF остаются вне KSeF, поэтому автоматическое распознавание документов по-прежнему нужно. Отраслевые бенчмарки дают среднюю стоимость ручной обработки одной фактуры около 10,89 USD, а при автоматическом распознавании и сопоставлении - около 2,78 USD.

Какие данные должны быть в CRM, чтобы фактура выставлялась сама? Минимум - это NIP покупателя, полное название и адрес, позиции с описанием услуги, ставка VAT по каждой позиции, срок оплаты и номер договора или заказа. Без NIP и ставки VAT документ не пройдёт валидацию. Без срока оплаты и номера договора он пройдёт, но привязать его к проекту и отследить просрочку автоматически уже не выйдет.

Зачем возвращать номер KSeF в CRM? Потому что присвоенный системой номер - единственный идентификатор, который связывает вашу запись с документом на стороне ведомства, а работа с долгами, отчёты и общение с бухгалтерией идут в CRM. Если номер есть только в PDF или в портале, кто-то будет искать его руками по каждому неоплаченному счёту. Обратная запись - это одно поле и один вызов API на этапе внедрения.

Сколько занимает подключение KSeF к своей CRM? Приём входящих фактур с записью в CRM обычно занимает 1-2 недели. Выставление из CRM с проверкой NIP и обратной записью номера KSeF - 2-4 недели. Полный поток с распознаванием документов вне KSeF и привязкой к проектам - 4-8 недель. Дольше всего тормозит не код, а наведение порядка в данных контрагентов в CRM.

Сколько стоит интеграция KSeF с CRM для сервисной компании? У меня приём входящих фактур начинается от 900 € (3 900 zł), а выставление из CRM с обратной записью номера KSeF - от 2 800 € (12 000 zł). Польские подрядчики публикуют для таких проектов вилки от 3 000-15 000 zł за простую настройку до 80 000-250 000 zł за решения, пишущие данные в CRM и ERP крупной компании, а годовую поддержку считают как 15-25% от стоимости внедрения.