# Externý systém – integrácia

Aplikácia Chameleoon umožňuje napojiť vlastný systém pomocou API.

**Je potrebné aby API na Vašej strane spĺňalo očakávané požiadavky, ktoré máme definované [v tomto návode](/api-v3).**

## Užitočné informácie

- [Ako nastaviť prepojenie s vašim systémom?](#nastavenia-prepojenia)
- [Ako nastaviť označenie spôsobu úhrady objednávky?](#oznacenie-sposobu-uhrady-objednavky)
- [Ako nastaviť ignorovanie váhy z e-shopu?](#nastavenie-ignorovania-vahy-z-e-shopu)
- [Ako nastaviť automatické doplnenie čísla objednávky k objednávke v e-shope?](#automaticke-doplnenie-cisla-prepravy-k-objednavke-v-e-shope)
- [Ako nastaviť zmenu stavu objednávky?](#nastavenie-zmeny-stavu-objednavky)
- [Ako nastaviť automatické priradenie objednávok k jednotlivým dopravcom?](#oznacenie-kuriera-vo-vasom-systeme)

<h2 id="nastavenia-prepojenia">Nastavenia prepojenia</h2>

Všetky dôležité nastavenia pre Váš e-shop môžete nastaviť v sekcii **Nastavenia externého systému.**

![Pridanie externého systému](/images/EXT-základ.png)

Pre správnu komunikáciu s API je potrebné:

- **Vyplniť URL adresu pre API a prihlasovacie údaje** - Podporované spôsoby sú: **API kľúč, bearer token alebo basic authentication.**
- **Definovať štandardné API endpointy** - Nie je potrebné vypĺňať všetky, stačia tie, ktoré si vyberiete. Tieto endpointy budú volať API Chameleoon počas procesu expedície.

### API endpointy

**Adresa pre vrátanie objednávok podľa dátumu**
- *Táto adresa sa využíva pri hromadnej expedícii na načitanie objednávok podľa zvoleného dátumu.*

**Adresa pre vrátanie objednávky podľa ID**
- *Táto adresa sa využíva pri hromadnej expedícii a kontrole výdaja na načitanie objednávky podľa ID (referencie dokladu).*

**Adresa pre zmenu stavu objednávky**
- *Táto adresa sa využíva pri spätnom zápise čísla zásielky do Vášho systému a pri zmene stavu objednávky.*

**Adresa pre získanie objednávok podľa stavu**
- *Táto adresa sa využíva pri hromadnej expedícii na načitanie objednávok podľa zvoleného stavu.*

**Adresa pre získanie stavov**
- *Táto adresa sa využíva pre získanie stavov zo systému, aby bolo možné načítať objednávky podľa stavu.*

![EXT-endpointy](/images/EXT-zakladne-nastavenia.png)

<h2 id="oznacenie-sposobu-uhrady-objednavky">Označenie spôsobu úhrady objednávky</h2>

Označenie spôsobu úhrady objednávky vo Vašom systéme je dôležité nastavenie, podľa ktorého aplikácia Chameleoon určuje **či sa zásielka posiela na dobierku alebo nie.** Aplikácia neumožní používateľovi expedovať zásielku, ak nie je známy spôsob úhrady objednávky z prepojenia.

Ak aplikácia zistí, že sa jedná o nový spôsob platby, ktorý nepozná, je potrebné rozhodnúť, či je daný spôsob platby považovaný za dobierku alebo nie.

**Príklad:**

Ak využívate ako spôsob úhrady **dobierku, platbu v hotovosti, platbu v hotovosti na pokladni a ďalšie spôsoby,** označte možnosť **Áno.**

Ak využívate ako spôsob úhrady **platbu kartou, GooglePay, platbu prevodom a ďalšie spôsoby,** označte možnosť **Nie.**

Po potvrdení si aplikácia tento výber zapamätá.

![EXT-dobierka](/images/EXT---dobierka.png)

<h2 id="nastavenie-ignorovania-vahy-z-e-shopu">Nastavenie ignorovania váhy z e-shopu</h2>

V prípade, že si neželáte zadávať váhu z e-shopu, alebo váhu nemáte uvedenú, zvoľte možnosť **Ignorovať váhu.**

V tomto prípade sa nastaví váha, ktorú máte uvedenú pri cieľovom dopravcovi.

![EXT-ignorovanie váhy](/images/EXT-váha.png)

<h2 id="automaticke-doplnenie-cisla-prepravy-k-objednavke-v-e-shope">Automatické doplnenie čísla prepravy k objednávke v e-shope</h2>

Toto nastavenie umožňuje pridať číslo prepravy k objednávke vo Vašom e-shope hneď po odoslaní zásielky. Toto číslo následne môžete zaslať Vašim zákazníkom v e-maili.

![EXT- Automatické dopôlnenie čísla obj.](/images/EXT-%C4%8D%C3%ADslo-objedn%C3%A1vky.png)

<h2 id="nastavenie-zmeny-stavu-objednavky">Nastavenie zmeny stavu objednávky</h2>

Toto nastavenie umožňuje automatickú zmenu stavu pri niekoľkých údalostiach. Môžete si nastaviť pravidlo, pri akej údalosti sa má zmeniť stav objednávky vo Vašom e-shope.

**Vytvorenie pravidla pre zmenu stavu**

V konfigurácii pravidla je potrebné zadať **názov pravidla, vybrať stav zásielky a vybrať stav, na ktorý sa zmení vo Vašom e-shope.**

Ďalšie údaje nie sú povinné, avšak pre bližšiu špecifikáciu ich môžete vyplniť.

*Nastavenie pravidla môže vyzerať takto:*

*Zmena stavu hneď po vytvorení objednávky na stav odoslaná:*

![EXT-zmena stavu objednávky](/images/EXT-zmena-stavu.png)

<h2 id="oznacenie-kuriera-vo-vasom-systeme">Označenie kuriéra vo Vašom systéme</h2>

Aby ste predišli manuálnemu výberu kuriérov pri expedícií, aplikácia Chameleoon dokáže podľa tohto nastavenia automaticky zaradiť objednávky pre vybraného kuriéra.

Pre každého kuriéra, ktorým budete expedovať cez aplikáciu Chameleoon, **skopírujte názov kuriéra z Vášho systému a priraďte konfigurácií kuriéra v aplikácií Chameleoon**.

![EXT- kuriéri](/images/EXT-nastavenie-kuri%C3%A9rov.png)