Integracija preko API-ja

Wix prodavnica i fiskalni račun

Da kažemo odmah: gotovog Wix dodatka za Tezgu nema. Veza ide preko Tezginog API-ja, isto kao za bilo koji sajt koji ume da pošalje porudžbinu na spoljnu adresu. Kad je porudžbina plaćena, pošalje se Tezgi, a Tezga izda i fiskalizuje račun.

Kako teče

  1. 01

    Porudžbina je plaćena

    Veza kreće tek kad je uplata potvrđena, ne kad je porudžbina napravljena. Tako se ne izdaje račun za kupovinu koja nije prošla.

  2. 02

    Kod ili automatizacija šalje porudžbinu

    U Wix-u to obično radi programer u Velo-u, Wix-ovom alatu za pisanje koda na serverskoj strani. Drugi put je n8n, Make ili Zapier, ako tvoj alat vidi porudžbine iz Wix prodavnice.

  3. 03

    Tezga izdaje i fiskalizuje račun

    Račun se fiskalizuje preko V-PFR-a Poreske uprave. Odgovor nosi PFR broj, brojač računa, verifikacioni link i PDF koji radi bez prijave.

  4. 04

    Kupac dobija račun

    Tezga ga šalje na mejl kupca ako u zahtevu stoji posaljiMejl, ili ti link iz odgovora ubaciš u svoju potvrdu o kupovini.

Šta šalješ Tezgi

Jedan POST sa API ključem u zaglavlju i porudžbinom u telu. Isti oblik koriste i sopstveni sajtovi, aplikacije i automatizacije.

Cela API dokumentacija
POST https://pos.narbiz.com/api/integrations/order?provider=custom
X-Tezga-Api-Key: tzg_…
Content-Type: application/json

{
  "externalId": "WIX-10231",
  "tok": "fiskalni",
  "nacinPlacanja": "Kartica",
  "posaljiMejl": true,
  "kupac": { "naziv": "Kupac", "email": "kupac@primer.rs" },
  "stavke": [
    { "naziv": "Keramička šolja", "kolicina": 2, "cenaSaPdv": 1290, "poreskaStopa": "20" }
  ]
}

Na šta da paziš

  • API ključ drži samo u serverskom kodu. Kod koji se izvršava u pregledaču kupca vidi svako.
  • Za externalId koristi broj Wix porudžbine. Ponovljen zahtev sa istim brojem vraća isti račun, nikad novi.
  • Svaka stavka nosi svoju poresku stopu: 20, 10 ili 0. Ako tvoja firma nije u sistemu PDV-a, Tezga ionako svaku stavku evidentira kao oslobođenu.
  • Trošak dostave pošalji kao zasebnu stavku, da zbir računa bude isti kao zbir porudžbine.

Više o API-ju za prodavnice piše u temi fiskalni API, a sve ostale veze su na strani Integracije.

Česta pitanja

Postoji li Tezga aplikacija za Wix?

Ne postoji. Wix prodavnica se sa Tezgom povezuje preko Tezginog REST API-ja: kad je porudžbina plaćena, kod ili automatizacija je pošalje Tezgi kao JSON, a Tezga izda i fiskalizuje račun.

Mogu li da povežem Wix bez programera?

Samo ako koristiš alat za automatizaciju (n8n, Make ili Zapier) koji vidi porudžbine iz tvoje Wix prodavnice i ume da pošalje HTTP zahtev. U suprotnom treba programer. Povezivanje web shopa radimo zajedno sa tobom.

Da li se broj računa upisuje nazad u Wix porudžbinu?

Ne sam od sebe. Tezga broj računa, verifikacioni link i PDF vraća u odgovoru na zahtev, a upis u porudžbinu radi tvoj kod. Automatski upis nazad postoji samo u gotovim vezama za WooCommerce i Shopify.

Wix prodavnica, fiskalni račun bez prekucavanja

Otvori nalog, napravi API ključ za Wix i pošalji prvi test račun. Ako zapneš, piši nam sa opisom prodavnice.