Jak vystavit fakturu z vlastní aplikace

Mnoho firem eviduje práci jinde než v Pohodě: hodiny v docházkovém systému, předplatné v aplikaci, zakázky v CRM. Na konci měsíce pak někdo ručně přepisuje faktury. S apios vystaví fakturu přímo váš systém — v Pohodě se objeví jako běžná vydaná faktura, kterou účetní zaúčtuje stejně jako všechny ostatní.

Minimální faktura

curl -X PUT https://api.apios.cz/api/v1/invoice \
  -H "X-AUTH-TOKEN: VAS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: faktura-predplatne-2026-10-zakaznik-25" \
  -d '{
    "customer_company": "ABC s.r.o.",
    "customer_name": "Jan Novák",
    "customer_street": "Václavské nám. 109",
    "customer_city": "Praha",
    "customer_zip": "11000",
    "customer_company_id": "12345678",
    "customer_vat": "CZ12345678",
    "text": "Fakturujeme vám předplatné za říjen 2026",
    "date_due": "2026-11-02",
    "payment": "příkazem",
    "invoice_items": [
      { "name": "Předplatné Standard", "qty": 1, "unit": "měs", "price": 1500, "vat_rate": "high" },
      { "name": "Konzultace", "qty": 2.5, "unit": "hod", "price": 1200, "vat_rate": "high" }
    ]
  }'

Totéž volání najdete v dokumentaci se všemi parametry a můžete si ho tam rovnou vyzkoušet:

Povinné jsou zákazník, forma úhrady (payment) a položky. U každé položky musí být name, qty, price a vat_rate (none, low nebo high).

Odpověď vrátí ID a číslo faktury:

{
  "success": true,
  "message": "Faktura byla úspěšně vytvořena",
  "data": { "id": 813, "number": "250100185", "action_type": "add" }
}

Zákazník z adresáře

Fakturujete pravidelně stejným zákazníkům? Místo adresy pošlete customer_id — ID záznamu v adresáři Pohody. Adresa se převezme z adresáře a faktura je s ním správně provázaná, takže v Pohodě uvidíte všechny doklady daného zákazníka pohromadě:

{
  "customer_id": 25,
  "payment": "příkazem",
  "invoice_items": [
    { "name": "Předplatné Standard", "qty": 1, "price": 1500, "vat_rate": "high" }
  ]
}

Jak ID zákazníka zjistit nebo zákazníka založit, popisuje návod Jak hledat a zakládat zákazníky v adresáři.

Skladové položky

Prodáváte i zboží ze skladu? Přidejte k položce kód zásoby v ids (nebo její ID v id) a položka se ve faktuře propojí se skladem:

{ "name": "Router AX3000", "qty": 1, "price": 2490, "vat_rate": "high", "ids": "RT-AX3000" }

Užitečná pole

Faktury v cizí měně podporuje API také (currency_ids, currency_rate a u položek price_foreign). U nich ale pozor: cenu bere Pohoda z price_foreign přepočtenou kurzem, takže položka bez price_foreign skončí na nule.

Hromadné vystavení

Na konci měsíce fakturujete desítky zákazníků najednou? Endpoint PUT /api/v1/invoice/bulk přijme víc faktur v jednom požadavku a Pohoda je zpracuje v jedné dávce. Podrobnosti najdete v dokumentaci.

Co dál

• Stáhněte fakturu jako PDF a pošlete ji zákazníkovi z vlastní aplikace.
• Až zákazník zaplatí, označte fakturu jako uhrazenou.