Автоматизація фін. обліку: Jobber → Google Sheet через N8N
Реалізовано комплексну та відмовостійку систему автоматизації для клінінгового бізнесу. Головне завдання — налаштувати автоматичне перенесення даних з CRM Jobber до Google Sheets за допомогою платформи n8n для точного розрахунку виплат клінінговим командам (процентна та погодинна модель).
Що було зроблено (Технічні деталі реалізації):
- Секційна модель даних ("Конструктор"): Рядок візиту в таблиці розділений на незалежні зони (Візит, Інвойс, Платіж, Розрахунок). Кожен потік n8n оновлює лише свої поля, що виключає конфлікти при паралельній обробці вебхуків.
- Динамічна адресація (Header-based): n8n зчитує номери колонок за ключами у першому рядку таблицы. Менеджер може вільно міняти стовпчики місцями — інтеграція не зламається.
- Ідемпотентність та захист від дублів: Реалізовано генерацію унікальних ключів event_id та механіку atomic upsert через n8n Data Table. Повторні вебхуки відсікаються автоматично, не створюючи дублів.
- Гнучкий розподіл фінансів:
- - Написано алгоритм визначення відповідального за готівку (Cash Taker) серед кількох команд на візиті на основі їхнього типу та ID.
- - Реалізовано логіку розщеплення мульти-візитних інвойсів (якщо один рахунок виставлено на декілька прибирань, суми діляться порівну).
- Режим «Ручне Редагування» (Manual Lock): Створено механізм захисту даних. Якщо менеджер ставить галочку ручного коригування на будь-якому рядку візиту, автоматика повністю заморожує оновлення цього об'єкта, щоб не затерти ручні правки.
- Fail-safe та моніторинг:
- - Інтегровано чергу помилок — Dead Letter Queue (Failed_Events) прямо в Google Sheets для зручного розбору менеджером.
- - Налаштовано Exponential Backoff політики ретраїв для обходу лімітів API (429, 5xx).Створено систему з 24 кастомних Telegram-алертів (розділених по гілках: Info, Warnings, Errors) для моментального сповіщення про розбіжності в сумах, відсутність команд у довідниках чи помилки API.
- Оптимізація навантаження: Розрахунок підсумкових виплат (V), сум прибирання (N) та розбіжностей (R) повністю винесено на сторону формул Google Sheets всередині рядка, що зменшило кількість запитів до API та прискорило роботу системи.
Стек технологій:
- n8n (Створення workflow, n8n Data Table для логування та дедуплікації)
- Jobber API (GraphQL, Webhooks, Верифікація подій через HMAC-SHA256)
- Google Sheets API (Batch-оновлення, робота з формулами)
- JavaScript / Node.js (Регулярні вирази, парсинг line items та логіка фільтрації даних всередині n8n-вузлів)
- Telegram Bot API (Маршрутизація сповіщень по топіках)
Результат для бізнесу:
Замовник отримав повністю автономну фінансову вітрину. Ручна робота бухгалтера/менеджера зведена до мінімуму — система сама збирає дані про виконану роботу, рахує чистий дохід за вирахуванням паркінгів та податків, ділить чайові та нараховує зарплату клінерам. Усі нестандартні кейси чи фінансові розбіжності підсвічуються через Telegram, що гарантує 100% контроль за фінансами.
Що було зроблено (Технічні деталі реалізації):
- Секційна модель даних ("Конструктор"): Рядок візиту в таблиці розділений на незалежні зони (Візит, Інвойс, Платіж, Розрахунок). Кожен потік n8n оновлює лише свої поля, що виключає конфлікти при паралельній обробці вебхуків.
- Динамічна адресація (Header-based): n8n зчитує номери колонок за ключами у першому рядку таблицы. Менеджер може вільно міняти стовпчики місцями — інтеграція не зламається.
- Ідемпотентність та захист від дублів: Реалізовано генерацію унікальних ключів event_id та механіку atomic upsert через n8n Data Table. Повторні вебхуки відсікаються автоматично, не створюючи дублів.
- Гнучкий розподіл фінансів:
- - Написано алгоритм визначення відповідального за готівку (Cash Taker) серед кількох команд на візиті на основі їхнього типу та ID.
- - Реалізовано логіку розщеплення мульти-візитних інвойсів (якщо один рахунок виставлено на декілька прибирань, суми діляться порівну).
- Режим «Ручне Редагування» (Manual Lock): Створено механізм захисту даних. Якщо менеджер ставить галочку ручного коригування на будь-якому рядку візиту, автоматика повністю заморожує оновлення цього об'єкта, щоб не затерти ручні правки.
- Fail-safe та моніторинг:
- - Інтегровано чергу помилок — Dead Letter Queue (Failed_Events) прямо в Google Sheets для зручного розбору менеджером.
- - Налаштовано Exponential Backoff політики ретраїв для обходу лімітів API (429, 5xx).Створено систему з 24 кастомних Telegram-алертів (розділених по гілках: Info, Warnings, Errors) для моментального сповіщення про розбіжності в сумах, відсутність команд у довідниках чи помилки API.
- Оптимізація навантаження: Розрахунок підсумкових виплат (V), сум прибирання (N) та розбіжностей (R) повністю винесено на сторону формул Google Sheets всередині рядка, що зменшило кількість запитів до API та прискорило роботу системи.
Стек технологій:
- n8n (Створення workflow, n8n Data Table для логування та дедуплікації)
- Jobber API (GraphQL, Webhooks, Верифікація подій через HMAC-SHA256)
- Google Sheets API (Batch-оновлення, робота з формулами)
- JavaScript / Node.js (Регулярні вирази, парсинг line items та логіка фільтрації даних всередині n8n-вузлів)
- Telegram Bot API (Маршрутизація сповіщень по топіках)
Результат для бізнесу:
Замовник отримав повністю автономну фінансову вітрину. Ручна робота бухгалтера/менеджера зведена до мінімуму — система сама збирає дані про виконану роботу, рахує чистий дохід за вирахуванням паркінгів та податків, ділить чайові та нараховує зарплату клінерам. Усі нестандартні кейси чи фінансові розбіжності підсвічуються через Telegram, що гарантує 100% контроль за фінансами.
Одеса 
Вільний для роботи