# SPS integrácia s Chameleoon

Táto dokumentácia slúži ako podrobný sprievodca pre expedíciu zásielok u dopravcu SPS.
Dopravca SPS umožňuje doručenie zásielok **priamo na adresu**, alebo na **výdajné miesto**.
Jeho využitie umožňuje odosielať zásielky nielen v rámci Slovenskej republiky, ale aj Českej republiky, Maďarska, Poľska, Rakúska a ďalších 15 krajín.

## Užitočné informácie

- [Ako nastaviť prepojenie s dopravcom SPS?](#zakladne-nastavenia)
- [Ako nastaviť rozdelenie na balíky?](#rozdelenie-na-baliky)
- [Ako nastaviť spôsob úhrady dobierky?](#nastavenie-sposobu-uhrady-dobierky)
- [Ako nastaviť výšku poistenia?](#nastavenie-vysky-poistenia)
- [Ako nastaviť rovnakú výšku poistenia pre všetky zásielky?](#nastavenie-vysky-poistenia)
- [Ako nastaviť doručenie v sobotu?](#dorucenie-zasielky-v-sobotu)
- [Ako nastaviť automatické skrátenie názvu organizácie pri prekročení maximálneho počtu znakov?](#automaticke-skratenie-nazvu-organizacie)
- [Ako nastaviť doručenie do výdajného miesta?](#dorucenie-do-vydajneho-miesta)
- [Ako nastaviť automatické odosielanie notifikácie zákazníkom o doručovaní zásielky?](#notifikacie-o-doruceni)

<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 SPS**.

![Konfigurácia pre kuriéra SPS](/images/SPS-Konf..png)

Chameleoon komunikuje s SPS prostredníctvom **API Webship**.

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

1. **Kontaktovať obchodného zástupcu a požiadať ho o prístup k ostrej verzii API Webship**
2. **Zadať prístupové údaje** - Prístupové údaje **sú rovnaké** ako prihlasovacie údaje do portálu SPS.

Tieto údaje zadajte v našej aplikácii.

![Prihlasovacie údaje](/images/SPS-prístup.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ť.

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

**Notifikácia o doručení zásielky**
- Umožňuje zasielanie upozornenia o doručení zásielky zákazníkovi e-mailom, SMS správou, telefonicky alebo ich kombináciou.

**Služba**
- Umožňuje zvoliť želaný spôsob doručenia zásielky.

![Služby dopravcu SPS](/images/SPS-Slu%C5%BEby-.png)

**Účtovacia jednotka**

**Spôsob úhrady dobierky**
- Tento údaj hovorí o tom, ako môže zákazník uhradiť objednávku na dobierku.

**Výška poistenia**
- Táto hodnota slúži pre poistenie zásielky. Hodnota sa uvádza v mene EUR.

**Vždy poistiť hodnotu**
- Zaškrtnutím sa vždy použije ako poistenie tá hodnota, ktorú máte zadanú. V opačnom prípade sa zadaná hodnota použije len v prípade, že nie je známa hodnota objednávky.

**Sobotné doručenie**

**Automaticky skrátiť adresu doručenia v prípade, že prekročí maximálny počet znakov**

**Povoliť expedíciu do SPS ParcelShop**

![Predvolené hodnoty pre SPS](/images/SPS---predvolen%C3%A9-hodnoty.png)

<h2 id="rozdelenie-na-baliky">Rozdelenie na balíky</h2>

Táto funkcionalita umožní automatické zvýšenie počtu balíkov pokiaľ bude splnená zadaná podmienka. Môžete si vybrať z troch možností - **podľa váhy, podľa počtu položiek alebo možnosť nerozdeľovať.**

**Podľa váhy**
- Ak objednávka presiahne zadanú váhu, aplikácia automaticky navyši počet balíkov.

**Príklad:** Ak nastavíte pravidlo napríklad na max. 15kg a niektorá z objednávok bude mať 30kg, aplikácia Vám automaticky nastaví počet balíkov na 2 a vytlačí aj 2 štítky.

**Podľa počtu položiek**
- Ak posielate každú položku ako samostatný balík, aplikácia automaticky nastaví počet balíkov podľa počtu položiek na objednávke.

**Príklad:** Ak nastavíte toto pravidlo ako aktívne a objednávka bude obsahovať napríklad 5 položiek, aplikácia automaticky nastaví počet balíkov na 5 a vytlačí aj 5 štítkov.

![SPS- rozdelenie na balíky](/images/SPS-rozdelenie-na-bal%C3%ADky.png)

## Tlač štítkov

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

![Tlač štítkov SPS](/images/SPS-tlač.png)

## Užitočné informácie

<h3 id="nastavenie-sposobu-uhrady-dobierky">Nastavenie spôsobu úhrady dobierky</h3>

Toto nastavenie Vám umožní zvoliť preferovaný spôsob úhrady objednávky odoslanej na dobierku. Môžete zvoliť platbu **len v hotovosti,** alebo umožníte Vašim zákazníkom aj **platbu kartou, alebo platbu prostredníctvom služby VIAMO.**

![Spôsob úhrady dobierky](/images/SPS-dobierka.png)

<h3 id="nastavenie-vysky-poistenia">Nastavenie výšky poistenia</h3>

Umožňuje zadať želanú výšku poistenia zásielky.

![Nastavenie výšky poistenia](/images/SPS-poistenie.png)

Pre poistenie všetkých objednávok rovnakou hodnotou je potrebné vyplniť požadovanú hodnotu a **zapnúť nastavenie "Vždy poistiť hodnotou."** V opačnom prípade sa zadaná hodnota použije len pri objednávke, u ktorej nie je známa hodnota objednávky.

![Nastavenie vždy poistiť hodnotou](/images/SPS-v%C5%BEdy-poistenie.png)

<h3 id="dorucenie-zasielky-v-sobotu">Doručenie zásielky v sobotu</h3>

Ak si želáte doručenie zásielok aj v sobotu, zapnite nastavenie **sobotné doručenie.**

![Nastavenie doručenia v sobotu](/images/SPS-sobotn%C3%A9-doru%C4%8Denie.png)

<h3 id="automaticke-skratenie-nazvu-organizacie">Automatické skrátenie názvu organizácie</h3>

Toto nastavenie Vám umožní skrátiť názov pri prekročení maximálneho počtu znakov.

![automatické skrátenie](/images/SPS--automatick%C3%A9-skr%C3%A1tenie-n%C3%A1zvu.png)

<h3 id="dorucenie-do-vydajneho-miesta">Doručenie do výdajného miesta</h3>

Ak si želáte doručiť zásielky do výdajného miesta, zapnite nastavenie **Povoliť expedíciu do SPS ParcelShop.**

![Doručenie do výdajného miesta](/images/SPS-ParcelShop.png)

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

Dopravca SPS umožňuje zasielať notifikácie o doručení zásielky zákazníkovi prostredníctvom **SMS, E-mailu, telefonicky alebo kombináciou všetkých možností.**

![Notifikácie o doručení](/images/SPS-notifik%C3%A1cie.png)

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