Průvodce
Propojení s bankou, úřady a e-shopem
Příkazy přes rozhraní banky, odeslání podání do testovacího prostředí a e-shopy. Co funguje, co je vypnuté a co jsme nezkoušeli.
Propojení najdete v Nastavení, Další, Propojení. Vidí je vlastník a účetní. Pokud žádné nepoužíváte, nikde jinde se neobjeví.
Banky
| Banka | Co je postavené | Stav |
|---|---|---|
| Fio banka | Příkazy (CZK, EUR, zahraniční), inkaso i SEPA inkaso, pohyby | Podle dokumentace banky. Fio nemá testovací prostředí, zkoušeno proti naší maketě |
| Raiffeisenbank | Příkazy (CZK, EUR, zahraniční), tuzemské inkaso, stav dávky, pohyby | Neověřeno, podle zveřejněné specifikace. Testovací prostředí banky vyžaduje registraci, zkoušeno proti naší maketě |
| Komerční banka | Příkazy (CZK, EUR), stav dávky, pohyby. Zahraniční platby a inkasa jejich dávkové API nepřijímá | Neověřeno, podle zveřejněné příručky a specifikace |
| Banka CREDITAS | Příkazy (CZK, EUR, zahraniční), stav importu, pohyby. Inkaso přes API neposíláme | Neověřeno, podle konzole banky a klienta od třetí strany. Testovací prostředí jsme nenašli |
| Česká spořitelna | Příkazy (jen CZK), stav dávky, pohyby. Dávku podepíšete v George | Neověřeno. Portál banky bez registrace nic neukáže: podle veřejného standardu ČOBS a klienta od třetí strany, zkoušeno proti naší maketě |
| ČSOB | Příkazy (CZK, EUR), protokol o importu, pohyby z výpisů GPC. Příkaz podepíšete v CEB. Zahraniční platby a inkaso neposíláme | Neověřeno. Podle kopií příručky a WSDL banky od třetích stran, zkoušeno proti naší maketě |
| MONETA | Pohyby, a přes API PSD2 tuzemské platby v korunách, každou podepíšete v Internet Bance zvlášť. Příkazy chtějí přístup PSD2 od provozovatele s licencí | Neověřeno. Příkazy podle dokumentu banky a standardu ČOBS, pohyby podle klientů od třetích stran, zkoušeno proti naší maketě |
Odesílání příkazů musí nejdřív povolit provozovatel a pak vy u konkrétního účtu.
Když je zapnuté, odeslání vypadá takto:
- V Banka, Příkazy zvolíte u příkazu Odeslat do banky.
- Uvidíte příjemce a částky, zaškrtnete, že jste je zkontrolovali, a odešlete. Musí to být vlastník nebo účetní. Přes API klíč nebo AI agenta to jde jen tehdy, když to vlastník výslovně zapnul a nastavil limity. Ve výchozím stavu to nejde.
- Příkaz se nahraje do banky. Peníze odejdou, až ho v internetovém bankovnictví autorizujete.
Když banka neodpoví, výsledek je neznámý: dávka tam být může. Aplikace příkaz sama znovu nepošle. Zkontrolujte internetové bankovnictví a potvrďte, že tam dávka není.
Úřady
Odeslání je dostupné z obrazovek podání, když máte zapnutý kanál:
| Kanál | Co potřebujete | Testovací prostředí |
|---|---|---|
| Datová schránka | Přihlašovací jméno a heslo k testovací schránce | Veřejný test ISDS, schránku si zřídíte zdarma |
| EPO, Finanční správa | Kvalifikovaný certifikát | Kontrola souboru na adrese Finanční správy, bez podání. Musí ji povolit provozovatel |
| e-Podání ČSSZ | Kvalifikovaný certifikát a registrace u ČSSZ | Testovací brána ČSSZ. Měsíční hlášení a registrace tudy zatím nejdou |
Ostře půjde jen datová schránka, která podpis nepotřebuje. Přes EPO a e-Podání ČSSZ by podání podepsal server vaším kvalifikovaným certifikátem bez vás, a to aplikace nedělá: tyto kanály slouží jen ke zkoušce. Stažené XML můžete vždy podat sami.
Stejný soubor jako ke stažení se odešle až po vašem potvrzení. Stav se pak čte zpět.
Pozor na došlou poštu. Zapnete-li u datové schránky čtení odpovědí úřadů, aplikace si stáhne seznam došlých zpráv. Tím se ze zákona doručí všechny zprávy čekající ve schránce a mohou začít běžet lhůty. Proto je to vypnuté. Bez toho aplikace vidí jen, že byla vaše zpráva doručena, a odpověď ČSSZ najdete ve schránce sami.
E-shopy
Shoptet, Shopify a WooCommerce. Objednávky přicházejí sem a rezervují zboží. Odsud jde stav skladu, produkty a stav objednávek. Každý směr zapínáte zvlášť.
- Jedna objednávka je vždy jeden doklad, i když se přečte vícekrát.
- Co selhalo, je v záznamu synchronizace po položkách, a znovu se to zkusí při další synchronizaci.
- Zboží s neznámým kódem zůstane na objednávce jako text a nic nerezervuje. Záznam na to upozorní.
- U položky v kartě Další nastavíte, ve kterých e-shopech se prodává, její kategorie, parametry a popisy. Bez e-shopu to neuvidíte.
- Produkty: položky zařazené do e-shopu se v něm založí nebo aktualizují, včetně kategorií, parametrů, obrázků a EAN. Produkt se stejným kódem se převezme, nezaloží se podruhé. Co se nezměnilo, se neposílá. Sada se neposílá a varianty jdou jako samostatné produkty. V Nastavení zvolíte, zda posílat cenu s DPH, bez DPH, nebo vůbec. E-shop v jiné měně cenu posílat nesmí, ceny položek jsou v korunách.
- GPSR: výrobce, odpovědná osoba v EU, EAN výrobku a bezpečnostní informace se připojí na konec popisu produktu, protože žádná z platforem na ně nemá vlastní pole. To chce čl. 19 nařízení (EU) 2023/988 u nabídky na dálku; název a obrázky jsou v produktu samy. Bezpečnostní informace pište česky.
- Stav objednávky: e-shop se dozví, že je objednávka rozpracovaná, vyřízená nebo zrušená, každý stav jednou. U Shoptetu v Nastavení přiřadíte stavy z vašeho e-shopu, stav bez přiřazení se neposílá. U Shopify je vyřízení odeslání zásilky a zrušení zrušení bez vrácení peněz a bez naskladnění, to rozhodnete v Shopify. Rozpracovaná objednávka se do Shopify neposílá.
- Upozornění: po registraci a zapnutí pošle e-shop zprávu hned, jak objednávka vznikne nebo se změní, a objednávka je tu do minuty. Pravidelné čtení po 15 minutách běží dál. Objednávka zrušená v e-shopu tady uvolní rezervaci, pokud už zboží neodešlo. U Shopify nejdřív zadejte tajný klíč vlastní aplikace. Upozornění potřebují veřejnou adresu https serveru.
Shoptet jsme vyzkoušeli proti jeho oficiálnímu testovacímu rozhraní, které vrací ukázková data, Shopify a WooCommerce proti vlastní maketě. Na skutečném e-shopu to zatím nikdo nezkoušel. První produkt v e-shopu proto zkontrolujte, hlavně cenu: Shoptet v dokumentaci neuvádí, zda jeho cena obsahuje DPH.
Konektory pro POHODU
Propojení psaná pro POHODA mServer mohou posílat XML na /v1/pohoda/xml. Jako heslo v hlavičce STW-Authorization použijte API klíč. Umí vypsat adresář, zásoby, objednávky, faktury a kategorie, přidat, upravit a smazat adresu a zásobu, přidat a smazat objednávku a převzít fakturu jako koncept. Klíč jen pro čtení umí jen vypisovat.
Odpovědi odpovídají schématům Stormware, ale se skutečným konektorem to nikdo nezkoušel. Každý záznam má číselné ID jako v POHODĚ, které se nemění a po smazání se znovu nepoužije. Adresy a zásoby jde upravit i smazat, přijatou objednávku smazat, a to tak, že se koncept odstraní a vystavená se stornuje. U faktur schéma POHODY úpravy ani mazání nenabízí, proto je server odmítne. Záznam, který se už používá, se nesmaže, stejně jako v aplikaci.