Začíname
Pripojenie ABRA Flexi
Ako vo Flexi pripraviť používateľa pre API, kde nájsť adresu servera a kód firmy a ako pripojenie otestovať.
eFaktúra mostík sa k ABRA Flexi pripája cez jeho REST API – číta vydané faktúry, ich položky, odberateľov a PDF tlač a voliteľne zapisuje štítky so stavom e-faktúry. Do Flexi nič iné nezapisuje. Názvy menu nižšie sa môžu podľa verzie a jazyka Flexi mierne líšiť.
1. Prístup k API v licencii ABRA Flexi
REST API nie je súčasťou základnej licencie. Vo Flexi musí byť aktivovaný doplnok Prístup k API – v webovom rozhraní cez Nastavenia → Licencia a predplatné → Prehľad → Aktivovať prístup k API. Po aktivácii môžete založiť ľubovoľný počet API používateľov.
Podrobne: Licencovanie prístupu k API (podpora ABRA Flexi).
Licencie majú denný limit požiadaviek na API (Basic 5 000, Business 10 000, Premium 20 000 denne). Pri bežnom používaní eFaktúra mostík spotrebuje na kontrolu nových faktúr približne 100 požiadaviek denne a pri každej odoslanej faktúre niekoľko ďalších. Ak API používate aj s inými aplikáciami, môžete interval kontroly predĺžiť v pravidlách prenosu.
2. Používateľ pre API
Pre eFaktúra mostík založte vo Flexi samostatného používateľa – nikdy nepoužívajte prihlasovacie údaje bežného používateľa.
- Webové rozhranie: Nastavenia → Prehľad používateľov → Založiť používateľa a ako typ zvoľte API prístup. V desktopovej aplikácii: Nástroje → Používatelia vo firme → Nový, záložka Prihlasovacie údaje, typ REST API.
- Zadajte prihlasovacie meno (napr.
efaktura) a silné heslo. - Priraďte rolu s prístupom k Faktúram vydaným: na čítanie stačí čítanie; ak chcete zapisovať štítky so stavom, aj zmenu existujúcich faktúr. Vlastnú rolu vytvoríte v Nástroje → Používateľské role skopírovaním rozsiahlejšej roly a obmedzením práv.
- Používateľovi nezapínajte dvojfázové overenie – aplikácia sa prihlasuje automaticky a overovací kód zadať nevie.
Podrobne: Ako pracovať s používateľmi, Používateľské role a návod Doklado Vytvorenie API používateľa ABRA Flexi.
3. Adresa servera a kód firmy
- Adresa servera – pri ABRA Flexi v cloude adresa v tvare
https://vasa-firma.flexibee.eu. Pri vlastnom serveri jeho adresa aj s portom, zvyčajne:5434(zistíte u správcu servera). - Kód firmy (databáza) – po prihlásení do Flexi v prehliadači je to časť adresy za
/c/alebo/flexi/, napr.moja_firma_s_r_o_. Najjednoduchšie je skopírovať celú adresu z prehliadača do poľa Adresa servera – kód firmy sa doplní sám.
Po obnove databázy zo zálohy sa kód firmy vo Flexi môže zmeniť – potom ho treba upraviť aj v eFaktúra mostík.
4. Pripojenie v aplikácii
- Otvorte Nastavenia → ABRA Flexi.
- Vyplňte adresu servera, používateľa a heslo API používateľa a kód firmy. Pri vlastnom serveri s nedôveryhodným (vlastnoručne podpísaným) certifikátom môžete vypnúť overovanie SSL certifikátu – odporúčame však na serveri nainštalovať platný certifikát.
- Kliknite na Uložiť a otestovať. Aplikácia sa prihlási do Flexi a overí prístup k vydaným faktúram.
Heslo je uložené šifrované a nikde sa nezobrazuje; pri ďalšej úprave ho vyplníte len pri zmene. Pri vlastnom serveri musí byť ABRA Flexi dostupné z internetu (verejná adresa a povolený port na firewalle).
Faktúry vo Flexi
- Faktúry vystavujete ako doteraz v Predaj → Vydané faktúry. Ktoré typy dokladov sa posielajú, určíte v pravidlách prenosu.
- Odberateľ musí mať vyplnené DIČ – podľa neho sa určí jeho adresa v sieti Peppol.
- Dátum zdaniteľného plnenia (dodania) určuje zákonnú lehotu na odoslanie.
- Pri chýbajúcich údajoch aplikácia faktúru označí ako Neúplné údaje a vypíše, čo treba vo Flexi doplniť.
Nenašli ste odpoveď? Napíšte nám na efaktura@nva.sk.