- Nápověda
- Banky a platby
Banky a platbyNávod krok za krokem
PayPal: platby, poplatky a výběry v účetnictví Doruna
Jak propojit účet PayPal s Doruna. Platby, poplatky, vratky a výběry na banku se stahují samy a platby se spárují s fakturami.
Obsah návodu
Co propojení umí
- Každou noc ve 2:40 stáhne z PayPal transakce účtu: přijaté i odeslané platby, poplatky PayPal, vratky a chargebacky, výběry na bankovní účet a převody mezi měnami. Kdykoli je stáhnete i tlačítkem Synchronizovat nyní.
- Přijatou platbu zapíše v plné (hrubé) částce a poplatek PayPal k ní zvlášť.
- Platbu spáruje s vydanou fakturou v Doruna podle Invoice ID, které obchod posílá do PayPal — když se shoduje s variabilním symbolem nebo číslem faktury a sedí i částka.
- Poplatky PayPal a výběry na bankovní účet zaúčtuje sama, bez DPH. Poplatek v cizí měně přepočte kurzem ČNB ke dni transakce.
- Výběr z PayPal spáruje s příchozí platbou od PayPal na bankovním účtu v Doruna podle částky a dne.
- Pro každou měnu zůstatku v PayPal založí v Platbách vlastní účet PayPal.
- Funguje na tarifech Pro a Business. Na Free a Start okno ukáže Dostupné od tarifu Pro s odkazem na změnu tarifu.
Co propojení neumí
- Nic v PayPal neposílá, nevrací ani nemění — jen čte. Platbu, vratku ani výběr přes Doruna v PayPal neuděláte.
- Nevystavuje faktury z plateb. Platba bez faktury v Doruna zůstane v Platbách k zaúčtování — fakturu k ní vystavte, nebo ji zaúčtujte přímo.
- Převody mezi měnami sama nezaúčtuje — zaúčtujete je v Platbách (postup potvrdí účetní).
- Vratky a chargebacky s opravným dokladem sama nepáruje — spárujete je v Platbách.
- Blokace peněz (spor, kontrola platby, rezerva) do Plateb nepřenáší — peníze jsou dál vaše; skutečné stržení přijde jako vratka nebo chargeback.
- Čekající platby (stav Pending) převezme až po jejich dokončení. Novou transakci PayPal ukáže nejpozději do tří hodin.
- Transakce starší než tři roky PayPal nevydá.
Co k tomu potřebujete
- Firemní účet PayPal (PayPal Business) a přístup do PayPal Developer (developer.paypal.com) — přihlásíte se týmž účtem.
- REST aplikaci v PayPal Developer v režimu Live se zapnutým Transaction Search a její Client ID a Secret.
- Tarif Doruna Pro nebo Business (na Free a Start se brána nepřipojí ani nesynchronizuje).
- V Doruna roli s přístupem k platbám (menu Platby), která smí měnit data.
- Účetní, která potvrdí schéma účtů — Doruna předběžně založí účty 261xxx (PayPal – peníze na cestě) a 518xxx (PayPal poplatky) a výběry účtuje přes 261000.
Část 1: aplikace v PayPal Developer
Aplikaci si vytvoříte ve svém účtu PayPal — Doruna k ní dostane jen Client ID a Secret.
Část 2: připojení v Doruna
Připojení najdete v Nastavení na záložce Integrace, v části Platební integrace.
Jak to funguje
- Při připojení Doruna založí v účtové osnově účet 518xxx „PayPal poplatky“. Účet PayPal v Platbách („Účet PayPal“, v jiné měně třeba „Účet PayPal (EUR)“) a jeho účet 261xxx „PayPal – peníze na cestě“ založí s první transakcí v dané měně.
- Synchronizace stahuje transakce po obdobích nejvýš 30 dní, od posledního staženého dne (14 dní zpět — kvůli čekajícím platbám a zpoždění PayPal) do dneška. Z každé transakce zapíše řádek s částkou a, má-li poplatek, i řádek poplatku. Den řádku je den vzniku transakce.
- Každý pohyb se uloží jen jednou — další synchronizace ho přeskočí.
- Čekající platby (stav Pending) si Doruna pamatuje a při každé synchronizaci se na ně PayPal zeptá znovu. Dokončenou převezme se dnem, kdy vznikla, i když to trvá týdny; zamítnutou vynechá. Čeká-li platba déle než 30 dní, ukáže upozornění.
- Platbu Doruna spáruje s vydanou fakturou nebo zálohovou fakturou, když se Invoice ID (nebo Custom ID) z PayPal shoduje s variabilním symbolem nebo číslem faktury, faktura je ve stejné měně a zbývá na ní zaplatit přesně částka platby. Najde-li takových faktur víc, nepáruje — vyberete sami.
- Spárované platby zaúčtujete v Platbách na účtu PayPal (i hromadně). Poplatky Doruna zaúčtuje sama: MD 518xxx / D 261xxx, bez DPH; vrácený poplatek naopak. Výběr na banku: MD 261000 Peníze na cestě / D 261xxx.
- Výběr Doruna spáruje s příchozí platbou na bankovním účtu (výpis nebo propojená banka), když sedí částka, den (nejvýš 10 dní po výběru) a protistrana nebo popis platby obsahuje „PayPal“. Příchozí platbu zaúčtujte MD 221 / D 261000 — účet 261000 se tím vyrovná.
- Nové platby a vratky projdou po spárování vašimi pravidly automatizace (Automatizace) jako ostatní pohyby v Platbách. Převody mezi měnami a ostatní pohyby PayPal zaúčtujete sami.
Jak ověřit, že vše funguje
- V Nastavení → Integrace má karta PayPal štítek Aktivní a pod popisem ID účtu PayPal a čas poslední synchronizace.
- V okně PayPal na záložce Synchronizace je vyplněné „Pohyby stažené do“ a není tam červené hlášení.
- Tlačítko Zobrazit platby otevře účet PayPal v Platbách — pohyby porovnejte s aktivitou v účtu PayPal (blokace peněz Doruna nepřenáší).
Řešení problémů
| Co vidíte | Proč | Co udělat |
|---|---|---|
| „Propojení s PayPal je dostupné od tarifu Pro (tarify Pro a Business). Tarif změníte v Nastavení → Fakturace.“ — nebo v okně PayPal místo formuláře upozornění Dostupné od tarifu Pro (karta má štítek Od tarifu Pro). | Firma je na tarifu Free nebo Start. Propojení s PayPal je jen v tarifech Pro a Business (rozhodnutí z 23. 10. 2026). | Tarif změníte v Nastavení → Fakturace (tlačítko Změnit tarif v okně PayPal). Firma, která přešla na nižší tarif, propojení nepřijde — synchronizace se zastaví a PayPal můžete odpojit; po návratu na Pro poběží dál. |
| Karta PayPal má štítek Připravujeme a tlačítko Připojit nejde stisknout. | Propojení s PayPal je v Doruna zatím vypnuté — zapne ho Doruna po ověření na skutečném účtu PayPal. | Pohyby zatím zpracujte z výpisu účtu PayPal. O zapnutí propojení vás informujeme. |
| „Propojení s PayPal je v Doruna zatím vypnuté — zapne se po ověření na skutečném účtu PayPal.“ | Propojení je na serveru Doruna vypnuté. | Počkejte na zapnutí propojení; pohyby do té doby zpracujte z výpisu účtu PayPal. |
| „Vyplňte Client ID i Secret aplikace z PayPal Developer (Apps & Credentials).“ | Jedno z polí je prázdné. | Zkopírujte oba údaje z detailu aplikace v PayPal Developer. |
| „Client ID je dlouhý kód aplikace z PayPal Developer (Apps & Credentials), ne e-mail ani číslo účtu PayPal.“ | Do pole Client ID jste vložili e-mail, číslo účtu nebo jiný text. | V detailu aplikace v PayPal Developer zkopírujte Client ID — dlouhý kód z písmen a číslic. |
| „PayPal nepřijal Client ID nebo Secret. Zkopírujte oba údaje znovu z PayPal Developer → Apps & Credentials → vaše aplikace — v režimu ….“ | Client ID nebo Secret nesedí — jsou zkopírované neúplně, patří k jiné aplikaci, Secret v PayPal někdo změnil, nebo jsou z režimu Sandbox. | V PayPal Developer přepněte na Live a zkopírujte oba údaje znovu z detailu aplikace. U připojeného PayPal použijte v okně PayPal na záložce Nastavení tlačítko Zadat nový Secret. |
| „PayPal odmítl přístup k transakcím (HTTP 403). V PayPal Developer → Apps & Credentials → vaše aplikace zapněte Transaction Search a uložte. PayPal změnu někdy promítne až za několik hodin.“ | Aplikace nemá zapnuté Transaction Search, nebo ho PayPal ještě nepromítl. | V detailu aplikace zaškrtněte Transaction Search a uložte. Když hlášení po několika hodinách zůstává, napište podpoře na podpora@doruna.cz. |
| „PayPal dočasně omezil počet dotazů. Zkuste to prosím za chvíli znovu.“ | PayPal dočasně odmítá další dotazy (limit dotazů). | Zkuste to za pár minut. Noční synchronizace pohyby doplní sama. |
| „PayPal teď neodpovídá. Zkuste to prosím za chvíli znovu.“ | PayPal neodpověděl včas nebo hlásí výpadek. | Zkuste to za pár minut. Noční synchronizace pohyby doplní sama. |
| „PayPal vrátil odpověď v neočekávané podobě. Synchronizace se zastavila — napište prosím podpoře na podpora@doruna.cz.“ | Odpověď PayPal má jiný tvar, než Doruna zná. | Napište podpoře na podpora@doruna.cz — uveďte den, kterého se hlášení týká. |
| „PayPal vrátil chybu…“ | PayPal odmítl dotaz s vlastním kódem chyby. | Kód a text chyby pošlete podpoře na podpora@doruna.cz. |
| „PayPal má za … víc než 10 000 transakcí — tolik jich jedním dotazem nevydá. Napište prosím podpoře na podpora@doruna.cz.“ | PayPal vydá jedním dotazem nejvýš 10 000 transakcí — v ten den jich bylo víc. | Napište podpoře na podpora@doruna.cz. Dny před ním jsou stažené. |
| „Údaje patří k jinému účtu PayPal (…), než ze kterého jsou pohyby v Platbách (…) — pohyby dvou účtů by se smíchaly. Zadejte údaje původního účtu, nebo účty PayPal v Platbách nejdřív smažte.“ | Client ID a Secret patří aplikaci v jiném účtu PayPal, než ze kterého Doruna pohyby už stáhla. | Zadejte údaje aplikace v původním účtu PayPal. Přecházíte-li na jiný účet PayPal natrvalo, poraďte se s účetní — smazání účtů PayPal v Platbách smaže i jejich pohyby a zaúčtování. |
| „Synchronizace s PayPal právě běží. Počkejte prosím, až doběhne, a zkuste to znovu.“ | Stejná synchronizace už běží — noční, první po připojení, nebo spuštěná z jiného okna. Dokud běží, nejde spustit další ani PayPal odpojit. | Počkejte pár minut a zkuste to znovu. |
| „Pohyby od … se nestáhly: …“ | PayPal při synchronizaci odmítl dotaz nebo neodpověděl, nebo pohyb nebylo kam uložit. Pohyby dnů před tím jsou stažené. | Postupujte podle textu za dvojtečkou (řádky výše i níže) a klikněte na Synchronizovat nyní. |
| „Účet „Účet PayPal…“ je v Platbách smazaný. Připojte PayPal znovu (Nastavení → Integrace → PayPal) — Doruna účet založí znovu a pohyby do něj stáhne od dne v poli „Stahovat pohyby od“.“ | Účet PayPal jste v Platbách smazali — tím se PayPal odpojil a Secret se z Doruna smazal. | V Nastavení → Integrace u karty PayPal klikněte na Připojit a zadejte údaje znovu. Doruna účet založí znovu s první transakcí a pohyby do něj stáhne od dne v poli Stahovat pohyby od. |
| „Synchronizace se nepovedla — zkuste to prosím za chvíli znovu. Když se to opakuje, napište podpoře na podpora@doruna.cz.“ | Synchronizaci zastavila chyba na straně Doruna. | Zkuste to znovu za pár minut; když hlášení zůstává, napište podpoře. |
| „Pohyby jsou stažené do … — další dny stáhne příští synchronizace.“ | Ruční synchronizace stáhne najednou nejvýš 90 dní. | Klikněte na Synchronizovat nyní znovu, nebo počkejte na noční synchronizaci. |
| „Nezaúčtované poplatky a převody PayPal (…): … Zaúčtujte je v Platbách na účtu PayPal.“ | Poplatek nebo výběr se nezaúčtoval — důvod je v hlášení (chybí kurz ČNB, období je uzavřené, chybí účet poplatků). | Odstraňte důvod (kurz ČNB vyhlašuje banka v pracovní dny, uzavřené období otevře účetní) a pohyb zaúčtujte v Platbách na účtu PayPal. |
| „Čekající transakce PayPal (stav Pending): … — převezmou se, až je PayPal dokončí.“ | Platba v PayPal ještě není dokončená (například platba z bankovního účtu kupujícího nebo platba v kontrole). | Nic — Doruna si ji pamatuje a po dokončení ji další synchronizace převezme se dnem, kdy vznikla. |
| „Transakce PayPal čekající na dokončení déle než … dní: … (nejstarší z …) — zkontrolujte je v PayPal. Doruna je převezme, až je PayPal dokončí.“ | Platba v PayPal zůstává ve stavu Pending déle, než bývá obvyklé (kontrola platby, spor, platba z bankovního účtu kupujícího). | Podívejte se na transakci v aktivitě účtu PayPal. Až ji PayPal dokončí, Doruna ji převezme sama se dnem vzniku; zamítnutá z hlášení zmizí. |
| „Transakci PayPal… nejde převzít: …“ | V odpovědi PayPal u transakce chybí údaj (ID, měna, částka, datum) nebo je poplatek v jiné měně. | Transakci zaúčtujte podle aktivity v účtu PayPal a napište podpoře na podpora@doruna.cz. |
| „Účet poplatků musí být nákladový účet (třída 5) z účtové osnovy této firmy.“ | V poli Účet poplatků je jiný než nákladový účet. | Vyberte nákladový účet — výchozí 518xxx PayPal poplatky, nebo účet, který určí účetní. |
| „Datum v poli „Stahovat pohyby od“ nesmí být v budoucnosti.“ | Zvolený den ještě nenastal. | Zvolte dnešní nebo dřívější den. |
| „Pohyby jde stáhnout nejvýš … dní zpět — zvolte pozdější datum v poli „Stahovat pohyby od“.“ | Zvolený den je dál než tři roky zpět — starší transakce PayPal nevydá. | Zvolte pozdější den. Starší pohyby zaúčtujte z výpisu účtu PayPal. |
| „Neplatné datum v poli „Stahovat pohyby od“.“ | Datum není celé nebo neexistuje. | Vyberte den v kalendáři pole. |
| „PayPal je odpojený — připojte ho znovu.“ | PayPal jste odpojili. | V Nastavení → Integrace u karty PayPal klikněte na Připojit a zadejte údaje znovu. |
| „PayPal není připojený.“ | Firma PayPal ještě nepřipojila. | Připojte PayPal podle části 2 tohoto návodu. |
| „Pohyb stažený z PayPal nejde smazat — při další synchronizaci by se vrátil. Zaúčtujte ho jinak: zaúčtovaný nejdřív „Stornovat zaúčtování“, pak ho zaúčtujte znovu, jak má být.“ (v menu pohybu PayPal místo Smazat transakci je „Pohyb brány se nemaže“). | Synchronizace přebírá transakce PayPal celé — smazaný řádek by pro ni neexistoval a transakci by stáhla znovu (transakce posledních 14 dní při každé synchronizaci, starší po změně „Stahovat pohyby od“ nebo po novém připojení) a poplatek či výběr zaúčtovala podruhé. Proto pohyby bran smazat nejde — stejně u Stripe, Comgate a GoPay. | Pohyb, který do účetnictví nepatří, zaúčtujte jinak podle pokynu účetní (například jako převod): zaúčtovaný nejdřív Stornovat zaúčtování, pak zaúčtovat znovu. Zůstatek účtu PayPal pak sedí s PayPal. |
| Platba z PayPal je v Platbách, ale není spárovaná s fakturou. | Invoice ID se neshoduje s variabilním symbolem ani číslem faktury, částka platby se liší od zbývající částky, nebo sedí víc faktur. | Na účtu PayPal v Platbách platbu spárujte s fakturou ručně. Do PayPal posílejte jako Invoice ID variabilní symbol faktury. |
| „Platbu spárujte v Platbách — přijde z brány sama.“ — při ručním zápisu úhrady faktury na účet PayPal. | PayPal je připojený a platby z něj přicházejí synchronizací na účet PayPal v Platbách. Ručně zapsaná úhrada by se se stejnou platbou z PayPal zdvojila, proto ji Doruna na účet s živým propojením nezapíše. | Počkejte na synchronizaci a na účtu PayPal v Platbách platbu spárujte s fakturou, pokud se nespárovala sama. Platbu, která přišla jinak (převodem na účet, hotově), zapište na bankovní účet nebo do pokladny. |
| Výběr z PayPal na bankovní účet není spárovaný s příchozí platbou v bance. | Výpis banky s výběrem ještě v Doruna není, platba přišla v jiné částce nebo později než 10 dní, nebo v ní není slovo PayPal. | Po importu výpisu se výběr spáruje při další synchronizaci. Jinak příchozí platbu zaúčtujte MD 221 / D 261000. |
| Platba, kterou v PayPal vidím, v Platbách chybí. | PayPal ji ještě nevydal (nejvýš tři hodiny), je čekající (Pending), jde o blokaci peněz, nebo je starší než den v poli Stahovat pohyby od. | Počkejte na další synchronizaci. Starší pohyby stáhnete po změně pole Stahovat pohyby od na záložce Nastavení. |
| V Nastavení → Integrace je místo karty PayPal „Platební brány spravuje člen s přístupem k platbám. Požádejte vlastníka firmy o přístup.“ | Vaše role ve firmě nemá přístup k platbám. | PayPal připojí vlastník firmy, nebo vám přístup k platbám přidá. |
| „Máte k této firmě přístup jen pro čtení. Změny může provést vlastník nebo administrátor.“ | Máte ve firmě roli Jen čtení. Stav propojení a stažené pohyby vidíte, ale synchronizaci spustit, PayPal připojit, změnit nastavení ani odpojit nemůžete. | Synchronizaci spustí nebo propojení změní vlastník nebo administrátor firmy. |
Odpojení
- V okně PayPal klikněte vlevo dole na Odpojit PayPal a v dalším okně na Odpojit. Další synchronizace už neproběhne a Secret se z Doruna smaže. Běžící synchronizaci odpojení nepřeruší: dokud běží, PayPal odpojit nejde (tlačítko Odpojit je neaktivní, případně Doruna odpojení odmítne hlášením „Synchronizace s PayPal právě běží. Počkejte prosím, až doběhne, a zkuste to znovu.“). Po jejím doběhnutí PayPal odpojte.
- Účty PayPal v Platbách, stažené pohyby i jejich zaúčtování zůstanou beze změny. Účty osnovy zůstanou také.
- Znovu připojit PayPal můžete kdykoli — Doruna použije stejné účty a pohyby nezdvojí.
- Smažete-li v Platbách účet PayPal (i s jeho pohyby), PayPal se odpojí stejně jako tlačítkem Odpojit PayPal. Po novém připojení Doruna účet založí znovu s první transakcí a pohyby do něj stáhne od dne v poli Stahovat pohyby od. Účet se zaúčtovanými nebo spárovanými pohyby ale Doruna smazat nedovolí — smazáním by se změnilo účetnictví; PayPal pak jen odpojte, pohyby i zaúčtování zůstanou.
- Aplikaci v PayPal Developer, kterou jinde nepoužíváte, můžete po odpojení smazat — Client ID a Secret pak přestanou platit.
Bezpečnost
- Secret aplikace Doruna ukládá zašifrovaný (AES-256) a nikomu ho neukáže — v okně je jen maska. Do PayPal ho posílá jen při získání přístupového tokenu šifrovaným spojením; token drží jen po dobu synchronizace a neukládá ho.
- Doruna s údaji aplikace jen čte transakce (Transaction Search) — platby, vratky ani výběry nevytváří. V aplikaci pro Doruna nezapínejte funkce, které Doruna nepotřebuje.
- Do Doruna se z PayPal přenese jméno a e-mail plátce, předmět platby, Invoice ID, Custom ID a ID transakce — u pohybu v Platbách.
- PayPal připojí jen člen firmy s přístupem k platbám, který smí měnit data.
- Přístup zrušíte i bez Doruna: aplikaci v PayPal Developer smažte — Client ID a Secret přestanou platit.
Časté otázky
Kolik propojení stojí?
Jak často se pohyby stahují?
Proč musím v aplikaci zapnout Transaction Search?
Řeší Doruna DPH z poplatků PayPal?
Co musí e-shop posílat do PayPal, aby se platby párovaly?
Proč zůstatek účtu PayPal v Doruna nesedí přesně se zůstatkem v PayPal?
Související návody
NávodStripe: platby, poplatky a výplaty v účetnictví DorunaOtevřít návodNávodComgate: výplaty a platby brány v účetnictví DorunaOtevřít návodNávodKurzy ČNB: přepočet dokladů v cizí měně na korunyOtevřít návodNávodRevolut Business: pohyby z výpisu CSV nebo CAMT.053 do DorunaOtevřít návodNávodWooCommerce: faktury k objednávkám z e-shopu v DorunaOtevřít návodNávodUpgates: faktury, dobropisy a účtenky z e-shopuOtevřít návod