Integracja Synci.io — Automatyczna synchronizacja z bankiem we Freenance

Automatyczna synchronizacja z bankiem przez Synci.io

Synci.io to regulowany agregator PSD2 z dostępem read-only do 2 500+ banków w 31 krajach europejskich, włączając wszystkie większe polskie, niemieckie, francuskie, włoskie, holenderskie i hiszpańskie instytucje. Freenance integruje się z Synci.io jako destination webhooka — każda transakcja zsynchronizowana przez Synci ze Twoim banku trafia automatycznie do Freenance jako wydatek lub przychód.

Płacisz Synci ich własną subskrypcję — bieżący cennik i plany znajdziesz na synci.io/pricing. Freenance nie pobiera dodatkowej opłaty za samą integrację; jest dostępna na każdym płatnym planie Freenance (Enthusiast Investor i wyżej). Synci.io obsługuje flow zgody PSD2, autoryzację banku, okresową synchronizację i przypomnienia o ponownej zgodzie. Freenance tylko odbiera transakcje.

Dlaczego Synci.io zamiast bezpośredniej integracji bankowej?

Bezpośrednie integracje PSD2 (Enable Banking, GoCardless, Plaid) pobierają od aplikacji finansowych kilka euro miesięcznie za każdego użytkownika, co zmusiłoby Freenance albo do znacznego podniesienia cen, albo do ograniczenia synchronizacji bankowej do najwyższego planu. Delegując flow PSD2 do Synci.io — który sprzedaje bezpośrednio użytkownikom końcowym — Freenance trzyma koszt po stronie użytkowników, którzy faktycznie chcą synchronizacji bankowej, zamiast wliczać go w subskrypcję wszystkich.

Trade-off: konfiguracja to dwa kroki zamiast jednego (zasubskrybuj Synci, wklej URL do Freenance). Korzyść: cennik Synci jest istotnie niższy niż bezpośrednie integracje, lista banków jest szersza niż większości bezpośrednich dostawców i zachowujesz jedną zgodę PSD2 dla wszystkich narzędzi, do których chcesz przekazywać dane (Sheets, YNAB, Lunch Money, a teraz Freenance).

Jakie dane są importowane?

Webhook Synci.io dostarcza zaksięgowane transakcje bankowe — uregulowane debety i kredyty — w częstotliwości zależnej od planu który wybierzesz w Synci. Freenance mapuje każdą transakcję:

Każda dostawa webhooka jest logowana w Konfiguracja → Synci.io → Ostatnie zdarzenia ze statusem (Utworzono / Duplikat / Transfer / Wykluczono / Brak autoryzacji / Niepowodzenie) plus wskaźnik kategoryzacji AI (Kategoryzuje / Skategoryzowane / Niepowodzenie), więc możesz zweryfikować pipeline jednym spojrzeniem.

Każda dostawa jest weryfikowana HMAC: Synci podpisuje każdy payload sekretem whsec_… skonfigurowanym w Kroku 4 poniżej, a Freenance odrzuca każdą dostawę, której sygnatura się nie zgadza.

Konfiguracja krok po kroku

Krok 1: Subskrybuj Synci.io

Wejdź na synci.io/pricing i wybierz plan. Najtańszy płatny tier Synci'ego wystarczy żeby przekazywać transakcje do Freenance — ceny, częstotliwość synchronizacji, liczba endpointów webhooków i ewentualne dodatki (np. wzbogacanie kategoriami) są opisane na ich stronie i mogą się zmieniać w czasie, więc linkujemy do niej zamiast cytować. Cokolwiek ustawisz po stronie Synci, po prostu zadziała w Freenance — my tylko odbieramy to co nam pchną.

Krok 2: Połącz bank w Synci

W UI Synci kliknij Dodaj bank, wybierz swój bank z przeszukiwalnej listy i przejdź flow zgody PSD2 na stronie banku (zwykle redirect, logowanie biometryczne i potwierdzenie). Zgody PSD2 są ważne przez 90 dni — Synci wysyła Ci przypomnienia o ponownej zgodzie, bez akcji ze strony Freenance.

Krok 3: Włącz Freenance i skopiuj URL webhooka

Zaloguj się do Freenance na freenance.io, otwórz Konfiguracja → Integracje, kliknij kafelek Synci.io i kliknij Włącz integrację Synci.io — Freenance wygeneruje URL webhooka w postaci https://api.freenance.io/core/synci/webhook/{token}. Skopiuj go.

Krok 4: Dodaj Freenance jako destination Custom webhook w Synci

Wróć do Synci, przejdź do Destinations → Add destination → Custom webhook, wklej URL z Freenance i zapisz. Synci pokaże Ci wtedy sekret podpisujący whsec_… — to wartość, której Synci używa do podpisywania HMAC każdego payloadu, który Ci dostarczy.

Skopiuj sekret whsec_…, wróć do strony Synci.io we Freenance, wklej go w pole Sekret podpisujący Synci i kliknij Zapisz sekret. Freenance przechowuje go zaszyfrowany AES w spoczynku i używa do weryfikacji każdej przychodzącej dostawy przed importem transakcji.

Krok 5: Weryfikacja

Synci uruchomi pierwszą synchronizację w częstotliwości którą określa plan jaki wybrałeś. Otwórz Konfiguracja → Synci.io i sprawdź tabelę Ostatnie zdarzenia — powinieneś zobaczyć wiersze ze statusem Utworzono, a kolumna Kategoryzacja AI zmieni się z Kategoryzuje na Skategoryzowane w ciągu kilku sekund od dostarczenia (jeśli masz włączoną kategoryzację AI w ustawieniach importu bankowego). Otwórz ekrany Wydatki i Przychody, by zobaczyć nowe wpisy. Gotowe.

Kategoryzacja AI

Gdy transakcje przychodzą przez Synci, Freenance przepuszcza je przez ten sam pipeline kategoryzacji AI co importer wyciągów bankowych. Kategoryzacja czyta Twoje ustawienia AI (toggle, wskazówki, wzorce wykluczeń) — skonfigurowane globalnie w Konfiguracja → Synci.io → Otwórz ustawienia AI (lub w Konfiguracja → Import bankowy), stosują się do każdego źródła importu: CSV, MT940, YNAB i Synci.

Wykluczone transakcje (pasujące do dowolnego z Twoich wzorców wykluczeń przez case-insensitive substring w opisie) nigdy nie stają się wydatkiem ani przychodem — są audytowane jako Wykluczone w tabeli zdarzeń, abyś mógł zweryfikować, że Twoje wzorce robią to, czego oczekujesz.

Bezpieczeństwo

Każda dostawa Synci jest weryfikowana HMAC-SHA256 przeciwko Twojemu zapisanemu sekretowi whsec_…. Niezgodność sygnatury → 401 + wiersz audytu Brak autoryzacji w tabeli zdarzeń. Sekret jest przechowywany we Freenance zaszyfrowany AES-256-GCM — nawet wyciek bazy danych go nie ujawni.

Zrotuj URL webhooka w dowolnej chwili ze strony Synci.io we Freenance. Rotacja generuje nowy URL (musisz zaktualizować destination w Synci); sekret pozostaje powiązany z destination po stronie Synci, więc nie wymaga ponownego wklejenia, chyba że obracasz go po stronie Synci.

Sam Synci.io nigdy nie przechowuje danych logowania do banku — to twardy wymóg PSD2. Wydaje i odświeża tokeny dostępu w stylu OAuth wobec regulowanego API PSD2 banku, ze wszystkimi danymi szyfrowanymi w spoczynku i w tranzycie.

Rozwiązywanie problemów

Brak zdarzeń: otwórz tabelę Ostatnie zdarzenia. Jeśli jest pusta, sprawdź konfigurację destination w Synci — URL musi zawierać dokładnie /core/synci/webhook/<twój-token>, a nagłówek X-Synci-Secret musi się zgadzać. Jeśli tabela pokazuje wiersze ze statusem Brak autoryzacji, sekret jest błędny; zrotuj.

Zdarzenia pojawiają się ze statusem Niepowodzenie: Synci wysłał transakcję w kształcie, którego nie umieliśmy zmapować. Kolumna error_message w wierszu audytu mówi co brakowało. Zespół integracji to monitoruje — daj znać przez kontakt, załatamy mapper.

Banner ostrzegawczy "brak zdarzeń od 7 dni": zgody PSD2 wygasają po 90 dniach. Synci wysyła Ci przypomnienie o ponownej zgodzie; odnów ją w Synci.io. Po odnowieniu zgody bank, kolejna synchronizacja Synci wznowi dostawy webhooka.

Transakcja trafiła do złej kategorii: każdy wiersz w Wydatkach / Przychodach jest edytowalny — zmień kategorię jak każdy inny wpis. Przyszłe zdarzenia Synci od tego samego odbiorcy użyją Twojej zapisanej kategorii, jeśli pasuje po nazwie.

FAQ

Czy Synci.io obsługuje mój bank?: tak, jeśli Twój bank jest w UE/EOG — 2 500+ banków w 31 krajach. Polska obsługa obejmuje mBank, ING, PKO BP, Santander Bank Polska, Millennium, Alior, Pekao, Credit Agricole, Citi, BNP Paribas, Velo, Nest i większość mniejszych instytucji.

Ile to kosztuje?: aktualny cennik Synci'ego znajdziesz na synci.io/pricing (rozliczane przez Synci, nie Freenance). Jedna subskrypcja Synci łączy jeden bank; użytkownicy wielobankowi kupują wiele połączeń. Freenance nie nakłada dodatkowej opłaty za integrację ponad Twój płatny plan.

Jakiego planu potrzebuję we Freenance?: Enthusiast Investor i wyżej. Integracja jest wliczona w każdy płatny plan — brak dopłaty po zakupie planu.

Czy mogę uruchomić Synci → Freenance i Synci → Sheets jednocześnie?: tak. Synci wspiera wiele webhookowych destinations per połączenie z bankiem na płatnych planach (szczegóły w ich cenniku). Dodaj Freenance jako jedną destination, Sheets jako drugą — Synci rozpyla do obu.

Czy zaimportuje historyczne transakcje?: Synci domyślnie pushuje od daty połączenia w przód; możesz skonfigurować transfer_start_date w Synci, aby zaimportować starszą historię, jeśli Twój bank ją udostępnia przez PSD2. Freenance deduplikuje względem transakcji już zaimportowanych przez YNAB CSV lub inne źródła, więc ponowny import jest bezpieczny.

👉 Wypróbuj Synci.io z Freenance — freenance.io