Vytváření faktur přes API
Programové vytváření přijatých i vydaných faktur pomocí REST API. Umožňuje externím systémům (e-shopy, CRM, ERP) automaticky vytvářet faktury v aplikaci FaktApp bez nutnosti ručního zadávání.
Brzy doplníme screenshoty a podrobnější návod.
Autentizace API klíčem
Všechny API volání vyžadují autentizaci pomocí API klíče. Klíč se posílá v HTTP hlavičce 'jv-api-key'. API klíč získáte v administraci aplikace. Všechny endpointy používají metodu POST a přijímají i vracejí data ve formátu JSON.
Vytvoření přijaté faktury
Endpoint POST /api/create-incoming-invoice přijímá JSON s polem 'InvoiceData' obsahujícím serializovaná data faktury (číslo faktury, dodavatel, odběratel, částky, data, bankovní spojení). Po odeslání systém vytvoří nebo aktualizuje fakturu v databázi. Odpověď obsahuje pole 'success' (úspěch) a 'message' (zpráva). Po vytvoření se automaticky spustí AI vytěžení z přiloženého dokumentu.
Vytvoření vydané faktury
Endpoint POST /api/create-outgoing-invoice přijímá JSON s poli 'Document' (binární PDF dokument) a 'InvoiceData' (serializovaná data faktury). Systém vytvoří vydanou fakturu, automaticky vygeneruje ISDOC nebo ZUGFeRD PDF podle země odběratele a spustí událost OnInvoiceDocumentGenerated pro případné automatické odeslání do externích systémů.
Nahrání dokumentu faktury
Endpoint POST /api/load-invoices přijímá binární obsah souboru (pole 'Content') a název souboru (pole 'FileName'). Systém vytvoří novou fakturu s nahraným dokumentem. Tento endpoint je vhodný pro hromadné nahrávání PDF dokumentů, například z účetního softwaru nebo z e-mailových příloh.
Generování faktury z externího systému (Makej)
Endpoint POST /api/generate-employee-invoice-makej přijímá data faktury ze systému Makej. Systém automaticky: vygeneruje číslo faktury (formát RR-MM-DD-NNN), vytvoří variabilní symbol, nastaví stav na 'Čeká na schválení', přiřadí dodavatele z profilu firmy, najde odpovídající bankovní účet podle měny, vygeneruje ISDOC PDF a odešle e-mailovou notifikaci o nové faktuře.