Instalace LedgerPort v obchodě WooCommerce a připojení k QuickBooks Online

Tato příručka pokrývá instalaci pluginu LedgerPort ve vašem obchodě WooCommerce a dokončení připojení k QuickBooks Online prostřednictvím Průvodce nastavením.

Než začnete

  • Váš web musí používat HTTPS. LedgerPort vyžaduje zabezpečené připojení a na webech pouze s HTTP zablokuje průběh připojení.
  • WooCommerce musí být nainstalován a aktivní. LedgerPort se bez něj neaktivuje.
  • Potřebujete aktivní účet LedgerPort na ledgerport.com. Pokud jej nemáte, můžete si jej vytvořit na app.ledgerport.com.
  • Měna vašeho obchodu WooCommerce musí odpovídat domovské měně vaší společnosti v QuickBooks Online. LedgerPort neprovádí převody měn a při neshodě zablokuje aktivaci.

Krok 1: Instalace pluginu

Možnost A: Instalace z WordPress.org

  1. Ve svém administrátorském rozhraní WordPress přejděte na Pluginy » Přidat nový plugin.
  2. Vyhledejte LedgerPort.
  3. Klikněte na Nainstalovat a poté na Aktivovat.

Možnost B: Nahrání souboru zip

  1. Ve svém administrátorském rozhraní WordPress přejděte na Pluginy » Přidat nový plugin.
  2. Klikněte na Nahrát plugin.
  3. Vyberte soubor ledgerport.zip, který jste stáhli.
  4. Klikněte na Nainstalovat a poté na Aktivovat.

Po aktivaci vás LedgerPort automaticky přesměruje do Průvodce nastavením. Pokud přesměrováni nejste, přejděte v nabídce administrace na LedgerPort » Dashboard a klikněte na Nastavit připojení nebo vyhledejte odkaz na Průvodce nastavením.

Krok 2: Otevření Průvodce nastavením

Průvodce nastavením se otevře jako překryvné okno na celou obrazovku. Provede vás připojením vašeho obchodu k LedgerPort a autorizací přístupu k vaší společnosti v QuickBooks Online.

Kliknutím na Připojit k LedgerPort začněte.

Krok 3: Autorizace připojení

Po kliknutí na Připojit vás LedgerPort přesměruje na app.ledgerport.com k dokončení autorizace.

  1. Přihlaste se ke svému účtu LedgerPort (nebo si vytvořte nový).
  2. Vyberte obchodní účet LedgerPort, který chcete připojit ke svému obchodu WooCommerce.
  3. Kliknutím na Autorizovat udělte společnosti LedgerPort přístup k vašemu obchodu.
Modální karta s výzvou k připojení vašeho obchodu k LedgerPort se zeleným tlačítkem 'Připojit váš obchod' a pomocným textem níže.

Poté budete automaticky přesměrováni zpět na váš web WordPress.

Krok 4: Zřízení připojení

Když jste přesměrováni zpět, LedgerPort automaticky spustí proces zřízení na pozadí:

Seznam webhooků na stránce Nastavení zobrazující události LedgerPort pro zákazníky a produkty (vytvořeno, aktualizováno, odstraněno) s aktivním stavem.
  1. Bezpečně uloží vaše API pověření.
  2. Vytvoří klíč WooCommerce REST API s přístupem pro čtení.
  3. Zaregistruje následující webové háčky WooCommerce pro odesílání dat v reálném čase do LedgerPort:
Téma webového háčkuCo zachycuje
order.createdNové objednávky
order.updatedZměny objednávky (stav, položky atd.)
order.deletedSmazané objednávky
product.createdNové produkty
product.updatedÚpravy produktů
product.deletedSmazané produkty
customer.createdNoví zákazníci
customer.updatedZměny profilu zákazníka
customer.deletedSmazaní zákazníci
refund.createdVrácení peněz za objednávky
product_variation.created / updated / deletedVarianty variabilních produktů
  1. Registruje připojení k platformě LedgerPort.

Pokud zřizování proběhne úspěšně, přejdete na řídicí panel LedgerPort a připojení bude aktivní.

Přehledový panel zobrazující stav synchronizace, nedávnou aktivitu a položky vyžadující pozornost; levá karta ukazuje 97% úspěšnost (celkem 1 856 synchronizací), prostřední ukazuje 18 objednávek (54% úspěšnost), pravá ukazuje 1 položku vyžadující kontrolu; rozsah dat 17.–23. června 2026 a poslední synchronizace před 44 minutami s tlačítkem Synchronizovat nyní.

Řešení chyb připojení

„Vaše stránka nepoužívá HTTPS“ Vaše stránka musí mít povolené SSL. Kontaktujte svého poskytovatele hostingu a povolte HTTPS, poté se vraťte do Průvodce nastavením a zkuste to znovu.

„Nesoulad měn“ Váš obchod WooCommerce je nastaven na jinou měnu než vaše společnost QuickBooks Online. Přejděte na WooCommerce » Nastavení » Obecné a aktualizujte pole Měna tak, aby odpovídalo domovské měně vaší společnosti QBO, poté znovu připojte.

„Dosaženo maximálního počtu připojení“ Váš plán LedgerPort má limit počtu připojených obchodů. Přihlaste se na app.ledgerport.com, zkontrolujte svůj plán a v případě potřeby upgradujte.

„Tato stránka je již připojena k jinému účtu“ URL vaší stránky je již zaregistrována pod jiným účtem LedgerPort. Pokud tento účet vlastníte, přihlaste se na app.ledgerport.com a odpojte stávající připojení, poté znovu připojte. Pokud je to neočekávané, kontaktujte podporu LedgerPort.

Zřizování selhalo v polovině LedgerPort používá transakční vrácení změn. Pokud jakýkoli krok zřizování selže, všechny dokončené kroky (API klíče, webhooky) jsou automaticky vráceny, takže váš obchod WooCommerce nezůstane v částečném stavu. Vraťte se do Průvodce nastavením a zkuste to znovu.

Odpojení

Chcete-li svůj obchod odpojit od LedgerPort:

  1. Přejděte na LedgerPort » Připojení.
  2. Klikněte na Odpojit.
  3. Potvrďte odpojení.
Panel připojení WooCommerce zobrazující example.com, aktivní klíč API, 9 webhooků a tlačítko Odpojit.

LedgerPort bude:

  • Odstraní klíč rozhraní WooCommerce REST API, který vytvořil.
  • Odstraní všechny webhooky LedgerPort z WooCommerce.
  • Upozorní platformu LedgerPort, aby bylo připojení deaktivováno na straně SaaS.

Váš obchod WooCommerce a objednávky nejsou ovlivněny. Odstraní se pouze klíč API specifický pro LedgerPort a webhooky.

Opětovné připojení

Chcete-li se znovu připojit po odpojení, vraťte se na LedgerPort » Dashboard a klikněte na tlačítko nastavení nebo opětovného připojení a znovu spusťte Průvodce nastavením. Všechna předchozí mapování uložená v LedgerPort zůstanou zachována.

Často kladené dotazy

Musím si klíč API WooCommerce vytvořit ručně? Ne. LedgerPort vytvoří a spravuje klíč rozhraní WooCommerce REST API automaticky během procesu připojení. Nemusíte nic nastavovat v WooCommerce » Nastavení » Pokročilé » REST API.

Ovlivní LedgerPort mé stávající webhooky WooCommerce? LedgerPort vytváří a spravuje pouze své vlastní webhooky (pojmenované „LedgerPort – téma“). Nemění žádné webhooky, které jste vytvořili vy sami.

Kde jsou uloženy mé přihlašovací údaje? Váš klíč API LedgerPort a přihlašovací údaje WooCommerce jsou uloženy v tabulce možností WordPress, šifrované pomocí AES-256-CBC s bezpečnostními klíči vašeho webu WordPress.

Mohu znovu spustit Průvodce nastavením bez odpojení? Pokud jste již připojeni, Průvodce nastavením rozpozná existující připojení. Chcete-li začít znovu, nejprve se odpojte na stránce Připojení a poté znovu spusťte průvodce.

Jaká uživatelská role WooCommerce je vyžadována pro připojení LedgerPort? Musíte mít oprávnění manage_woocommerce, které je ve výchozím nastavení přiřazeno administrátorům WordPress a správcům obchodů WooCommerce.

Pokud narazíte na jakékoli problémy, neváhejte nás kontaktovat kliknutím sem. Náš tým podpory vám bude schopen pomoci.