- Nápověda
- Ubytování a pronájmy
Ubytování a pronájmyNávod krok za krokem
Uplisting: rezervace z Airbnb a Booking.com v účetnictví
Jak propojit Uplisting s Doruna API klíčem. Rezervace z Airbnb, Booking.com a dalších kanálů se stahují samy a v Platbách je zaúčtujete jako tržby.
Obsah návodu
Co propojení umí
- Stáhne vaše nemovitosti a rezervace z Uplistingu: hosta, termín pobytu, kanál (Airbnb, Booking.com…), cenu ubytování, úklid, provize a výplatu.
- Nové a změněné rezervace dostává hned — Doruna si v Uplistingu sama zaregistruje webhooky. Navíc každou noc v 1:00 stáhne všechny rezervace znovu.
- Po připojení zapne modul Krátkodobé pronájmy a v Platbách založí účet „Uplisting – ubytování“.
- Potvrzené rezervace, jejichž pobyt skončil, sama přenese do Plateb jako řádky platební brány. Zaúčtováním rezervace vznikne faktura hostovi a úhrada provize kanálu.
- Upozorní na zrušené rezervace, jejichž platba už je v účetnictví.
- Rezervace v cizí měně přepočte kurzem ČNB.
- Jeden účet Uplisting může být připojený k více firmám v Doruna: každá firma si vybere své objekty a dostává jen jejich rezervace — tržby se do dvou účetnictví nezdvojí.
Co propojení neumí
- Nic v Uplistingu nemění — rezervace, ceny ani kalendář. Jen čte a zaregistruje si webhooky pro rezervace.
- Budoucí pobyt do Plateb nepřenese — rezervace se tam objeví po skončení pobytu, s noční synchronizací.
- Rezervace sama nezaúčtuje; zaúčtování potvrzujete v Platbách.
- Nezaúčtuje měsíční fakturu kanálu za provize — tu zaúčtujete, až od Airbnb nebo Booking.com přijde.
- Nestahuje zprávy hostů ani recenze.
- Na tarifu Free modul Krátkodobé pronájmy není — karta Uplisting má zámek tarifu a připojit nejde.
Co k tomu potřebujete
- Účet v Uplistingu s přístupem na stránku Connect → API, kde se vytváří API klíč.
- Tarif Doruna Pro nebo Business — modul Krátkodobé pronájmy, do kterého rezervace přicházejí, ve Free není.
- V Doruna roli s přístupem k platbám a k modulu Krátkodobé pronájmy, která smí měnit data.
- Účetní, která zkontroluje nastavení účtování rezervací v modulu Krátkodobé pronájmy.
Část 1: API klíč v Uplistingu
Klíč dává Doruna přístup ke čtení vašich nemovitostí a rezervací.
Část 2: připojení v Doruna
Připojení najdete v Nastavení na záložce Integrace.
Otevřete kartu Uplisting
Vložte API klíč
Zkontrolujte připojení
Vyberte objekty této firmy
Část 3: první rezervace v Platbách
V menu přibyla položka Krátkodobé pronájmy.
Stáhněte rezervace
Zkontrolujte rezervace v Platbách
Zaúčtujte rezervaci
Jak to funguje
- Doruna se do Uplistingu přihlašuje vaším API klíčem (rozhraní connect.uplisting.io) a jen čte nemovitosti a rezervace.
- Při připojení si zaregistruje tři webhooky (nová, změněná a zrušená rezervace) na tajnou adresu, kterou zná jen Doruna. Každou noc v 1:00 navíc stáhne všechny rezervace znovu a srovná změny.
- Rezervace se ukládají v modulu Krátkodobé pronájmy. Po každém zápisu rezervace (webhook, noční synchronizace, Importovat rezervace) Doruna srovná Platby: potvrzenou rezervaci s ukončeným pobytem přenese, změněnou upraví a zrušenou odebere — zaúčtovaný řádek nechá být. Tlačítko Přenést rezervace do Plateb jen dorovná, co chybí; nic nezdvojí.
- Peníze u kanálu jsou v účetnictví peníze na cestě (účet 261 „Uplisting – peníze na cestě“). Zaúčtováním rezervace vznikne faktura hostovi a úhrada tím, co si kanál strhl; zbytek spárujete s příchozí platbou na bankovním účtu.
- Zrušená rezervace, jejíž platba je už zaúčtovaná nebo platí doklad, zůstane v účetnictví — upozorní na ni štítek Zrušené rezervace u karty Uplisting.
- Výběr objektů: po uložení přicházejí (webhookem, noční synchronizací i Importovat rezervace) jen rezervace vybraných objektů. Nezaúčtované řádky ostatních objektů z Plateb zmizí a s nimi i jejich rezervace — jsou to data jiné firmy; zaúčtovaný nebo spárovaný řádek a jeho rezervace zůstanou. Rezervace nově vybraného objektu přijdou s další synchronizací nebo tlačítkem Importovat rezervace. Rezervací z nahraných výpisů Airbnb a Booking.com se výběr netýká.
- Rezervace v cizí měně se přepočte kurzem ČNB ke dni odjezdu hosta (den zdanitelného plnění).
Jak ověřit, že vše funguje
- Karta Uplisting v Nastavení → Integrace má štítek Aktivní a správný počet nemovitostí; okno Nastavení hlásí zaregistrované webhooky.
- V modulu Krátkodobé pronájmy vidíte rezervace se stejnými termíny a částkami jako v Uplistingu.
- Nová rezervace v Uplistingu se v modulu objeví bez čekání na noc; po skončení pobytu je v Platbách na účtu Uplisting – ubytování.
Řešení problémů
| Co vidíte | Proč | Co udělat |
|---|---|---|
| U karty Uplisting „Vyberte objekty této firmy (Nastavení) — dokud je nevyberete, přicházejí rezervace všech objektů účtu Uplisting.“ | Firma ještě nevybrala své objekty — dostává rezervace všech objektů účtu, jako před výběrem. | Otevřete Nastavení u karty Uplisting a v části Objekty této firmy vyberte objekty a uložte. |
| Při uložení výběru: „Objekt „…“ má v Doruna vybraný jiná firma — jeden objekt může patřit jen jedné firmě. Nejdřív ho odeberte tam.“ | Stejný účet Uplisting je připojený i k jiné firmě v Doruna a ta má tento objekt vybraný. Jeden objekt patří jen jedné firmě, jinak by tytéž tržby byly ve dvou účetnictvích. | Ve firmě, které objekt patřit nemá, ho ve výběru odškrtněte a uložte; pak ho vyberte tady. Kterou firmu Doruna nejmenuje — může patřit jinému vlastníkovi. |
| „Zadejte API klíč.“ nebo „Vložte celý API klíč z Uplistingu — najdete ho v Uplistingu v Connect → API.“ | Pole je prázdné, nebo vložený text nemůže být API klíč (je příliš krátký). | Zkopírujte celý klíč ze stránky Connect → API v Uplistingu a vložte ho znovu. |
| „Uplisting klíč nepřijal. Zkontrolujte, že jste vložili celý API klíč z Uplistingu (Connect → API).“ | Uplisting klíč nepřijal — je neúplný, neplatný, nebo už byl obnoven. | V Uplistingu zkopírujte aktuální klíč z Connect → API a připojte znovu. |
| Karta Uplisting má místo štítku Nepřipojeno zámek „Pro a Business“ a tlačítko Připojit otevře nabídku tarifů. | Firma je na tarifu Free — rezervace z Uplistingu se zobrazují v modulu Krátkodobé pronájmy, který je v tarifech Pro a Business. | Přejděte na vyšší tarif v Nastavení → Fakturace, pak Uplisting připojte. |
| Karta Uplisting má zámek „Nedostupné“. | Vaše role ve firmě nemá přístup k modulu Krátkodobé pronájmy. | Uplisting připojí vlastník firmy, nebo vám přístup k modulu přidá. |
| Karta Uplisting se v Nastavení → Integrace nezobrazí; místo ní je „Import rezervací a propojení s Uplistingem 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. | Uplisting připojí vlastník firmy, nebo vám přístup k platbám přidá. |
| Uplisting je připojený (z doby před zámkem tarifu), ale v menu chybí Krátkodobé pronájmy. | Firma je na tarifu Free — modul Krátkodobé pronájmy je v tarifech Pro a Business. | Přejděte na vyšší tarif v Nastavení → Fakturace, nebo Uplisting odpojte. |
| „Uplisting není připojen.“ (po kliknutí na Importovat rezervace nebo Synchronizovat). | Uplisting je odpojený, nebo připojení nedokončené. | Připojte Uplisting znovu v Nastavení → Integrace. |
| „Rezervace z Uplistingu se nepodařilo stáhnout. Uplisting teď neodpovídá. Zkuste to za chvíli znovu.“ (nebo „Synchronizace s Uplistingem se nezdařila. …“) | Uplisting na dotaz neodpověděl, nebo odmítl další dotazy (limit). | Zkuste to za chvíli znovu. Když chyba trvá, napište podpoře na podpora@doruna.cz. |
| „… Uplisting odmítl uložený API klíč (v Uplistingu byl obměněn nebo zrušen). Nový klíč vložíte, když Uplisting odpojíte a znovu připojíte v Nastavení → Integrace.“ | Klíč, se kterým je Uplisting připojený, byl v Uplistingu obnoven nebo zrušen. | Odpojte Uplisting a připojte ho znovu s aktuálním klíčem z Connect → API. Okno odpojení řekne předem, co se smaže. |
| Nové rezervace se v Doruna objevují až druhý den. | Webhooky se nezaregistrovaly (v okně Nastavení chybí hlášení o webhoocích), takže rezervace přicházejí až s noční synchronizací. | Odpojte Uplisting a připojte ho znovu — Doruna webhooky zaregistruje znovu. |
| U karty Uplisting štítek „Zrušené rezervace: …“ a v nápovědě „… Řádek je zaúčtovaný nebo platí doklad, proto ho Doruna nesmazala.“ | Host rezervaci zrušil, ale její platba už je v účetnictví. | Klikněte na štítek, otevřete řádek v Platbách a zaúčtování nebo doklad opravte (třeba dobropisem). Při pochybnostech se poraďte s účetní. |
| Při zaúčtování „Kurz … k … není k dispozici — obnovte kurzy ČNB. Bez kurzu rezervaci nelze zaúčtovat.“ | Rezervace je v cizí měně a kurz ČNB k jejímu dni zatím v Doruna není. | V Kurzech ČNB klikněte na Stáhnout aktuální kurzy ČNB; u staršího data požádejte podporu o doplnění kurzů. |
| Rezervace v Platbách se po změně v Uplistingu nezměnila. | Řádek rezervace je už zaúčtovaný nebo platí doklad — takový Doruna nepřepisuje. | Opravte zaúčtování ručně, nebo se poraďte s účetní. |
| Tlačítko Odpojit v rezervaci je šedé, nebo „Faktura … je zaúčtovaná — rezervaci nejde odpojit. Nejdřív stornujte zaúčtování (v deníku smažte zápis faktury a zápisy srážky — odkazy jsou v terminálu rezervace), pak rezervaci odpojte.“ | Faktura hostu je zaúčtovaná. Odpojená by zůstala v účetnictví bez rezervace a k rezervaci by šla vystavit druhá faktura — tržba za jeden pobyt dvakrát. | V rezervaci otevřete odkazy na zápisy (Zápis faktury … a zápisy srážky), v deníku je smažte a pak klikněte na Odpojit. Zůstala-li jen srážka („… má zaúčtovanou srážku kanálu …“), smažte v deníku její zápisy. |
| V rezervaci žluté upozornění, po Potvrdit a zaúčtovat okno „Vystavit další fakturu k rezervaci?“: „K rezervaci už byla vystavena faktura … — je od rezervace odpojená a zaúčtovaná. Další faktura by tržbu za tento pobyt zdvojila. Patří-li faktura … k tomuto pobytu, připojte ji zpět v poli „Doklad“; jinak ji stornujte. Chcete-li přesto vystavit další fakturu, potvrďte to.“ (u nezaúčtované „… odpojená a nezaúčtovaná. Další faktura by po zaúčtování tržbu za tento pobyt zdvojila. … jinak ji smažte. …“) | Rezervace už svou fakturu hostu měla a ta je od ní odpojená (tlačítkem Odpojit) — mohla být mezitím zaúčtovaná ze seznamu faktur. Další faktura by tržbu za jeden pobyt započítala dvakrát. | Patří-li stará faktura k pobytu, vyberte ji v poli Doklad (u ní „dřív připojená k této rezervaci“) — připojí se zpět a nová nevznikne. Neplatí-li, nezaúčtovanou smažte, zaúčtovanou stornujte opravným dokladem na celou částku — upozornění pak zmizí a další fakturu vystavíte bez okna. Jinak další fakturu vystavíte tlačítkem Vystavit další fakturu v okně — Doruna to nezakazuje. |
Odpojení
- V Nastavení → Integrace klikněte u karty Uplisting na Nastavení a pak na Odpojit. Okno „Odpojit Uplisting?“ vypíše, co se smaže a co zůstane; odpojíte tlačítkem Odpojit Uplisting, tlačítkem Zpět se vrátíte.
- Smaže se vždy API klíč a napojení na Uplisting — Doruna odstraní své webhooky z Uplistingu a nové rezervace přestanou přicházet — a seznam nemovitostí stažený z Uplistingu.
- Bez rezervací z nahraných výpisů Airbnb nebo Booking.com se smaže i nastavení účtování rezervací (účty výnosů a poplatků, sazba DPH, kanály) a modul Krátkodobé pronájmy zmizí z menu, pokud ho zapnulo připojení. S výpisy nastavení účtování i modul zůstanou.
- Rezervace, které už v Doruna jsou, řádky v Platbách, faktury a jejich zaúčtování zůstávají.
- Chcete-li přístup zrušit i na straně Uplistingu, obnovte API klíč na stránce Connect → API.
Bezpečnost
- API klíč Uplistingu ukládá Doruna zašifrovaný (AES-256) a nikomu ho neukazuje.
- Webhooky míří na adresu s náhodnou tajnou částí; Doruna z ní ukládá jen otisk. Při novém připojení se adresa změní a stará přestane fungovat.
- Doruna z Uplistingu jen čte. Do Doruna se přenášejí i údaje hostů (jméno, e-mail, telefon) — kvůli fakturám hostům.
- Uplisting připojí jen člen firmy s přístupem k platbám a k modulu Krátkodobé pronájmy, který smí měnit data.