Pripojenie SuperFaktúry
Deratix odosiela faktúry do SuperFaktúry cez jej rozhranie. Potrebuje na to tri údaje z vášho účtu v SuperFaktúre. Odporúčame najprv všetko vyskúšať so skúšobným účtom SuperFaktúry, aby sa do vašej ostrej SuperFaktúry pri skúške nič neodoslalo.
Skúšobný účet SuperFaktúry (sandbox)
SuperFaktúra poskytuje bezplatné skúšobné prostredie na adrese sandbox.superfaktura.sk. Je to samostatná kópia SuperFaktúry s vlastným prihlásením a vlastnými prístupovými údajmi; s vašou ostrou SuperFaktúrou nijako nesúvisí.
- Otvorte sandbox.superfaktura.sk/registracia a zaregistrujte sa (e-mail a heslo). Registrácia je zadarmo.
- Po prihlásení založte firmu (stačí názov a DIČ; podľa SuperFaktúry tým získate 30 dní plnej verzie).
- V skúšobnej SuperFaktúre otvorte Nástroje → API prístup a poznačte si API kľúč. Poznačte si aj ID firmy (Company ID), ktoré nájdete v nastaveniach účtu.
Poznámka: Ak skúšku vynecháte, môžete rovno použiť údaje z ostrej SuperFaktúry. V takom prípade si prvé faktúry po odoslaní pozorne skontrolujte v SuperFaktúre.
Zadanie prístupových údajov
- Otvorte Nastavenia → Integrácie a vľavo vyberte SuperFaktúra.
- Vyplňte SuperFaktúra Email (e-mail, ktorým sa do SuperFaktúry prihlasujete), SuperFaktúra API kľúč a SuperFaktúra Company ID. Pri skúške použite údaje zo skúšobného účtu, naostro údaje z ostrej SuperFaktúry.
- Kliknite Uložiť a potom Test pripojenia. Správny výsledok je Pripojenie OK.
Poznámka: Prístupové údaje zadáva správca. Neukladajte ich do poznámok v protokoloch ani do zdieľaných dokumentov. Tie isté údaje používa aj import klientov zo SuperFaktúry.
Prostredie a test pripojenia
- Otvorte Nastavenia → Fakturácia, kartu SuperFaktúra.
- Trh SuperFaktúry nechajte Slovensko (superfaktura.sk).
- Prostredie: pri skúške zvoľte Sandbox (testovanie), naostro Produkcia. Prostredie musí zodpovedať zadaným údajom: skúšobný kľúč funguje len so sandboxom, ostrý kľúč len s produkciou.
- Kliknite Otestovať pripojenie a uložte nastavenia.
Upozornenie: Doklady odoslané do sandboxu nie sú skutočné. Každá faktúra si pamätá, kam bola odoslaná; prepnutie prostredia po odoslaní dokladov sa zapíše do histórie a takú faktúru už nemožno odoslať inam.
Ak test pripojenia zlyhá
| Hlásenie | Príčina | Riešenie |
|---|---|---|
| „SuperFaktúra odmietla prihlasovacie údaje pre prostredie …“ | zadaný kľúč patrí k inému prostrediu, než je zvolené | zadajte kľúč zo správneho účtu, alebo prepnite prostredie |
| „Pripojenie zlyhalo“ bez poznámky o prostredí | preklep v e-maile, kľúči alebo Company ID | skopírujte údaje znova z Nástroje → API prístup |
| „SuperFaktúra nie je nakonfigurovaná“ | chýba e-mail, kľúč alebo Company ID | doplňte všetky tri údaje v Nastavenia → Integrácie |