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 ↩