Shopify integracija v Račun123 (vodič korak za korakom)
Cilj vodiča
Po koncu vodiča bo Shopify ob dogodku uspešnega plačila samodejno sprožil webhook, Račun123 pa bo iz podatkov naročila ustvaril račun.
Priporočena konfiguracija za večino uporabnikov
Za večino Shopify trgovin zadošča en webhook z dogodkom Order payment v formatu JSON.
Pomembno
V Shopify moraš uporabiti isti Webhook URL in isto signing secret vrednost, kot ju vidiš v Račun123 pri Shopify integraciji.
1. Odpri Shopify integracijo v Račun123
Pojdi na Nastavitve → Več nastavitev → Integracije → Shopify.
Na tej strani vidiš:
- Webhook URL
- Webhook skrivnost
- Domena trgovine
- gumb za test povezave
Produkcijski Webhook URL je:
https://moj.racun123.si/api/integrations/shopify
👉 To stran pusti odprto, ker boš te podatke potreboval v Shopify adminu.
2. Vpiši domeno svoje Shopify trgovine
V polje Domena trgovine vpiši svojo Shopify domeno, na primer:
tvoja-trgovina.myshopify.com
Uporabi domeno brez https:// in brez dodatnih poti.
Primer
Če je naslov tvoje trgovine testing12314312.myshopify.com, potem v Račun123 vpišeš točno to vrednost.
3. Odpri Webhooks v Shopify
V Shopify adminu pojdi na:
Settings → Notifications → Webhooks
Nato klikni Create webhook.
Če menija ne najdeš
V Shopify lahko uporabiš tudi zgornje iskalno polje in vpišeš webhooks.
4. Ustvari webhook v Shopify
Pri ustvarjanju webhooka nastavi naslednje:
- Event / Dogodek: Order payment
- Format: JSON
- URL: Webhook URL iz Račun123
V polje za URL prilepi:
https://moj.racun123.si/api/integrations/shopify
Nato webhook shrani.
Kaj pomeni “Order payment”?
Ta dogodek Shopify sproži, ko je naročilo uspešno plačano. To je pravilen trenutek, da Račun123 prejme podatke in pripravi račun.
5. Poveži signing secret
Ko je webhook ustvarjen, Shopify zanj samodejno uporablja podpisovanje zahtevkov.
V Shopify pri webhooku preveri podpisno vrednost oziroma skrivnost, nato jo kopiraj in prilepi v Račun123 v polje “Webhook skrivnost”.
Vrednost mora biti v obeh sistemih enaka.
Pozor
Če Webhook URL drži, signing secret pa ne, bo Shopify webhook sicer poslal, vendar Račun123 zahteve ne bo mogel pravilno potrditi.
6. Kako veš, da je webhook pravilno nastavljen?
Ko je povezava pravilna, v Shopify vidiš:
- dogodek Order payment
- pravilen URL webhooka
- format JSON
- aktivno webhook povezavo
V Račun123 pa vidiš:
- pravilen Webhook URL
- vpisano Webhook skrivnost
- pravilno domeno trgovine
7. Testiraj povezavo
Preden začneš uporabljati integracijo v produkciji, naredi testno naročilo v Shopify.
Nato preveri:
- ali Shopify webhook res sproži
- ali se zapis pojavi v dnevniku webhookov v Račun123
- ali se ustvari pravilen račun
Priporočilo
Najprej naredi en preprost test z enim izdelkom in uspešnim plačilom, da hitro preveriš osnovni tok podatkov.
8. Po potrebi vklopi dodatno avtomatiko v Račun123
Ko test deluje, v Račun123 po potrebi vklopi še:
- ✅ samodejno davčno potrjevanje
- ✅ samodejno pošiljanje računa po e-pošti
Če posluješ v režimu, kjer je davčno potrjevanje potrebno, preveri še:
- oznako poslovnega prostora
- oznako naprave
- operaterja
9. Hitri povzetek: končna konfiguracija
Kaj nastaviš v Shopify
- Webhook event: Order payment
- Format: JSON
- Webhook URL:
https://moj.racun123.si/api/integrations/shopify
Kaj nastaviš v Račun123
- domena trgovine tvoja-trgovina.myshopify.com
- Webhook skrivnost
- po potrebi:
- samodejno davčno potrjevanje
- samodejno pošiljanje računa po e-pošti
To je priporočena konfiguracija za večino Shopify trgovin, ki želijo avtomatsko ustvarjanje računov po uspešnem plačilu.
Če nekaj ne dela (hitri checklist)
Webhook se ne sproži?
- Preveri, ali je izbran pravi dogodek Order payment
- Preveri, ali je URL pravilno prilepljen
- Preveri, ali je webhook v Shopify shranjen in aktiven
Račun se ne ustvari?
- Preveri signing secret
- Preveri domeno trgovine v Račun123
- Preveri dnevnik webhookov v Račun123
Podatki na računu niso pravilni?
- Preveri podatke na Shopify naročilu
- Preveri davčne nastavitve, stopnje in izdelke v trgovini
- Preveri, ali imaš v Račun123 pravilno nastavljen način izdaje računov
Ni emaila kupcu?
- Preveri, ali je pošiljanje računov po e-pošti vklopljeno v Račun123
- Preveri, ali ima naročilo v Shopify vpisan email kupca
Pogosta vprašanja
Ali potrebujem Shopify app?
Ne nujno. Za osnovno povezavo z Račun123 zadošča pravilno nastavljen webhook.
Ali zadošča samo en webhook?
Za večino primerov da. Priporočena osnovna nastavitev je en webhook za Order payment.
Kdaj se račun ustvari?
Račun se ustvari, ko Shopify po uspešnem plačilu pošlje podatke v Račun123 preko webhooka.
Ali se račun tudi samodejno davčno potrdi?
Da, če imaš v Račun123 pravilno nastavljeno davčno potrjevanje in če zate ta obveznost velja.
Ali se račun lahko samodejno pošlje kupcu?
Da, če v Račun123 vklopiš samodejno pošiljanje računa po e-pošti.
Ali moram v Shopify še kaj programirati?
Za osnovno webhook povezavo praviloma ne. Dovolj je, da pravilno nastaviš dogodek, URL in skrivnost webhooka.
Potrebuješ pomoč pri Shopify integraciji?
Če se webhook ne sproži, če se račun ne ustvari pravilno ali če želiš preverbo nastavitev, smo ti z veseljem na voljo.
Piši nam na podpora@racun123.si ali nam pošlji sporočilo prek kontaktnega obrazca.
Skupaj bomo hitro preverili povezavo in poskrbeli, da Shopify in Račun123 delujeta brezhibno.
