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íte nastaviť prepojenie so SuperFaktúra:
Požadované údaje
Pre konfiguráciu potrebujete tri údaje z vášho 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)
Nastavenie v Deratix
- Prejdite do administrácie
- Otvorte Nastavenia → Integrácie
- V sekcii SuperFaktúra vyplňte:
- Email účtu
- API kľúč
- Company ID
- Kliknite na Uložiť
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.