Práce s fakturami

Předpokladem je správně vytvořený a připojený FAPI klient. Návod na nastavení a vytvoření FAPI klienta.

API dokumentace enpointu invoices.

Vytvoření faktury

$invoice = $fapiClient->getInvoices()->create([
	'client' => $clientId,         		// ID klienta
//	'form' => 123,                    	// ID prodejního formuláře
	'vat_date' => date('Y-m-d'),      	// datum uskutečnění zdanitelného plnění (pouze pro plátce DPH)
	'proforma' => true,               	// jedná se o zálohovou fakturu?
	'reverse_charge' => false,         	// jedná se o fakturu v režimu přenesené daňové povinnosti?
	'notes' => 'Poznámka',            	// interní poznámka k faktuře (nepovinné pole)
	'currency' => 'CZK',              	// kód měny dle normy ISO 4217
	'items' => [
		[
			'name' => 'Položka',      	// název
			'description' => 'Popis', 	// popis (nepovinné pole)
			'price' => 123.45,        	// cena
			'vat' => 21,              	// sazba DPH (pouze pro plátce DPH)
			'count' => 1,             	// počet
			'including_vat' => false, 	// je uvedená částka včetně DPH? (výchozí hodnota = false)
		],
	],
]);

Parametr proforma určuje, zda se má vytvářet zálohová faktura nebo daňový doklad. Pokud není uvedený, použije se automaticky to nastavení, které je nastaveno v nastavení fakturace.

Parametr reverse_charge určuje, zda je faktura v režimu přenesené daňové povinnosti. V takovém případě se na faktuře v patičce zobrazí věta "Daň odvede zákazník." a odečte se DPH od všech položek. Pokud není tento parametr uvedený, použije se autodetekce (pokud je zákazník z jiného státu a má platné DIČ, přepne se faktura automaticky do režimu přenesené daňové povinnosti).

Parametr vat_date určuje datum uskutečnění zdanitelného plnění. Pokud není uveden, považuje se faktura za fakturu neplátce DPH.

Parametr form specifikuje ID prodejního formuláře ve FAPI, pod kterým se má faktura vystavit. Prodejní formulář ovlivňuje nastavení e-mailových šablon, číselných řad, upomínek a URL notifikací. Chcete-li tedy upravit tato nastavení (např. po zaplacení objednávky vykonat nějakou URL notifikaci), vytvořte si ve FAPI prodejní formulář a proveďte v něm příslušná nastavení. Z URL adresy stránky, na které se upravuje prodejní formulář, si pak zkopírujte ID prodejního formuláře (např. pokud je stránka pro úpravu prodejního formuláře https://web.fapi.cz/user-form/edit/123?projectId=456, pak je ID prodejního formuláře 123).

Označení faktury jako zaplacené

$fapiClient->getInvoices()->update($invoice['id'], [
	'paid' => true,
]);