> For the complete documentation index, see [llms.txt](https://docs.portos.sk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.portos.sk/rozsirenia/spin.md).
# SPIN
Prepojenie systému PORTOS s podnikovým informačným systémom SPIN od spoločnosti Asseco.
## Na čo slúži prepojenie so systémom SPIN?
SPIN je podnikový informačný systém od spoločnosti Asseco, určený na vedenie ekonomiky a účtovníctva.
Vďaka prepojeniu so systémom SPIN sa tržby z pokladníc systému Portos automaticky prenášajú do pokladničnej knihy v systéme SPIN. Tržby tak viac nemusíte do systému SPIN ručne prepisovať.
Do systému SPIN sa prenášajú:
* tržby za každú dennú uzávierku, a to za každú fiškálnu tlačiareň samostatne, vo forme príjmového pokladničného dokladu. Doklad obsahuje súčty tržieb rozdelené podľa sadzieb DPH a prípadné zaokrúhlenie.
Údaje sa prenášajú iba jedným smerom, zo systému Portos do systému SPIN. Tovary, jednotlivé účtenky ani skladové pohyby sa neprenášajú.
## Ako funguje prepojenie so systémom SPIN?
Prostredníctvom zabezpečeného programátorského rozhrania (API) systému SPIN. Synchronizácia prebieha automaticky na pozadí služby PORTOS API:
* bezprostredne po štarte služby PORTOS API,
* po uložení nastavení rozšírenia,
* následne opakovane, podľa nastavenej [periódy synchronizácie](#synchronizacia).
Pri každej synchronizácii systém Portos odošle všetky denné uzávierky uzatvorené od [poslednej synchronizácie](#synchronizacia). Denná uzávierka, ktorá ešte nebola uzatvorená, sa neodosiela. Ak odoslanie zlyhá, systém Portos ho zopakuje pri nasledujúcej synchronizácii. Doklad, ktorý už v systéme SPIN existuje, sa druhýkrát nevytvorí.
## Ako spustiť prepojenie so systémom SPIN na mojej prevádzke?
Spustenie prepojenia systému Portos so systémom SPIN vyžaduje:
* Používanie systému Portos vo verzii 4.2.10 alebo novšej.
* Rozšírenie "*Prepojenie so systémom SPIN*", ktoré je spoplatnené podľa [aktuálneho cenníka](https://portos.sk/cennik).
* Údaje pre prístup k API systému SPIN (adresu a prístupový kľúč) a údaje z číselníkov systému SPIN, ktoré sú popísané v časti [Nastavenia](#nastavenia). Poskytne vám ich dodávateľ systému SPIN.
* Sieťové spojenie medzi počítačom so službou PORTOS API a serverom systému SPIN. Ak je server systému SPIN dostupný iba cez VPN, musí byť VPN pripojenie aktívne aj na počítači so službou PORTOS API.
S celým procesom vám radi pomôžeme. Kontaktujte svojho servisného technika.
## Nastavenia
Pre prístup k nastaveniam prepojenia so systémom SPIN:
* otvorte aplikáciu [Portos BackOffice](/backoffice/uvod-do-aplikacie-backoffice.md) a prihláste sa.
* v hlavnom menu kliknite v sekcii "**Systém**" na položku "**Rozšírenia**".
* Zobrazí sa zoznam rozšírení systému. V časti "**SPIN**" stlačte tlačidlo "**Spravovať**".
Zobrazí sa obrazovka s nastaveniami, na ktorej sú k dispozícii nastavenia popísané nižšie. Zmeny nastavení sa uplatnia po stlačení tlačidla "**Uložiť**", pričom sa zároveň spustí synchronizácia.
Nastavenia rozšírenia SPIN v aplikácii PORTOS BackOffice
* **Aktívne**: určuje, či je rozšírenie aktívne. Synchronizácia prebieha iba vtedy, ak je rozšírenie aktívne.
### Spojenie s API
* **Adresa API**: adresa API systému SPIN. Musí začínať `http://` alebo `https://`.
* **Prístupový kľúč**: kľúč pre prístup k API systému SPIN.
### Predajné miesto
* **Skratka pokladničnej knihy**: skratka pokladničnej knihy v systéme SPIN, do ktorej sa budú zapisovať tržby. Slúži pre identifikáciu predajného miesta.
* **Skratka organizačnej štruktúry (strediska)**: skratka strediska v systéme SPIN. Slúži pre identifikáciu strediska.
* **Interný kód odberateľa**: interný kód odberateľa v systéme SPIN, na ktorého sa pokladničné doklady vystavujú. Musí byť väčší ako 0.
### Číselníky
Identifikátory položiek z číselníkov systému SPIN.
* **ID položky daňového dokladu**: identifikátor typu položky pokladničného dokladu, pod ktorým sa zapisujú tržby.
* **ID položky zaokrúhlenia**: identifikátor položky používaný pre zaokrúhlenie sumy na pokladničnom doklade. Štandardne `79`.
* **ID položky pokladničného dokladu**: typ pokladničného dokladu. Štandardne `P` (príjem).
### Synchronizácia
* **Posledná synchronizácia**: dátum a čas poslednej úspešnej synchronizácie. Systém Portos ho po každej úspešnej synchronizácii zapíše automaticky. Posunutím termínu dozadu sa pri ďalšej synchronizácii znova odošlú aj staršie denné uzávierky. Tie, ktoré už v systéme SPIN existujú, sa druhýkrát nevytvoria.
* **Synchronizovať od**: dátum a čas, od ktorého budú odosielané predaje. Denné uzávierky uzatvorené pred týmto termínom nebudú odoslané do systému SPIN.
* **Perióda synchronizácie**: ako často sa má synchronizácia opakovať. Hodnota v tvare `HH:MM:SS`, štandardne `12:00:00` (každých 12 hodín).
### Texty na doklade
* **Šablóna čísla dokladu**: určuje formát číslovania pokladničných dokladov v systéme SPIN. Štandardne `--`.
* **Šablóna účelu dokladu**: určuje účel dokladu. Ak nie je vyplnená, účel sa neodosiela.
Obe šablóny podporujú nahrádzanie textu premennými podľa zoznamu nižšie:
| Premenná | Nahradí sa hodnotou |
| ----------------------------------- | ----------------------------------------------- |
| `` | rok uzatvorenia dennej uzávierky (4 číslice) |
| `` | rok uzatvorenia dennej uzávierky (2 číslice) |
| `` | mesiac uzatvorenia dennej uzávierky (2 číslice) |
| `` | deň uzatvorenia dennej uzávierky (2 číslice) |
| `` | číslo dennej uzávierky |
| `` | kód pokladnice (4 posledné číslice DKP) |
| `` | názov fiškálnej tlačiarne |
Napríklad šablóna `--` vytvorí pre dennú uzávierku č. 125 z roku 2026 na pokladnici s DKP končiacim na `4321` číslo dokladu `4321-2026-125`.
{% hint style="warning" %}
Číslo dokladu musí byť pre každú dennú uzávierku a fiškálnu tlačiareň jedinečné. Šablóna preto musí obsahovať aspoň číslo dennej uzávierky a kód pokladnice.
Vo verziách PORTOS API starších ako 4.3.22 je predvolená šablóna `0`, teda všetky doklady majú rovnaké číslo. Ak používate staršiu verziu, šablónu nastavte ručne, napríklad podľa príkladu vyššie.
{% endhint %}
### Sadzby dane
Priradenie sadzieb DPH v systéme Portos k označeniam daní v systéme SPIN. Novú sadzbu pridáte tlačidlom "**Pridať**", sadzbu odstránite ikonou koša.
* **Sadzba DPH**: percentuálna sadzba DPH. Nechajte prázdne pre nedaňovú hladinu.
* **Označenie základu dane**: označenie základu dane pre danú sadzbu v systéme SPIN.
* **Označenie dane**: označenie dane pre danú sadzbu v systéme SPIN.
{% hint style="danger" %}
Každá sadzba DPH, ktorá sa vyskytuje v predajoch, musí mať v zozname svoje priradenie. V opačnom prípade sa tržby za dennú uzávierku do systému SPIN neodošlú.
{% endhint %}
## Stav synchronizácie
Ak pri synchronizácii nastane chyba, rozšírenie sa zobrazí v aplikácii PORTOS Pokladňa, v obrazovke *Stav systému*, s hlásením "*Pri synchronizácii nastala chyba*" a popisom chyby. Obrazovka *Stav systému* zobrazuje iba súčasti s varovaním alebo chybou. Ak rozšírenie pracuje správne, v obrazovke sa nezobrazuje.
## Otázky a odpovede
### Tržby za dennú uzávierku sa do systému SPIN neprenášajú
1. Overte, či je rozšírenie v nastaveniach [aktívne](#nastavenia) a či je denná uzávierka uzatvorená. Neuzatvorené denné uzávierky sa neodosielajú.
2. Overte stav rozšírenia v obrazovke *Stav systému* v aplikácii PORTOS Pokladňa. Popis chyby zvyčajne uvádza, ktorý údaj v systéme SPIN nebol nájdený (napríklad pokladničná kniha, stredisko, odberateľ alebo sadzba DPH).
3. Overte, či je server systému SPIN z počítača so službou PORTOS API dostupný (napríklad či je aktívne VPN pripojenie).
4. Overte, či denná uzávierka nebola uzatvorená pred termínom v nastavení [Synchronizovať od](#synchronizacia).
### Ako znova odošlem staršie denné uzávierky?
V [nastaveniach rozšírenia](#synchronizacia) posuňte **Poslednú synchronizáciu** na termín pred uzatvorením týchto denných uzávierok a nastavenia uložte. Denné uzávierky, ktoré už v systéme SPIN existujú, sa druhýkrát nevytvoria.
