Integrace se Shoptetem — automatická fakturace pro e-shopy
· Redakce Doklad.ai · general
Integrace se Shoptetem bez bolení hlavy. Nainstaluj doplněk Doklad.ai, nastav pravidla a k objednávkám se ti samy vystaví doklady. Bez přepisování údajů.
Integrace se Shoptetem — automatická fakturace pro e-shopy
Sedíš nad objednávkami a přepisuješ údaje do faktur? Mezitím pípají další platby a zákazník se ptá, kde má doklad. Znáš to.
Integrace se Shoptetem v Doklad.ai tuhle rutinu převezme. Z objednávek se podle pravidel, která si nastavíš, samy vystaví faktury nebo zálohové faktury a úhrada se umí propsat mezi Shoptetem a Doklad.ai oběma směry. Níž najdeš, jak to propojit, co se dá nastavit a kde má integrace hranice.
Co ti integrace se Shoptetem reálně přinese
- Faktury nebo zálohové faktury se z objednávek vystavují automaticky. Bez přepisování.
- Doklad převezme odběratele, všechny řádky objednávky včetně dopravy, platby a slev, sazby DPH i měnu.
- Doklad může odejít zákazníkovi e-mailem z Doklad.ai, nebo se odkaz na PDF vloží do objednávky v Shoptetu.
- Stav „zaplaceno“ se přebírá ze Shoptetu a úplnou úhradu z Doklad.ai jde zapsat zpět do Shoptetu.
- Při stornu objednávky může vzniknout dobropis, k dokladu i dodací list bez cen.
- Starší objednávky přeneseš ručně, nové se fakturují samy.
💡 Tip: Fakturu zákazníkovi doručuj jen jednou cestou: buď e-mailem z Doklad.ai, nebo odkazem v e-mailu Shoptetu. Jinak ji dostane dvakrát.
Jak Shoptet propojit s Doklad.ai
Propojení nestojí na API klíči, ale na doplňku Doklad.ai z katalogu doplňků Shoptetu. Nastaví ho majitel nebo administrátor firmy v Doklad.ai.
- V Doklad.ai otevři Nastavení → Integrace → karta „Shoptet“ a klikni na „Připojit Shoptet“. Aplikace tě přesměruje do katalogu doplňků Shoptetu.
- Doplněk Doklad.ai v Shoptetu nainstaluj.
- V administraci Shoptetu otevři nastavení doplňku a klikni na „Propojit firmu v Doklad.ai →“.
- Přihlas se do Doklad.ai, v kartě „Dokončit propojení Shoptetu“ zkontroluj, že je uvedená správná firma, a klikni na „Propojit s touto firmou“.
- Vrať se do nastavení doplňku v Shoptetu a nastav pravidla vystavování.
Jedna firma v Doklad.ai může mít propojený jen jeden e-shop. Další e-shop propoj s jinou firmou („Přidat firmu“ v přepínači firem).
Kdy se faktura vystaví: pravidla vystavování
V doplňku najdeš „Pravidla vystavování“ se třemi možnostmi:
- „Po zaplacení, u dobírky při odeslání“ (výchozí): doklad vznikne, jakmile Shoptet objednávku označí jako zaplacenou. Dobírku vyfakturuje po přechodu do stavů zaškrtnutých v „Stavy znamenající odeslání“.
- „Při přijetí objednávky“: doklad vznikne hned po vytvoření objednávky.
- „Vlastní pravidla podle platby“: pro každou platební metodu zvlášť „Po zaplacení“, „Při přijetí objednávky“ nebo „Ve vybraném stavu“.
Pravidla ulož tlačítkem „Uložit pravidla“. Datem vystavení je den, kdy doklad vznikl. Zálohová faktura se při výchozím pravidle vystaví hned po přijetí objednávky.
Starší objednávky
Automaticky se fakturují jen objednávky vytvořené po instalaci doplňku. Starší přeneseš v doplňku v části „Historické objednávky“: vyplň „Od“ a „Do“, klikni na „Načíst náhled“, zaškrtni objednávky, potvrď, že nemají fakturu vystavenou jinde, a klikni na „Vystavit vybrané doklady“. Takové doklady vzniknou s dnešním datem a e-mailem se neposílají.
Co dalšího si nastavíš
V Doklad.ai u karty Shoptet i v doplňku:
- „Automatická fakturace“ a splatnost ve dnech (1–90, výchozí 14).
- „Typ dokladu“: Faktura, nebo Zálohová faktura (proforma).
- „Poslat doklad zákazníkovi e-mailem“ (výchozí vypnuto).
- „Přebírat stav „zaplaceno““ (výchozí zapnuto).
- „Dobropis při stornu“ a „Dodací list“.
Jen v doplňku (u nové instalace zapnuté):
- „Po zaplacení proformy vytvořit konečnou fakturu“.
- „Zapsat úplnou úhradu zpět do Shoptetu“: plně uhrazený doklad v Doklad.ai, třeba po spárování platby z banky, označí objednávku jako zaplacenou.
- „Vložit odkaz na PDF do objednávky“: odkaz se zapíše do zvolené „Doplňující informace“ objednávky (výchozí pole 6) a můžeš ho vložit do e-mailové šablony Shoptetu.
- „Pravidelně dohledávat nepřenesené objednávky“: jednou denně dohledá objednávky, které se nepřenesly.
Co doklad obsahuje
- Odběratele z fakturační adresy a doručovací adresu, pokud se liší.
- Všechny řádky objednávky včetně dopravy, platby a slev, u produktu i jeho kód.
- Sazby DPH tak, jak přijdou z objednávky. Vlastní pravidla DPH se pro e-shop v Doklad.ai nenastavují.
- Měnu objednávky s kurzem ČNB.
- Číslo z číslování firmy a variabilní symbol z čísla dokladu.
- Poznámku zákazníka, jinak text „Objednávka z e-shopu: <číslo>“.
Existujícího zákazníka aplikace použije jen při shodě všech údajů, jinak založí nového. PDF faktury je v češtině.
Platby a párování
Objednávky, které Shoptet označí jako zaplacené (typicky online platby), se se zapnutým „Přebírat stav „zaplaceno““ vyfakturují rovnou jako zaplacené. Platební brány (GoPay, Comgate a další) Doklad.ai napojené nemá, informace o zaplacení přichází ze Shoptetu.
Platby převodem páruje Doklad.ai z banky podle variabilního symbolu, měny a částky. Banku napojíš e-mailovými oznámeními o pohybech na účtu, u Fio i přes API. Dobírky od Zásilkovny se párují s dobírkovými fakturami podle VS a částky. Když se částka liší, potvrdíš je ručně. Potvrzení platby zákazníkovi Doklad.ai u faktur ze Shoptetu neposílá.
Co integrace se Shoptetem neumí
- Nepřepíše už vystavený doklad, když se objednávka změní (částka, měna, položky, částečné storno). Zpracování skončí chybou a doklad opravíš ručně.
- Nevystaví dobropis podle vrácených položek ani automatický dobropis k faktuře s dodatečnou slevou na celý doklad.
- Neověřuje DIČ ve VIES a nemá režim OSS ani pravidla pro EU. Formulář Doklad.ai nabízí sazby 21, 12 a 0 %.
- Nenapojuje platební brány a vrácené peníze nespáruje s dobropisem.
- Nepřenáší produkty do Ceníku a nemění sklad v Shoptetu.
- Nevyfakturuje objednávku s DPH firmě, která je v Doklad.ai neplátce DPH.
- Neposílá e-maily z tvé domény, odcházejí přes Doklad.ai.
Nejčastější zádrhele
Objednávka se nevyfakturovala
Zkontroluj pravidla vystavování (objednávka může čekat na zaplacení nebo na stav odeslání), zda je zapnutá „Automatická fakturace“ a zda objednávka nevznikla před instalací doplňku. Důvod chyby najdeš v Doklad.ai v „Historie synchronizací — Shoptet“, v doplňku v „Poslední synchronizace“. Objednávku, kterou se nepodaří zpracovat ani po opakování, doplněk ohlásí hláškou „Některé objednávky se nepodařilo zpracovat…“ s tlačítkem „Zkusit znovu“.
Chyba u neplátce DPH
Hláška „Objednávka ze Shoptetu obsahuje DPH, ale firma v Doklad.ai je neplátce…“ znamená nesoulad nastavení. Zkontroluj přepínač „Jsem plátce DPH“ v Nastavení → Firma → Údaje firmy a nastavení DPH v Shoptetu.
Doplněk je pozastavený
Pozastavený doplněk objednávky nezpracovává. Po obnovení je aplikace dohledá, pokud máš zapnuté „Pravidelně dohledávat nepřenesené objednávky“.
💡 Tip: Máš e-shop na WordPressu? Pro WooCommerce existuje plugin „Doklad.ai pro WooCommerce“.
Časté otázky
Jak napojit Shoptet na Doklad.ai?
V Doklad.ai otevři Nastavení → Integrace → Shoptet a klikni na „Připojit Shoptet“. V Shoptetu nainstaluj doplněk Doklad.ai, v jeho nastavení klikni na „Propojit firmu v Doklad.ai →“ a v Doklad.ai potvrď „Propojit s touto firmou“. Nakonec v doplňku nastav pravidla vystavování.
Jak nastavit, aby se faktura vystavila až po zaplacení?
Nech výchozí pravidlo „Po zaplacení, u dobírky při odeslání“. Doklad vznikne, jakmile Shoptet objednávku označí jako zaplacenou, dobírka po přechodu do zvoleného stavu odeslání. U plateb převodem můžeš jako typ dokladu zvolit zálohovou fakturu. Po spárování platby z banky vznikne se zapnutou volbou „Po zaplacení proformy vytvořit konečnou fakturu“ i konečná faktura a se zapnutým „Zapsat úplnou úhradu zpět do Shoptetu“ se úhrada propíše do objednávky.
Umí integrace vystavit dobropis při vrácení zboží?
Jen při stornu celé objednávky, se zapnutou volbou „Dobropis při stornu“. Částečné vrácení nebo změnu objednávky integrace nepřepíše, dobropis v takovém případě vystavíš ručně.
Jak řešíte DPH pro zákazníky z EU (OSS)?
Režim OSS Doklad.ai nemá a integrace DIČ ve VIES neověřuje. Doklad přebírá sazby z objednávky v Shoptetu, takže prodeje do EU řeš v nastavení Shoptetu a se svou účetní.
Dá se faktura posílat z vlastní domény?
Ne. E-maily odcházejí přes Doklad.ai se jménem tvé firmy a odpovědi jdou na e-mail firmy. Alternativou je zapnout „Vložit odkaz na PDF do objednávky“ a odkaz poslat v e-mailu Shoptetu.