API tehnička dokumentacija
https://swagger-kanc.paragraf.rs/
Testiranje se obavlja na test serveru kompanije Paragraf i demo verziji Sistema Elektronskih Faktura.
Kancelarko API: modul e-Fakture
Na ovoj strani dobićete neophodne informacije za povezivanje Vašeg računovodstvenog ili drugog (ERP) programa sa Kancelarkom. Ukoliko se korisnik računovodstvenog programa link do ove stranice možete proslediti svom dobavljaču programa kako biste sugerisali povezivanje sa Kancelarkom.
Prednosti integracije Vašeg programa sa Kancelarkom putem API:
- Slanje/prijem na državni Sistem elektronskih faktura (SEF)
- Ugrađene callback funkcije sistema elektronskih faktura - izveštavanje o promeni statusa kod poslatih/primljenih dokumenata, za koje je neophodno da postoji javna IP adresa po subjektu (da bi desktop knjigovodstveni programi ugradili ovo direktno, svaki korisnik mora imati javno izloženu IP adresu i HTTP server)
- Tehnička i korisnička podrška krajnjim korisnicima vezana za sva pitanja vezano za e-Fakture
- Stalno usklađivanje sa API-jem - posle prvog povezivanja sa Kancelarko API, računovodstveni program ne bi trebalo da ima u budućnosti veće programerske zahteve. Kancelarko će se usklađivati sa SEF i podatke pakovati i prepakovati prema zahtevima SEF
- Informacioni posrednik: Paragraf je već predao zahtev da postane Informacioni Posrednik. Povezivanje direktno na SEF API neće dati mogućnost PDV prijave, dok će preko Kancelarka (odnosno informacionog posrednika) ovo biti moguće
- Slanje i van sistema elektronskih faktura. Slanje primaocima koji nisu u obavezi da koriste SEF
- Slanje na više email adresa - više primalaca
- Pojednostavljeno slanje metapodataka o dokumentima - JSON format
- Validacija strukture i šeme XML UBL 2.1 dokumenta
- Validacija SEF
- Masovno slanje XML fajlova u slučaju da korisnik fajlove uvozi iz drugog programa (podrazumeva se da ti fajlovi moraju biti urađeni po UBL 2.1 standardu i prema tehničkoj specifikaciji Ministarstva finansija
- Čuvanje faktura: Kancelarko će čuvati kopije faktura, a takođe je u planu da, u ulozi informacionog posrednika, nudi i čuvanje originalnih faktura na serveru u Srbiji
- Kancelarko će slati fakture i email-om (za primaoce koji nisu korisnici SEF). To dalje znači da ako računovodstveni program samo gleda SEF, neće imati celu sliku svih poslatih faktura, a ako gleda Kancelarka, imaće kompletnu sliku svih poslatih i primljenih faktura
Mogućnost integracije preko učitavanja fajlova
- Potrebno je u paru poslati JSON i PDF fajl fakture
- Potrebno je da oba fajla imaju isti naziv sa razlicitim ekstenzijama
- Na osnovu podataka iz JSON Kancelarko fajla se pravi faktura na Kancelarku
- Slanje na SEF je opciono, takodje je opciono i slanje na CRF
Primere JSON fajlova možete preuzeti OVDE
U svakom folderu postoji jsonc fajl u kome se nalaze komentari koji bliže objašnjavaju polja u JSON fajlu.
Formular za prijavu za integraciju
Popunite formular kako biste dobili General token koji je neophodan da bi se krenulo u realizaciju integracije.