# TopTrans integrácia s Chameleoon

Táto dokumentácia slúži ako podrobný sprievodca pre expedíciu zásielok u dopravcu TopTrans.
Dopravca TopTrans umožňuje doručenie zásielok **priamo na adresu**.
Jeho využitie umožňuje odosielať zásielky nielen v rámci Slovenskej republiky, ale aj Českej republiky, Maďarska, Slovinska, Rumunska, Chorvátska a do ďalších krajín v rámci Európy.

## Užitočné informácie

- [Ako nastaviť prepojenie s dopravcom TopTrans?](#zakladne-nastavenia)
- [Ako nastaviť automatické odosielanie notifikácie zákazníkom o doručovaní zásielky?](#notifikacie-o-doruceni-zasielky)

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

Všetky dôležité nastavenia pre expedíciu alebo tlač štítkov môžete nastaviť v sekcii **Konfigurácia pre kuriéra TopTrans.**

![Konfigurácia pre kuriéra TopTrans](/images/Toptrans-konfiguracia.png)

Chameleoon komunikuje s TopTrans prostredníctvom **API TopTrans.**

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

1. **Požiadať o povolenie na prístup k API TopTrans** - Tento prístup Vám zriadi Váš obchodný zástupca alebo podpora dopravcu TopTrans.
2. **Prihlasovacie meno a heslo** - Údaje Vám rovnako poskytne Váš obchodný zástupca alebo podpora dopravcu TopTrans.
3. **Vyplniť údaje o platcovi a nákladke** - Je potrebné vyplniť kedy sa platí preprava, IBAN a SWIFT kód na vyplácanie dobierok. Pri nákladke sa vyberá adresa, kde sa nákladka vykonáva.

Tieto informácie zadajte v našej aplikácii.

![TopTrans- základné nastavenia](/images/TopTrans--Z%C3%A1klad.png)

## Nastavenia expedície

Aplikácia Chameleoon Vám umožní prednastaviť si hodnoty potrebné pre expedíciu tak, aby ste nemuseli pri každej objednávke tieto údaje vypĺňať.

![Toptrans-nastavenie predvolených hodnôt](/images/Toptrans-predvolen%C3%A9-hodnoty.png)

*Môžete prednastaviť tieto hodnoty:*

**Váha**
- Váha sa uvádza v mernej jednotke kg. Tento údaj môžete vyplniť priemernou hodnotou vašich balíkov.
- Ak niektorá z expedovaných objednávok bude vo veľkej miere presahovať zadanú hodnotu, môžete váhu zmeniť pri konkrétnej objednávke.

**Počet balíkov**
- Tento údaj hovorí o tom, koľko balíkov má zásielka. Pokiaľ vo väčšine prípadov posielate zásielku, ktorá obsahuje jeden balík, odporúčame Vám nastaviť túto hodnotu na 1.
- Ak niektorá z objednávok bude obsahovať viacero balíkov, môžete tento údaj zmeniť pri konkrétnej objednávke.

**Termín**
- Dopravca TopTrans umožňuje vybrať optimálny termín doručenia zásielky.

![Toptrans-termíny doručenia zásielky](/images/Toptrans-termíny.png)

**Obal**

**Služba Comfort pri nákladke a výkladke**
- Nastavenie umožňuje zvoliť želaný spôsob - **bez služby Top Comfort, služba Top Comfort, služba Top Comfort plus.**

![Toptrans-služba comfort pri nákladke](/images/Toptrans-slu%C5%BEba-comfort.png)

**Dodací list**
- Umožňuje zvoliť želaný spôsob doručenia dodacieho listu.
- Na výber viacero možností: **nedodávať, elektronicky, fyzicky, elektronicky + fyzicky**

**Služby**

## Tlač štítkov

Môžete si vybrať z dvoch formátov - A4/A6.

![Toptrans-formát tlače štítkov](/images/Toptrans-tla%C4%8D-%C5%A1t%C3%ADtkov.png)

## Užitočné informácie

<h3 id="notifikacie-o-doruceni-zasielky">Notifikácie o doručení zásielky</h3>

Dopravca Toptrans umožňuje zasielanie notifikácií o doručení zásielky **telefonicky, e-mailom, SMS správou,** alebo ponúka možnosť **rozvozu po avizácii.**
Želaný spôsob avizácie môžete zvoliť **v sekcii služby.**

![Toptrans-notifikácia o doručení zásielky](/images/Toptrans-notifikácia.png)

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