# Authentica Fulfillment

{% hint style="warning" %}
Pouze pro klienty **Rocketoo MAX**.
{% endhint %}

Modul **Authentica Fulfillment** propojuje váš e‑shop se službou **Authentica Fulfillment** (externí sklad a logistika). Díky tomu můžete:

* Automaticky **přenášet produkty** z e‑shopu do systému Authentica
* **Aktualizovat skladové zásoby** z Authentica zpět do e‑shopu
* **Přenášet objednávky** z e‑shopu k expedici do Authentica (automaticky nebo ručně)

Cílem modulu je snížit ruční práci, minimalizovat chyby a zajistit, aby stav skladu v e‑shopu odpovídal reálnému stavu ve skladu Authentica.

### Kde najdu modul?

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

V administraci Rocketoo najdete Authentica na dvou místech:

* **Nastavení** → **Authentica Fulfillment** – zde modul nastavujete
* Menu **Authentica** (v levém menu) – zde najdete:
  * **Produkty**
  * **Log requestů**

## Co je Authentica Fulfillment

Authentica Fulfillment je služba, která za vás zajišťuje:

* skladování zboží,
* balení a expedici objednávek,
* příjem zboží a práci se skladem.

Modul v Rocketoo:

* propojuje váš e‑shop s účtem v Authentica Fulfillment,
* přenáší **produkty** a jejich parametry (rozměry, váha, čárové kódy),
* přenáší a aktualizuje **objednávky a jejich stavy**,
* pravidelně stahuje **skladové zásoby** z Authentica, aby odpovídaly realitě.

## Přístupové údaje

Než modul začnete používat, ujistěte se, že máte:

* Aktivní účet u **Authentica Fulfillment**
* Od Authentica přidělené údaje:
  * **Base URL** – adresa jejich API
  * **Client ID**
  * **Client Secret**
* Uživatelský účet v Rocketoo s oprávněním měnit nastavení (typicky vlastník / administrátor).

## Nastavení modulu v administraci

* V horním menu Rocketoo klikněte na **Nastavení**
* V seznamu rozšíření vyhledejte **Authentica Fulfillment**
* Klikněte na položku – otevře se formulář s více záložkami:
  * **Obecné**
  * **Dopravy**
  * **Stavy objednávky**
  * **Webhook / Synchronizace objednávek** (součást jedné ze záložek)

### Záložka Obecné – propojení s Authentica

Na této záložce zadáváte základní přístupové údaje:

* **Base URL** – adresa API Authentica (dodá Authentica)
* **Client ID** – identifikátor vašeho napojení
* **Client Secret** – tajný klíč vašeho napojení
* **E‑shop (Shop)** – výběr konkrétního e‑shopu / provozu v Authentica, pokud jich máte víc

#### Postup propojení

{% stepper %}
{% step %}
Vyplňte **Base URL, Client ID a Client Secret**.
{% endstep %}

{% step %}
Klikněte na **Uložit**.
{% endstep %}

{% step %}
Klikněte na tlačítko ***Propojit s Authentica Fulfillment***.
{% endstep %}

{% step %}
Dle pokynů dokončete autorizaci (případné přihlášení, potvrzení přístupu).
{% endstep %}

{% step %}
Po úspěšném propojení se zobrazí informace o platnosti přístupu, např. **Propojení je nastaveno. Přihlašovací token je platný do ... .**“
{% endstep %}
{% endstepper %}

Dokud není propojení dokončeno, modul nemůže synchronizovat produkty ani objednávky.

### Webhook – zpětná komunikace

V nastavení také najdete:

* **Webhook URL** – adresa, na kterou Authentica posílá informace zpět do e‑shopu
* **Webhook secret** – tajný klíč pro ověření, že zpráva pochází opravdu z Authentica

Tyto údaje se obvykle předají na stranu Authentica, která webhook nastaví.\
Pokud nevíte, co s nimi, kontaktujte technickou podporu.

### Synchronizace objednávek – kdy se objednávky přenáší

Na této záložce určujete, **ve kterém momentu se má objednávka odeslat do Authentica**.

Najdete zde:

* **Automaticky synchronizovat objednávky** – zapnutí / vypnutí automatického přenosu
* **Synchronizovat objednávky ve stavu** – obecný stav, kdy se má objednávka poslat (pokud níže nespecifikujete přesnější kombinace)
* **Výběr Typu platby a Stavu** – přesné kombinace „Typ platby + Stav objednávky“, kdy se má objednávka automaticky odeslat.

Příklad nastavení

* Zaškrtnete **Automaticky synchronizovat objednávky**
* Nastavíte stav **„Zaplaceno“** jako obecný stav pro odeslání
* Přidáte kombinace:
  * Platba kartou + stav „Zaplaceno“
  * Bankovní převod + stav „Platba přijata“

Tím určíte, že se objednávky odešlou do Authentica ve chvíli, kdy je z pohledu plateb a zpracování vše připraveno k expedici.

### Záložka Dopravy – propojení způsobů dopravy

V sekci ***Propojení možností dopravy*** nastavíte, jak se propojí e‑shopové dopravy s dopravami v Authentica:

* **Doprava v e‑shopu** – výběr z doprav, které máte nastavené v Rocketoo
* **Doprava v Authentica** – výběr doprav, které Authentica používá
* Tlačítko ***Přidat propojení*** – přidá nový řádek propojení

Doporučený postup

{% stepper %}
{% step %}
Nejprve si v Rocketoo nastavte všechny potřebné dopravy (např. DPD, Zásilkovna, PPL, osobní odběr).
{% endstep %}

{% step %}
V nastavení Authentica otevřete záložku **Dopravy** a postupně spárujte každou e‑shopovou dopravu s odpovídající dopravou v Authentica.
{% endstep %}

{% step %}
Uložte nastavení.
{% endstep %}
{% endstepper %}

Bez správně spárovaných doprav nemusí být objednávky v Authentica založeny správně.

### Záložka Stavy objednávky - propojení stavů objednávek

V sekci ***Propojení stavů objednávky*** nastavíte, jak se propojí e‑shopové stavy objednávek se stavy v Authentica:

* **Stav objednávky v e-shopu** – výběr ze stavů, které máte nastavené v Rocketoo
* **Stav objednávky v Authentica** – výběr stavů, které Authentica používá
* Tlačítko ***Přidat propojení*** – přidá nový řádek propojení

## Synchronizace produktů

V menu Authentica najdete sekci ***Produkty***.

V přehledu uvidíte:

* seznam produktových variant z vašeho e‑shopu,
* **Authentica ID** – pokud už je varianta propojená s produktem v Authentica,
* **Váhu \[kg]** a **Rozměry \[cm]**,
* **Poslední aktualizaci** – kdy byl produkt naposledy synchronizován.

### Hromadná synchronizace produktů

V seznamu je k dispozici tlačítko ***Synchronizovat produkty do Authentica***.

Co se stane po kliknutí

{% stepper %}
{% step %}
Systém projde všechny produkty v e‑shopu.
{% endstep %}

{% step %}
U každé varianty:

* pokud **už existuje** v Authentica (dle čárového kódu), jen ji **propojí**,
* pokud **neexistuje**, modul ji **založí** jako nový produkt v Authentica.
  {% endstep %}

{% step %}
Vytvoří se nebo aktualizuje propojení mezi Rocketoo a Authentica (interní / externí ID).
{% endstep %}
{% endstepper %}

Kdy synchronizaci spustit

* po prvním nasazení modulu,
* po větších změnách v katalogu produktů,
* kdykoli si nejste jistí, zda jsou všechny produkty v Authentica založené.

***

## Aktualizace skladových zásob

Skladové zásoby se z Authentica do Rocketoo **aktualizují automaticky** pomocí pravidelné úlohy.

Jak to funguje

{% stepper %}
{% step %}
V pravidelných intervalech modul stáhne **stav skladů** z Authentica.
{% endstep %}

{% step %}
Podle dříve vytvořeného propojení produktů:

* najde odpovídající varianty v e‑shopu,
* aktualizuje jim **množství na skladě** (quantity).
  {% endstep %}

{% step %}
Po uložení množství se automaticky aktualizuje:

* **dostupnost produktů** na e‑shopu,
* případné štítky typu „skladem / vyprodáno“.
  {% endstep %}
  {% endstepper %}

Co z toho plyne pro vás

* zákazníci vidí **reálný stav skladu**
* omezíte situace, kdy se prodá zboží, které už fyzicky není k dispozici
* nemusíte ručně přepisovat zásoby podle reportů z logistiky.

***

## Přenos objednávek do Authentica

Objednávky můžete do Authentica posílat:

* **automaticky** – dle nastavení stavů a typů plateb,
* **ručně** – z detailu objednávky pomocí tlačítka v horní liště.

### Automatický přenos objednávek

Pokud je v nastavení zaškrtnuto ***Automaticky synchronizovat objednávky***:

{% stepper %}
{% step %}
Při změně stavu objednávky (a splnění definovaných podmínek) modul objednávku odešle do Authentica.
{% endstep %}

{% step %}
Pokud je přenos úspěšný:

* do historie objednávky se zapíše záznam: „Authentica – objednávka byla založena s ID: …“
  {% endstep %}

{% step %}
Pokud nastane chyba:

* v historii objednávky uvidíte informaci o chybě,
* zároveň se zobrazí chybová hláška v administraci.
  {% endstep %}
  {% endstepper %}

### Ruční přenos z detailu objednávky

{% stepper %}
{% step %}
Otevřete v administraci konkrétní **objednávku**.
{% endstep %}

{% step %}
V horní liště (toolbar) najdete tlačítko ***Authentica***.
{% endstep %}

{% step %}
V rozbalovacím menu klikněte na ***Přenést objednávku do Authentica***.
{% endstep %}

{% step %}
Systém objednávku odešle do Authentica a do historie objednávky zapíše záznam o úspěchu / chybě.
{% endstep %}

{% step %}
V horní části se zobrazí informační hláška s výsledkem operace.
{% endstep %}
{% endstepper %}

Ruční přenos se hodí např. při:

* jednorázovém odeslání konkrétní objednávky,
* testování propojení,
* opakovaném odeslání po úpravě nastavení.

## Log komunikace

V menu Authentica najdete sekci ***Log requestů***. Log slouží jako **historie komunikace** mezi Rocketoo a Authentica.

Uvidíte zde:

* datum a čas požadavku,
* typ operace (např. vytvoření objednávky, synchronizace produktu, stažení skladu),
* **URL** a **metodu** požadavku,
* **odpověď serveru** a návratový kód,
* případné chyby.

### K čemu log využijete

* při řešení problémů s přenosem objednávek,
* při konzultaci s podporou Rocketoo nebo Authentica,
* pro kontrolu, co a kdy se do Authentica odesílalo nebo stahovalo.

Log je primárně nástroj pro administrátory a technickou podporu, běžný uživatel ho využije hlavně v případě problémů.

***

## Často kladené otázky

<details>

<summary>Musím používat všechny funkce modulu (produkty, zásoby, objednávky)?</summary>

Nemusíte. Modul můžete používat jen částečně – např. pouze pro přenos objednávek. Největší přínos má ale při využití kompletního propojení (produkty + zásoby + objednávky).

</details>

<details>

<summary>Co se stane, když Authentica dočasně neodpovídá?</summary>

Objednávka nebo produkt se okamžitě nepřenese. V logu uvidíte chybu a můžete akci později zopakovat (např. ručně přenést objednávku).

</details>

<details>

<summary>Musí mít produkty čárový kód?</summary>

Doporučeno ano. Modul podle čárového kódu pozná, zda produkt v Authentica už existuje, nebo se má založit nový.

</details>

<details>

<summary>Co když změníme parametry produktu (rozměry, váha)?</summary>

Při další synchronizaci se tyto údaje do Authentica přenesou a aktualizují.

</details>

<details>

<summary>Kdy je vhodné použít ruční přenos objednávky?</summary>

Například při testování propojení, při výjimečných objednávkách nebo pokud jste měli dočasný výpadek spojení.

</details>

<details>

<summary>Co když se objednávka nepřenese kvůli chybě v dopravě nebo stavu?</summary>

Zkontrolujte v nastavení, zda jsou správně namapované **dopravy** a **stavy objednávek**. Po úpravě nastavení můžete objednávku ručně přenést z detailu.

</details>

<details>

<summary>Jak často se zásoby aktualizují?</summary>

Aktualizace probíhá automaticky v pravidelných intervalech (dle nastavení systému). Pro zákazníka to znamená, že dostupnost produktů je vždy co nejblíže reálnému stavu ve skladu Authentica.

</details>

<details>

<summary>Můžeme i nadále ručně měnit zásoby v e‑shopu?</summary>

Nedoporučuje se. Zásoby by měly být řízené především Authentica Fulfillment, aby nedošlo k nesouladu mezi systémy.

</details>

***

## Praktické příklady

### Spuštění nového napojení na Authentica

{% stepper %}
{% step %}
Získání přístupových údajů od Authentica: Base URL, Client ID a Client Secret.
{% endstep %}

{% step %}
Nastavení propojení v Rocketoo: v **Nastavení → Authentica Fulfillment** vyplňte údaje, uložte a klikněte na **„Propojit s Authentica Fulfillment“**.
{% endstep %}

{% step %}
Spárování doprav: v záložce **Dopravy** namapujte dopravy v e‑shopu na dopravy v Authentica.
{% endstep %}

{% step %}
Základní nastavení objednávek: v **Stavy objednávky** zapněte automatickou synchronizaci a vyberte vhodný stav (např. „Zaplaceno“).
{% endstep %}

{% step %}
První synchronizace produktů: v sekci **Authentica Fulfillment – Produkty** spusťte **„Synchronizovat produkty do Authentica“**.
{% endstep %}
{% endstepper %}

### Objednávky odesíláme až po zaplacení

{% stepper %}
{% step %}
V nastavení Authentica přejděte na **Stavy objednávky**.
{% endstep %}

{% step %}
Zaškrtněte **Automaticky synchronizovat objednávky**.
{% endstep %}

{% step %}
Do pole **Synchronizovat objednávky ve stavu** vyberte stav **„Zaplaceno“**.
{% endstep %}

{% step %}
Přidejte kombinace Typ platby + Stav (např. kartou online + Zaplaceno).
{% endstep %}

{% step %}
Uložte nastavení.
{% endstep %}
{% endstepper %}

Od této chvíle se všechny objednávky, které splní podmínku, automaticky odešlou do Authentica.

### Ruční přenos jedné problémové objednávky

{% stepper %}
{% step %}
V objednávkách najděte konkrétní objednávku.
{% endstep %}

{% step %}
Otevřete její detail.
{% endstep %}

{% step %}
V horním toolbaru klikněte na **„Authentica“**.
{% endstep %}

{% step %}
Zvolte **„Přenést objednávku do Authentica“**.
{% endstep %}

{% step %}
Zkontrolujte historii objednávky – měl by se objevit záznam o úspěšném přenosu nebo chybě.
{% endstep %}
{% endstepper %}


---

# 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/authentica-fulfillment.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.