Aktivní softwarová připojení a integrace
Vytvoření přístupových klíčů v eConnect

Vytvoření přístupových klíčů (App Key a Secret), Rychlé připojení, Email connector a zrušení připojení.

Pro připojení účetního softwaru k eConnect potřebujete přístupové klíče. Skládají se z App Key a Secret, pomocí kterých váš software bezpečně komunikuje s platformou eConnect. Můžete je vytvořit v několika krocích.

Co jsou přístupové klíče?

Přístupové klíče se skládají ze dvou částí:

  • App Key (také Consumer Key): identifikační kód vašeho připojení
  • Secret (také Consumer Secret): heslo zabezpečující připojení

Společně tvoří přihlašovací údaje, kterými váš software odesílá a přijímá faktury přes eConnect. Se Secret zacházejte jako s heslem a nesdílejte jej veřejně.

Vytvoření klíčů
  1. Přihlaste se na platform.econnect.eu.
  2. Přejděte na Mé prostředí a vyberte organizaci, pro kterou chcete připojení nastavit.
  3. Přejděte na Připojení nebo Připojit software (podle verze předplatného).
  4. Klikněte na Vytvořit nové připojení.
  5. Vyberte softwarový balíček ze seznamu.
  6. Platforma vygeneruje App Key a Secret. Zkopírujte je ihned: Secret se zobrazí pouze jednou.

Zadání klíčů do softwaru

Po vytvoření klíčů je zadejte ve svém softwarovém balíčku. Přesné umístění se liší podle balíčku, ale obecně platí tento postup:

  • Otevřete nastavení nebo konfiguraci softwarového balíčku.
  • Najděte sekci pro e-faktury, eConnect nebo Peppol.
  • Vložte App Key a Secret do určených polí.
  • Uložte nastavení a otestujte připojení.

U některých balíčků (například přes Rychlé připojení) můžete klíče vložit najednou pomocí CTRL+V v okně připojení.

Rychlé připojení

S Rychlým připojením zadáte klíče zrychleným způsobem. Místo kopírování App Key a Secret jednotlivě se otevře okno připojení, kde oba klíče vložíte najednou pomocí CTRL+V.

  1. Vytvořte přístupové klíče (viz výše).
  2. Klikněte na Rychlé připojení vedle vytvořeného připojení.
  3. Otevře se nové okno. Stiskněte CTRL+V: klíče se automaticky načtou.
  4. Vyberte administrativu, pro kterou chcete načítat faktury.
  5. Zadejte e-mailovou adresu propojenou s administrativou v softwarovém balíčku (ne e-mailovou adresu eConnect).
  6. Volitelně nastavte datum zahájení.
  7. Zvolte, zda chcete zpracovávat i prodejní faktury.
  8. Zaškrtněte potvrzovací políčko a klikněte na Použít.
Podporovaný software pro Rychlé připojení
SoftwareSměrBaseconePříjem (nákup + prodej)Exact MultiversOdesílání + PříjemWhiteVisionPříjem (nákup + prodej)YukiPříjem (nákup + prodej)RadarOdesílání

Tip: E-mailová adresa, kterou zadáte v Rychlém připojení, musí být adresa propojená s administrativou v softwarovém balíčku. Nepoužívejte e-mailovou adresu svého účtu eConnect.

Email connector

Jedno z připojení, které vytvoříte pomocí Rychlého připojení, se v platformě nazývá Email connector. Pozor: navzdory názvu funguje toto připojení prostřednictvím přístupových klíčů a patří do Připojení -- není při tom zasílán žádný e-mail. Nezaměňujte to s Email Receiver: to je aplikace, kterou sami přijímáte faktury e-mailem na platformě. Email connector dělá opak: automaticky přeposílá faktury přijaté přes eConnect na e-mailovou adresu dle vašeho výběru.

Email connectory s transformací

Kromě standardního Email connectoru existují varianty, které přijatý dokument transformují do konkrétního formátu (vždy SI 2.0, vždy BIS v3, vždy SI 1.2 nebo vždy SALES005 Faktura). Nastavení je stejné jako u standardního Email connectoru; eConnect zajistí dodání ve zvoleném formátu.

Email connector: přeposlání přijatých faktur

Jako příjemce můžete vytvořit Email connector, aby se faktury přijaté přes eConnect automaticky přeposílaly na zadanou e-mailovou adresu. Standardně se přitom odesílá pouze XML -- bez PDF nebo jiných příloh. Toto chování určuje parametr excludeAdditionalAttachments:

  • excludeAdditionalAttachments=true (standardně): další přílohy jako PDF se neodesílají.
  • excludeAdditionalAttachments=false: PDF a případné další přílohy se též odesílají.

U standardního Email connectoru (Collabrr auto-hook) je tento parametr nastaven na true. Chcete-li obdržet i PDF, může to upravit pouze Techsupport.

Pozor po úpravě Techsupportem: pokud jako klient poté sám upravujete Email connector, tato změna automaticky přepíše úpravu Techsupportu. PDF bude znovu potlačeno a nebude se již připojovat. Connector po opravě sami neupravujte.

Používáte-li namísto toho mailhook v PSB a connector si nastavujete sami, můžete si tento parametr nastavit sami -- to je samostatná, nezávislá self-service cesta.

Toto přeposlání je vhodnou alternativou pro příjemce, který (ještě) není v Peppolu, ale chce automaticky získat data faktury nebo PDF dokument.

Připojení více organizací

Pokud spravujete více organizací ve svém prostředí, vytvořte pro každou organizaci samostatnou sadu přístupových klíčů. App Key je jedinečný pro připojení organizace. Je možné používat stejný API klíč pro více organizací v rámci stejného softwarového balíčku, ale identifikátor specifický pro organizaci (například eConnect ID) musí být nastaven pro každou organizaci.

Ztratili jste klíče?

Pokud jste ztratili Secret, nelze vyžádat nový Secret. Musíte vytvořit novou sadu přístupových klíčů. Staré klíče přestanou platit. Nezapomeňte nové klíče aktualizovat také ve svém softwaru.

Bezpečnost

Přístupové klíče poskytují zabezpečený přístup k vaší organizaci eConnect. Mějte na paměti:

  • Klíče sdílejte pouze s osobou, která nastavuje připojení.
  • Secret uchovávejte na bezpečném místě (správce hesel).
  • Při podezření, že byly klíče kompromitovány, ihned vytvořte nové.
Zrušení připojení

Pokud chcete přejít na jinou metodu připojení nebo přestat používat softwarový balíček, můžete připojení zrušit.

  1. Přihlaste se na platform.econnect.eu.
  2. Přejděte na Připojení v příslušné organizaci.
  3. Klikněte na připojení, které chcete zrušit.
  4. Klikněte na Zrušit klíč.
  5. Připojení je nyní neaktivní.

Po zrušení můžete připojení zcela smazat: vraťte se do přehledu, klikněte na tři tečky vedle zrušeného připojení a zvolte Smazat připojení.

Zrušte připojení také ve svém softwarovém balíčku. Jinak se software bude dál pokoušet komunikovat přes staré klíče.

Opětovné připojení

Chcete se znovu připojit? Vytvořte novou sadu přístupových klíčů. Staré klíče po zrušení již nefungují.

Pozor: pokud přecházíte na Autopilot, musíte nejprve zrušit staré připojení. Dvě aktivní připojení ke stejné administrativě mohou kolidovat.

Co se stane s vašimi fakturami?

Zrušení nemá vliv na faktury, které již byly odeslány nebo přijaty. Nové faktury se přes staré připojení již nevyměňují. Faktury, které byly připravené, ale nebyly načteny, lze načíst později opětovným připojením a použitím „Znovu nabídnout API“.

Často kladené otázky
Co mám dělat, když jsem ztratil Secret?

Pokud jste ztratili Secret, nelze vyžádat nový. Musíte vytvořit novou sadu přístupových klíčů, čímž staré klíče přestanou platit. Nezapomeňte nové klíče aktualizovat také ve svém softwaru.

Můj software chce heslo nebo secret, co mám zadat?

Mnoho softwarových balíků nazývá pole Secret "heslo" nebo "secret". Obvykle se jedná o App Secret, nikoli o vaše přihlašovací heslo k eConnect platformě. Přihlaste se na platform.econnect.eu jako správce organizace, otevřete danou organizaci a přejděte na Připojení. Vytvořte nové připojení a okamžitě si zapište App Key a Secret: Secret poté není celý už viditelný. Oba údaje zadejte do eConnect připojení svého softwaru. Pokud autentizace stále selhává, sdělte, jaký software používáte, jaká pole software zobrazuje (uživatelské jméno/heslo, App Key/Secret nebo Client ID/Client Secret) a přesné znění chybové hlášky.

Mohu používat stejné přístupové klíče pro více organizací?

Je možné používat stejný API klíč pro více organizací v rámci stejného softwarového balíčku, ale identifikátor specifický pro organizaci (například eConnect ID) musí být nastaven pro každou organizaci. Pro nejlepší zabezpečení se doporučuje používat samostatnou sadu klíčů pro každou organizaci.

Co se stane s mými fakturami, když zruším připojení?

Zrušení nemá vliv na faktury, které již byly odeslány nebo přijaty. Nové faktury se přes staré připojení již nevyměňují. Faktury, které byly připravené, ale ještě nebyly načteny, lze načíst později opětovným připojením.

Jaký je rozdíl mezi Email connectorem a Email Receiverem?

Email connector je Připojení: automaticky přeposílá faktury přijaté přes eConnect na e-mailovou adresu dle vašeho výběru. Email Receiver je aplikace: tímto sami přijímáte faktury e-mailem na platformě. Obě používají slovo "email", ale fungují opačným směrem a jsou umístěny na jiném místě platformy.


Připraveni připojit software? Podívejte se, která integrační metoda se hodí k vašemu balíčku.

Vytvořte přístupové klíče