Dokumentacija / Dodatki / Integracija Stripe

Integracija Stripe

Vsako plačilo, ki prispe na vaš Stripe račun, postane davčno potrjen račun v Moj Računu. Vsako vračilo postane dobropis. Brez ročnega vnašanja.

4,99 € / mesec Mesečna naročnina · Odpoveste lahko kadarkoli, brez odpovednega roka

Če sprejemate plačila prek Stripe-a (kartice, Apple Pay, Google Pay, SEPA, naročnine), Integracija Stripe samodejno izda davčno potrjen račun v Moj Računu za vsako uspešno plačilo. Pri vračilih in izgubljenih sporih se prav tako samodejno izda dobropis (storno). Vsi računi imajo ZOI in EOR, generirajo se v PDF in (po želji) pošljejo stranki po e-pošti.

Vsebina

Kako deluje

Ko se zgodi plačilo v vašem Stripe računu, Stripe pošlje obvestilo (webhook) aplikaciji Moj Račun. Aplikacija nato samodejno opravi tale tok:

  1. Preveri pristnost obvestila (digitalni podpis Stripe-a).
  2. Poišče stranko v vašem CRM-ju ali jo ustvari, če je še nimate.
  3. Sestavi račun z vsemi obveznimi elementi (znesek, DDV, datum, številka).
  4. Pošlje na FURS v davčno potrditev (pridobi ZOI in EOR).
  5. Generira PDF in ga shrani v vašem oblačnem prostoru.
  6. Po želji pošlje PDF stranki na e-poštni naslov, ki ga je uporabila pri plačilu.

Celoten tok traja običajno manj kot 5 sekund od trenutka plačila do izdanega računa. Pri zelo visokih obremenitvah (več kot 100 plačil na minuto) lahko procesiranje traja nekaj minut, vendar se noben račun ne izgubi.

Pomembno: Moj Račun ne vidi vašega denarja. Stripe je merchant of record, vse transakcije gredo direktno na vaš Stripe račun. Mi samo opazujemo dogodke in izdamo račun za vaše davčne in računovodske potrebe.

Integracija obdela samo plačila od trenutka povezave naprej. Plačil, ki so se v vašem Stripe računu zgodila pred povezavo, ne uvozimo za nazaj in zanje ne izdamo računov samodejno — po potrebi jih izdate ročno v Moj Računu.

Kako se povežem s Stripe

Povezava traja običajno manj kot eno minuto:

  1. V aplikaciji Moj Račun odprite Dodatki → Integracija Stripe in se naročite na dodatek (mesečna naročnina 4,99 €, odpoveste lahko kadarkoli).
  2. Kliknite gumb "Poveži z Stripe". Preusmerjeni boste na stripe.com.
  3. Prijavite se v svoj Stripe račun (ali ga registrirajte, če ga še nimate — gre brezplačno).
  4. Stripe vas vpraša, ali dovoljujete Moj Računu dostop. Kliknite "Connect".
  5. Vrnjeni boste v aplikacijo Moj Račun. Sedaj samo še izberete scenarije, ki jih želite avtomatizirati, in shranite.

Povezovanje uporablja standardni protokol OAuth — Moj Račun nikoli ne vidi vašega gesla. Stripe nam izda žeton z omejenimi pravicami (samo branje plačil in podatkov o strankah), ki ga lahko kadarkoli prekličete iz Stripe nadzorne plošče ali iz Moj Račun nastavitev.

Vsi scenariji avtomatizacije — kaj DA in kaj NE

Vsak od štirih scenarijev lahko vklopite ali izklopite ločeno v nastavitvah dodatka. Tukaj je natančna razdelitev, kaj posamezen scenarij avtomatizira in kaj ne.

Enkratna plačila s kartico

✓ Avtomatizirano je
  • Plačila s karticami (Visa, Mastercard, Amex, …)
  • Apple Pay in Google Pay
  • Stripe Checkout in plačilni linki
  • PaymentIntent toki (npr. iz vaše spletne strani)
  • Račun se izda v trenutku, ko Stripe potrdi plačilo
✗ Avtomatizirano NI
  • Neuspela plačila (zavrnjena kartica, 3DS odpoved)
  • "Authorized" stanja brez bremenitve (pre-auth)
  • Plačila, ki so del naročnine — to pokriva drug scenarij
  • Test transakcije, dokler ne preklopite na "live mode"

Naročnine (Stripe Billing)

✓ Avtomatizirano je
  • Vsak mesečni ali letni obračun naročnine
  • Spremembe paketa sredi obdobja (proration) v naslednjem računu
  • Prilagojene cene in popusti, kakor jih sporoči Stripe
✗ Avtomatizirano NI
  • Poskusna obdobja (trial) — račun se izda šele ob prvem dejanskem plačilu
  • Predračuni za naročnine — Stripe jih ne ustvarja
  • Pavzirane naročnine (paused) brez plačila

SEPA direktna obremenitev

✓ Avtomatizirano je
  • Račun se izda glede na izbrano nastavitev časovnega okvira
  • Pri zavrnitvi SEPA plačila se samodejno izda storno
✗ Avtomatizirano NI
  • Stari SEPA toki z nestandardno potrditvijo
  • SEPA plačila, kjer Stripe ne sproži dogodkov

Časovni okvir: izberete lahko, da se račun izda takoj, ko Stripe sporoči "processing" (slovenska praksa), ali šele po končni potrditvi (T+6 dni). Prvi način je bolj odziven, drugi varnejši pri tveganju zavrnitve.

Stripe lastni računi

✓ Avtomatizirano je
  • Računi, ki ste jih ustvarili v Stripe-u in jih je stranka plačala
  • Računi se zrcalijo v Moj Račun z davčno potrditvijo in PDF-jem
✗ Avtomatizirano NI
  • Računi, ki ste jih ustvarili v Moj Računu — te že obvladujemo ročno
  • Osnutki Stripe računov (neplačani)

Vračila in spori (dobropisi)

Ko Stripe sporoči vračilo ali izgubljen spor (chargeback), Moj Račun lahko samodejno izda dobropis (storno) z davčnim potrjevanjem pri FURS-u. Sami izberete, kakšen način vam najbolj ustreza:

Samodejno (priporočeno)

Vsako vračilo samodejno ustvari storno. Pri sporu (chargeback) se storno izda samodejno šele po zaključku spora kot izgubljen ("lost"). Če spor dobite ("won"), prejmete obvestilo brez kakršnih koli sprememb računa.

Samo obvesti me

Dobite e-pošto in obvestilo v aplikaciji ob vsakem vračilu, sami pa odločite, ali boste izvedli storno. Primerno, če imate veliko nestandardnih primerov, ki zahtevajo individualno presojo.

Hibridno

Navadna vračila (s strani stranke) se samodejno izvedejo s stornom, spori (chargeback) pa zahtevajo vašo potrditev. Najpogostejši način pri tistih, ki imajo občasne spore.

Delna vračila

Stripe lahko vrne samo del plačila (npr. 30 € od 100 € računa). V tem primeru se izda manjši dobropis z navezavo na izvirni račun. Več delnih vračil ustvari več majhnih dobropisov. Vsak dobropis ima svoj ZOI in EOR za FURS.

Spori (chargeback)

Ko stranka pri svoji banki odpre spor, Stripe sporoči Moj Računu. Originalni račun označimo kot "v sporu". Storno se izda šele, ko Stripe zaključi spor kot izgubljen — če spor dobite, oznaka spora se umakne. Tako ne izdate dobropisa prezgodaj.

Politika valut

Stripe obdela plačila v različnih valutah. Vi izberete, kako se prikaže na računu:

Način Kako izgleda račun Priporočeno za
Izvirna valuta + EUR opomba Račun izstavljen v USD (npr. $50), v opombi protivrednost v EUR po dejanskem Stripe-ovem tečaju Slovenska praksa za tuje valute
Pretvorba v EUR Račun izstavljen v EUR, v opombi navedba izvirne valute Enostavno knjiženje, manjša transparentnost

Menjalniški tečaj uporabimo iz Stripe-ovega balance_transaction objekta — to je dejanski tečaj, po katerem je bila transakcija poravnana, ne pa hipotetični tečaj iz Banke Slovenije.

DDV in obrnjena davčna obveznost

Moj Račun uporabi vaše obstoječe DDV nastavitve iz Nastavitve → Račun. Če uporabljate Stripe Tax (Stripe-ov modul za samodejno določanje DDV-ja), aplikacija prepozna in upošteva razčlenitev, ki jo poda Stripe. Sicer računa DDV po vaših SKU nastavitvah.

Pri B2B kupcih iz EU z veljavnim VAT ID-jem (DE, AT, IT, …) se samodejno uporabi obrnjena davčna obveznost (reverse charge) v skladu z 196. členom Direktive 2006/112/EC. Račun se izda z 0 % DDV in z ustrezno opombo na PDF-ju.

Pri OSS shemi (sprostev e-trgovine v EU) se uporabi DDV stopnja namembne države, če imate v Moj Računu vklopljeno OSS in B2C prodajo prek meje. Več o tem v dokumentaciji za račune.

Kaj če nekaj ne uspe

Avtomatizacija ni magija — občasno se zgodi, da Stripe sporoči dogodek, ki ga ne moremo obdelati avtomatsko. V vsakem takem primeru dobite e-pošto in obvestilo v aplikaciji. Najpogostejši primeri:

Primer Kaj se zgodi Kaj naredite vi
Manjkajo FURS nastavitve Račun ni izdan, prejmete obvestilo s povezavo do nastavitev Vnesete poslovni prostor in ID elektronske naprave
FURS zavrne potrditev Račun ni izdan, prejmete e-pošto z razlogom Popravite DDV način ali druge fiskalne nastavitve
Vračilo brez izvirnega računa Storno ni izdan, prejmete obvestilo Ročno vnesete storno (ali ignorirate, če gre za starejši primer)
Več strank z istim e-naslovom Račun izstavimo na najboljšo oceno, označimo "potrebuje pregled" V rubriki Stranke ročno združite zapise
Stripe pooblastilo razveljavljeno Integracija se izklopi, prejmete e-pošto in opozorilo v aplikaciji Znova povežete Stripe iz dodatkov
Omrežna težava (kratkotrajna) Stripe ponovi pošiljanje do 3 dni — račun se izda kasneje Običajno nič — sistem sam zaživi nazaj

Kako prepoznam, da je nekaj narobe

Štirje neodvisni kanali za vaše obveščanje:

  • E-pošta — za vsako napako ali primer, ki zahteva vaš pregled, prejmete e-pošto na svoj naslov.
  • V aplikaciji — pod Dodatki → Integracija Stripe vidite seznam zadnjih dogodkov s statusom: uspeh, napaka, v obdelavi.
  • Aktivnost — na strani integracije imate pregled zadnjih 25 dogodkov z razlogom za morebitno napako.
  • Davčno potrjevanje (Dokumenti → Davčno potrjevanje) — pregled stanja davčnega potrjevanja vseh računov (Stripe in ročno izdanih), s števci po stanju in možnostjo ročnega ponovnega potrjevanja.

Odpornost na izpade FURS (naknadno davčno potrjevanje)

Aplikacija nikoli ne izgubi računa, tudi če je FURS v trenutku izdaje nedosegljiv. To velja tako za ročno izdane račune kot za Stripe samodejne račune. Vsak račun ima eno od šestih stanj davčnega potrjevanja:

Stanje Pomen
Davčno potrjenFURS je potrdil, EOR je prisoten, PDF je popolnoma davčno potrjen.
V naknadnem potrjevanjuFURS ni bil dosegljiv ob izdaji. Račun je ohranjen z lokalno izračunanim ZOI in se vsake 2 minuti poskuša znova potrditi.
Potrebna ročna oddaja (rok 2 delovnih dni)Od izdaje sta pretekla več kot 2 delovna dni in FURS še vedno ni potrdil. Račun morate ročno oddati prek eDavki.
Potrebna ročna oddaja (poslovna napaka)FURS je zavrnil potrditev (npr. neveljaven DDV način). Sporočilo o napaki vam pove, kaj popraviti.
Manjka certifikatRačun je izdan, vendar v trenutku izdaje ni bilo certifikata. Po nalaganju certifikata se računi, izdani v zadnjih 2 delovnih dneh, samodejno naknadno potrdijo.
Brez davčnega potrjevanjaUporabnik ima v nastavitvah izklopljeno davčno potrjevanje.

Rok FURS: 2 delovna dni

Slovenska FURS zakonodaja zahteva naknadno davčno potrjevanje računov v roku 2 delovnih dni od izdaje (vikendi in prazniki se ne štejejo). Po tem roku, če potrjevanje še ni uspelo, mora biti račun ročno oddan prek portala eDavki. Aplikacija te o tem opozori z nujno e-pošto.

Ko ponovno naložiš certifikat

Če si certifikat odstranil ali se je iztekel in si izdal nekaj Stripe računov v stanju "manjka certifikat", po ponovnem nalaganju veljavnega certifikata aplikacija samodejno:

  • Računi, izdani v zadnjih 2 delovnih dneh, se samodejno postavijo v vrsto za naknadno davčno potrjevanje. Strežnik jih potrdi v naslednjih nekaj minutah.
  • Računi, starejši od 2 delovnih dni, se označijo z "potrebna ročna oddaja" in jih vidiš v Dokumenti → Davčno potrjevanje, kjer jih lahko ročno oddaš prek eDavki ali poskusiš še enkrat z gumbom "Ponovno potrdi".
  • O obeh skupinah dobiš obvestilo v aplikaciji in po e-pošti.

Pogosta vprašanja

Ali Moj Račun vidi moje denarne tokove? +

Ne. Stripe je merchant of record, vsi denarni tokovi gredo direktno k vam. Moj Račun samo prejema obvestila o plačilih in izda račune za vaše davčne potrebe.

Ali se mi plačuje Stripe provizija večkrat? +

Ne. Moj Račun ne jemlje provizije od vaših Stripe plačil. Plačate samo 4,99 € na mesec za sam dodatek (in kar koli Stripe sam zaračuna za obdelavo plačil — to je popolnoma ločeno).

Kaj se zgodi, če izklopim integracijo sredi meseca? +

Računi, ki so že izdani, ostanejo nedotaknjeni. Naročnina se obračuna do konca tekočega meseca (sorazmerni del). Nadaljnja Stripe plačila se ne bodo več samodejno obdelovala, lahko pa znova povežete, kadar koli želite.

Kaj pa plačila, ki sem jih prek Stripe-a prejel pred povezavo? +

Integracija obdela samo plačila od trenutka povezave naprej. Starih plačil, izvedenih pred povezavo, ne uvozimo za nazaj in zanje ne izdamo računov samodejno. Če za takšno plačilo potrebujete račun, ga preprosto izdate ročno v Moj Računu (in po želji označite kot plačano).

Ali deluje za testne (test mode) Stripe transakcije? +

Da, podpiramo tako "test mode" kot "live mode" v Stripe-u. V testnem načinu se ne pošiljajo dejanski e-poštni opomniki strankam, vse ostalo pa deluje enako.

Kako varna je povezava? +

Uporabljamo standardni protokol OAuth (kakor pri Googlu, Facebooku). Vašega Stripe gesla nikoli ne vidimo. Stripe nam izda žeton z omejenimi pravicami, ki ga lahko kadarkoli prekličete iz Stripe nadzorne plošče (Settings → Connected applications) ali iz Moj Račun.

Kaj če dobi stranka račun po e-pošti dvakrat — enkrat od Stripe-a in enkrat od vas? +

Stripe običajno pošlje samo svoje potrdilo o plačilu (receipt), ki ga lahko izklopite v Stripe nastavitvah. Račun, ki ga izda Moj Račun, je davčno potrjen pri FURS-u in je dejanski uradni račun. Priporočamo, da v Stripe izklopite samodejne potrditve, če želite, da stranka dobi samo en dokument.

Ali integracija deluje, če imam tudi druge plačilne sisteme (PayPal, plačilo na TRR)? +

Da. Integracija Stripe obdela samo plačila, ki gredo prek Stripe-a. Vsa ostala plačila (PayPal, TRR, gotovina) ročno vnesete v Moj Račun kot doslej. Lahko pa razmislite o uvozu plačil iz banke — glejte dokumentacijo o uvozu plačil.

Kaj se zgodi pri Stripe Tax-u in slovenskem OSS-u? +

Če imate v Stripe-u vklopljen Stripe Tax (njihov modul za avtomatsko določanje DDV-ja), Moj Račun upošteva DDV razčlenitev, ki jo dobi od Stripe-a. Pri B2C čezmejnih prodajah v EU se uporabi vaša OSS shema (če je v Moj Računu vklopljena). Pri B2B prodajah v EU se uporabi obrnjena davčna obveznost.

Pravne in računovodske opombe

Integracija Stripe je orodje za poenostavitev izdaje računov. Pravna odgovornost za pravilnost računov in davčnih obveznosti ostaja na vas. Pri čezmejnih primerih (B2B EU reverse charge, OSS shema, neevropski kupci) priporočamo, da samodejno izdane račune redno pregledate skupaj s svojim računovodjo.

Moj Račun zagotavlja, da so vsi računi davčno potrjeni pri FURS-u (ZOI, EOR) in shranjeni v skladu z zahtevami slovenske davčne zakonodaje. Ne odgovarjamo pa za izbiro pravilnega DDV načina, OSS sheme ali napačno vneseno VAT ID stranke.

Pripravljeni na avtomatizacijo?

Naročite se na dodatek, povežite svoj Stripe račun in pustite, da Moj Račun poskrbi za davčno potrjene račune brez vašega posega.

Vključi v aplikaciji Registriraj se (brezplačno)

Mesečna naročnina 4,99 € · Odpoveste lahko kadarkoli, brez odpovednega roka

Drugi dodatki

Aplikacija ostaja brezplačna. Dodatki so opcijski: