Jak z Pohody vyexportovat faktury po splatnosti

Kdo vám dluží a jak dlouho? V Pohodě to zjistíte: v agendě Vydané faktury klikněte na záhlaví sloupce K likvidaci a zvolte záložku Po splatnosti. Jenže ten seznam vidí jen ten, kdo má Pohodu zrovna otevřenou. Chcete-li ho mít v e-mailu, v CRM nebo podle něj automaticky posílat upomínky, narazíte: XML rozhraní, přes které s Pohodou komunikují ostatní aplikace, příznak „neuhrazeno“ ani filtr na splatnost nemá. Neuhrazenou částku je potřeba dopočítat z celkové částky faktury a z toho, co už bylo zlikvidováno.

apios to dělá za vás. Podle toho, co s přehledem chcete dělat, máte tři možnosti.

1. Bez programování: report faktur

Pokud máte zapnuté Reporty, otevřete v administraci Reporty → Faktury. Sekce Po splatnosti ukazuje konkrétní doklady od nejstarších — číslo faktury, odběratele, počet dní po splatnosti a dlužnou částku. Vedle ní najdete rozdělení pohledávek podle stáří (1–30, 31–60, 61–90 a víc než 90 dní) a žebříček největších dlužníků.

Report stáhnete jako CSV pro Excel nebo jako PDF pro tisk. A pokud ho chcete mít každé pondělí ráno v e-mailu, nastavte si rozesílku podle návodu Jak si nastavit reporty.

2. Přes API, hotový seznam

Stejná data dostanete i přes API — hodí se to, když chcete seznam dlužníků zobrazit v CRM nebo z něj automaticky posílat upomínky. Sekce top-overdue reportu faktur vrací doklady po splatnosti seřazené od nejstarších:

curl "https://api.apios.cz/api/v1/report/invoice/top-overdue?top=100" \
  -H "X-AUTH-TOKEN: VAS_API_TOKEN"

{
  "report": "invoice.top_overdue",
  "data": [
    {
      "id": 812,
      "number": "250100184",
      "sym_var": "250100184",
      "label": "ABC s.r.o.",
      "ico": "12345678",
      "date_due": "2026-08-31",
      "days_overdue": 49,
      "total": 24200,
      "paid": 10000,
      "outstanding": 14200
    }
  ],
  "generated_at": "2026-10-19T07:12:44+00:00",
  "stale": false
}

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

Každý řádek obsahuje, kolik se fakturovalo (total), kolik už je uhrazeno (paid) a kolik zbývá (outstanding). Částečně zaplacené faktury jsou tedy v seznamu se správnou zbývající částkou. Stornované faktury a jejich storno doklady report vynechává.

Pár praktických poznámek:

• Období. Bez parametru from se report počítá z faktur vystavených od 1. ledna předchozího roku. Starší pohledávky zahrnete parametrem, např. from=2020-01-01.
• Rychlost. Report se počítá z dat v Pohodě a výsledek se ukládá do mezipaměti. Další dotazy jsou okamžité a čísla se samy obnovují na pozadí. Kdy byla čísla spočítána, vidíte v generated_at.
• Přijaté faktury. S parametrem type=received dostanete naopak seznam faktur po splatnosti, které máte zaplatit vy.
• Report API je součástí doplňku Reporty. Bez něj vrátí 403.

3. Přes API, vlastní výpočet

Pokud Reporty nemáte nebo potřebujete vlastní logiku, načtěte vydané faktury běžným exportem a neuhrazenou částku si dopočítejte. Export vrací u každé faktury datum splatnosti (date_due), souhrn částek (summary.home_currency) a uhrazenou částku (liquidation.amount_home):

curl "https://api.apios.cz/api/v1/invoice?from=2026-01-01&limit=1000" \
  -H "X-AUTH-TOKEN: VAS_API_TOKEN"

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

Výpočet v PHP může vypadat třeba takto:

$today = new DateTimeImmutable('today');
$overdue = [];

foreach ($response['data'] as $invoice) {
    // Stornovaná faktura a její storno doklad se navzájem ruší — nejsou to pohledávky.
    $isStorno = in_array($invoice['storno'], ['cancelDocument', 'cancelledDocument'], true);
    $sum = $invoice['summary']['home_currency'] ?? null;

    if ($isStorno || null === $sum || empty($invoice['date_due'])) {
        continue;
    }

    $total = $sum['price_none'] + $sum['price_low_sum'] + $sum['price_high_sum']
        + ($sum['price3_sum'] ?? 0) + ($sum['price_round'] ?? 0);
    $paid = $invoice['liquidation']['amount_home'] ?? 0;
    $dueDate = new DateTimeImmutable($invoice['date_due']);

    if ($total - $paid > 0.01 && $dueDate < $today) {
        $overdue[] = [
            'number' => $invoice['number']['number_requested'],
            'customer' => $invoice['partner_identity']['company'] ?? $invoice['partner_identity']['name'],
            'days' => $dueDate->diff($today)->days,
            'outstanding' => round($total - $paid, 2),
        ];
    }
}

Tip: filtr, který už v Pohodě máte

Máte-li v Pohodě v agendě Vydané faktury uložený vlastní filtr (třeba „Neuhrazené po splatnosti“), použijete ho i přes API parametrem user_filter s jeho názvem:

curl -G "https://api.apios.cz/api/v1/invoice" \
  --data-urlencode "user_filter=Neuhrazené po splatnosti" \
  -H "X-AUTH-TOKEN: VAS_API_TOKEN"

Podmínky filtru pak vyhodnotí přímo Pohoda.

Co dál

Když zákazník zaplatí, můžete fakturu označit jako uhrazenou přímo z vaší aplikace — třeba hned po platbě kartou.