Integracja z Citi Handlowy — import transakcji do Freenance

Importowanie transakcji z Citi Handlowy

Citi Handlowy (Bank Handlowy w Warszawie) udostępnia eksport historii operacji w formacie CSV przez serwisy CitiDirect (klienci korporacyjni) i Citibank Online (klienci indywidualni). Po pobraniu pliku możesz wgrać go do Freenance — system automatycznie kategoryzuje wydatki, wykrywa subskrypcje i pokazuje Twój Financial Freedom Runway.

Status integracji (aktualizacja: maj 2026): Citi Handlowy generuje kilka wariantów eksportu CSV (osobne dla CitiDirect i Citibank Online, różne dla kont firmowych i osobistych). Aktywnie dodajemy obsługę kolejnych wariantów na podstawie zgłoszeń. Jeśli przy imporcie zobaczysz "Utworzono 0 przychodów, 0 wydatków", napisz do nas z anonimizowanym przykładem pliku — dodajemy obsługę nowych wariantów w ciągu 1–3 dni roboczych.

Krok 1: Eksport z Citi Handlowy

1. Zaloguj się do CitiDirect (citidirect.handlowy.pl) lub Citibank Online.
2. Przejdź do Rachunki → Wyciągi lub Historia operacji i wybierz konto, którego historię chcesz wyeksportować.
3. Ustaw zakres dat (CitiDirect pozwala na okres do 12 miesięcy w jednej operacji).
4. Wybierz format CSV i, jeśli system o to pyta, kodowanie UTF-8.
5. Potwierdź eksport tokenem/aplikacją i pobierz plik.

Uwaga: Freenance importuje wyłącznie CSV i pliki MT940. Format XLS/Excel nie jest obsługiwany — jeśli Citi oferuje tylko XLS, otwórz plik w Excelu/LibreOffice i zapisz jako CSV (UTF-8).

Krok 2: Zmiana nazwy pliku

Freenance wymaga, żeby plik CSV miał nazwę w formacie:

citi-{numer-konta}.csv

Przykład: citi-12345678901234567890123456.csv (26-cyfrowy numer konta IBAN bez spacji i bez prefiksu PL).

Krok 3: Import do Freenance

1. Zaloguj się do Freenance.
2. Otwórz Konfiguracja → Import bankowy.
3. Przeciągnij plik CSV na pole upload lub kliknij Wybierz plik.
4. Kliknij Wyślij.
5. Po chwili lista importów pokaże wynik: liczbę utworzonych przychodów i wydatków oraz zakres dat.

Co Freenance robi po imporcie

• Automatyczna kategoryzacja typowych dostawców i sklepów na podstawie opisu operacji.
• Wykrywanie powtarzających się płatności — abonamenty, raty, czynsz oznaczane jako recurring.
• Wykrywanie duplikatów — możesz bezpiecznie importować nakładające się okresy.
• Wykrywanie przelewów własnych — przelewy między Twoimi kontami nie są liczone jako wydatek/przychód.

Bezpieczeństwo

• Brak dostępu do konta bankowego — nigdy nie pytamy o login/hasło do CitiDirect ani Citibank Online.
• Szyfrowane połączenie — wszystkie uploady idą po HTTPS.
• Możesz w każdej chwili usunąć dane z poziomu konta Freenance — pojedyncze transakcje, całe konto bankowe albo wszystko (RODO).

Inne banki w Freenance

Freenance importuje również transakcje z PKO, ING, Revolut, Credit Agricole, Nest Bank, Millennium i mBank. Wszystkie konta widzisz w jednym dashboardzie z jedną kategoryzacją i jednym budżetem.

Zacznij teraz

👉 Załóż konto w Freenance i zaimportuj pierwszy plik z Citi Handlowy. Jeśli coś nie zadziała — napisz do nas na hello@freenance.io.

Powiązane artykuły

• Jak importować transakcje z banku do Freenance — poradnik MT940 i CSV
• Integracja z Credit Agricole — import transakcji do Freenance
• Integracja z BNP Paribas — import transakcji do Freenance

FAQ

Czy Freenance obsługuje zarówno konta firmowe (CitiDirect) jak i osobiste w Citi?

Tak — Freenance obsługuje import CSV z obu serwisów Citi Handlowy: CitiDirect (klienci korporacyjni i MŚP) oraz Citibank Online (klienci indywidualni). Formaty eksportu różnią się między tymi serwisami, więc na liście wspieranych wariantów stale dodajemy obsługę nowych układów na podstawie zgłoszeń od użytkowników.

Czy Freenance łączy się z Citi Handlowy bezpośrednio przez API?

Nie — Freenance nie korzysta z bezpośredniego połączenia z Citi Handlowy ani z usług PSD2. Pracujemy wyłącznie na pliku CSV, który sam pobierasz z CitiDirect lub Citibank Online. Dzięki temu Twoje dane logowania do bankowości Citi nigdy nie opuszczają Twojej przeglądarki ani aplikacji bankowej.

Jak długi zakres historii mogę zaimportować z Citi za jednym razem?

CitiDirect zwykle pozwala na eksport do 12 miesięcy historii w jednej operacji, a Citibank Online ma zwykle podobny limit. Dla dłuższych zakresów (np. 2–3 lata wstecz) wykonaj kilka eksportów dla kolejnych okresów i wgraj je do Freenance jako oddzielne pliki — wykrywanie duplikatów zadba o spójność danych.

Co zrobić, gdy plik CSV z Citi ma polskie znaki jako krzaczki?

Najpierw spróbuj ponownie eksportu i wybierz kodowanie UTF-8, jeśli CitiDirect daje taką opcję w oknie eksportu. Jeśli system Citi domyślnie zapisuje plik w Windows-1250 lub innym kodowaniu, Freenance i tak rozpozna polskie znaki — mamy fallback na popularne kodowania używane przez polskie banki, więc import powinien zadziałać bez konwersji.

Czy mogę importować transakcje z kart kredytowych Citi razem z transakcjami z konta?

Tak — każdą kartę kredytową Citi traktuj jako osobne "konto" i eksportuj jej historię oddzielnie z Citibank Online (sekcja "Wyciągi z karty" lub "Historia operacji karty"). Nadaj plikowi nazwę citi-{numer-karty-lub-konta}.csv, a Freenance pokaże osobne saldo dla karty i osobne dla konta bieżącego w tym samym dashboardzie.