Práce s klienty

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

API dokumentace enpointu clients.

Vytvoření klienta

Vytvoříme se klienta například Josefa Nováka.

$client = $fapiClient->getClients()->create([
	'first_name' => 'Josef',
	'last_name' => 'Novák',
	'email' => '[email protected]',
	'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
	],
]);

Úprava klienta

Josef se nám ale přestěhoval a my mu cheme upravit jak fakturační adresu tak i jeho navou emailovou adresu.

$client = $fapiClient->getClients()->update($clientId, [
	'email' => '[email protected]',
	'address' => [
		'street' => 'Ulice a č.p.',
		'city' => 'Nové město',
		'zip' => '54321',
		'country' => 'SK', // kód státu dle normy ISO 3166-1
	],
]);

Zobrazení klienta

Pokud známe ID našeho klienta můžeme si jeho data nechat zobrazit.

$client = $fapiClient->getClients()->find($clientId);

//další práce s daty klienta

Vyhledávání

Pokud přesně nevíme s kterým klientem budeme chtít pracovat a hledáme klienta například podle jména.

$clients = $fapiClient->getClients()->findAll([
	'order' => 'first_name DESC', // řazení podle křesního jméne sestupně
	'search' => 'novak', // fulltextové vyhledávání
	'limit' => 10, // mašímální počet vrácených záznamů
]);

foreach ($clients as $client) {
	echo $client['email'] . PHP_EOL;
	//... vlastní operace
}

Smazání klienta

Klienta lze smazat pouze v případě, že k němu nejsou přiřazené žádné faktury.

$fapiClient->getClients()->delete($clientId);