Fakturoid + Stripe + 4notify: faktura, notifikace a uzávěrka bez vlastního kódu

Fakturoid je nejpoužívanější český fakturační SaaS pro malé a střední firmy; Stripe drží většinu online plateb. 4notify mezi nimi sedí jako orchestrátor: Stripe odešle webhook payment_intent.succeeded, 4notify ho podepsaný validuje, zavolá Fakturoid API s vystavením faktury (včetně DPH dle CZ pravidel), vrátí PDF URL a zároveň pošle e-mail zákazníkovi i SMS účetní.

Problém

Tým si obvykle napíše Node.js prostředník — 200 řádků kódu, který každý čtvrtek vypadne kvůli nové verzi Stripe API. Anebo používá Zapier (drahý) nebo Make.com (pomalý, latence 30 s). 4notify drží propojku přímo, s podpisem a retries.

Právní rámec

Zákon č. 235/2004 Sb. (ZDPH) § 28

Daňový doklad musí být vystaven do 15 dnů od uskutečnění zdanitelného plnění. 4notify trigger garantuje vystavení do 30 s od platby.

Zákon č. 563/1991 Sb. (o účetnictví)

Archivace dokladů minimálně 5 let; 4notify uchovává hash dokladu a metadata pro audit, samotné PDF zůstává ve Fakturoidu.

EET / Veri*sdělení 112/2016 Sb.

Pro online platby zrušeno k 1. 1. 2023; ponecháno jako konfigurovatelný režim pro firmy, které ho dobrovolně využívají.

Architektura

Validace podpisu Stripe

Stripe podepisuje webhook HMAC-SHA256; 4notify validuje s aktuálním webhook secretem před jakoukoli akcí, jinak hodí 400.

Vystavení faktury Fakturoid API

Volání POST /api/v3/accounts/{slug}/invoices.json s mapovanými řádky, IČ, DIČ, sazbou DPH a způsobem platby „převod“/„karta“.

Trojí výstup: e-mail, SMS, ERP webhook

Zákazníkovi e-mail s PDF, účetní SMS s číslem faktury a interní podepsaný webhook do vašeho ERP — vše paralelně, retry s exponenciálním back-offem.

Idempotence a deduplikace

Stripe občas opakuje stejný webhook; 4notify používá stripe_event_id jako idempotency key, takže duplicitní faktury nevzniknou.

Kód

json
// Webhook flow Stripe → 4notify → Fakturoid:
// 1. Stripe POST /webhooks/stripe-cz
{
  "id": "evt_3OmZk2",
  "type": "payment_intent.succeeded",
  "data": { "object": {
    "id": "pi_3OmZk2", "amount": 124800, "currency": "czk",
    "metadata": { "order_id": "2026-CZ-0481", "ico": "26168685" }
  }}
}

// 2. 4notify → Fakturoid POST /api/v3/accounts/eshop/invoices.json
{
  "subject_id": "lookup:26168685",
  "lines": [{ "name": "Severin SM 4810", "quantity": 1, "unit_price": "1031.40", "vat_rate": 21 }],
  "payment_method": "card",
  "variable_symbol": "20260481"
}

Ukázková zpráva

E-mailFaktura 2026-CZ-0481 v hodnotě 1 248 Kč — PDF v příloze

Dobrý den, děkujeme za platbu. V příloze najdete fakturu 2026-CZ-0481. Stažení také zde: fakturoid.cz/i/abc123. Pro účetní účely doporučujeme uchovat 5 let.

Před spuštěním

Stripe webhook secret přidaný do 4notify
Fakturoid API token (osobní, ne sdílený)
Mapování položek katalogu Stripe → Fakturoid
Šablona e-mailu zákazníkovi s {{invoice_pdf_url}}
SMS šablona pro účetní (číslo faktury, částka, splatnost)
Test platby 1 Kč end-to-end před spuštěním

Co dělá 4notify jinak

Idempotence Stripe webhooku a podpora opravných dokladů + DPH RPDP — bez vlastního Node.js prostředníka.

Časté dotazy

Funguje to i s Superfakturou nebo iDoklad?

Ano, máme konektory pro Fakturoid, Superfakturu, iDoklad a Money S3. Použít více současně lze (jeden hlavní + záloha).

Co s opravnými doklady (storno faktury)?

Když Stripe pošle charge.refunded, 4notify zavolá Fakturoid POST /invoices/{id}/storno.json, pošle zákazníkovi e-mail s opravným dokladem a aktualizuje ERP.

Jak řešíte režim přenesené daňové povinnosti (RPDP)?

Pokud má klient platné DIČ v EU mimo ČR (ověřeno přes VIES), 4notify nastaví vat_rate na 0 a doplní poznámku „Daň odvede zákazník“ — Fakturoid ji vytiskne v zákonném znění.