PokrećeGoSimple - agencija koja razvija Tezga eKasuPrijava
Tezga - eKasa
Registracija

Za web agencije i developere

Tvoj klijent prodaje. Porudžbina se sama fiskalizuje.

Praviš prodavnice klijentima u Srbiji? Tezga je odobren ESIR (IB 1597) sa REST API-jem i webhook-ovima. Porudžbina iz prodavnice postaje fiskalni račun preko V-PFR-a, bez uređaja kod klijenta i bez prekucavanja.

API dokumentacija OpenAPI opis

Put jedne porudžbine

  1. 01

    Prodavnica

    Porudžbina je plaćena ili dobije status koji si izabrao.

  2. 02

    Tezga API

    Prima porudžbinu i izdaje račun, jedan po porudžbini.

  3. 03

    Poreska uprava

    V-PFR fiskalizuje račun i vraća PFR broj i QR.

  4. 04

    Nazad

    Broj računa, verifikacioni link i PDF, a kupcu po želji račun mejlom.

Izaberi put za prodavnicu

Gotove veze sa prodavnicama su u paketu Biznis. Sve veze na jednom mestu, uz Wix i Gomag preko API-ja, su na strani Integracije.

Sve integracije

Tehnički minimum

POST https://pos.narbiz.com/api/integrations/order?provider=custom
X-Tezga-Api-Key: tzg_…
X-Tezga-Signature: sha256=…   (opciono, HMAC-SHA256 tela)
Content-Type: application/json
Ključ i potpis
API ključ u zaglavlju X-Tezga-Api-Key, po jedan za svaku integraciju. Telo se po želji potpisuje HMAC-SHA256 tajnom. OAuth i mTLS ne nudimo.
Bez duplih računa
Svaki zahtev nosi tvoj externalId. Isti externalId vraća postojeći račun, nikad novi.
Webhook događaji
racun.fiskalizovan, racun.greska, refundacija.izvrsena, storno.izvrsen. Telo je potpisano HMAC-om, a ako tvoj server ne odgovori, slanje se ponavlja posle 1, 5, 15, 60, 360 minuta.
Ograničenje zahteva
Podrazumevano 120 zahteva u minuti po firmi za izdavanje i 240 za čitanje. Za najavljen vrh prodaje ograničenje podižemo unapred.

Kako izgleda posao sa klijentom

Na nama su aktivacija, ispravnost fiskalizacije, dokumentacija i podrška pri integraciji. Na klijentu su nalog, uplata i bezbednosni element, a na tebi kod i odluka kad ide produkcija. Povezivanje prodavnice radimo zajedno sa tobom.

  1. 1

    Klijent otvara svoj nalog

    Račun nosi PIB firme čiji je nalog, pa svaki klijent ima svoj nalog, svoj bezbednosni element i svoju pretplatu. Jedan nalog ne izdaje račune za više firmi.

  2. 2

    Klijent sam unosi bezbednosni element

    Sertifikat, lozinku i PAK klijent unosi u Podešavanja, Fiskalizacija. Ti ih ne dobijaš i ne trebaju ti; čuvaju se šifrovani i ne napuštaju server.

  3. 3

    Klijent pravi API ključ za tvoju integraciju

    Imenovan ključ, jedan po integraciji. Klijent ga pauzira ili opoziva kad hoće, a ključ može da se veže za IP adrese tvog servera.

  4. 4

    Test na okruženju Poreske uprave

    Integraciju proveravaš na zvaničnom sandbox okruženju Poreske uprave, sa test bezbednosnim elementom. Tvoj kod se ne menja do produkcije.

  5. 5

    Prelazak na produkciju

    Zamena adrese i sertifikata u podešavanjima. API ključ i kod ostaju isti, pa nema novog razvoja.

Česta pitanja

Može li agencija da izdaje račune za više klijenata sa jednog naloga?

Ne. Fiskalni račun nosi PIB firme čiji je nalog, pa svaki klijent ima svoj nalog, svoj bezbednosni element i svoju pretplatu. Uslovi korišćenja zabranjuju izdavanje računa trećim licima preko sopstvenog naloga, osim ako je to posebno ugovoreno u pisanoj formi.

Treba li plugin za WooCommerce?

Ne treba. WooCommerce se sa Tezgom povezuje punom dvosmernom vezom bez plugina: Tezga povlači porudžbine na svakih 30 minuta i na dugme Preuzmi, a broj računa upisuje nazad u porudžbinu.

Šta se dešava kad V-PFR Poreske uprave ne odgovara?

Dokument se izda i ne gubi, a API vrati HTTP 202 sa ok:false i porukom. Tezga zatim sama ponavlja fiskalizaciju i javi ti webhook-om kad prođe. Isti externalId nikad ne pravi drugi račun, ni kad dva zahteva stignu istovremeno.

Koliko traje integracija?

Do prvog test računa obično pola radnog dana uz spremnog programera: jedan poziv za izdavanje, jedan za proveru stanja i jedan za storno. Prelazak na produkciju je promena podešavanja, ne novi razvoj.

Radiš prodavnicu za klijenta?

Ostavi kontakt i platformu. Javljamo se sa pristupom za probu i uputstvom za povezivanje.

Imaš klijenta kome treba fiskalizacija?

Piši nam sa opisom prodavnice (platforma, šta se prodaje, kako se plaća) i odgovaramo konkretno, sa primerima poziva za taj slučaj.

Piši namRegistruj firmu Probaj celu kasu