EasyFaktury CLI

Plná CLI dokumentace pro lokální i serverovou práci.

EasyFaktury CLI je určené pro přesné, opakovatelné workflow bez chatové improvizace. Funguje na macOS, Linuxu, Windows i VPS a umí lokální render faktur do PDF nebo ISDOC bez iOS nebo macOS závislostí. Klíčové je, že CLI drží české právní náležitosti a české fakturační zvyklosti konzistentně, místo aby je nechávalo na obecném modelu nebo ručním odhadu.

Instalace První faktura

lokální PDF a ISDOC registrace přes CLI ARES a registry QR platby JSON-first update v CLI

Krátká odpověď

Jde to plně lokálně?

Ano pro lokální draft, lokální render do PDF a lokální ISDOC export. Ne pokud chcete zapisovat vzdálené účetní záznamy do EasyFaktury backendu. Tam už jde o serverovou akci nad vaším profilem.

Kdy zvolit CLI

Když chcete přesnost

CLI je nejlepší pro copyable příkazy, cron, CI, backendové joby, lokální složku s podklady a workflow, kde má každý krok znamenat přesně to, co zadáte.

České fakturační věci, které CLI řeší za vás

ARES

Doplnění firmy podle IČO

CLI umí dohledat dodavatele nebo odběratele přes ARES, takže nemusíte ručně vypisovat jméno a adresu firmy.

Registry

Registrační věta na faktuře

Pokud jsou data dostupná, CLI doplní i text typu „zapsaná v obchodním rejstříku“ nebo živnostenském rejstříku.

DPH

DPH a stav plátce

CLI umí pracovat s DPH statusem a u lokálního renderu doplnit správný režim faktury včetně reverse charge scénářů.

Platby

IBAN a QR platba

Z čísla účtu a kódu banky umí odvodit český IBAN a do PDF připravit QR platbu, aby byla faktura rovnou použitelná.

Command map

Auth

`auth`

Registrace, přihlášení, kontrola session a volba aktivního profilu.

Onboarding

`onboarding`

Lead, ověření emailu a trial workflow pro nové účty.

Profiles

`profiles`

Lokální i vzdálený stav profilů, kontrola aktivního workspace.

Invoices

`invoices`

Lokální render draftu do PDF a příprava fakturačního workflow.

Expenses

`expenses`

Práce se synchronizovanými výdaji a přílohami.

Update

`update`

Kontrola nové verze a přímý self-update CLI binárky.

Quick Start Prototype

Zjednodušená verze stejného component patternu. Místo jednoho přetíženého panelu jsou tu tři samostatné kroky: instalace, přihlášení a první faktura.

1. Instalace CLI

# Doporučený start pro macOS. Homebrew a hned ověření verze.

$ brew install --formula 'https://easyfaktury.cz/downloads/easyfaktury-cli/easyfaktury.rb?v=0.3.0'

$ easyfaktury version

2. Přihlášení nebo registrace

# Univerzální cesta pro kontrolu session a aktivního profilu.

$ easyfaktury auth status --json

$ easyfaktury profiles remote --json

3. První faktura

# Univerzální lokální test. PDF a ISDOC bez registrace.

$ mkdir -p ./2026/3

$ easyfaktury --json invoices render --local --input ./draft.json --pdf-out ./2026/3/2026-0015.pdf --isdoc-out ./2026/3/2026-0015.isdoc

Pokročilejší verzi s nested přepínači a více režimy jsem popsal v interní dokumentaci, ať ji můžeme kdykoliv znovu vytáhnout bez reverse engineeringu od nuly.

Instalace

Začněte nejjednodušší cestou. Pro macOS doporučujeme jako výchozí variantu Homebrew. Přímé archivy nechte až na chvíli, kdy chcete ruční instalaci nebo běžíte na Linuxu či Windows.

macOS

Linux

Windows

Doporučeno pro macOS

Homebrew jako výchozí cesta

Pokud jste na macOS, tohle je nejčistší instalace. Dostanete jednoduchý install, snadné aktualizace a nejméně ruční práce.

nainstalujte CLI přes Homebrew
ověřte verzi
pak spusťte update check nebo rovnou pokračujte na registraci

macOS přes Homebrew

brew install --formula 'https://easyfaktury.cz/downloads/easyfaktury-cli/easyfaktury.rb?v=0.3.0'
easyfaktury version

Ruční instalace

macOS Apple Silicon

Když nechcete Homebrew nebo potřebujete archiv přímo, použijte arm64 build a binárku nainstalujte ručně.

macOS Apple Silicon

curl -fsSL -o easyfaktury.tar.gz \
  'https://easyfaktury.cz/downloads/easyfaktury-cli/easyfaktury-darwin-arm64.tar.gz?v=0.3.0'
tar -xzf easyfaktury.tar.gz
sudo install -m 0755 easyfaktury-darwin-arm64 /usr/local/bin/easyfaktury
easyfaktury version

Ruční instalace

macOS Intel

Pro starší Intel Macy použijte amd64 archiv a nainstalujte binárku ručně do PATH.

macOS Intel

curl -fsSL -o easyfaktury.tar.gz \
  'https://easyfaktury.cz/downloads/easyfaktury-cli/easyfaktury-darwin-amd64.tar.gz?v=0.3.0'
tar -xzf easyfaktury.tar.gz
sudo install -m 0755 easyfaktury-darwin-amd64 /usr/local/bin/easyfaktury
easyfaktury version

Ruční instalace

Linux x86_64

Standardní build pro většinu VPS a serverů. Stáhněte archiv, rozbalte ho a binárku nainstalujte do PATH.

Linux x86_64

curl -fsSL -o easyfaktury.tar.gz \
  'https://easyfaktury.cz/downloads/easyfaktury-cli/easyfaktury-linux-amd64.tar.gz?v=0.3.0'
tar -xzf easyfaktury.tar.gz
sudo install -m 0755 easyfaktury-linux-amd64 /usr/local/bin/easyfaktury
easyfaktury version

Ruční instalace

Linux ARM64

Pro ARM servery a menší stroje použijte arm64 build. Další kroky jsou stejné jako u ostatních unixových archivů.

Linux ARM64

curl -fsSL -o easyfaktury.tar.gz \
  'https://easyfaktury.cz/downloads/easyfaktury-cli/easyfaktury-linux-arm64.tar.gz?v=0.3.0'
tar -xzf easyfaktury.tar.gz
sudo install -m 0755 easyfaktury-linux-arm64 /usr/local/bin/easyfaktury
easyfaktury version

Windows x86_64

ZIP archiv a PATH

Na Windows stáhněte ZIP, rozbalte ho a přidejte easyfaktury.exe do PATH. Pak už ověřte verzi stejně jako na ostatních systémech.

Windows x86_64

Stáhněte:
https://easyfaktury.cz/downloads/easyfaktury-cli/easyfaktury-windows-amd64.zip?v=0.3.0

Rozbalte ZIP a přidejte `easyfaktury.exe` do PATH.
Pak ověřte:
easyfaktury version

První kontrola a update

Základní kontrola

easyfaktury version
easyfaktury --help
easyfaktury doctor --json

Update na nejnovější verzi

easyfaktury update check --json
easyfaktury update apply --base-url https://easyfaktury.cz
easyfaktury version

Registrace a onboarding přes CLI

Nový účet lze založit i přes CLI. Po ověření emailu můžete rovnou spustit trial a pokračovat k první faktuře.

Nejkratší registrace

easyfaktury auth email-start \
  --email YOUR_EMAIL \
  --consent-follow-up true \
  --json

printf '%s' "$VERIFY_TOKEN" | \
  easyfaktury auth email-verify --token-stdin --json

easyfaktury onboarding status --json
easyfaktury onboarding start-trial --json

Lead-based onboarding

easyfaktury onboarding create-lead \
  --email YOUR_EMAIL \
  --source agent \
  --json

easyfaktury onboarding send-verification \
  --lead-id lead_123 \
  --json

easyfaktury onboarding status \
  --lead-id lead_123 \
  --json

Přihlášení a profily

Login přes API key

printf '%s' "$EASYFAKTURY_API_KEY" | \
  easyfaktury auth login --api-key-stdin --json

easyfaktury auth status --json

Výběr profilu

easyfaktury profiles list --json
easyfaktury profiles remote --json
easyfaktury auth use-profile profile_123 --json
easyfaktury auth status --json

První lokální faktura

Pokud chcete ověřit, že CLI opravdu funguje, začněte čistě lokálním draftem a renderem do PDF. Tohle je dnes plně lokální cesta a právě tady se projeví i ARES enrichment, QR platba a odvození IBAN. Kdykoliv to jde, ukládejte výstupy přehledně do složek podle roku a měsíce, například 2026/3/.

Testovací draft

{
  "number": "TEST-001",
  "issue_date": "2026-03-30",
  "payment_method": "Banka",
  "currency": "CZK",
  "supplier": {
    "ico": "44846746",
    "dic": "CZ44846746",
    "vat_payer_status": "Čtvrtletní plátce",
    "account_number": "177081686",
    "bank_code": "0600"
  },
  "client": {
    "ico": "01648847"
  },
  "items": [
    {
      "description": "Testovací položka",
      "quantity": 1,
      "unit": "ks",
      "price_per_unit": 1000,
      "vat_rate": 21
    }
  ]
}

Render do PDF a ISDOC

mkdir -p ./2026/3
easyfaktury invoices render --local \
  --input ./invoice.json \
  --pdf-out ./2026/3/2026-0015.pdf \
  --isdoc-out ./2026/3/2026-0015.isdoc \
  --json

Co se u tohoto draftu doplní automaticky

Pokud zadáte ico, CLI může přes ARES doplnit název a adresu firmy. U dodavatele umí dopočítat registrační větu, odvodit český IBAN z čísla účtu a kódu banky a při bankovní platbě vygenerovat QR kód do PDF.

Doporučená struktura souborů

Pro přehlednost ukládejte vygenerované doklady ideálně do struktury ROK/MĚSÍC/ČÍSLO-FAKTURY, například 2026/3/2026-0015.pdf a 2026/3/2026-0015.isdoc.

Co je opravdu lokální a co ne

Plně lokálně

Draft JSON, lokální podklady, lokální PDF, lokální ISDOC, ARES enrichment, odvození IBAN a QR kód pro lokální výstup můžete generovat přímo na svém zařízení nebo VPS.

Ne plně lokálně

Registrace účtu, trial, vzdálené profilové dotazy a všechny skutečné write akce do EasyFaktury backendu používají server. CLI je jen deterministická vrstva nad těmito operacemi.

Command reference

Top-level help

easyfaktury --help

Commands:
  auth
  onboarding
  profiles
  invoices
  expenses
  update
  doctor
  version

auth

easyfaktury auth --help

Subcommands:
  setup
  login
  email-start
  email-verify
  status
  logout
  use-profile

onboarding

easyfaktury onboarding --help

Subcommands:
  create-lead
  send-verification
  status
  start-trial

invoices

easyfaktury invoices --help

Subcommands:
  render

expenses

easyfaktury expenses list --json

easyfaktury expenses create \
  --date 2026-03-28 \
  --invoice-number N202603001 \
  --base-amount 1000 \
  --vat-rate 21 \
  --supplier-vat-number CZ12345678 \
  --supplier-country-code CZ \
  --notes "Hosting" \
  --json

update

easyfaktury update --help

Subcommands:
  check
  apply

Tipy pro CI a server

Izolace stavu

export EASYFAKTURY_CLI_CONFIG_DIR="$PWD/.easyfaktury-cli"
easyfaktury auth status --json

Diagnostika

easyfaktury doctor --json
easyfaktury --verbose auth status --json

Nejčastější otázky

Umí CLI fungovat bez iOS nebo macOS?Ano. Lokální PDF a ISDOC workflow je navržené pro Linux, Windows, macOS i VPS prostředí.
Můžu s CLI vystavit fakturu plně lokálně?Ano, pokud tím myslíte lokální draft a lokální PDF nebo ISDOC výstup. Ne, pokud tím myslíte vzdálený zápis účetních dat do EasyFaktury backendu.
Je registrace možná přes CLI?Ano. Podporované jsou auth email-start, auth email-verify a onboarding příkazy.
Je CLI vhodné i pro neprogramátora?Ano, pokud chcete copyable příkazy a přesné kroky. Není to chat, ale nemusí být složité.
Kdy je lepší jít přes ChatGPT, Codex nebo Claude?Když chcete popsat úkol vlastními slovy. Když chcete přesné a opakovatelné příkazy, je lepší CLI.