# Fakturoid

**Modul Fakturoid** je rozšířením, které umožňuje napojení na online fakturační systém [**Fakturoid.cz**](https://www.fakturoid.cz). Umožňuje automatické vytváření faktur, správu subjektů, sledování plateb i odesílání notifikací o zaplacení.

## Propojení Fakturoidu s Rocketoo

Pro to, abyste mohli rozšíření používat, je potřeba mít u služby Fakturoid účet. Pokud tedy ještě účet nemáte, tak si jej můžete snadno vytvořit na stránkách [**Fakturoid.cz**](https://www.fakturoid.cz/). Můžete si vybrat z několika tarifů, které se kromě jiných parametrů liší i maximální povolenou intenzitou komunikace s jinými službami, tedy i s Rocketoo. U nejlevnějšího placeného tarifu to je 3000 volání služby za měsíc.

Přihlaste se do služby Fakturoid a v pravém horním rohu klikněte na vaše jméno a v rozbalovacím menu zvolte možnost **Nastavení**.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FBokoCbPi750PQBytIdso%2Ffakturoid-nastaveni.png?alt=media&#x26;token=acbf249e-6ad3-4fae-ab1a-150297140481" alt=""><figcaption></figcaption></figure>

Ve stránce Nastavení pak zvolte možnost **Napojení na jiné aplikace**.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FGROAILJWGRHiW25QOR4x%2Ffakturoid-nastaveni-2.png?alt=media&#x26;token=6f3cbf15-0663-4f26-b57a-4a47a825e201" alt=""><figcaption></figcaption></figure>

Na další stránce máte možnost prokliknout se na nastavení API a vytvoření webhooku. Nejdříve nastavíme propojení s API. Klikněte proto na odkaz na **Uživatelský účet**.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FgpalD4L3uGW5mP8mH8qW%2Ffakturoid-nastaveni-3.png?alt=media&#x26;token=e6d26594-100b-4d2e-b823-e4776832b504" alt=""><figcaption></figcaption></figure>

Pro nastavení propojení s Rocketoo vás zajímají tři údaje: váš nastavený **e-mail**, který používáte pro přihlášení, váš **název** **účtu** a **API klíč**. Tyto údaje překopírujte do nastaveni Fakturoidu ve vašem e-shopu Rocketoo (**Nastavení** / **Rozšíření** / **Fakturoid**).

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FflDOSXcP831bQRJLedbC%2Ffakturoid-nastaveni-api.png?alt=media&#x26;token=800a00c3-0a59-4f60-9ea3-153c143eb544" alt=""><figcaption></figcaption></figure>

Pokud je vše správně nastaveno a dáte **Uložit**, tak se vám zobrazí hláška o úspěšném propojení se službou Fakturoid. Od této chvíle se vám v detailu objednávky začne zobrazovat tlačítko pro vytvoření faktury ve Fakturoidu, ale o tom až za chvíli. Nyní si ještě nastavíme webhook, pomocí kterého vám bude Fakturoid dávat informace o zaplacených fakturách.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2F2cxJFrWZLfJ9n53qmZVs%2Ffakturoid01.png?alt=media&#x26;token=62b1ddff-ee54-4e22-a3d7-560d59577f02" alt=""><figcaption></figcaption></figure>

### Nastavení webhooku

Vraťte se na stánku **Napojení na jiné aplikace** a zvolte odkaz **Webhooky**. Zde do políčka **Adresa webhooku** zadejte URL adresu webhooku, kterou si zkopírujete z vašeho nastavení v Rocketoo.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FoMqcdRD77v2nCWbY4exc%2Ffakturoid-nastaveni-webhook.png?alt=media&#x26;token=c8a66255-ad70-4e98-9713-52c7ce549e6a" alt=""><figcaption></figcaption></figure>

Poté se vraťte do vašeho nastavení v Rocketoo a zaškrtněte volbu **Nastavovat zaplaceno** a v rozbalovacím menu vyberte *stav objednávky*, který se má po zaplacení nastavit. Celé nastavení uložte.

<figure><img src="https://2581951975-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8g4-si8hFmKl7wXNja%2Fuploads%2FSuHs50Hvb0eCfXiG4t5M%2Ffakturoid02.png?alt=media&#x26;token=711987ff-5d23-4f92-b4f4-2d96d3e98f74" alt=""><figcaption></figcaption></figure>

Nyní máte propojení se službou Fakturoid úspěšně nastaveno.

### Další nastavení

V nastavení můžete ještě definovat, aby se variabilní symbol na faktuře automaticky nastavoval podle čísla objednávky a nastavovat prefix pro interní číslo faktury.

### Automatické vytváření faktur

Faktury můžete vytvářet buď automaticky nebo ručně.

**Ručně** vytvoříte fakturu v detailu objednávky kliknutím na tlačítko **Fakturoid** v horní tlačítkové liště. Zde můžete vybrat volbu **Vytvořit fakturu** nebo **Vytvořit zálohovou fakturu** a položky z objednávky se automaticky přenesou do Fakturoidu a vytvoří se příslušná faktura.

Další volbou, kterou zde máte dostupnou je **Aktualizovat z Fakturoidu**. Kliknutím na tuto možnost zaktualizujete dostupné faktury k dané objednávce.  Pokud tedy například stornujete nějakou fakturu, tak ji takto odpárujete od dané objednávky.

**Automatické vytváření** faktur je potřeba navázat na nějaký **Stav objednávky**. Pokud pak objednávka získá předvolený stav, tak se doklad automaticky vytvoří. V nastavení si pak můžete nastavit **Typ vytvářeného faktury**, zda se bude vytvářet *daňový doklad* nebo *zálohová faktura*. Vytváření faktury pak můžete omezit pouze pro některé typy plateb.

### Odeslání faktury zákazníkovi

Fakturu můžete zákazníkovi odeslat buď přímo ze služby Fakturoid nebo z vašeho e-shopu. Pro odesílání faktury z e-shopu stačí do jakékoliv šablony, kterou máte navázánu na nějaký stav objednávky, přidat proměnou **{{ external\_invoice\_url }}** nebo **{{ external\_proforma\_url }}**, která obsahuje URL link na stránku *Webfaktura pro klienta* ve Fakturoidu.