> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/fakturoid.md).

# 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="/files/TnFXvAcmkDtAkwLLKaMk" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/vp6cINx8a9ubooOv1hD1" 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="/files/0A2k2exWVuJ9K5RROKqR" 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="/files/1p0SQoe8WB2PyKs5JErt" 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="/files/PbTCkBFQyN0N7wfmLZnf" 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="/files/fFU06RbTJgUhO8Dpgcmi" 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="/files/TonW9VJUbQKarueevb4S" 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.