Nápověda

Dokumentace a návody

Návody pro běžné používání, dokumentace veřejného API pro vývojáře a přehled integrací. Vše odpovídá tomu, co aplikace reálně umí.

Začínáme

Od registrace k první zaplacené faktuře ve čtyřech krocích.

1 · Registrace

Založ účet na /signup (e-mail a heslo, ověření kódem). Free tarif je bez platební karty, navždy zdarma do 2 odběratelů.

2 · Fakturační údaje

V Nastavení → Firma vyplň svoje údaje — IČO načteš jedním kliknutím z ARES. Nastav, jestli jsi plátce DPH, a přidej bankovní účet pro QR platbu.

3 · První faktura

Faktury → Nová faktura. Vyber odběratele (nebo ho doplň z ARES podle IČO), přidej položky — DPH a celková částka se počítají live.

4 · Odešli a inkasuj

Vystav fakturu, stáhni PDF s QR platbou nebo ji rovnou pošli e-mailem. Po zaplacení ji v Bance spáruješ podle variabilního symbolu.

Návody

Nejčastější úlohy krok za krokem — co kde v aplikaci najdeš a jak to funguje.

Odběratelé a ARES

V sekci Odběratelé zadej IČO a tlačítkem „Načíst z ARES" doplníš název, adresu i DIČ z obchodního rejstříku. Odběratel se pak nabízí při tvorbě faktury.

PDF s QR platbou

Každá faktura v CZK má v PDF QR platbu podle standardu České bankovní asociace (SPAYD) — odběratel zaplatí naskenováním v bankovní aplikaci.

Banka a párování plateb

V sekci Banka přidáš účet a naimportuješ transakce (CSV). Platby se automaticky párují s fakturami podle variabilního symbolu a faktura se označí jako zaplacená.

Pravidelné faktury

Opakované faktury (předplatné, paušály) nastavíš jednou a vystavují se automaticky. Můžeš použít i šablony pro rychlé opakované doklady.

Prodejky a pokladna

Prodejky (POS) pro hotovostní prodej s automatickým pokladním dokladem. Pokladna vede knihu příjmových a výdajových dokladů (PPD/VPD).

Cizí měna a kurz ČNB

Faktury umíš vystavit v cizí měně. Kurz se automaticky natáhne z denní kurzovní tabulky ČNB a částka se přepočítá i do CZK.

Export pro účetní

Doklady vyexportuješ pro účetní v Pohoda XML nebo CSV za zvolené období — bez ručního přepisování.

Číselné řady

V Číselných řadách si nastavíš formát a prefix číslování pro každý typ dokladu zvlášť. Importované doklady drží svá původní čísla v samostatné řadě.

Vzhled faktur a tým

V Nastavení → Vzhled faktur upravíš logo, barvu a texty. Pod Nastavení → Tým pozveš kolegy nebo účetní s rolemi (vlastník, admin, účetní, jen čtení).

Pro vývojáře — veřejné API

REST API v1 pro programové vystavování faktur a správu odběratelů. Dostupné v tarifu Pro s API klíčem.

Základy

Base URL: https://zafakturujto.cz/api/v1
Autentizace: Bearer API klíč (fakt_…)
Kde vezmu klíč: Nastavení → Aplikace / Integrace
Oprávnění: scope read (čtení) / write (zápis)
Tarif: jen Pro
Limit požadavků: 429 + hlavička Retry-After
Idempotence: stejné cisloObjednavky vrátí existující fakturu
Tvar chyby: { "error": "..." }

Příklad — vytvoření faktury

curl -X POST https://zafakturujto.cz/api/v1/faktury \
  -H "Authorization: Bearer fakt_TVUJ_KLIC" \
  -H "Content-Type: application/json" \
  -d '{
    "odberatel": { "nazev": "Firma s.r.o.", "ico": "12345678" },
    "polozky": [
      { "popis": "Konzultace", "jednotkovaCenaBezDPH": 1000, "sazbaDPH": "S_21" }
    ]
  }'

GET/fakturySeznam vydaných faktur

POST/fakturyVytvořit fakturu

GET/faktury/{cislo}Detail faktury

PATCH/faktury/{cislo}/stavZměna stavu faktury

GET/faktury/{cislo}/pdfPDF faktury

GET/odberateleSeznam odběratelů

POST/odberateleVytvořit odběratele

Integrace

S čím se ZaFakturujTo.cz propojuje. Co je hotové a co teprve připravujeme.

Import z iDokladu

Přeneseš vydané faktury, zálohové i dobropisy se zachovanými čísly. Náhled je zdarma, samotný import je součást Pro (7 dní na zkoušku zdarma).

Návod na přechod

Veřejné REST API

Vystavuj faktury a odběratele programově z vlastního systému. Kompletní reference níže, strojový spec v OpenAPI.

Dokumentace API

WordPress / WooCommerce

Plugin pro WooCommerce — faktura se vystaví automaticky po objednávce v e-shopu (přes veřejné API). Součást Pro.

Shopify

Již brzy

Propojení Shopify obchodu pro automatické fakturování objednávek.

Export pro účetní

Pohoda XML a CSV za zvolené období — předáš účetní bez přepisování.

Webhooky

Notifikace o událostech (např. vystavení faktury) na tvoji URL — napoj si vlastní automatizace. Součást Pro.

Nenašel jsi, co potřebuješ?

Napiš nám — rádi poradíme. Free tarif vyzkoušíš bez karty, Pro má 7 dní na zkoušku (pak 123 Kč/měs bez DPH).