KIGO.CLOUD

Povezivanje sa Shopifyem putem WebHooka

Integracija sa Shopifyem radi putem WebHook mehanizma. Kada se narudžba u Shopifyu ispuni (fulfill), podaci se automatski šalju u KigoCloud koja kreira račun ili ponudu, fiskalizira dokument i šalje ga kupcu e-mailom.

Postupak aktivacije:

  1. U Shopify Adminu otvorite Settings → Notifications.
  2. Na dnu stranice kliknite Create Webhook.
  3. Odaberite event tipa Order Fulfillment (podržani su svi orders/* eventi).
  4. U polje URL zalijepite WebHook adresu iz Kigo postavki (dostupna na stranici Shopify integracije).
  5. Spremite WebHook i testirajte slanjem probne narudžbe.

Kreiranje računa ili ponude

Vrsta dokumenta ovisi o statusu plaćanja narudžbe u trenutku kad WebHook pošalje podatke:

  • Ako je narudžba označena kao plaćena (financial_status = paid) — kreira se račun.
  • Ako narudžba nije plaćena — kreira se ponuda.

Ovo ponašanje možete dodatno prilagoditi putem taba Dodatna pravila gdje definirate kombinaciju eventa, načina plaćanja i željenog statusa dokumenta.

Artikli se automatski preuzimaju iz Shopify narudžbe zajedno s cijenom i porezom. Bitno je da svaki artikl u Shopifyu ima definiran SKU kako se ne bi duplicirao pri svakoj novoj narudžbi.

Mapiranje načina plaćanja

Kigo automatski prepoznaje način plaćanja iz Shopify narudžbe prema sljedećim pravilima:

  • Kartična plaćanja — evidentiraju se kao način plaćanja Kartica.
  • Bank transfer, Cash on Delivery (COD), Bank deposit, PayPal — evidentiraju se kao Transakcija.

Za specifične konfiguracije koristite tab Dodatna pravila gdje možete mapirati pojedini Shopify payment gateway na željeni Kigo način plaćanja.

Postavljanje PDV-a i B2B računi (R1)

PDV se automatski preuzima iz Shopify narudžbe. Za ispravno postavljanje:

  1. U Shopifyu otvorite Settings → Taxes and duties i dodajte Hrvatsku s PDV stopom od 25%.
  2. Na svakom proizvodu označite opciju Charge tax on this product.

Za B2B kupce (izdavanje R1 računa), kupac prilikom narudžbe u polje Company name upisuje naziv tvrtke i OIB (npr. Firma d.o.o. / 12345678901). Kigo automatski prepoznaje OIB (11 znamenki) iz tog polja i kreira B2B klijenta.

Polje Company name omogućite u Shopify Admin → Settings → Checkout, sekcija Customer information, postavite na Optional ili Required.

Sinkronizacija artikala (PREMIUM)

Za dvosmjernu sinkronizaciju artikala, zaliha i kategorija sa Shopifyem potrebna je opcija Shopify Sinkronizacija koja zahtijeva PREMIUM licencu.

Za korištenje sinkronizacije potrebni su Shopify API pristupni podaci:

  1. U Shopify Adminu otvorite Apps → Apps and sales channels → Developer apps.
  2. Kreirajte novu aplikaciju (npr. KigoPOS) i omogućite dozvole: write_inventory, read_inventory, read_locations, read_products, write_products.
  3. Kopirajte API key, password i shared secret te ih unesite u Kigo Shopify postavke.

Artikli moraju imati postavljen Naziv za web (jedinstven za sve varijacije), opciju Vidljiv na webu = Da, te po potrebi atribute za varijacije (npr. Veličina: XL) i meta podatke.

Česta pitanja

  • Narudžba se ne pojavljuje u Kigu? Provjerite je li WebHook URL ispravno kopiran i je li odabran ispravan event. Status isporuke WebHooka možete provjeriti u Shopify Admin → Settings → Notifications → Webhooks.
  • Kako storniram račun kreiran iz Shopifya? Storniranje se radi isključivo u Kigo aplikaciji. Pronađite račun i koristite opciju storniranja — fiskalizirano storniranje automatski se prijavljuje poreznoj upravi.
  • Mogu li koristiti kategorije s podkategorijama? Da, koristite znak > u nazivu grupe za definiranje hijerarhije (npr. Odjeća > Ženska > Haljine). Kigo će automatski kreirati odgovarajuće kolekcije na Shopifyu.
  • Moram li ručno unositi artikle? Ne, ako ne vodite skladište. Artikli se automatski dodaju iz svake narudžbe, ali moraju imati definiran SKU u Shopifyu.

Integracije