SuperFaktúra
SuperFaktúra je slovenský online fakturačný a účtovný systém. Táto integrácia umožňuje importovať vašich klientov zo SuperFaktúra priamo do Deratix.
Konfigurácia
Pred prvým importom musí byť prepojenie so SuperFaktúra nastavené. Ak karta SuperFaktúra zobrazuje stav Vyžaduje konfiguráciu alebo import nie je dostupný, požiadajte správcu alebo podporu Deratix o nastavenie pripojenia.
Požadované údaje
Na nastavenie pripojenia sú potrebné tri údaje zo SuperFaktúra účtu:
| Údaj | Kde ho nájdete |
|---|---|
| Email, ktorým sa prihlasujete do SuperFaktúra | |
| API kľúč | SuperFaktúra → Nástroje → API prístup |
| Company ID | SuperFaktúra → Nástroje → API prístup (číslo firmy) |
Kde získať API kľúč
- Prihláste sa do SuperFaktúra.
- Kliknite na Nástroje v hlavnom menu.
- Vyberte API prístup.
- Skopírujte:
- API Token (dlhý textový reťazec)
- Company ID (číslo)
Poznámka: Prístupové údaje odovzdajte iba osobe, ktorá spravuje vašu inštaláciu Deratix. Neukladajte ich do poznámok v protokoloch ani do verejných dokumentov.
Test pripojenia
Po konfigurácii odporúčame otestovať pripojenie:
- Otvorte Integrácie v aplikácii
- Pri SuperFaktúra kliknite na Test
- Počkajte na výsledok:
- ✅ Pripojenie je funkčné - konfigurácia je správna
- ❌ Chyba - skontrolujte zadané údaje
Časté chyby
| Chyba | Riešenie |
|---|---|
| Neplatné prihlasovacie údaje | Skontrolujte email a API kľúč |
| Neplatné Company ID | Overte číslo firmy v SuperFaktúra |
| Pripojenie zlyhalo | Skontrolujte internetové pripojenie |
Import klientov
Spustenie importu
- Otvorte Integrácie
- Pri SuperFaktúra kliknite na Importovať
- Počkajte na načítanie a analýzu klientov
Príprava importu
Systém automaticky:
- Stiahne všetkých klientov zo SuperFaktúra
- Konsoliduje klientov podľa IČO (klienti s rovnakým IČO = jeden klient s viacerými adresami)
- Porovná s existujúcou databázou klientov
- Zobrazí prehľad na schválenie
Stavy klientov
Po analýze sa klienti rozdelia do troch kategórií. Prehľad vidíte v paneli štatistík:
| Stav | Farba | Význam | Predvolená akcia |
|---|---|---|---|
| Nový | Zelená | Klient s daným IČO ešte neexistuje | Importovať |
| Existuje | Modrá | Klient s rovnakým IČO už je v systéme | Aktualizovať |
| Duplicita | Červená | Nájdených viac možných zhôd | Preskočiť |
Tabuľka importu
Tabuľka zobrazuje všetkých klientov zo SuperFaktúra:
| Stĺpec | Popis |
|---|---|
| Názov | Meno alebo názov firmy |
| IČO | Identifikačné číslo organizácie |
| Kontaktný email | |
| Adresy | Počet adries (fakturačná + dodacie) |
| Stav | Nový / Existuje / Duplicita |
| Akcia | Importovať / Aktualizovať / Preskočiť |
Výber akcie
Pre každého klienta môžete vybrať akciu:
- Importovať - Vytvorí nového klienta v Deratix
- Aktualizovať - Aktualizuje údaje existujúceho klienta
- Preskočiť - Klient sa neimportuje
Porovnanie údajov
Pri klientoch so stavom Existuje alebo Duplicita môžete porovnať údaje:
- Kliknite na ikonu 👁 (oko) v riadku klienta
- Otvorí sa dialóg s porovnaním:
- Vľavo: údaje zo SuperFaktúra
- Vpravo: aktuálne údaje v Deratix
- Rozdiely sú zvýraznené
- Rozhodnite sa pre akciu
Hromadný výber
Pre urýchlenie práce môžete použiť hromadné akcie:
- Vybrať všetko - Zaškrtne všetkých klientov na stránke
- Zrušiť výber - Odškrtne všetkých klientov
Spustenie
- Skontrolujte výber klientov a ich akcie
- Kliknite na Importovať (počet)
- Počkajte na dokončenie
Počas importu sa zobrazuje:
- Percento dokončenia
- Počet importovaných
- Počet aktualizovaných
- Počet preskočených
Výsledok importu
Po dokončení sa zobrazí súhrn:
| Kategória | Ikona | Popis |
|---|---|---|
| Importovaných | ✅ | Novo vytvorení klienti |
| Aktualizovaných | 🔄 | Klienti s aktualizovanými údajmi |
| Preskočených | ⏭️ | Klienti bez zmeny |
| Chýb | ❌ | Neúspešné operácie (ak nastali) |
Kliknite na Zobraziť klientov pre prechod do databázy klientov.
Čo sa importuje
Zo SuperFaktúra sa importujú tieto údaje:
Základné údaje klienta
- Názov firmy / Meno
- IČO, DIČ, IČ DPH
- Kontaktný email
- Telefónne číslo
- Kontaktná osoba
Adresy
- Fakturačná adresa - Ulica, mesto, PSČ
- Dodacie adresy - Importujú sa ako pobočky klienta
Konsolidácia podľa IČO
SuperFaktúra môže obsahovať viacero záznamov s rovnakým IČO (napr. rôzne pobočky). Deratix tieto záznamy automaticky konsoliduje:
- Klienti s rovnakým IČO sa zlúčia do jedného
- Rôzne adresy sa importujú ako pobočky
- Zachovajú sa všetky kontaktné údaje
Stránkovanie a radenie
Radenie
Tabuľku môžete radiť kliknutím na hlavičky stĺpcov:
- Názov (A-Z, Z-A)
- IČO
- Počet adries
- Stav
Stránkovanie
Pri veľkom počte klientov sa zobrazí stránkovanie. Navigujte pomocou tlačidiel « a ».
Opakovanie importu
Import môžete vykonať kedykoľvek opakovane:
- Noví klienti zo SuperFaktúra sa pridajú
- Existujúci klienti sa môžu aktualizovať
- Už importovaní klienti sa preskočia (ak nezmeníte akciu)
Tip: Pravidelným importom udržíte databázu klientov aktuálnu so SuperFaktúra.
Riešenie problémov
Import je pomalý
- Pri prvom importe sa sťahujú všetci klienti
- Čakanie závisí od počtu klientov vo SuperFaktúra
- Buďte trpezliví pri tisíckach klientov
Klient sa nezobrazuje
- Skontrolujte, či má klient vyplnené základné údaje vo SuperFaktúra
- Klienti bez názvu sa nemôžu importovať
Duplicitné záznamy
- Klienti sa párujú podľa IČO
- Klienti bez IČO sa vytvárajú vždy ako noví
- Po importe skontrolujte duplicity v databáze klientov
Chyba pripojenia počas importu
- Import sa automaticky zastaví
- Skontrolujte internetové pripojenie
- Spustite import znova - už importovaní klienti sa preskočia
Tipy pre efektívny import
Tip: Pred prvým importom vyčistite duplicitných klientov vo SuperFaktúra.
Tip: Pri prvom importe najprv importujte menšiu vzorku a skontrolujte výsledok.
Tip: Klienti sú párovaní podľa IČO. Uistite sa, že máte IČO vyplnené správne.
Tip: Po importe skontrolujte v detaile klienta správnosť adries a kontaktov.
Tip: Používajte akciu Aktualizovať pre synchronizáciu zmien zo SuperFaktúra.