Propojení Make.com (Integromat) a Doklad.ai: návod k automatizaci fakturace
· Victor Eliot · settings
Jak propojit Make.com (dříve Integromat) s Doklad.ai pomocí oficiální aplikace s 19 moduly: automatické faktury z e-shopu, doplnění z ARES, párování plateb, náklady a archivace PDF s ISDOC.
Doklad.ai propojíte s platformou Make.com (dříve Integromat) pomocí oficiální aplikace Doklad.ai s 19 hotovými moduly a okamžitým webhookem. V Doklad.ai vygenerujete firemní API klíč (dk_...) v sekci Nastavení → Integrace → API klíče a webhooky, nainstalujete aplikaci Doklad.ai do svého účtu Make.com a během několika minut složíte scénář pro automatické vystavování faktur z e-shopu, doplnění odběratele z ARES, párování příchozích plateb nebo ukládání PDF faktur s ISDOC na Google Drive.
Oficiální aplikace pokrývá vydané faktury, proformy a dobropisy, zákazníky s dohledáním v ARES (ČR) a RPO (SR), přijaté doklady (náklady), zápis úhrad a odesílání upomínek i okamžité triggery (REST Hooks) podepisované pomocí HMAC-SHA256. Nemusíte tak ručně nastavovat obecné HTTP požadavky ani skládat JSON těla.
Nainstalovat aplikaci Doklad.ai do Make.com · Otevřít API klíče a webhooky v Doklad.ai · Přehled integrace Make.com. Pokud účet v Doklad.ai ještě nemáte, nejprve se zaregistrujte zdarma.
Aktuálnost ověřena: 8. 11. 2026. Návod popisuje produkční aplikaci Doklad.ai v1.0.0 pro Make.com (19 modulů, 15 typů webhook událostí) ověřenou end-to-end testy proti API v1.
Co potřebujete před propojením Make.com a Doklad.ai?
Připravte si účet v Make.com (pro většinu scénářů stačí i bezplatný tarif Free s 1 000 operacemi měsíčně) a aktivní firmu v Doklad.ai, pod kterou mají doklady vznikat. V Doklad.ai zkontrolujte, že máte vyplněné fakturační údaje firmy, výchozí číselnou řadu, bankovní spojení (IBAN pro QR platbu) a správně nastavený režim DPH (plátce, neplátce nebo identifikovaná osoba).
Každý API klíč (dk_...) je v Doklad.ai svázán s konkrétní firmou (companyId). Pokud v Doklad.ai spravujete více firem (například OSVČ a s.r.o.), vytvoříte si pro každou firmu samostatné připojení (Connection) v Make.com.
Jak propojit Make.com a Doklad.ai v pěti krocích?
Propojení probíhá přes firemní API klíč a nevyžaduje žádné programování. Jakmile v Make.com uložíte připojení, všechny moduly i okamžité webhooky používají toto spojení automaticky.
1. Kde v Doklad.ai vygeneruji API klíč?
Přihlaste se do Doklad.ai, v horním přepínači vyberte cílovou firmu a otevřete Nastavení → Integrace → API klíče a webhooky (nebo klikněte přímo na správu API klíčů).
Klikněte na Nový API klíč, pojmenujte ho například Make.com produkce a zkopírujte vygenerovaný klíč začínající prefixem dk_. Klíč se z bezpečnostních důvodů v plném znění zobrazí pouze při vytvoření; v databázi Doklad.ai se ukládá pouze jeho kryptografický otisk SHA-256.
2. Jak přidám aplikaci Doklad.ai do svého účtu Make.com?
Otevřete oficiální instalační odkaz aplikace Doklad.ai pro Make.com a potvrďte přidání aplikace do své organizace v Make.com. Současně probíhá zařazení aplikace do veřejného globálního katalogu Make.com; instalační odkaz zpřístupňuje totožnou verzi v1.0.0 okamžitě bez čekání.
Po instalaci najdete Doklad.ai přímo ve vyhledávači modulů při tvorbě libovolného scénáře v Make.com.
3. Jak v Make.com vytvořím připojení (Connection) k Doklad.ai?
V editoru scénáře v Make.com klikněte na tlačítko +, vyhledejte Doklad.ai a vyberte libovolný modul (například Vyhledat firmu v ARES / RPO podle IČO nebo Vytvořit fakturu / proformu / dobropis).
V okně modulu klikněte u pole Connection na tlačítko Add, do pole API klíč (dk_...) vložte zkopírovaný klíč z kroku 1 a klikněte na Save. Make.com okamžitě zavolá ověřovací endpoint GET /api/v1/me, zkontroluje platnost klíče a připojení pojmenuje názvem a IČO vaší firmy.
4. Jak fungují okamžité webhooky (Watch Events)?
Pokud chcete scénář spouštět okamžitě ve chvíli, kdy v Doklad.ai vznikne nová faktura, přijde úhrada nebo se založí náklad, zvolte jako první modul scénáře Sledovat události v Doklad.ai (Okamžitý) (watchEvents).
Při vytvoření webhooku v Make.com vyberete svůj účet Doklad.ai a zaškrtnete události, které chcete sledovat (například invoice.created a invoice.paid). Make.com na pozadí automaticky zavolá POST /api/v1/webhooks a zaregistruje webhook v Doklad.ai včetně sdíleného tajemství (whsec_...). Každou příchozí zprávu Make.com ověřuje přes hlavičku X-Webhook-Signature (HMAC-SHA256). Když scénář smažete nebo odpojíte, Make.com webhook v Doklad.ai sám odregistruje (DELETE /api/v1/webhooks/:id).
5. Jak scénář otestuji před zapnutím?
V levém dolním rohu editoru Make.com klikněte na Run once. Po provedení kroku se u modulu Doklad.ai zobrazí zelená bublina s počtem operací a rozbalovací strom všech vrácených polí (například id, invoiceNumber, total, variableSymbol, status), která můžete přetáhnout do navazujících modulů (Gmail, Slack, Google Drive, Google Sheets, Shoptet, WooCommerce nebo Pohoda).
Jakmile scénář projde bez chyby, přepněte přepínač plánování (Scheduling) vlevo dole do polohy ON.
Jakých 19 modulů aplikace Doklad.ai v Make.com obsahuje?
Moduly jsou v Make.com rozdělené do pěti přehledných skupin podle oblasti. Všechny moduly pracují s českými popisky polí a vracejí typovaná výstupní data pro snadné mapování v dalších krocích scénáře.
| Skupina v Make.com | Název modulu (ID) | Typ modulu | Co modul v Doklad.ai dělá |
|---|---|---|---|
| Okamžité triggery (Webhooks) | Sledovat události v Doklad.ai (watchEvents) | Instant Trigger | Okamžitě spustí scénář při vybrané události (15 typů událostí pro faktury, platby, náklady a zákazníky) s automatickou registrací a ověřením podpisu HMAC-SHA256 |
| Faktury a doklady | Vytvořit fakturu / proformu / dobropis (createInvoice) | Action | Vystaví novou fakturu, zálohovou fakturu nebo dobropis; odběratele vybere z rozbalovacího seznamu nebo ho automaticky založí; spočítá DPH a při stavu paid rovnou zapíše úhradu |
| Faktury a doklady | Získat detail faktury (getInvoice) | Action | Načte kompletní hlavičku faktury, údaje odběratele i pole položek (items) podle ID |
| Faktury a doklady | Upravit fakturu (updateInvoice) | Action | Aktualizuje stav, datum splatnosti, variabilní symbol, způsob platby nebo poznámku |
| Faktury a doklady | Smazat fakturu (deleteInvoice) | Action | Smaže nevystavenou (koncept) nebo stornovanou fakturu podle ID |
| Faktury a doklady | Stáhnout PDF faktury (včetně ISDOC) (downloadInvoicePdf) | Action | Stáhne binární soubor PDF faktury s vloženým QR kódem (SPAYD) a strojově čitelnou přílohou ISDOC XML pro uložení na Google Drive, OneDrive nebo odeslání účetní |
| Faktury a doklady | Vyhledat faktury (listInvoices) | Search | Vyhledá faktury podle stavu (draft, sent, paid, overdue, cancelled), odběratele, datového rozsahu nebo fulltextu (číslo faktury, variabilní symbol) |
| Faktury a doklady | Zaznamenat úhradu faktury (recordInvoicePayment) | Action | Zapíše příchozí platbu k faktuře; pokud nezadáte částku, uhradí zbývající nedoplatek a přepne fakturu do stavu paid |
| Faktury a doklady | Odeslat fakturu zákazníkovi e-mailem (sendInvoiceEmail) | Action | Odešle fakturu v PDF příloze s odkazem na klientský portál na e-mail odběratele (koncept před odesláním automaticky vystaví a očísluje) |
| Faktury a doklady | Odeslat upomínku k faktuře (sendInvoiceReminder) | Action | Odešle 1. upomínku, 2. upomínku nebo pokus o smír s přiloženým PDF faktury |
| Zákazníci a ARES | Vytvořit zákazníka (kontakt) (createCustomer) | Action | Založí novou kartu odběratele nebo dodavatele v adresáři firmy |
| Zákazníci a ARES | Získat detail zákazníka (getCustomer) | Action | Vrátí detail karty zákazníka podle ID |
| Zákazníci a ARES | Upravit zákazníka (updateCustomer) | Action | Aktualizuje kontaktní nebo fakturační údaje existujícího zákazníka |
| Zákazníci a ARES | Vyhledat firmu v ARES / RPO podle IČO (lookupAres) | Action | Dohledá v registru ARES (ČR, včetně skupinového DIČ a plátcovství DPH) nebo RPO (SR) přesný název, sídlo, DIČ a stav plátce podle IČO |
| Zákazníci a ARES | Vyhledat zákazníky (listCustomers) | Search | Vyhledá kontakty v adresáři podle názvu, IČO, DIČ nebo e-mailu |
| Náklady (přijaté doklady) | Vytvořit náklad (přijatý doklad) (createExpense) | Action | Zapíše přijatou fakturu nebo účtenku, automaticky dopočítá základ a DPH a ohlídá duplicity |
| Náklady (přijaté doklady) | Získat detail nákladu (getExpense) | Action | Vrátí detail přijatého dokladu včetně položek podle ID |
| Náklady (přijaté doklady) | Vyhledat náklady (listExpenses) | Search | Vypíše přijaté doklady filtrované podle stavu, kategorie a období |
| Ostatní / Vlastní API volání | Provést vlastní API volání (makeApiCall) | Universal | Zavolá libovolný autorizovaný endpoint Doklad.ai s již připojeným API klíčem (např. /v1/me, /export/invoices/isdoc) |
Součástí aplikace je také vzdálená procedura (rpcListCustomers), která přímo v modulu Vytvořit fakturu načítá rozbalovací seznam vašich existujících odběratelů z Doklad.ai.
Jaké události umí okamžitý webhook sledovat?
Modul Sledovat události v Doklad.ai (Okamžitý) (watchEvents) podporuje 15 typů událostí. V jednom scénáři můžete sledovat buď jednu konkrétní událost, nebo jejich libovolnou kombinaci:
- Faktury (8 událostí):
invoice.created(nová faktura),invoice.updated(úprava faktury),invoice.sent(odeslání faktury),invoice.paid(úhrada faktury),invoice.overdue(faktura po splatnosti),invoice.cancelled(storno faktury),invoice.status_changed(změna stavu),invoice.deleted(smazání faktury). - Platby (2 události):
payment.received(přijatá platba),payment.matched(spárovaná platba). - Náklady (3 události):
expense.created(nový náklad),expense.approved(schválený náklad),expense.paid(uhrazený náklad). - Zákazníci (2 události):
customer.created(nový zákazník),customer.updated(upravený zákazník).
Jaké scénáře v Make.com ušetří nejvíc práce?
Níže jsou tři nejčastější scénáře, které podnikatelé a e-shopy v Make.com s Doklad.ai nasazují:
1. Objednávka z e-shopu nebo formuláře → ARES → Faktura → E-mail zákazníkovi
Když přijde nová objednávka (z WooCommerce, Shopify, Webflow, Tally, Typeformu nebo vlastního webhooku):
- Modul Vyhledat firmu v ARES / RPO podle IČO (
lookupAres) ověří IČO zákazníka a načte oficiální název firmy, adresu a DIČ z registru ARES. - Modul Vytvořit fakturu / proformu / dobropis (
createInvoice) založí daňový doklad s položkami objednávky, variabilním symbolem podle čísla objednávky a správnou sazbou DPH. - Modul Odeslat fakturu zákazníkovi e-mailem (
sendInvoiceEmail) odešle hotové PDF s QR platbou a ISDOC přílohou přímo zákazníkovi.
2. Příchozí platba ze Stripe, GoPay, Comgate nebo banky → Spárování a úhrada faktury
Když platební brána (Stripe, GoPay, Comgate) nebo banka oznámí přijatou platbu:
- Modul Vyhledat faktury (
listInvoices) najde v Doklad.ai neuhrazenou fakturu podle variabilního symbolu nebo čísla objednávky (search). - Modul Zaznamenat úhradu faktury (
recordInvoicePayment) zapíše přijatou částku, datum platby a poznámku s ID transakce a automaticky přepne fakturu do stavupaid.
3. Nová nebo uhrazená faktura → Stažení PDF (s ISDOC) na Google Drive a řádek v Google Sheets
Pro automatické předávání dokladů účetní bez ručního stahování:
- Modul Sledovat události v Doklad.ai (Okamžitý) (
watchEvents) zachytí událostinvoice.createdneboinvoice.paid. - Modul Získat detail faktury (
getInvoice) načte kompletní údaje dokladu. - Modul Stáhnout PDF faktury (včetně ISDOC) (
downloadInvoicePdf) stáhne PDF soubor (u českých firem obsahuje vložený ISDOC XML) a navazující modul Google Drive — Upload a File ho uloží do složkyFaktury 2026/11pro účetní, zatímco Google Sheets — Add a Row zapíše přehled do tabulky.
Jak jsme Make.com aplikaci ověřili?
Celou aplikaci Doklad.ai v1.0.0 pro Make.com jsme 8. listopadu 2026 ověřili 19krokovým end-to-end testem proti produkčnímu REST API v1 a databázi Doklad.ai. Kontrolovali jsme autentizaci klíčem dk_..., registraci a odpojení webhooku, ověření podpisu X-Webhook-Signature, výpočty DPH, stahování binárního PDF i bezpečnostní omezení firemního API klíče.
| Kontrolovaná operace v Make.com | Volaný endpoint v Doklad.ai | Ověřený výsledek |
|---|---|---|
Ověření spojení (doklad-ai-key) | GET /api/v1/me | 200 OK (vráceno ID, název a IČO firmy) |
Automatická registrace webhooku (attach) | POST /api/v1/webhooks | 201 Created (externalHookId + whsec_...) |
| Založení, čtení, úprava a vyhledání zákazníka | POST/GET/PATCH /api/v1/customers | 201/200 OK (včetně RPC seznamu rpcListCustomers) |
| Dohledání firmy v ARES podle IČO | GET /api/test/ares/lookup/:ico | 200 OK (doplněn název, sídlo, DIČ a plátcovství DPH) |
| Vystavení, čtení, úprava a vyhledání faktury | POST/GET/PATCH /api/v1/invoices | 201/200 OK (automatický výpočet DPH 21 % a položek) |
Zápis úhrady faktury (recordInvoicePayment) | POST /api/v1/invoices/:id/payments | 200 OK (přepnutí do stavu paid, spárování částky) |
Stažení PDF faktury s ISDOC (downloadInvoicePdf) | GET /api/invoices/:id/pdf | 200 OK (application/pdf, binární buffer s ISDOC) |
| Založení, čtení a výpis nákladů | POST/GET /api/v1/expenses | 201/200 OK (automatický dopočet základu a DPH) |
Smazání konceptu faktury (deleteInvoice) | DELETE /api/invoices/:id | 200 OK (ochrana vystavených/uhrazených dokladů) |
Odpojení webhooku po vypnutí scénáře (detach) | DELETE /api/v1/webhooks/:id | 200 OK (transakční smazání webhooku i historie doručení) |
Bezpečnostní izolace klíče dk_... | GET /api/settings/api-keys, /api/bank-accounts | 403 Forbidden (API klíč nemůže číst bankovní tokeny ani měnit klíče) |
Časté otázky
Je aplikace Doklad.ai pro Make.com zdarma?
Ano. Ze strany Doklad.ai je využívání API klíčů, webhooků i všech 19 modulů v Make.com zcela zdarma. V Make.com spotřebováváte pouze běžné operace podle svého tarifu Make (bezplatný tarif Make.com obsahuje 1 000 operací měsíčně).
Kde v Doklad.ai najdu API klíč pro Make.com?
Po přihlášení do Doklad.ai otevřete Nastavení → Integrace → API klíče a webhooky (přímý odkaz) a klikněte na Nový API klíč. Vygenerovaný klíč začíná znaky dk_ a vkládá se přímo do okna připojení (Connection) v Make.com.
Musím webhooky v Doklad.ai nastavovat ručně?
Ne. Pokud v Make.com použijete modul Sledovat události v Doklad.ai (Okamžitý) (watchEvents), Make.com webhook v Doklad.ai zaregistruje sám přes API při uložení scénáře a při smazání scénáře ho opět sám odregistruje. Ruční zadání URL v Doklad.ai použijete jen tehdy, pokud posíláte události do vlastního serveru mimo Make.com.
Obsahuje PDF stažené přes Make.com také QR platbu a ISDOC?
Ano. Modul Stáhnout PDF faktury (včetně ISDOC) (downloadInvoicePdf) stahuje stejné plnohodnotné PDF jako v webové aplikaci Doklad.ai — včetně QR kódu pro okamžitou platbu (SPAYD) a vložené přílohy ISDOC XML pro import do účetních programů (Pohoda, Money S3, ABRA Flexi).
Může API klíč v Make.com omylem smazat zaplacenou fakturu nebo změnit bankovní účet?
Ne. Modul deleteInvoice dovolí smazat pouze pracovní koncept (draft), neodeslanou fakturu (issued) nebo stornovanou fakturu (cancelled). Zaplacené ani odeslané faktury smazat nelze. Firemní API klíč dk_... má navíc na úrovni serveru zakázaný přístup ke správě ostatních API klíčů i k nastavení bankovních účtů a Fio/PSD2 tokenů (403 Forbidden).
Zdroje
- Instalace oficiální aplikace Doklad.ai v Make.com (v1.0.0).
- Veřejná dokumentace REST API Doklad.ai (OpenAPI / Swagger).
- Správa API klíčů a webhooků v Doklad.ai.
- Přehled integrace Make.com a Doklad.ai.
- Make.com Help Center: Custom Apps & Webhooks.
Článek vydává Doklad.ai jako oficiální dokumentaci k integraci s Make.com.