Platební brána Shopify Payments je pro e-shopy na platformě Shopify skvělou možností, jak zákazníkům rychle a snadno poskytnout rozmanité spektrum forem úhrady. Díky platební bráně Shopify Payments může váš zákazník použít svůj oblíbený způsob platby, ať již bude platit kartou, online bankovním převodem či moderními způsoby jako Apple Pay a Google Pay, zatímco vy jako provozovatel obchodu budete mít výhody nativní integrace s e-shopem.
Dativery v rámci projektu Bankovní výpisy umožňuje automatické a průběžné stahování výpisů z platební brány Shopify Payments do vašeho účetního systému ABRA Gen, a to bez nutnosti ručního stahování a nahrávání souborů. Celý proces tak probíhá automaticky a bez opakované účasti uživatele.
Výhoda automatického načítání výpisů
Automatické stahování plateb přináší spolehlivost, úsporu času i aktuální přehled o pohybech na účtu. Díky pravidelnému načítání výpisů každou hodinu máte informace o úhradách k dispozici téměř okamžitě. Zároveň odpadá nutnost ručního přenosu výpisů – pokud byste této činnosti věnovali každý pracovní den pouhých 10 minut, jedná se o více než čtyři hodiny měsíčně, které můžete využít efektivněji. Automatizovaný přenos plateb je proto ideálním řešením pro všechny, kteří potřebují mít o svých platbách aktuální přehled častěji než jednou za několik týdnů.
Obsah
Abyste mohli snadno přenášet platby z platební brány Shopify Payments do svého účetního systému ABRA Gen, budou potřeba následující kroky:
- Nastavit fiktivní bankovní účet v systému ABRA Gen.
- Zajistit uživatele pro připojení Dativery k ABRA Gen.
- Nainstalovat a nastavit Dativery Agent pro propojení ABRA Gen a Dativery.
- Připojit ABRA Gen k Dativery.
- Zajistit přístupové údaje do Shopify Payments.
- Aplikovat scénář propojení Shopify Payments API a systému ABRA Gen.
V následujícím textu jsou tyto kroky podrobně vysvětleny. Předpokládáme, že již máte vytvořený svůj účet v aplikaci Dativery.
Fiktivní bankovní účet v ABRA Gen
V systému ABRA Gen si nejprve založte nový fiktivní bankovní účet, na který budou následně nahrávány výpisy plateb z platební brány Shopify Payments. Nový bankovní účet vytvoříte v hlavním menu Agendy → Banka → Bankovní účty. Následně v pravém menu klepněte na tlačítko Nový a vyplňte potřebné údaje účtu.
- Do pole Název banky zadejte název fiktivního účtu, např. Shopify Payments CZK.
- Do pole Bankovní účet zadejte smyšlené číslo účtu, např. 123.
- Do pole Kód měny zadejte měnu, ve které je účet veden.
- Do pole Řada bankovních výpisů vyberte číselnou řadu, která se bude přiřazovat k importovaným bankovním výpisům.
- Do pole Zúčtovací středisko vyberte organizační jednotku firmy, která se bude přiřazovat k bankovním výpisům.
- Do pole První použité období zadejte rok, od kterého bude bankovní účet používán.
- Do pole Počátek zadejte počáteční zůstatek účtu k datu jeho zavedení.
- Dále můžete doplnit také specifický symbol, SWIFT, IBAN kód, země banky, řadu platebních příkazů nebo analytický účet.
Jednotlivé nahrávané transakce budou odkazovat na tento založený účet. Při aktivaci scénáře přenosu plateb v Dativery vyberete tento účet jako cílový.
Uživatel ABRA Gen pro přístupy Dativery
API je součástí všech verzí ABRA Gen a pro použití s Dativery jej stačí pouze aktivovat. API následně běží na serveru jako služba systému Windows.
Pro použití ABRA Gen s Dativery je potřeba mít zakoupenou samostatnou uživatelskou licenci. V ABRA Gen následně založte uživatele určeného pro Dativery a povolte mu možnost Umožnit přístup do API na spojení. Uživatelské jméno a heslo tohoto uživatele budete následně potřebovat při propojení ABRA Gen s platformou Dativery.
K vytvořenému uživateli je zároveň potřeba přiřadit roli, prostřednictvím které se v ABRA Gen nastavují jeho přístupová práva. Roli můžete uživateli přiřadit v agendě Uživatelé na záložce Role. Této roli následně nastavte oprávnění potřebná pro práci Dativery.
Pro přenos plateb je nutné roli povolit následující práva k objektům a funkcím:
- Práva k objektům:
- Bankovní účty → Zvolit konkrétní účet → Zobrazit
- Bankovní účty → Zvolit konkrétní účet → Použít
- Řady dokladů → Zvolit konkrétní řadu → Zobrazit
- Řady dokladů → Zvolit konkrétní řadu → Použít
- Střediska → Zvolit konkrétní středisko → Zobrazit
- Střediska → Zvolit konkrétní středisko → Použít
- Účetní řady → Zvolit konkrétní řadu → Zobrazit
- Účetní řady → Zvolit konkrétní řadu → Použít
- Zakázky → Zvolit konkrétní zakázku → Zobrazit
- Zakázky → Zvolit konkrétní zakázku → Použít
- Práva k funkcím:
- API funkce → Dávka → Vykonat
- Banka → Bankovní výpisy → Spustit
- Banka → Bankovní výpisy → Přidat
- Banka → Přehled plateb bankou → Spustit
- Nastavení → Období → Spustit
- Nastavení → Měny → Spustit
- Účetnictví → Účetní předkontace → Spustit
Dativery Agent
Dativery Agent představuje nejjednodušší a doporučený způsob propojení ABRA Gen s Dativery. Přístup k API je zajištěn prostřednictvím Dativery Agenta, takže není nutné řešit veřejné IP adresy, certifikáty, VPN ani další zabezpečení spojení – to zajišťuje samotný Dativery Agent.
Pro přístup k ABRA Gen navíc umí Dativery Agent provádět požadavky z pevné IP adresy, díky čemuž lze na firewallu nastavit další úroveň zabezpečení. Pokud chcete vědět více o bezpečnosti, přečtěte si článek ohledně bezpečnosti Dativery Agentu pro ABRA Gen.
Pro propojení postupujte následovně:
- Začněte stažením aktuální verze Dativery Agentu a nainstalujte jej na server, na kterém je dostupné API systému ABRA Gen.
- Je nutné mít aktivované ABRA Gen API. Dativery Agent se pokusí API aktivovat automaticky. Pokud se automatická aktivace nezdaří nebo ji nechcete využít, proveďte manuální aktivaci podle kompletního návodu ABRA Gen.
- Aktivujte ABRA Gen v Dativery Agentu. Po úspěšné aktivaci vygenerujte jednorázový kód, který následně použijete pro propojení ABRA Gen s platformou Dativery.
Pokud nechcete využít doporučené připojení prostřednictvím Dativery Agenta, jsou k dispozici také následující možnosti:
- ABRA Gen Online: Pokud využíváte ABRA Gen Online, kontaktujte přímo podporu ABRA Gen, která Vám poskytne údaje potřebné pro propojení s Dativery – konkrétně název serveru pro API nebo IP adresu Vaší instalace ABRA Gen serveru. Pokud omezujete přístup ke své instalaci ABRA Gen pouze na konkrétní IP adresy, je potřeba tuto skutečnost zohlednit také v nastavení připojení. Dativery bude následně k Vaší instalaci přistupovat pouze z IP adresy 46.101.177.29.
- Veřejná IP adresa a IIS: Připojení prostřednictvím veřejné IP adresy a IIS je technicky nejnáročnější variantou, proto doporučujeme, aby jeho nastavení prováděl zkušený IT administrátor. Postup naleznete v článku Instalace API pro ABRA Gen v sekci Veřejná IP adresa a IIS.
Připojení ABRA Gen v Dativery
V tomto kroku připojíte ABRA Gen k Dativery buď samostatně a nebo při aplikaci některého scénáře integrace. My si ukážeme samostatné připojení ABRA Gen:
- Ve webové aplikaci v pravém sloupci klepněte na položku Aplikace.
- Mezi aplikacemi najděte ABRA Gen a klepněte na něj.
- Na zobrazené stránce ABRA Gen klepněte na tlačítko +Propojit.
Zobrazí se Vám první krok přidání průvodce s formulářovými políčky:
- Zaškrtněte možnost Použít Dativery Agent a zadejte jednorázový kód/heslo vygenerované v Dativery Agentu.
Pozor, pokud využíváte ABRA Gen Online (nebo veřejnou IP adresu a IIS), možnost Použít Dativery Agent nezaškrtávejte a do pole Jméno serveru pro API zadejte adresu Vaší instalace, např. onlineapi.abra.eu/ZAKAZNIK. Pokud omezujete přístup ke své instalaci ABRA Gen pouze na konkrétní IP adresy, zaškrtněte možnost Přistupovat z pevné IP adresy. Dativery bude následně přistupovat pouze z IP adresy 46.101.177.29. Pokud přístup podle IP adres neomezujete, ponechte tuto možnost nezaškrtnutou. - Do polí Uživatel a Heslo zadejte přihlašovací údaje k ABRA Gen určeného pro Dativery. Přihlašovací údaje vždy považujeme za výjimečně citlivý údaj a ukládáme je v odděleném zabezpečeném úložišti s omezeným přístupem (viz též Zásady zpracování osobních údajů).
- V poli Domácí měna zvolte měnu, ve které je připojovaná firma účtována. V Česku obvykle česká koruna, na Slovensku euro.
- Klepněte na tlačítko Další pro přechod na druhý krok průvodce. Po odeslání se průvodce spojí s Vaší instalací ABRA Gen, aby ověřil zadané údaje. Pokud se spojení nezdaří, zobrazí se chybové hlášení s možností zobrazit provedený požadavek, získanou odpověď a obvykle i vysvětlení příčin chyby.
- Na druhém kroku průvodce vyberete z účtovaných firem tu, kterou chcete připojit.
- Stisknutím tlačítka Uložit nastavení je připojení aplikace ABRA Gen dokončené. Tu můžete zvolit při aplikaci libovolného scénáře integrace s ABRA Gen.
Na stránce propojené aplikace naleznete v pravém sloupci odkaz Nastavení připojení, pomocí kterého můžete průvodce připojením kdykoliv znovu otevřít – třeba v případě změny přihlašovacích údajů.
Integrace s ABRA Gen pro více firem
V případě, že potřebujete propojit integrace pro více účtovaných firem, připojte ABRA Gen pro každou účtovanou firmu samostatně.
Na stránce propojené aplikace naleznete v pravém sloupci odkaz Upravit vlastní název. Pomocí něj můžete každou propojenou aplikaci pojmenovat, a jednotlivá připojení tak mezi sebou snadno rozlišit.
Pokud připojujete více účtovaných firem, doporučujeme také zvážit založení samostatné organizace pro každou z nich. Více informací o správě více organizací naleznete v článku Fakturace.
Příprava přístupu pro Shopify Payments
Aby se Dativery mohlo připojit k vašemu účtu u Shopify Payments a přenášet informace o uskutečněných platbách, je potřeba získat tři údaje – jméno serveru e-shopu, Client ID a Secret. Všechny potřebné údaje získáte přímo v administraci Shopify.
Jméno serveru e-shopu zjistíte po přihlášení do administrace Shopify. V levém dolním rohu otevřete Nastavení a následně v levém menu zvolte Domény. Zde naleznete adresu Vašeho e-shopu, např. detskeboty.myshopify.com. Pro připojení v Dativery použijte právě adresu s doménou myshopify.com.
Vytvoření Client ID a Secret v Shopify
Pro propojení Shopify Payments s Dativery je potřeba vytvořit v Shopify vlastní aplikaci, prostřednictvím které Dativery získá potřebný přístup k Vašemu e-shopu.
- Přihlaste se do administrace Shopify. V levém dolním rohu otevřete Nastavení a v levém menu zvolte Aplikace. Následně klepněte na možnost Vyvíjet aplikace.
Poté na Vytvářet aplikace v Dev Dashboardu.
- Klepněte na tlačítko Vytvořit aplikaci, zadejte libovolný název aplikace, například Dativery, a vytvoření potvrďte.
- V nastavení vytvořené aplikace přejděte do sekce Adresy URL a do části Adresa URL aplikace vložte adresu https://app.dativery.com/.
- V sekci Přístup k API do části Rozsahy nastavte požadované oprávnění: read_all_orders,read_orders,write_orders,read_shopify_payments_payouts
- Do části Povolená URL přesměrování vložte adresu https://app.dativery.com/channel-granted/.
- Zaškrtněte možnost Používat starší postup instalace a následně klepněte na Vydat.
Následně se zobrazí potvrzovací okno. Klepněte na tlačítko Vydat, čímž vytvořenou verzi aplikace publikujete.
- Po publikování otevřete vytvořenou aplikaci a přejděte do části Nastavení aplikace. Zde naleznete ID klienta (Client ID) a Tajný kód (Secret). Oba údaje zkopírujte – budete je potřebovat při připojení Shopify Payments na platformě Dativery.
Upozornění: Client ID a zejména Secret považujte za citlivé přístupové údaje. Neukládejte je na veřejně dostupná místa ani je nesdílejte s neoprávněnými osobami.
Schválení oprávnění read_all_orders
Oprávnění read_all_orders vyžaduje předchozí schválení ze strany Shopify. Pokud se Vám při zadávání rozsahů pole zobrazí červeně a pod ním se objeví informace Obsahuje neplatné rozsahy: read_all_orders, je potřeba si nejprve vyžádat příslušné oprávnění.
- Klepněte na odkaz Požádat o přístup nad polem Rozsahy. Následně se otevře nové okno prohlížeče a budete přesměrováni do prostředí Shopify Partners. Vyberte účet, pod kterým chcete pokračovat, případně klepněte na Přidat účet a přihlaste se pomocí požadovaného účtu.
- V prostředí Shopify Partners přejděte v levém menu do sekce Distribution. Zvolte možnost Custom distribution a pokračujte klepnutím na tlačítko Select.
Zobrazí se potvrzovací okno. Pokračujte klepnutím na tlačítko Select custom distribution.
- Do pole Store domain zadejte adresu svého e-shopu Shopify v požadovaném tvaru, např. detskeboty.myshopify.com. Následně klepněte na tlačítko Generate link.
Zobrazí se potvrzovací okno. Pokračujte klepnutím na tlačítko Generate link.
- Následně v levém menu přejděte do sekce API access requests. Zde se zobrazí možnost Read all orders scope, prostřednictvím které můžete požádat o přístup ke kompletní historii objednávek. Klepněte na tlačítko Request access.
- Následně se zobrazí formulář, ve kterém Shopify požaduje zdůvodnění přístupu k objednávkám starším než 60 dní. Do textového pole stručně popište, že aplikace potřebuje přístup k historickým objednávkám pro přenos a zpracování souvisejících plateb v účetním systému. Po vyplnění zdůvodnění klepněte na tlačítko Request access a odešlete žádost o přístup.
- Po odeslání žádosti se vraťte do sekce API access requests. Pokud se u možnosti Read all orders scope zobrazí informace Your app can access the full order history for a store, bylo oprávnění úspěšně uděleno a aplikace má nyní přístup ke kompletní historii objednávek.
- Nakonec se vraťte do původního okna Dev Dashboardu, ve kterém jste aplikaci vytvářeli. Stránku aktualizujte a do pole Rozsahy znovu zadejte požadovaná oprávnění. Červené upozornění u read_all_orders se již nezobrazí a můžete pokračovat v nastavení aplikace a následném propojení Shopify Payments s Dativery.
Připojení Shopify Payments v Dativery
- V Dativery následně při připojení Shopify Payments API vyplníte jméno serveru e-shopu, Client ID a Secret. Podle současného formuláře se jako jméno serveru zadává pouze část adresy před .myshopify.com, např. pro detskeboty.myshopify.com zadáte pouze detskeboty. Poté klepněte na Uložit nastavení.
Po uložení nastavení se zobrazí informace, že je potřeba poskytnout Dativery přístup k vašim datům v Shopify Payments API. Klikněte na tlačítko Poskytnout přístup
- Následně budete automaticky přesměrováni na přihlašovací stránku Shopify. Přihlaste se pomocí svých přihlašovacích údajů.
- Po úspěšném přihlášení se zobrazí stránka s přehledem oprávnění, která vytvořená aplikace požaduje. Zkontrolujte požadované přístupy a klepněte na tlačítko Instalovat.
- Po dokončení instalace budete automaticky přesměrováni zpět na platformu Dativery, kde bude propojení s aplikací Shopify Payments API dokončeno a připraveno k použití.
Scénář přenosu plateb z Shopify Payments API
V dalším kroku aplikujte scénář přenosu plateb. Ideálně v nové záložce či okně prohlížeče si otevřete scénář Přenos plateb z Shopify Payments API do ABRA Gen a aplikujte jej.
- Použijte již připojenou aplikaci Shopify Payments API a klikněte na tlačítko Dále.
- Následně zvolte existující propojení s ABRA Gen nebo přidejte zcela nové tím, že vyplníte:
- Vygenerované jednorázové heslo při použití Dativery Agenta nebo adresu serveru pro API v případě ABRA Gen Online nebo připojení přes veřejnou IP adresu a IIS.
- Jméno uživatele pro přístup Dativery.
- Heslo k tomuto účtu.
- Domácí měnu, ve které je firma účtována.
- Stiskněte tlačítko Další, načež se Dativery zkusí na server připojit.
- Pokud uspěje, nabídne vám na výběr účtovanou společnost.
- V posledním kroku nastavte parametry přenosu plateb, tj.:
- Zvolte cílový bankovní účet v ABRA Gen.
- Zvolte středisko v ABRA Gen.
- Zadejte datum, od kterého mají být platby přenášeny.
- Vyplňte měnu transakcí na účtu v Shopify Payments.
- Zvolte, zda mají být vytvářeny i samostatné bankovní doklady pro netto částky a pro poplatky (doklady pro brutto částky budou vytvářeny vždy).
- Případně zvolte předkontaci brutto částek, netto částek a poplatků.
- Nastavení uložte.
- Aktivace je dokončena, stahování začíná.
Jak propojení funguje?
Dativery se připojuje k platební bráně Shopify Payments pravidelně každou hodinu po celý den. Navíc máte možnost kdykoliv ručně spustit okamžité stažení výpisu a jeho zpracování. Po získání výpisu plateb se automaticky provádí import pohybů na účtu do účetnictví ABRA Gen.
Scénáře nepodporují přímé nastavení automatického párování plateb s fakturami. Protože tuto funkci neřešíme na straně Dativery, doporučujeme obrátit se pro podrobnější informace přímo na podporu účetního systému ABRA Gen.
Pokud jste pro začátek přenosu plateb zvolili datum v hluboké minulosti, bude úvodní stažení historických plateb postupné a bude nějakou dobu trvat. Při každém připojení žádáme obvykle nanejvýše o 7 dní, takže jeden měsíc nazpět přeneseme v automatickém režimu za 4–5 hodin. Chcete-li přenést platby rychleji, můžete na stránce přenosu stisknout tlačítko Přenést platby – pokud neběží či není naplánovaný žádný přenos plateb, spustí tlačítko přenos plateb, stále s krokem 7 dní.
Doklady vytvořené v účetnictví ABRA Gen
Protože platební brána Shopify Payments poskytuje informace o poplatku z provedené platby, jsou pro každou platbu při importu vytvořeny tři bankovní doklady:
- doklad na brutto částku odpovídající částce hrazené zákazníkem,
- doklad na netto částku, tj. čistou částku, která vám bude platební bránou vyplacena,
- doklad na částku poplatku Shopify Payments za zpracování platby.
První doklad na brutto částku, tj. na částku zaplacenou zákazníkem, je vytvářen pro možnost párování s vydanou fakturou podle částky.
Vytváření druhého dokladu na netto částku, tj. na čistou částku vyplacenou platební bránou Shopify Payments, je potřeba pro nulování zůstatku fiktivního bankovního účtu.
Třetí doklad na částku poplatků za transakci umožňuje při správném zaúčtování sledovat výši nákladů na používání platební brány samotné.
Vytváření dokladů na netto částky a transakční poplatky je volitelná funkce. Je ale důležité počítat s tím, že tyto doklady nemají žádný odpovídající doklad, na který by se mohly automaticky napárovat. Stačí je pouze zaúčtovat – netto částky obvykle jako Peníze na cestě a transakční poplatky jako Bankovní poplatky.
Proti těmto dokladům se následně objeví další pohyby: výplata od platební brány, která dorazí na bankovní účet – ta souvisí s netto částkami, a vyúčtování poplatků, které je potřeba uhradit – to odpovídá transakčním poplatkům.
V nastavení flow můžete zvolit jednotlivé předkontace, které se použijí pro bankovní doklady s brutto částkou, netto částkou nebo transakčním poplatkem.
Zkusíte propojení hned?
Můžete zkusit přenášet výpisy plateb z Shopify Payments API do účetnictví ABRA Gen okamžitě, nemusíte na nic čekat.