Registracija fakture - grupni unos↵
Funkcionalnost omogućava registraciju više faktura u jednom koraku, upload-om fajla specifične strukture.
Info
Ovaj dokument sadrži samo informacije specifične za ovu vrstu registracije fakture.
Za potpuno razumevanje procesa registracije fakture pogledajte opšte informacije o registraciji fakture.
Unos↵
Korisnik odabira dozvoljenu vrstu fajla i potvrđuje pritiskom na dugme Registruj fakturu.
Prilikom grupnog unosa, ukoliko postoji bilo kakva greška kompletan fajl se odbija i korisniku se prijavljuje lista grešaka za sve fakture iz fajla.
Specifikacija ulaznih fajlova↵
Ulazni fajlovi moraju da zodovolje sledeća pravila:
- Moraju biti u JSON3 ili CSV2 formatu (CSV fajl mora imati header)
- Moraju imati odgovarajuću ekstenziju (na primer, nije moguće učitati
.txt
fajl koji sadrži CSV podatke). - Mora biti u ASCII ili UTF-8 (bez BOM karaktera) enkodingu.
- Zaglavlje CSV fajla vodi računa o velikim i malim slovima (case-sensitive).
- Veličina fajla podleže ograničenjima4
- Maksimalni broj faktura: 1000
- Maksimalna veličina: 5 MB
Imena atributa fakture su na engleskom jeziku. Redosled atributa pojedinačne fakture u fajlovima nije od značaja.
Sledeći primer prikazuje unos dve fakture i jedne profakture u oba podržana formata:
JSON
[ { "DebtorCompanyNumber": "10522", "InvoiceNumber": "Racun 18/01", "IssueDate": "2018-01-12", "Amount": 10000.50, "Comments": "" }, { "DebtorCompanyNumber": "10522", "InvoiceNumber": "Racun 18/02", "IssueDate": "2018-01-13", "Amount": 1725500.00, "Comments": "Na osnovu ugovora broj 182790" }, { "DebtorCompanyNumber": "10522", "InvoiceNumber": "Profaktura 18/01", "IssueDate": "2020-01-13", "Amount": 80900.34, "Comments": "", "Lifetime": 44 } ]
CSV
DebtorCompanyNumber,InvoiceNumber,Amount,IssueDate,Comments,Lifetime 10522,Racun 18/01,10000.50,2018-01-12 10522,Racun 18/02,1725500.00,2018-01-13,Na osnovu ugovora broj 182790 10522,Profaktura 18/03,80900.34,2018-01-13,,44
Nakon obrade se prikazuje rezultat operacije u dve sekcije - sekcija sa greškama i sekcija sa listom registrovanih faktura. Prikazani rezultat moguće je sačuvati kao izveštaj u tekstulani fajl. Greške je moguće sačuvati i u dijanogstički fajl koji korisnici koji imaju problema sa unosom koje ne mogu sami da prevaziđu treba da pošalju na adresu CRF podrške.
Detalji atributa↵
Tip | Naziv engleski | Naziv srpski | Validacija | Obavezno |
---|---|---|---|---|
string | DebtorCompanyNumber | JBKJS dužnika | postojanje i tip u registru KJS | da |
string | InvoiceNumber | Broj fakture | max dužina 22, sintaksa | da |
decimal | Amount | Iznos | sintaksa | da |
datetime | IssueDate | Datum izdavanja | ISO-8601 standard 1, ne sme biti raniji od 01.03.2018. |
da |
integer | Lifetime | Rok trajanja u danima | sintaksa, min <= lifetime <= max |
ne |
string | Comments | Komentar | max dužina 150 | ne |
-
CSV mora biti formata RFC-4180: https://tools.ietf.org/html/rfc4180 (arhiva) ↩
-
JSON mora biti formata RFC-8259: https://tools.ietf.org/html/rfc8259 (arhiva) ↩
-
U slučaju da je potrebno uneti fajlove koji prevazilaze ova ograničenja, potrebno je da ih korisnik particioniše u više manjih fajlova koji zadovoljavaju zadate uslove ↩