Automatyzacja finansowego księgowania: Jobber → Google Sheet przez N8N
Zrealizowano kompleksowy i odporny na awarie system automatyzacji dla branży sprzątającej. Główne zadanie — skonfigurować automatyczny transfer danych z CRM Jobber do Google Sheets za pomocą platformy n8n w celu dokładnego obliczenia wypłat dla zespołów sprzątających (model procentowy i godzinowy).
Co zostało zrobione (Szczegóły techniczne realizacji):
- Sekcyjny model danych („Konstruktor”): Wiersz wizyty w tabeli podzielony jest na niezależne strefy (Wizyta, Faktura, Płatność, Rozliczenie). Każdy strumień n8n aktualizuje tylko swoje pola, co wyklucza konflikty podczas równoległego przetwarzania webhooków.
- Dynamiczne adresowanie (Header-based): n8n odczytuje numery kolumn według kluczy w pierwszym wierszu tabeli. Menedżer może swobodnie zmieniać miejsca kolumn — integracja nie ulegnie awarii.
- Idempotentność i ochrona przed duplikatami: Zrealizowano generację unikalnych kluczy event_id oraz mechanikę atomic upsert przez n8n Data Table. Powtarzające się webhooki są automatycznie odrzucane, nie tworząc duplikatów.
- Elastyczne rozdzielanie finansów:
- Napisano algorytm określania odpowiedzialnego za gotówkę (Cash Taker) wśród kilku zespołów na wizycie na podstawie ich typu i ID.
- Zrealizowano logikę podziału faktur multi-wizytowych (jeśli jedna faktura jest wystawiona na kilka sprzątań, kwoty są dzielone równo).
- Tryb „Ręczna Edycja” (Manual Lock): Stworzono mechanizm ochrony danych. Jeśli menedżer zaznaczy opcję ręcznej korekty w dowolnym wierszu wizyty, automatyka całkowicie zamraża aktualizację tego obiektu, aby nie nadpisać ręcznych poprawek.
- Fail-safe i monitoring:
- Zintegrowano kolejkę błędów — Dead Letter Queue (Failed_Events) bezpośrednio w Google Sheets dla wygodnego rozpatrywania przez menedżera.
- Skonfigurowano politykę retrajów Exponential Backoff w celu obejścia limitów API (429, 5xx). Stworzono system 24 niestandardowych powiadomień Telegram (podzielonych na gałęzie: Info, Ostrzeżenia, Błędy) do natychmiastowego powiadamiania o rozbieżnościach w kwotach, braku zespołów w słownikach lub błędach API.
- Optymalizacja obciążenia: Obliczenia końcowych wypłat (V), kwot sprzątania (N) i rozbieżności (R) zostały całkowicie przeniesione na stronę formuł Google Sheets w obrębie wiersza, co zmniejszyło liczbę zapytań do API i przyspieszyło działanie systemu.
Stos technologii:
- n8n (Tworzenie workflow, n8n Data Table do logowania i deduplikacji)
- Jobber API (GraphQL, Webhooki, Weryfikacja zdarzeń przez HMAC-SHA256)
- Google Sheets API (Batch-aktualizacje, praca z formułami)
- JavaScript / Node.js (Wyrażenia regularne, parsowanie pozycji i logika filtrowania danych wewnątrz węzłów n8n)
- Telegram Bot API (Routing powiadomień według tematów)
Wynik dla biznesu:
Zleceniodawca otrzymał całkowicie autonomiczną witrynę finansową. Ręczna praca księgowego/menedżera została zminimalizowana — system sam zbiera dane o wykonanej pracy, oblicza czysty dochód po odliczeniu parkingów i podatków, dzieli napiwki i nalicza wynagrodzenie dla sprzątaczy. Wszystkie nietypowe przypadki lub rozbieżności finansowe są sygnalizowane przez Telegram, co gwarantuje 100% kontrolę nad finansami.
Co zostało zrobione (Szczegóły techniczne realizacji):
- Sekcyjny model danych („Konstruktor”): Wiersz wizyty w tabeli podzielony jest na niezależne strefy (Wizyta, Faktura, Płatność, Rozliczenie). Każdy strumień n8n aktualizuje tylko swoje pola, co wyklucza konflikty podczas równoległego przetwarzania webhooków.
- Dynamiczne adresowanie (Header-based): n8n odczytuje numery kolumn według kluczy w pierwszym wierszu tabeli. Menedżer może swobodnie zmieniać miejsca kolumn — integracja nie ulegnie awarii.
- Idempotentność i ochrona przed duplikatami: Zrealizowano generację unikalnych kluczy event_id oraz mechanikę atomic upsert przez n8n Data Table. Powtarzające się webhooki są automatycznie odrzucane, nie tworząc duplikatów.
- Elastyczne rozdzielanie finansów:
- Napisano algorytm określania odpowiedzialnego za gotówkę (Cash Taker) wśród kilku zespołów na wizycie na podstawie ich typu i ID.
- Zrealizowano logikę podziału faktur multi-wizytowych (jeśli jedna faktura jest wystawiona na kilka sprzątań, kwoty są dzielone równo).
- Tryb „Ręczna Edycja” (Manual Lock): Stworzono mechanizm ochrony danych. Jeśli menedżer zaznaczy opcję ręcznej korekty w dowolnym wierszu wizyty, automatyka całkowicie zamraża aktualizację tego obiektu, aby nie nadpisać ręcznych poprawek.
- Fail-safe i monitoring:
- Zintegrowano kolejkę błędów — Dead Letter Queue (Failed_Events) bezpośrednio w Google Sheets dla wygodnego rozpatrywania przez menedżera.
- Skonfigurowano politykę retrajów Exponential Backoff w celu obejścia limitów API (429, 5xx). Stworzono system 24 niestandardowych powiadomień Telegram (podzielonych na gałęzie: Info, Ostrzeżenia, Błędy) do natychmiastowego powiadamiania o rozbieżnościach w kwotach, braku zespołów w słownikach lub błędach API.
- Optymalizacja obciążenia: Obliczenia końcowych wypłat (V), kwot sprzątania (N) i rozbieżności (R) zostały całkowicie przeniesione na stronę formuł Google Sheets w obrębie wiersza, co zmniejszyło liczbę zapytań do API i przyspieszyło działanie systemu.
Stos technologii:
- n8n (Tworzenie workflow, n8n Data Table do logowania i deduplikacji)
- Jobber API (GraphQL, Webhooki, Weryfikacja zdarzeń przez HMAC-SHA256)
- Google Sheets API (Batch-aktualizacje, praca z formułami)
- JavaScript / Node.js (Wyrażenia regularne, parsowanie pozycji i logika filtrowania danych wewnątrz węzłów n8n)
- Telegram Bot API (Routing powiadomień według tematów)
Wynik dla biznesu:
Zleceniodawca otrzymał całkowicie autonomiczną witrynę finansową. Ręczna praca księgowego/menedżera została zminimalizowana — system sam zbiera dane o wykonanej pracy, oblicza czysty dochód po odliczeniu parkingów i podatków, dzieli napiwki i nalicza wynagrodzenie dla sprzątaczy. Wszystkie nietypowe przypadki lub rozbieżności finansowe są sygnalizowane przez Telegram, co gwarantuje 100% kontrolę nad finansami.
Odessa 
Gotowy do podjęcia pracy