For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Pri každej synchronizácii systém Portos odošle všetky denné uzávierky uzatvorené od poslednej synchronizácie. 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.

  • Ú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. 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 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 <Fiscal.DKP>-<DailySalesReport.CloseDate.YYYY>-<DailySalesReport.Number>.

  • Š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

<DailySalesReport.CloseDate.YYYY>

rok uzatvorenia dennej uzávierky (4 číslice)

<DailySalesReport.CloseDate.YY>

rok uzatvorenia dennej uzávierky (2 číslice)

<DailySalesReport.CloseDate.MM>

mesiac uzatvorenia dennej uzávierky (2 číslice)

<DailySalesReport.CloseDate.dd>

deň uzatvorenia dennej uzávierky (2 číslice)

<DailySalesReport.Number>

číslo dennej uzávierky

<Fiscal.DKP>

kód pokladnice (4 posledné číslice DKP)

<Fiscal.Name>

názov fiškálnej tlačiarne

Napríklad šablóna <Fiscal.DKP>-<DailySalesReport.CloseDate.YYYY>-<DailySalesReport.Number> vytvorí pre dennú uzávierku č. 125 z roku 2026 na pokladnici s DKP končiacim na 4321 číslo dokladu 4321-2026-125.

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.

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

Ako znova odošlem staršie denné uzávierky?

V nastaveniach rozšírenia 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.

Naposledy aktualizované