SuperFaktúra

SuperFaktúra to słowacki system fakturowania i księgowości online. Ta integracja pozwala importować klientów z SuperFaktúra bezpośrednio do Deratix.

Konfiguracja

Połączenie musi być skonfigurowane przed pierwszym importem. Jeśli karta SuperFaktúra pokazuje Wymaga konfiguracji albo import nie jest dostępny, poproś administratora lub wsparcie Deratix o ustawienie połączenia.

Wymagane Dane

Do ustawienia połączenia potrzebne są trzy dane z konta SuperFaktúra:

Jak Uzyskać Klucz API

1. Zaloguj się do SuperFaktúra.
2. Otwórz Narzędzia w głównym menu.
3. Wybierz Dostęp API.
4. Skopiuj:
   • API Token (długi ciąg tekstowy)
   • Company ID (numer)

Uwaga: Dane dostępowe przekazuj tylko osobie zarządzającej instalacją Deratix. Nie zapisuj ich w notatkach protokołów ani w publicznych dokumentach.

Test Połączenia

Po konfiguracji zalecamy przetestować połączenie:

1. Otwórz Integracje w aplikacji.
2. Na karcie SuperFaktúra kliknij Test.
3. Poczekaj na wynik:
   • ✅ Połączenie działa - konfiguracja jest poprawna
   • ❌ Błąd - sprawdź wprowadzone dane

Częste Błędy

Import Klientów

Uruchomienie Importu

1. Otwórz Integracje.
2. Na karcie SuperFaktúra kliknij Importuj.
3. Poczekaj na wczytanie i analizę klientów.

Import klientówDesktop

Przygotowanie Importu

System automatycznie:

1. Pobiera wszystkich klientów z SuperFaktúra.
2. Konsoliduje klientów według Company ID (klienci z tym samym Company ID stają się jednym klientem z wieloma adresami).
3. Porównuje ich z istniejącą bazą klientów.
4. Wyświetla podgląd do zatwierdzenia.

Statusy Klientów

Po analizie klienci są podzieleni na trzy kategorie. Podsumowanie widoczne jest w panelu statystyk:

Statystyki importuDesktop

Tabela Importu

Tabela pokazuje wszystkich klientów z SuperFaktúra:

Tabela importuDesktop

Wybór Akcji

Dla każdego klienta możesz wybrać akcję:

• Importuj - tworzy nowego klienta w Deratix
• Aktualizuj - aktualizuje dane istniejącego klienta
• Pomiń - klient nie zostanie zaimportowany

Porównanie Danych

Dla klientów ze statusem Istnieje lub Duplikat możesz porównać dane:

1. Kliknij ikonę 👁 w wierszu klienta.
2. Otworzy się okno porównania:
   • Po lewej: dane z SuperFaktúra
   • Po prawej: aktualne dane w Deratix
   • Różnice są wyróżnione
3. Zdecyduj, którą akcję wykonać.

Zaznaczanie Zbiorcze

Aby przyspieszyć pracę, użyj akcji zbiorczych:

• Zaznacz wszystko - zaznacza wszystkich klientów na stronie
• Wyczyść zaznaczenie - odznacza wybranych klientów

Uruchomienie

1. Sprawdź wybór klientów i ich akcje.
2. Kliknij Importuj (liczba).
3. Poczekaj na zakończenie.

Podczas importu widoczne są:

• Procent ukończenia
• Liczba zaimportowanych klientów
• Liczba zaktualizowanych klientów
• Liczba pominiętych klientów

Wynik Importu

Po zakończeniu wyświetla się podsumowanie:

Kliknij Zobacz klientów, aby przejść do bazy klientów.

Co Jest Importowane

Z SuperFaktúra importowane są następujące dane:

Podstawowe Dane Klienta

• Nazwa firmy / imię i nazwisko
• Company ID, identyfikator podatkowy, numer VAT
• Email kontaktowy
• Numer telefonu
• Osoba kontaktowa

Adresy

• Adres rozliczeniowy - ulica, miasto, kod pocztowy
• Adresy dostawy - importowane jako lokalizacje klienta

Konsolidacja według Company ID

SuperFaktúra może zawierać kilka rekordów z tym samym Company ID, na przykład różne oddziały. Deratix automatycznie je konsoliduje:

• Klienci z tym samym Company ID są łączeni w jednego klienta.
• Różne adresy są importowane jako lokalizacje.
• Zachowane są wszystkie dostępne dane kontaktowe.

Stronicowanie i Sortowanie

Sortowanie

Tabelę można sortować klikając nagłówki kolumn:

• Nazwa (A-Z, Z-A)
• Company ID
• Email
• Liczba adresów
• Status

Stronicowanie

Przy dużej liczbie klientów pojawia się stronicowanie. Nawiguj przyciskami « i ».

Powtarzanie Importu

Import można wykonać ponownie w dowolnym momencie:

• Nowi klienci z SuperFaktúra zostaną dodani.
• Istniejący klienci mogą zostać zaktualizowani.
• Już zaimportowani klienci zostaną pominięci, jeśli nie zmienisz akcji.

Wskazówka: Regularny import utrzymuje bazę klientów zgodną z SuperFaktúra.

Rozwiązywanie Problemów

Import Jest Wolny

• Pierwszy import pobiera wszystkich klientów.
• Czas oczekiwania zależy od liczby klientów w SuperFaktúra.
• Przy tysiącach klientów trzeba uzbroić się w cierpliwość.

Klient Się Nie Wyświetla

• Sprawdź, czy klient ma wypełnione podstawowe dane w SuperFaktúra.
• Klienci bez nazwy nie mogą zostać zaimportowani.

Zduplikowane Rekordy

• Klienci są dopasowywani według Company ID.
• Klienci bez Company ID są zawsze tworzeni jako nowi.
• Po imporcie sprawdź duplikaty w bazie klientów.

Błąd Połączenia Podczas Importu

• Import zatrzymuje się automatycznie.
• Sprawdź połączenie internetowe.
• Uruchom import ponownie - już zaimportowani klienci zostaną pominięci.

Wskazówki dla Efektywnego Importu

Wskazówka: Przed pierwszym importem usuń duplikaty klientów w SuperFaktúra.

Wskazówka: Przy pierwszym imporcie zacznij od mniejszej próbki i sprawdź wynik.

Wskazówka: Klienci są dopasowywani według Company ID. Upewnij się, że Company ID są wypełnione poprawnie.

Wskazówka: Po imporcie sprawdź adresy i kontakty w szczegółach klienta.

Wskazówka: Używaj akcji Aktualizuj, aby synchronizować zmiany z SuperFaktúra.