SuperFaktúra
SuperFaktúra je slovenský online fakturační a účetní systém. Tato integrace umožňuje importovat vaše klienty ze SuperFaktúra přímo do Deratix.
Konfigurace
Před prvním importem musíte nastavit propojení se SuperFaktúra:
Požadované údaje
Pro konfiguraci potřebujete tři údaje z vašeho SuperFaktúra účtu:
| Údaj | Kde ho najdete |
|---|---|
| Email, kterým se přihlašujete do SuperFaktúra | |
| API klíč | SuperFaktúra → Nástroje → API přístup |
| Company ID | SuperFaktúra → Nástroje → API přístup (číslo firmy) |
Kde získat API klíč
- Přihlaste se do SuperFaktúra
- Klikněte na Nástroje v hlavním menu
- Vyberte API přístup
- Zkopírujte:
- API Token (dlouhý textový řetězec)
- Company ID (číslo)
Nastavení v Deratix
- Přejděte do administrace
- Otevřete Nastavení → Integrace
- V sekci SuperFaktúra vyplňte:
- Email účtu
- API klíč
- Company ID
- Klikněte na Uložit
Test připojení
Po konfiguraci doporučujeme otestovat připojení:
- Otevřete Integrace v aplikaci
- U SuperFaktúra klikněte na Test
- Počkejte na výsledek:
- ✅ Připojení je funkční - konfigurace je správná
- ❌ Chyba - zkontrolujte zadané údaje
Časté chyby
| Chyba | Řešení |
|---|---|
| Neplatné přihlašovací údaje | Zkontrolujte email a API klíč |
| Neplatné Company ID | Ověřte číslo firmy v SuperFaktúra |
| Připojení selhalo | Zkontrolujte internetové připojení |
Import klientů
Spuštění importu
- Otevřete Integrace
- U SuperFaktúra klikněte na Importovat
- Počkejte na načtení a analýzu klientů
Příprava importu
Systém automaticky:
- Stáhne všechny klienty ze SuperFaktúra
- Konsoliduje klienty podle IČO (klienti se stejným IČO = jeden klient s více adresami)
- Porovná s existující databází klientů
- Zobrazí přehled ke schválení
Stavy klientů
Po analýze se klienti rozdělí do tří kategorií. Přehled vidíte v panelu statistik:
| Stav | Barva | Význam | Výchozí akce |
|---|---|---|---|
| Nový | Zelená | Klient s daným IČO ještě neexistuje | Importovat |
| Existuje | Modrá | Klient se stejným IČO už je v systému | Aktualizovat |
| Duplicita | Červená | Nalezeno více možných shod | Přeskočit |
Tabulka importu
Tabulka zobrazuje všechny klienty ze SuperFaktúra:
| Sloupec | Popis |
|---|---|
| Název | Jméno nebo název firmy |
| IČO | Identifikační číslo organizace |
| Kontaktní email | |
| Adresy | Počet adres (fakturační + dodací) |
| Stav | Nový / Existuje / Duplicita |
| Akce | Importovat / Aktualizovat / Přeskočit |
Výběr akce
Pro každého klienta můžete vybrat akci:
- Importovat - Vytvoří nového klienta v Deratix
- Aktualizovat - Aktualizuje údaje existujícího klienta
- Přeskočit - Klient se neimportuje
Porovnání údajů
U klientů se stavem Existuje nebo Duplicita můžete porovnat údaje:
- Klikněte na ikonu 👁 (oko) v řádku klienta
- Otevře se dialog s porovnáním:
- Vlevo: údaje ze SuperFaktúra
- Vpravo: aktuální údaje v Deratix
- Rozdíly jsou zvýrazněny
- Rozhodněte se pro akci
Hromadný výběr
Pro urychlení práce můžete použít hromadné akce:
- Vybrat vše - Zaškrtne všechny klienty na stránce
- Zrušit výběr - Odškrtne všechny klienty
Spuštění
- Zkontrolujte výběr klientů a jejich akce
- Klikněte na Importovat (počet)
- Počkejte na dokončení
Během importu se zobrazuje:
- Procento dokončení
- Počet importovaných
- Počet aktualizovaných
- Počet přeskočených
Výsledek importu
Po dokončení se zobrazí souhrn:
| Kategorie | Ikona | Popis |
|---|---|---|
| Importovaných | ✅ | Nově vytvoření klienti |
| Aktualizovaných | 🔄 | Klienti s aktualizovanými údaji |
| Přeskočených | ⏭️ | Klienti bez změny |
| Chyb | ❌ | Neúspěšné operace (pokud nastaly) |
Klikněte na Zobrazit klienty pro přechod do databáze klientů.
Co se importuje
Ze SuperFaktúra se importují tyto údaje:
Základní údaje klienta
- Název firmy / Jméno
- IČO, DIČ, DIČ DPH
- Kontaktní email
- Telefonní číslo
- Kontaktní osoba
Adresy
- Fakturační adresa - Ulice, město, PSČ
- Dodací adresy - Importují se jako pobočky klienta
Konsolidace podle IČO
SuperFaktúra může obsahovat více záznamů se stejným IČO (např. různé pobočky). Deratix tyto záznamy automaticky konsoliduje:
- Klienti se stejným IČO se sloučí do jednoho
- Různé adresy se importují jako pobočky
- Zachovají se všechny kontaktní údaje
Stránkování a řazení
Řazení
Tabulku můžete řadit kliknutím na hlavičky sloupců:
- Název (A-Z, Z-A)
- IČO
- Počet adres
- Stav
Stránkování
Při velkém počtu klientů se zobrazí stránkování. Navigujte pomocí tlačítek « a ».
Opakování importu
Import můžete provést kdykoliv opakovaně:
- Noví klienti ze SuperFaktúra se přidají
- Existující klienti se mohou aktualizovat
- Už importovaní klienti se přeskočí (pokud nezměníte akci)
Tip: Pravidelným importem udržíte databázi klientů aktuální se SuperFaktúra.
Řešení problémů
Import je pomalý
- Při prvním importu se stahují všichni klienti
- Čekání závisí na počtu klientů v SuperFaktúra
- Buďte trpěliví při tisících klientů
Klient se nezobrazuje
- Zkontrolujte, zda má klient vyplněné základní údaje v SuperFaktúra
- Klienti bez názvu se nemohou importovat
Duplicitní záznamy
- Klienti se párují podle IČO
- Klienti bez IČO se vytváří vždy jako noví
- Po importu zkontrolujte duplicity v databázi klientů
Chyba připojení během importu
- Import se automaticky zastaví
- Zkontrolujte internetové připojení
- Spusťte import znovu - už importovaní klienti se přeskočí
Tipy pro efektivní import
Tip: Před prvním importem vyčistěte duplicitní klienty v SuperFaktúra.
Tip: Při prvním importu nejprve importujte menší vzorek a zkontrolujte výsledek.
Tip: Klienti jsou párováni podle IČO. Ujistěte se, že máte IČO vyplněné správně.
Tip: Po importu zkontrolujte v detailu klienta správnost adres a kontaktů.
Tip: Používejte akci Aktualizovat pro synchronizaci změn ze SuperFaktúra.