# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/fakturoid.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.