# Upgates integrácia s Chameleoon

Táto dokumentácia slúži ako podrobný sprievodca pre prepojenie e-shopového systému Upgates.

Systém Upgates je jeden z najznámejších systémov. Je skvelým riešením ako pre drobných podnikateľov, tak aj pre väčšie firmy. Poskytuje svoje služby pre viac ako 3000 e-shopov.

## Užitočné informácie

- [Ako nastaviť prepojenie so systémom Upgates?](#zakladne-nastavenia)
- [Ako nastaviť označenie spôsobu úhrady objednávky?](#oznacenie-sposobu-uhrady-objednavky)
- [Ako nastaviť variabilný symbol pre platby na dobierku?](#nastavenie-variabilneho-symbolu)
- [Ako nastaviť aby sa poznámka od zákazníka neprenášala ku dopravcovi?](#nastavenie-neprenasania-poznamky-od-zakaznika-ku-dopravcovi)
- [Ako nastaviť automatické pridanie čísla prepravy k objednávke v e-shope?](#automaticke-doplnenie-cisla-prepravy-k-objednavke-v-e-shope)
- [Ako nastaviť váhu, alebo ignorovanie váhy z e-shopu?](#nastavenie-vahy-alebo-ignorovania-vahy-z-e-shopu)
- [Ako nastaviť zmenu stavu objednávok v e-shope?](#nastavenie-zmeny-stavu-objednavky)
- [Ako nastaviť automatické priradenie objednávok k jednotlivým prepravcom?](#oznacenie-dopravcu-vo-vasom-systeme)

<h2 id="zakladne-nastavenia">Základné nastavenia</h2>

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

![Nastavenia Upgates](/images/Upgates-konfigurácia.png)

Chameleoon komunikuje s e-shopom Upgates prostredníctvom **API rozhrania.** Prepojenie je možné prostredníctvom **Doplnku Chameleoon pre Upgates.**

Prepojenie vášho e-shopu s aplikáciou Chameleoon je prostredníctvom doplnku oveľa jednoduchšie, bez potreby manuálneho nastavenia základných údajov.

### Pre prístup k API je potrebné:

**Aktivovať doplnok Chameleoon pre Upgates**

Doplnok nájdete:

1. V rozhraní vášho e-shopu v časti **Doplnky.**
2. Na stránke Upgates: [Doplnok Chameleoon pre Upgates](https://www.upgates.sk/p/chameleoon)

![Doplnok pre Upgates - aktivácia](/images/Upgates---doplnok.png)

## Užitočné informácie

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

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

![Spôsob úhrady - Upgates](/images/Upgates-sp%C3%B4sob-%C3%BAhrady.png)

<h3 id="nastavenie-variabilneho-symbolu">Nastavenie variabilného symbolu</h3>

Aplikácia Chameleoon umožňuje zvoliť želaný variabilný symbol pre objednávky uhradené na dobierku.
Ako variabilný symbol môžete zvoliť **variabilný symbol objednávky, číslo objednávky, alebo číslo faktúry.**

**Tento údaj nie je povinný.** Ak nič nevyberiete, automaticky sa ako hodnota nastaví číslo objednávky.

![Variabilný symbol - Upgates](/images/Upgates---VS.png)

<h3 id="nastavenie-neprenasania-poznamky-od-zakaznika-ku-dopravcovi">Nastavenie neprenášania poznámky od zákazníka ku dopravcovi</h3>

Toto nastavenie zapnite v prípade, ak si želáte, aby sa poznámka, ktorú Vám zákazník pridal k objednávke nepreniesla k dopravcovi do systému, alebo sa nezobrazovala na štítku.

![Upgates - neprenášanie poznámky](/images/Upgates---pozn%C3%A1mka-od-z%C3%A1kazn%C3%ADka.png)

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

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.

![Automatické doplnenie čísla prepravy k objednávke v e-shope](/images/Upgates---doplnenie-%C4%8D%C3%ADsla.png)

> Rýchle a prehľadné sledovanie zásielok môžete poskytnúť Vašim zákazníkom na stránke [Balík Chameleoon](https://balik.chameleoon.sk/1750263396).

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

Ako mernú jednotku pre váhu môžete zvoliť **kilogram, alebo gram.**

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.

![Ignorovanie váhy v Upgates](/images/Upgates---ignorovanie-v%C3%A1hy.png)

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

Toto nastavenie umožňuje automatickú zmenu stavu pri niekoľkých udalostiach. Môžete si nastaviť pravidlo, pri akej udalosti 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á:*

![Pravidlo pre zmenu stavu objednávky v Upgates](/images/Upgates---zmena-stavu.png)

<h3 id="oznacenie-dopravcu-vo-vasom-systeme">Označenie dopravcu vo Vašom systéme</h3>

Toto nastavenie slúži na automatické zaradenie zásielok pre jednotlivých dopravcov. Umožňuje predísť manuálnemu výberu dopravcov pre jednotlivé zásielky.

Pre toto nastavenie je potrebné skopírovať názov dopravcu v Upgates a priradiť ho v konfigurácii dopravcu v našej aplikácii.

![Označenie dopravcu - Upgates](/images/Upgates---ozna%C4%8Denie-kuri%C3%A9ra.png)

Nenašli ste potrebné informácie? Radi Vám pomôžeme, kontaktujte nás na e-mail: **podpora@chameleoon.sk**