← Svi tekstovi

Referenca CSV formata za grupno generisanje faktura

5 min čitanja

Brzi početak

Svaki red u CSV-u predstavlja jednu fakturu. Prvi red mora biti red zaglavlja s nazivima kolona. Nazivi kolona su neosjetljivi na velika/mala slova i podržavaju nekoliko uobičajenih aliasa.

Minimalni CSV (3 fakture):

client_name,invoice_no,issue_date,item_description,item_quantity,item_price
Acme Corp,INV-001,2026-04-01,Veb dizajn,1,2500
TechStart,INV-002,2026-04-01,Konsalting,8,150
Blue Sky Ltd,INV-003,2026-04-15,Mesečni retejner,1,1800

Obavezna polja

Ova polja moraju biti prisutna i neprazna da bi red bio validan:

PoljePrihvaćeni nazivi kolona
Ime klijentaclient_name, client, to_name, company, customer
Broj faktureinvoice_no, invoice_number, inv_no, number
Datum izdavanjaissue_date, date, invoice_date
Opis stavkeitem_description, description, item_desc, service, item1_desc
Količina stavkeitem_quantity, quantity, qty, hours, item1_qty
Jedinična cenaitem_price, unit_price, rate, price, amount, item1_price

Opciona polja

PoljePrihvaćeni nazivi kolonaPodrazumevano
Rok plaćanjadue_date, payment_due
ValutacurrencyEUR
Porez stavke %item_tax, tax, vat, item1_tax0
Email klijentaemail, client_email, to_email
Adresa klijentaaddress, client_address, to_address
PDV broj klijentavat_number, client_vat, tax_id
Napomenenotes, note, memo
Uslovi plaćanjapayment_terms, terms
Popust %discount0

Fakture s više stavki

Za dodavanje više stavki jednoj fakturi, koristite numerisane sufikse kolona item1_, item2_ itd:

client_name,invoice_no,issue_date,item1_desc,item1_qty,item1_price,item2_desc,item2_qty,item2_price
Acme Corp,INV-001,2026-04-01,Faza dizajna,1,1500,Faza razvoja,20,100

Podržano je do 10 stavki po fakturi (item1_ do item10_). Svaka grupa prati isti obrazac: itemN_desc, itemN_qty, itemN_price, itemN_tax.

JSON alternativni format

Umesto CSV-a možete otpremiti .json datoteku. Format je niz objekata gde ključevi odgovaraju istim nazivima kolona kao u CSV-u:

[
  {
    "client_name": "Acme Corp",
    "invoice_no": "INV-001",
    "issue_date": "2026-04-01",
    "item1_desc": "Veb dizajn",
    "item1_qty": 1,
    "item1_price": 2500,
    "currency": "EUR"
  }
]

Format datuma

Datumi moraju biti u ISO 8601 formatu: GGGG-MM-DD (npr. 2026-04-01). Drugi formati se mogu ne parsirati konzistentno u svim pretraživačima.

Kodovi valuta

Koristite standardne ISO 4217 kodove: EUR, USD, GBP, CHF, SEK, NOK, DKK, HRK, RSD, BAM, PLN, CZK, HUF, RON. Ako je kolona currency izostavljena, koristi se EUR kao podrazumevano.

Preuzimanje uzornih predložaka

Preuzmite uzornu CSV datoteku direktno.

Napomene o mapiranju kolona

  • Nazivi kolona su neosjetljivi na velika/mala slovaClient_Name, client_name i CLIENT_NAME rade isto
  • Dodatne kolone koje se ne mapiraju ni na jedno polje fakture se tiho ignorišu
  • Ako automatsko prepoznavanje propusti kolonu, koristite Maper kolona (korak 2) da je ručno dodelite
  • Sačuvani predlošci mapiranja omogućavaju preskakanje koraka mapiranja pri sledećim otpremanjima
  • Za kompletan vodič koraka po korak pogledajte Kako generisati više faktura iz CSV-a