# Propojení s bankou, úřady a e-shopem · Dokumentace DameDokladu

> 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.

Source: https://damedoklad.cz/docs/guides/connections/

# 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í.

Všechno je ve výchozím stavu vypnuté. Žádné z těchto propojení ještě neběželo proti skutečné bance, ostrému portálu úřadu, produkční datové schránce ani skutečnému e-shopu. Dnes spolehlivě funguje soubor příkazu, stažené XML a výpisy.

## 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:

1.  V **Banka, Příkazy** zvolíte u příkazu **Odeslat do banky**.
2.  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](/docs/authentication/). Ve výchozím stavu to nejde.
3.  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 |

**Povinnost tím nesplníte.** Odesílání je jen do testovacího prostředí. Ostré podávání zapne provozovatel až po kontrole daňovým poradcem, a do té doby XML dál stahujete a podáváte sami. Dosud nebylo odesláno žádné podání ani do testu.

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.