Kratak odgovor
Web shop se na kasu vezuje API ključem: porudžbina iz shopa sama postane fiskalni račun, kupac dobije link sa QR kodom, a refundacija se okida pravo iz shopa. Tezga eKasa ima gotovu vezu za WooCommerce i otvoren API za sve ostalo, i radi dvosmerno: i izdavanje i statusi i povraćaji.
Najskuplji zaposleni u mnogim malim web shopovima je osoba koja prekucava porudžbine u kasu. Shop primi porudžbinu, neko je ujutru pročita, otkuca račun, pa ga pošalje kupcu. Svaki korak je prilika za grešku, a nijedan ne dodaje vrednost.
To prekucavanje je tačno ono što API veza ukida. Evo kako izgleda kad se uradi kako treba.
Porudžbina koja sama postane račun
Veza je pojmovno prosta: shop pri svakoj plaćenoj porudžbini pozove kasu sa stavkama, iznosom i podacima kupca, kasa izda fiskalni račun na Poreskoj i vrati javni link ka računu. Kupac dobije mejl sa računom i QR kodom za proveru, isti kao na kasi u radnji. Za WooCommerce je veza gotova, za custom shopove i ERP-ove postoji API dokumentovan po OpenAPI 3.1 standardu.
Tri detalja odvajaju ozbiljnu integraciju od demo snimka:
Noćne porudžbine. Kupci poručuju u 23:40, a niko ne sedi kraj kase. Fiskalizacija zato mora da radi bez čoveka: porudžbina stigne, račun se izda, gotovo. Ujutru vas čeka izveštaj, ne posao.
Duplikati. Mreža zna da pukne baš posle poslatog zahteva, pa shop pošalje isti zahtev ponovo. Kasa mora da prepozna isti eksterni broj porudžbine i vrati postojeći račun umesto da izda drugi. To se zove idempotencija i bez nje dvostruki računi nisu pitanje „da li”, nego „kada”.
Povraćaji. Online kupac ima pravo na odustanak, pa su refundacije svakodnevica. Kroz Tezgin API refundacija se okida pravo iz shopa ili CRM-a, puna ili delimična po stavkama, vezana za PFR broj originalnog računa, kako zakon traži.
Dvosmerno ili nikako
Veza koja samo gura porudžbine u kasu je pola posla. U suprotnom smeru idu statusi: kad je račun fiskalizovan, kad je stigla uplata, kad je prošla refundacija, shop i CRM to saznaju webhook obaveštenjem, potpisanim i sa ponavljanjem isporuke. Time web shop, kasa i knjigovodstvo prestanu da budu tri odvojene istine o istoj prodaji; kako taj komplet izgleda za knjigovođu, pisao sam u tekstu o kasi i knjigovođi.
Ako naplaćujete virmanski, predračun sa IPS QR kodom i automatsko izdavanje računa po uplati zatvaraju isti krug za uslužne firme, o čemu sam pisao u tekstu o automatskoj fiskalizaciji. A pun spisak svih integracija stoji u vodiču na Treku.
Pitanja i odgovori
Da li web shop u Srbiji mora da izdaje fiskalne račune?
Mora, online prodaja robe građanima se fiskalizuje kao i prodaja u radnji, kroz odobren ESIR. Račun se kupcu dostavlja elektronski, linkom ili mejlom, sa QR kodom za proveru na sajtu Poreske uprave.
Kako se WooCommerce povezuje sa kasom?
API ključem iz podešavanja: shop pri porudžbini pozove Tezgu, ona izda račun i vrati link. Veza je dvosmerna, statusi i refundacije se vraćaju u shop, a noćne porudžbine prolaze bez čoveka.
Šta ako kupac vrati robu poručenu online?
Iz shopa ili CRM-a se okine refundacija kroz API: puna ili po stavkama, vezana za PFR broj originalnog računa. Ponovljeni zahtev ne pravi duplu refundaciju, jer API garantuje idempotenciju.
