Fakturace (doporučený způsob)

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

API dokumentace enpointu orders.

$order = $fapiClient->getOrders()->create([
	// ID prodejního formuláře
	'form' => 86,

	// Údaje zákazníka
	'first_name' => 'Josef',
	'last_name' => 'Novák',
	'email' => 'josef.novak@example.com',
	'phone' => '+420 123 456 789',
	'company' => 'Firma s.r.o.',
	'ic' => '12345678',
	'dic' => 'CZ12345678',
	'address' => [
		'street' => 'Ulice a č.p.',
		'city' => 'Město',
		'zip' => '123 45',
		'country' => 'CZ', // kód státu dle normy ISO 3166-1
	],
	'shipping_address' => [
		'name' => 'Karel',
		'surname' => 'Novák',
		'street' => 'Ulice a č.p.',
		'city' => 'Město',
		'zip' => '123 45',
		'country' => 'CZ', // kód státu dle normy ISO 3166-1
	],

	// Položky
	'items' => [
		[
			'item_template' => 105,   // ID šablony položky, ze které se mají údaje předvyplnit (nepovinné pole)
			'name' => 'Položka',      // název
			'description' => 'Popis', // popis (nepovinné pole)
			'code' => '777',          // kód položky
			'price_czk' => 2700.00,   // cena v CZK
			'price_eur' => 100.00,    // cena v EUR
			'vat' => 21,              // sazba DPH (pouze pro plátce DPH)
			'count' => 1,             // počet kusů
			'including_vat' => false, // je uvedená částka včetně DPH? (výchozí hodnota = false)
		],
	],

	// Způsob platby
	'payment_type' => 'wire', // cash | collect on delivery | credit card | wire | sms
	'bank' => 'wire',         // Pokud je payment_type = 'wire', pak je možné specifikovat banku:
	// cz_fio | cz_kb | cz_mbank | cz_rb | sk_slsp | sk_unicredit |
	// sk_tatrabanka | sk_sberbank | sk_pabanksk | sk_vub | wire
	// Parametr bank = 'wire' znamená ruční platbu bankovním převodem. Ostatní
	// možnosti přesměrují zákazníka na platební bránu GoPay. U nové platební
	// brány GoPay je možné uvést parametr bank = null. Když je nastaven tento
	// parametr, tak se zákazníkovi zobrazí nabídka dostupných bank v platební
	// bráně GoPay.
]);

$nextUrl = $order['next_url'];

Při vystavení objednávky tímto způsobem je klient automaticky spárován a ve vráceném poli najdete pod indexem next_url adresu, kam máte zákazníka přesměrovat. Jedná se buď o adresu GoPay platební brány, nebo děkovací stránku, pokud zákazník vybral třeba platbu na dobírku nebo bankovním převodem ručně.

Je tedy potřeba nastavit u daného prodejního formuláře údaje ke GoPay a adresu děkovací a chybové stránky.

Pokud mají být vystavovány zálohové faktury, je potřeba zaškrtnout v nastavení prodejního formuláře pole Vystavovat zálohové faktury.

Dále je potřeba nastavit správně pole DPH pro zahraniční klienty, které určuje, v jakých případech se má faktura vystavit v režimu přenesené daňové povinnosti.