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í být propojení se SuperFaktúra nastavené. Pokud karta SuperFaktúra zobrazuje stav Vyžaduje konfiguraci nebo import není dostupný, požádejte správce nebo podporu Deratix o nastavení připojení.
Požadované údaje
Pro nastavení připojení jsou potřeba tři údaje z účtu SuperFaktúra:
| Ú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)
Poznámka: Přístupové údaje předávejte pouze osobě, která spravuje vaši instalaci Deratix. Neukládejte je do poznámek v protokolech ani do veřejných dokumentů.
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.