KIGO.CLOUD
Integracija koristi besplatni plugin KigoCloud for WooCommerce (distribuira se preko GitHub-a). Plugin osluškuje statuse narudžbi i automatski šalje podatke na Kigo Cloud API koji kreira račun ili ponudu, fiskalizira (ako je uključeno) i podržava R1 za B2B kupce.

Pregled

WooCommerce narudžbe automatski se prenose u Kigo Cloud i pretvaraju u fiskalizirane dokumente. Plugin se sam ažurira s GitHub-a, pa nakon prve instalacije ne morate ručno preuzimati nove verzije.

Instalacija plugina

Plugin se distribuira preko GitHub-a, ne preko wordpress.org. Zato u WP-u NE radi "Dodaci → Dodaj novi → Pretraga" - zip se učitava ručno jednom, a dalje se ažurira sam.

  1. Preuzmite kigocloud-for-woocommerce.zip s GitHub releases
  2. U WordPress administraciji: Dodaci → Dodaj novi → Učitaj dodatak
  3. Odaberite zip, Instaliraj odmah, zatim Aktiviraj
  4. U lijevom WP izborniku pojavi se stavka KigoCloud (ikona oblaka) - sve postavke su tu, NE u "WooCommerce → Postavke"

Izvorni kod, changelog i prijava grešaka: github.com/symmetria-doo/kigocloud-for-woocommerce

Connection - API kredencijali

KigoCloud admin stranica ima 9 tabova (Connection, Orders, Prices, Price list, R1, Email, Mapping, Logs, About) i jedan Save all settings gumb na dnu. Prvi tab je Connection:

  • API username / password - vaši Kigo Cloud podaci (isti kao prijava na app.kigo.cloud; za test admin_demo / admin_demo)
  • Employee PIN - PIN djelatnika koji se vodi kao kreator dokumenta (default 1; popis u Kigo Cloud "Djelatnici")

Orders - mapiranje po načinu plaćanja

Glavni dio konfiguracije. Za svaki WooCommerce gateway (Stripe, virman, pouzeće...) odredite što se kreira u Kigu (račun ili ponuda) i kod kojeg statusa narudžbe se šalje.

Uz okidač Order created dokument nastaje prvi put kad narudžba dođe u status Na čekanju, U obradi ili Završeno, pa i kad je plaćanje prošlo tek iz drugog pokušaja. Kasnije promjene statusa ne stvaraju novi dokument. Za jednu narudžbu nastaje jedan dokument.

Ako je porez u WooCommerce-u isključen, račun koristi stopu PDV-a upisanu na artiklu u Kigo Cloudu. Varijacije bez vlastitog SKU-a dijele šifru proizvoda, pa se na računu spajaju u jedan redak s ukupnom količinom.

Globalne opcije: Shipping reference (Kigo šifra za stavku "Dostava", default shipping) i Fill empty SKU (ako proizvod nema SKU, šalje sku-{id} da lookup ne padne).

Prije početka provjerite da su u WooCommerce-u uredni SKU-ovi i porezne stope. Više od pola problema integracije dolazi od pogrešnog PDV-a ili nedostajućih/dupliranih SKU-ova.

R1 računi za B2B

Tab R1 omogućuje R1 račune za poslovne kupce (naziv tvrtke i OIB na checkoutu), uz live preview i gumb "Send test R1 offer" za provjeru.

Dijagnostika

Tab Logs prikazuje zadnjih 50 API poziva s rezultatom - glavni alat za otklanjanje problema. Tab About pokazuje verziju plugina i WC/WP/PHP detekciju.

Potpuni vodič korak-po-korak nalazi se i u aplikaciji: Opcije → Integracije → WooCommerce Integracija.

Sinkronizacija artikala i zaliha *

Na kartici WooCommerce Sinkronizacija Kigo Cloud šalje artikle i zalihe u trgovinu. Trgovina se povezuje adresom i API ključevima iz WooCommerce-a.

  • Puna sinkronizacija: naziv, opis, cijena, kategorije, marka, varijacije i količine u trgovini zamjenjuju se podacima iz Kigo Clouda.
  • Samo količine: u trgovinu se šalje samo količina, po šifri artikla (SKU). Ostali podaci ostaju kako su uređeni u trgovini.

Kad artikl povezan s trgovinom spremite s Vidljiv na webu na Ne, Kigo Cloud pita što napraviti u trgovini: sakriti proizvod, postaviti mu zalihu na 0 ili ne mijenjati ništa.

* Sinkronizacija artikala i zaliha dio je paketa Business i viših.

Booking dodaci (npr. Amelia)

Booking dodaci poput Amelia koji naplatu vode kroz WooCommerce ne trebaju zasebnu integraciju - svaka rezervacija postaje WooCommerce narudžba koju plugin obradi kao i svaku drugu (uz iste uvjete: mapiran gateway i uredan SKU/PDV).

Integracije