Na pripojenie účtovného softvéru k eConnect potrebujete prístupové kľúče. Skladajú sa z App Key a Secret, pomocou ktorých váš softvér bezpečne komunikuje s platformou eConnect. Môžete ich vytvoriť v niekoľkých krokoch.

Prístupové kľúče sa skladajú z dvoch častí:

• App Key (tiež Consumer Key): identifikačný kód vášho pripojenia
• Secret (tiež Consumer Secret): heslo zabezpečujúce pripojenie

Spoločne tvoria prihlasovacie údaje, ktorými váš softvér odosiela a prijíma faktúry cez eConnect. So Secret zaobchádzajte ako s heslom a nezdieľajte ho verejne.

1. Prihláste sa na platform.econnect.eu.
2. Prejdite na Moje prostredie a vyberte organizáciu, pre ktorú chcete pripojenie nastaviť.
3. Prejdite na Pripojenia alebo Pripojiť softvér (podľa verzie predplatného).
4. Kliknite na Vytvoriť nové pripojenie.
5. Vyberte softvérový balík zo zoznamu.
6. Platforma vygeneruje App Key a Secret. Skopírujte ich ihneď: Secret sa zobrazí iba raz.

Po vytvorení kľúčov ich zadajte vo svojom softvérovom balíku. Presné umiestnenie sa líši podľa balíka, ale všeobecne platí tento postup:

• Otvorte nastavenia alebo konfiguráciu softvérového balíka.
• Nájdite sekciu pre e-faktúry, eConnect alebo Peppol.
• Vložte App Key a Secret do určených polí.
• Uložte nastavenia a otestujte pripojenie.

Pri niektorých balíkoch (napríklad cez Rýchle pripojenie) môžete kľúče vložiť naraz pomocou CTRL+V v okne pripojenia.

S Rýchlym pripojením zadáte kľúče zrýchleným spôsobom. Namiesto kopírovania App Key a Secret jednotlivo sa otvorí okno pripojenia, kde oba kľúče vložíte naraz pomocou CTRL+V.

1. Vytvorte prístupové kľúče (pozri vyššie).
2. Kliknite na Rýchle pripojenie vedľa vytvoreného pripojenia.
3. Otvorí sa nové okno. Stlačte CTRL+V: kľúče sa automaticky načítajú.
4. Vyberte administratívu, pre ktorú chcete načítavať faktúry.
5. Zadajte e-mailovú adresu prepojenú s administratívou v softvérovom balíku (nie e-mailovú adresu eConnect).
6. Voliteľne nastavte dátum začatia.
7. Zvoľte, či chcete spracovávať aj predajné faktúry.
8. Začiarknite potvrdzovacie políčko a kliknite na Použiť.

Tip: E-mailová adresa, ktorú zadáte v Rýchlom pripojení, musí byť adresa prepojená s administratívou v softvérovom balíku. Nepoužívajte e-mailovú adresu svojho účtu eConnect.

Jedno z pripojení, ktoré vytvoríte pomocou Rýchleho pripojenia, sa v platforme nazýva Email connector. Upozornenie: napriek názvu funguje toto pripojenie prostredníctvom prístupových kľúčov a patrí do Pripojenia -- žiadny e-mail sa pritom nezasiela. Nezamňajte to s Email Receiver: to je aplikácia, ktorou sami prijímate faktúry e-mailom na platforme. Email connector robí opak: automaticky posiela ďalej faktúry prijaté cez eConnect na e-mailovú adresu podľa vášho výberu.

Okrem štandardného Email connectora existujú varianty, ktoré prijatý dokument transformujú do konkrétneho formátu (vždy SI 2.0, vždy BIS v3, vždy SI 1.2 alebo vždy SALES005 Faktúra). Nastavenie je rovnaké ako pri štandardnom Email connectore; eConnect zabezpečí dodanie vo zvolenom formáte.

Ako príjemca môžete vytvoriť Email connector, aby sa faktúry prijaté cez eConnect automaticky posielali ďalej na uvedenú e-mailovú adresu. Štandardne sa pritom odosiela iba XML -- bez PDF alebo iných príloh. Toto správanie určuje parameter excludeAdditionalAttachments:

• excludeAdditionalAttachments=true (štandardne): dodatočné prílohy ako PDF sa neodosielajú.
• excludeAdditionalAttachments=false: PDF a prípadné iné prílohy sa tiež odosielajú.

Pri štandardnom Email connectore (Collabrr auto-hook) je tento parameter nastavený na true. Ak chcete dostať aj PDF, môže to upraviť len Techsupport.

Upozornenie po úprave Techsupportom: ak si ako klient poté sám upravujete Email connector, táto zmena automaticky prepíše úpravu Techsupportu. PDF bude znova potlačené a nebude sa už prikladatť. Connector po oprave sami neupravujte.

Ak namíesto toho používate mailhook v PSB a connector si nastavujete sami, môžete si tento parameter nastaviť sami -- to je samostatná, nezávislá self-service cesta.

Toto posielanie ďalej je vhodnou alternatívou pre príjemcu, ktorý (ešte) nie je v Peppole, ale chce automaticky získať dáta faktúry alebo PDF dokument.

Ak spravujete viac organizácií vo svojom prostredí, vytvorte pre každú organizáciu samostatnú sadu prístupových kľúčov. App Key je jedinečný pre pripojenie organizácie. Je možné používať rovnaký API kľúč pre viac organizácií v rámci rovnakého softvérového balíka, ale identifikátor špecifický pre organizáciu (napríklad eConnect ID) musí byť nastavený pre každú organizáciu.

Ak ste stratili Secret, nemožno vyžiadať nový Secret. Musíte vytvoriť novú sadu prístupových kľúčov. Staré kľúče prestanú platiť. Nezabudnite nové kľúče aktualizovať aj vo svojom softvéri.

Prístupové kľúče poskytujú zabezpečený prístup k vašej organizácii eConnect. Majte na pamäti:

• Kľúče zdieľajte iba s osobou, ktorá nastavuje pripojenie.
• Secret uchovávajte na bezpečnom mieste (správca hesiel).
• Pri podozrení, že boli kľúče kompromitované, ihneď vytvorte nové.

Ak chcete prejsť na inú metódu pripojenia alebo prestať používať softvérový balík, môžete pripojenie zrušiť.

1. Prihláste sa na platform.econnect.eu.
2. Prejdite na Pripojenia v príslušnej organizácii.
3. Kliknite na pripojenie, ktoré chcete zrušiť.
4. Kliknite na Zrušiť kľúč.
5. Pripojenie je teraz neaktívne.

Po zrušení môžete pripojenie úplne vymazať: vráťte sa do prehľadu, kliknite na tri bodky vedľa zrušeného pripojenia a zvoľte Vymazať pripojenie.

Zrušte pripojenie aj vo svojom softvérovom balíku. Inak sa softvér bude ďalej pokúšať komunikovať cez staré kľúče.

Chcete sa znova pripojiť? Vytvorte novú sadu prístupových kľúčov. Staré kľúče po zrušení už nefungujú.

Pozor: ak prechádzate na Autopilot, musíte najprv zrušiť staré pripojenie. Dve aktívne pripojenia k rovnakej administratíve môžu kolidovať.

Zrušenie nemá vplyv na faktúry, ktoré už boli odoslané alebo prijaté. Nové faktúry sa cez staré pripojenie už nevymieňajú. Faktúry, ktoré boli pripravené, ale neboli načítané, možno načítať neskôr opätovným pripojením a použitím „Znova ponúknuť API“.

Pripravení pripojiť softvér? Pozrite sa, ktorá integračná metóda sa hodí k vášmu balíku.