Интеграция с кадровой системой: как автоматизировать 1500 договоров в месяц

Интеграция с кадровой системой была разработана для польской IT-компании с кадровым оборотом более 1500 договоров в месяц. До проекта кадровая команда вручную переносила данные из Google Sheets в Rewizor nexo и Gratyfikant nexo: создавала работников, договоры, umowy o dzieło, umowy zlecenia и rachunki. Этот процесс занимал около одной рабочей недели в месяц и был чувствителен к ошибкам.

Главный риск был не только в скорости. Ошибка в типе договора, данных выплаты или признаке передачи авторских прав могла привести к некорректному расчету PIT, потому что для договоров с передачей авторских прав применяется другой уровень kosztów uzyskania przychodu.

Growth Insider разработал PayrollBridge: внутренний batch-интеграционный процесс между Google Sheets, MS SQL Server и системами Rewizor nexo / Gratyfikant nexo. Сейчас полный пакет обрабатывается примерно за 10 минут, а сверка занимает еще около 10 минут. В рамках тестирования на более чем 10 000 договоров ошибок не обнаружено.

Кратко о проекте

Проект был реализован для польской IT-компании, название которой не раскрывается по условиям конфиденциальности. Клиент работает в сфере IT и digital operations, где ежемесячно обрабатывается более 1500 договоров и связанных с ними документов.

До начала проекта процесс был в значительной степени ручным. Исходные данные хранились в Google Sheets, после чего их нужно было переносить, обрабатывать и сверять в нескольких системах: Rewizor nexo, Gratyfikant nexo и MS SQL Server. В работу входили данные сотрудников, договоры, umowy o dzieło, umowy zlecenia, счета, а также сверка корректности информации между источниками и целевыми системами.

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

В рамках проекта была разработана интеграция формата Batch ETL / database-level integration. Решение автоматизировало передачу данных из Google Sheets в целевые системы, включая обработку, структурирование и подготовку информации для дальнейшей работы в учетных и кадровых процессах.

После внедрения время обработки сократилось с примерно одной рабочей недели в месяц до около 10 минут на загрузку и обработку данных, а также около 10 минут на финальную сверку. Это позволило существенно снизить объем ручной работы и сделать процесс более предсказуемым.

Перед запуском интеграция была протестирована на массиве из более чем 10 000 договоров. В ходе проверки ошибок обнаружено не было, что подтвердило стабильность решения и его готовность к работе с большим объемом данных.

Проблема: неделя ручной работы каждый месяц

Клиент работал с большим количеством исполнителей и работников. Каждый месяц кадровая команда обрабатывала от 1000 до 1500 договоров и примерно такое же количество rachunki.

Исходные данные попадали в Google Sheets. После этого кадровик вручную переносил их в кадрово-бухгалтерские системы. Нужно было создать или обновить работника, подготовить договор, корректно указать тип договора, создать umowa o dzieło или umowa zlecenia, а затем сформировать rachunek на основании договора.

На первый взгляд это выглядит как обычный перенос данных. В реальности процесс был намного сложнее. Польская кадровая и налоговая специфика требует точного различения типов договоров, налоговых признаков и логики расчета. Особенно важным был признак передачи авторских прав. Для договоров с передачей авторских прав и без передачи авторских прав применяются разные koszty uzyskania przychodu. Ошибка в этом месте могла повлиять на расчет PIT.

Ручной процесс создавал несколько бизнес-рисков:

1. Кадровик тратил около 40 часов в месяц на повторяемую работу.
2. Ошибки чаще всего появлялись при добавлении данных о выплатах.
3. Масштабирование процесса зависело от одного или нескольких специалистов.
4. Проверка после ручного ввода занимала дополнительное время.
5. Руководство не получало полностью повторяемого и проверяемого процесса.

Для небольшой команды это становилось операционной нагрузкой. Чем больше договоров, тем выше риск задержек, перепроверок и ошибок в данных.

Почему обычной интеграции было недостаточно

В типовом сценарии интеграция строится через API. Но для нужного процесса у InsERT nexo не было подходящего API, который позволял бы безопасно и полноценно автоматизировать создание работников, договоров и rachunki именно в таком сценарии.

Поэтому интеграцию пришлось делать на уровне базы данных через MS SQL Server. Это повышает сложность проекта. Нужно понимать не только источник данных в Google Sheets, но и внутреннюю структуру Rewizor nexo и Gratyfikant nexo.

InsERT nexo включает Rewizor nexo как систему финансово-бухгалтерского учета и Gratyfikant nexo как кадрово-платежную систему. В таких системах данные связаны между собой. Работник, адрес, договор, rachunek, налоговые параметры и служебные записи не существуют изолированно. Если нарушить одну связь, ошибка может появиться позже, например при создании договора или сверке расчетов.

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

Решение: PayrollBridge как интеграция с кадровой системой для Google Sheets, Rewizor nexo и Gratyfikant nexo

Growth Insider разработал PayrollBridge как custom integration layer. Это не SaaS-продукт и не универсальный коннектор. Это внутренний интеграционный процесс, настроенный под конкретный кадровый и бухгалтерский workflow клиента.

PayrollBridge связывает Google Sheets, MS SQL Server, Rewizor nexo и Gratyfikant nexo. Он работает как batch-интеграция: данные загружаются пакетом, проходят проверки, нормализацию, создание или обновление сущностей, а затем попадают в сверочную таблицу.

Главная ценность решения: кадровая команда больше не переносит вручную сотни и тысячи строк. Оператор запускает процесс, получает результат, проверяет сверочную таблицу и может быстро увидеть, совпадают ли данные из Google Sheets с данными, созданными в Rewizor nexo / Gratyfikant nexo.

Как работает интеграция

Workflow PayrollBridge выглядит так:

1. Данные выгружаются из внутренней базы IT-компании в Google Sheets.
2. Интеграция проверяет наличие обязательных листов.
3. Проверяются заголовки и структура таблиц.
4. Данные нормализуются и приводятся к ожидаемому формату.
5. Проверяются обязательные поля, PESEL, тип договора, данные выплат и признаки передачи авторских прав.
6. Создается или обновляется работник.
7. На основании работника и истории из Google Sheets создается договор.
8. Создаются umowy o dzieło и umowy zlecenia.
9. На основании договора создается rachunek.
10. Записываются технические JSON-логи.
11. Данные попадают в сверочную таблицу.
12. Оператор сравнивает Google Sheets и данные в Rewizor nexo / Gratyfikant nexo.
13. При необходимости процесс можно безопасно запустить повторно.

Отдельно была реализована preflight validation. Это предварительная проверка до записи данных. Она помогает обнаружить проблемы в структуре, обязательных полях или связях до того, как процесс начнет изменять данные в целевых системах.

Также использовался dry-run. Это режим тестового запуска без финальной записи. Он полезен при проверке новых правил, новых листов или изменений в структуре данных. Для кадровых и бухгалтерских систем это важно, потому что надежность процесса важнее скорости разработки.

Почему idempotency была критична

Idempotency означает, что повторный запуск процесса не должен создавать дубли. Простыми словами: если интеграция уже создала работника, договор или rachunek для конкретной операции, второй запуск не должен создать еще одну копию.

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

В PayrollBridge эта задача решалась через deterministic import key, то есть предсказуемый ключ импорта. Он позволяет системе понимать, относится ли строка к уже обработанной операции. Дополнительно применялись проверки дублей и source-aware processing. Система учитывает источник данных и не смешивает записи из разных листов и сценариев.

Для бизнеса это означает, что процесс можно запускать повторно без страха, что база будет загрязнена дублями. Это снижает нагрузку на кадровика и уменьшает риск ручного исправления данных после импорта.

Как предотвратили дубли и ошибки в данных

PayrollBridge был спроектирован не только как механизм создания записей. Важная часть решения: предотвращение ошибок до того, как они попадут в Rewizor nexo и Gratyfikant nexo.

В проекте были реализованы:

• проверка обязательных листов Google Sheets;
• проверка заголовков;
• нормализация данных;
• проверка PESEL без раскрытия значений;
• проверка типа договора;
• проверка предмета договора;
• защита от пустого или некорректного contract subject;
• проверка признака передачи авторских прав;
• проверка данных выплат;
• duplicate prevention для работников, договоров и rachunki;
• reconciliation table для быстрой сверки;
• JSON logging;
• error reporting;
• data integrity checks;
• rollback-сценарии для безопасного отката в тестовых и контролируемых операциях;
• safe reruns для повторного запуска.

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

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

Что было самым сложным технически

Самая сложная часть проекта была не в чтении Google Sheets. Основная сложность была в том, чтобы корректно записывать данные в кадрово-бухгалтерскую инфраструктуру через MS SQL Server и не нарушать связи внутри InsERT nexo.

В проекте было несколько технических вызовов:

• Cложная структура базы данных. Внутри системы много связанных сущностей и подструктур. Создание работника или договора требует правильной последовательности действий и корректной связи между записями.
• Польская кадровая специфика. Umowa o dzieło, umowa zlecenia, rachunek, PIT и koszty uzyskania przychodu требуют точной логики. Интеграция должна была учитывать разные типы договоров и разные налоговые последствия.
• Надежность повторного запуска. Процесс должен был быть безопасным при повторной обработке. Это особенно важно в ежемесячном цикле, где данные могут обновляться, уточняться или перепроверяться.
• Cверка. Недостаточно просто импортировать данные. Бизнесу нужен быстрый способ проверить, что данные в Google Sheets соответствуют тому, что появилось в Rewizor nexo и Gratyfikant nexo. Поэтому сверочная таблица стала частью решения, а не дополнительной ручной задачей после запуска.
• Отсутствие подходящего API для нужного сценария. Работа на уровне базы данных требует более строгой инженерной дисциплины: preflight validation, dry-run, rollback, логи, контроль дублей и аккуратная проверка связей.

Результаты

После внедрения PayrollBridge процесс обработки полного пакета занимает около 10 минут. Дополнительная сверка занимает еще около 10 минут. Раньше этот же процесс занимал около одной рабочей недели в месяц.

Ключевые результаты:

• обработка 1000-1500 договоров в месяц;
• создание сопоставимого количества rachunki;
• автоматизация создания и обновления работников;
• автоматизация umowy o dzieło и umowy zlecenia;
• снижение ручного ввода;
• безопасный повторный запуск без создания дублей;
• отдельная сверочная таблица для контроля результата;
• тестирование на более чем 10 000 договоров за последние 3 года;
• по результатам тестов ошибок не обнаружено;
• production verification показал 41 из 41 успешных совпадений проверенных договоров по ключевым полям.

Важно: проект не утверждает, что ошибки невозможны. Корректная формулировка: в рамках проведенного тестирования ошибок не обнаружено, а операционный риск ручных ошибок был существенно снижен.

Экономика проекта

До автоматизации кадровик тратил примерно одну рабочую неделю в месяц.

Расчет прямой стоимости:

5 дней × 8 часов = 40 часов
40 часов × 60 PLN brutto = 2400 PLN brutto в месяц

Это только прямая стоимость ручной работы. Реальный эффект выше, потому что ручной процесс также создавал дополнительные издержки:

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

Автоматизация не просто “экономит часы”. Она меняет качество процесса. Команда получает повторяемый workflow, понятную сверку, технические логи и возможность быстрее закрывать ежемесячный кадровый цикл.

Что предприниматель может вынести из этого кейса

1. автоматизация должна начинаться с процесса, а не с кода. Если не описать, как данные движутся от источника до результата, интеграция быстро превращается в набор технических исправлений.
2. интеграция без API возможна, но требует осторожности. Работа через MS SQL Server может быть оправдана, когда API не покрывает нужный сценарий. Но такой подход требует проверки связей, тестов, логов и контроля дублей.
3. в кадровых и бухгалтерских системах надежность важнее скорости разработки. Лучше потратить больше времени на preflight validation, dry-run и сверку, чем потом исправлять production-данные.
4. idempotency обязательна для повторяемых импортов. Если процесс запускается каждый месяц или несколько раз в рамках одного цикла, он должен понимать, что уже было создано.
5. сверка данных должна быть частью решения. Нельзя оставлять контроль результата на ручную интуицию оператора.
6. польская кадровая специфика требует понимания предметной области. Разница между договорами с передачей авторских прав и без передачи авторских прав влияет не только на текст договора, но и на расчет PIT.

Когда компании нужна такая интеграция

Интеграция с кадровой системой особенно актуальна, если компания:

• ежемесячно обрабатывает сотни договоров;
• использует Google Sheets как промежуточный источник данных;
• вручную переносит данные в Rewizor nexo или Gratyfikant nexo;
• регулярно создает umowy o dzieło, umowy zlecenia и rachunki;
• сталкивается с ошибками в данных выплат;
• зависит от одного кадровика или бухгалтера;
• хочет быстрее закрывать ежемесячный процесс;
• не может использовать готовый API для нужного сценария;
• нуждается в прозрачной сверке между источником и целевой системой.

Такая автоматизация особенно полезна IT-компаниям, digital-агентствам, платформам с большим числом исполнителей, HR-отделам и операционным командам, где кадровый документооборот уже превысил ручной масштаб.

FAQ

1. Что такое интеграция с кадровой системой?

Это соединение между источником данных и кадровой или payroll-системой. Такая интеграция может автоматически создавать работников, договоры, начисления, rachunki и сверочные записи без ручного переноса данных.

2. Можно ли интегрировать Google Sheets с Rewizor nexo и Gratyfikant nexo?

Да, можно. В этом кейсе Google Sheets использовался как источник данных, а Rewizor nexo и Gratyfikant nexo как целевые системы. Интеграция выполнялась через MS SQL Server, потому что стандартного API для нужного сценария было недостаточно.

3. Почему интеграция через базу данных сложнее, чем через API?

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

4. Что такое idempotency в кадровой интеграции?

Idempotency означает, что повторный запуск процесса не создает дубли. Если работник, договор или rachunek уже были созданы для конкретной операции, система должна распознать это и не создавать вторую копию.

5. Как избежать дублей работников и договоров?

Нужны предсказуемые ключи импорта, проверки перед записью, анализ уже существующих данных, source-aware processing и сверочная таблица. Также важно тестировать сценарии повторного запуска.

6. Можно ли автоматизировать umowy o dzieło и umowy zlecenia?

Да. Но автоматизация должна учитывать тип договора, предмет договора, данные выплат, признаки передачи авторских прав и налоговые последствия. Это не просто генерация документа, а часть кадрово-бухгалтерского процесса.

7. Сколько времени может экономить такая автоматизация?

В этом кейсе процесс, который занимал около одной рабочей недели в месяц, был сокращен до примерно 10 минут обработки и около 10 минут сверки. Фактический эффект зависит от объема данных и сложности процесса.

8. Когда бизнесу стоит заказывать custom HR/payroll integration?

Когда ручной процесс стал узким местом, команда регулярно переносит данные между системами, ошибки влияют на выплаты или налоги, а готовые API или стандартные коннекторы не покрывают нужный workflow.

Если в вашей компании кадровый, бухгалтерский или договорной процесс держится на Google Sheets, ручном вводе и проверках в несколько этапов, мы можем помочь спроектировать безопасную интеграцию. Получите консультацию Growth Insider по автоматизации HR, payroll и операционных процессов.

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