Banka

Bančne izpiske v obliki camt.053 lahko v Quibi nalagate samodejno iz svojega programa, pregledate uvožene izpiske in povezave vrstic na dokumente.

Za vse klice potrebuje uporabnik pravico Banka in podjetje naročnino na modul Banka. Brez tega API vrne HTTP 403. Prijava, oblika odgovora in splošna pravila so opisani v navodilih za razvijalce.

Metoda: GET URL: /api2/transakcijskiracuni

Za vsak račun vrne id, naziv, trr (IBAN), swift, default (privzeti račun) in konto (konto v glavni knjigi).

Seznama za uvoz ne potrebujete, saj Quibi račun določi po IBAN-u iz izpiska. Koristen je, če želite izpiske filtrirati po računu.

Metoda: GET URL: /api2/bancniizpiski

Parametri (v naslovu, vsi neobvezni):

• transakcijskiracuni_id – samo izpiski tega računa
• zakljucen – 0 (odprti) ali 1 (zaključeni)
• datod, datdo – datum izpiska v obliki Y-m-d
• limit – število izpiskov na stran (privzeto 100, največ 500)
• po – nadaljevanje seznama: vrednost naslednji_po iz prejšnjega odgovora

Izpiski so razvrščeni po id naraščajoče. Ko je naslednji_po null, ste prebrali vse.

{
   "error":false,
   "message":"",
   "data":{
      "Bancniizpiski":[
         {"Bancniizpiski":{"id":"16731","transakcijskiracuni_id":"1","zapst":"9001","datum":"2026-11-13","iban":"SI56610000006637087","zacetnostanje":"1000.00","koncnoostanje":"1029.70","stprilivov":"2","vrednostprilivov":"32.20","stodlivov":"1","vrednostodlivov":"2.50","zakljucen":false,"created":"2026-11-13 15:14:07","modified":"2026-11-13 15:14:07"}}
      ],
      "naslednji_po":null
   }
}

• zapst – številka izpiska iz banke
• zacetnostanje, koncnoostanje – stanje na začetku in koncu izpiska
• stprilivov, vrednostprilivov, stodlivov, vrednostodlivov – število in vsota prilivov oziroma odlivov
• zakljucen – ali je izpisek zaključen (plačila so vnesena na dokumente)

Metoda: POST URL: /api2/bancniizpiski/uvoz

Uvozi izpisek camt.053 v obliki XML ali ZIP z več datotekami XML, enako kot »Vnesi nov bančni izpisek« v programu.

Datoteko pošljite na enega od načinov:

• multipart/form-data – datoteka v polju datoteka (ali data[Bancniizpiski][datoteka]), neobvezno polje transakcijskiracuni_id
• JSON (Content-Type: application/json):

{"Bancniizpiski": {"transakcijskiracuni_id": 1, "ime": "izpisek.xml", "datoteka_base64": "PD94bWwgdmVyc2lvbj0iMS4wIi..."}}

ime določa, ali gre za ZIP (končnica .zip); ZIP Quibi prepozna tudi po vsebini. Največja velikost pri base64 je 20 MB.

Transakcijski račun: transakcijskiracuni_id ni obvezen. Brez njega Quibi poišče račun z IBAN-om iz izpiska (Stmt/Acct/Id/IBAN). Presledki in drugi znaki se ne upoštevajo, IBAN pa mora biti na koncu zapisa računa v Quibiju. Če IBAN-a ni med računi podjetja ali je pri več računih, če je v datoteki več različnih IBAN-ov ali če datoteka IBAN-a nima, API vrne HTTP 400. Takrat podajte transakcijskiracuni_id oziroma izpiske uvozite ločeno. Podan račun se uporabi kot v programu; če IBAN v izpisku ne ustreza računu, je to navedeno v opozorila.

Uspešen odgovor:

{"error":false,"message":"","errors":[],"data":{"transakcijskiracuni_id":1,"shranjeno":1,"ids":[16731],"napake":[],"opozorila":[]}}

• ids – id-ji uvoženih izpiskov (za /api2/bancniizpiski/view/ID)
• napake – izpiski, ki niso bili uvoženi (npr. že uvoženi ali neveljavni XML v ZIP-u)
• opozorila – vrstice, ki so bile že uvožene v drugem izpisku (npr. dnevni in mesečni izpisek). Takšna vrstica se ob zaključku ne upošteva drugič.

Če ni uvožen noben izpisek, API vrne HTTP 400 in "error": true; razlog je v errors. Izpisek z isto številko, datumom in računom se ne uvozi dvakrat (»Bančni izpisek je že vnesen.«), zato je ponovitev po prekinitvi povezave varna.

Ob uvozu Quibi prilive samodejno poveže z odprtimi računi in predračuni po sklicu, odlive pa s prejetimi računi po referenci prejemnika. Povezave preberete s klicem podrobnosti izpiska.

Metoda: GET URL: /api2/bancniizpiski/view/ID_IZPISKA

Vrne Bancniizpiski (ista polja kot seznam) in Postavkevancniizpiski – vse vrstice izpiska:

• id, tip (CRDT – priliv, DBIT – odliv), datumknjizenja, znesek, valuta, bancnakoda
• referenca – sklic (npr. SI00 2026-00001), bancnareferenca – referenca banke, namen
• iban, partner, naslov – plačnik oziroma prejemnik
• podvojenapostavka_id, izvirnik_bancniizpiski_id – če je vrstica že uvožena v drugem izpisku: izvirna vrstica in njen izpisek
• Povezave – dokumenti, na katere je vrstica povezana:
  • model – Glavadokumenta (izdan dokument) ali Stroski (prejeti račun), model_id – id dokumenta
  • glava_id, ZapSt, ordernumber – vrsta, številka in »Št. naročila« dokumenta
  • znesekdokumenta – znesek dokumenta, znesek – del vrstice, povezan na ta dokument
  • vneseno – ali je plačilo že vneseno na dokument (po zaključku izpiska)

{
   "id":"108420","tip":"CRDT","datumknjizenja":"2026-11-13","znesek":"12.20","valuta":"EUR","referenca":"SI001-755-2026","namen":"Placilo racuna 755-2026","partner":"EKVIVAL D.O.O.",
   "podvojenapostavka_id":null,"izvirnik_bancniizpiski_id":null,
   "Povezave":[{"id":43325,"model":"Glavadokumenta","model_id":2212053,"stranka_id":4212,"glava_id":1,"ZapSt":"755-2026","ordernumber":null,"znesekdokumenta":"12.20","znesek":"12.20","vneseno":false}]
}

Izpisek drugega podjetja ali neobstoječ izpisek vrne HTTP 404.

Metoda: POST URL: /api2/bancniizpiski/povezi

Naredi isto kot povezovanje dokumenta pri vrstici izpiska v programu.

{"Povezava": {"postavka_id": 108421, "model": "Glavadokumenta", "model_id": 2212052}}

• postavka_id* – id vrstice izpiska (Postavkevancniizpiski[].id iz podrobnosti izpiska)
• model* – Glavadokumenta (izdan račun, predračun, dobropis …) ali Stroski (prejeti račun)
• model_id* – id dokumenta

Povezan znesek je manjši od še nepovezanega dela vrstice in odprtega zneska dokumenta. Dobropis lahko povežete samo na priliv. Poveže se z negativnim zneskom in poveča znesek, ki je na voljo za račune na isti vrstici.

{"error":false,"message":"","data":{"obstaja":false,"Povezava":{"id":"47550","postavkevancniizpiski_id":"108421","stranka_id":"4137","model":"Glavadokumenta","model_id":"2212052","znesek":"12.20","vneseno":false}}}

Ponovljen klic za isto vrstico in dokument ne ustvari nove povezave, ampak vrne obstoječo z "obstaja": true. Ponovitev po prekinitvi povezave je zato varna.

Napake: 400 – manjkajoči ali napačni parametri ali dobropis na odlivu; 404 – vrstice ali dokumenta ni med podatki podjetja; 409 – izpisek je zaključen, vrstica je dvojnik vrstice iz drugega izpiska (povežite izvirno vrstico) ali je dobropis že porabljen.

Če plačilo spletnega naročila nosi sklic naročila (npr. SI00 2026-00001), ga Quibi ne more povezati sam. Številka spletnega naročila je v Quibiju v polju »Št. naročila« (ordernumber), zato:

1. V podrobnostih izpiska poiščite vrstico in iz referenca preberite številko naročila.
2. Poiščite račun: POST /api2/fakture z {"Filtriraj": {"ordernumber": "2026-00001"}}. Najde račun s to številko in račun, izdelan iz naročila kupca s to številko. Prek naročila lahko greste tudi tako: POST /api2/narocilakupcev z istim filtrom, nato v GET /api2/glavadokumenta/view/ID_NAROCILA v IzdelaniDokumenti poiščite račun (glava_id: 1).
3. Povežite vrstico z računom (/api2/bancniizpiski/povezi).
4. Ko so povezane vse vrstice, zaključite izpisek.

Glejte tudi Seznam dokumentov.

Metoda: POST URL: /api2/bancniizpiski/odvezi/ID_POVEZAVE

ID_POVEZAVE je Povezave[].id iz podrobnosti izpiska. Povezave na zaključenem izpisku ali z že vnesenim plačilom ni mogoče odstraniti (HTTP 409).

Metoda: POST URL: /api2/bancniizpiski/zakljuci/ID_IZPISKA

Naredi isto kot »Zaključi« v programu. Na povezane dokumente vnese plačila (način plačila »Bančno nakazilo«, porabljen dobropis kot »Dobropis«) z datumom izpiska in izpisek zaključi. Vrstice, ki so dvojniki vrstic iz drugega izpiska, se ne upoštevajo. Znesek plačila določa nastavitev podjetja »Pri zaključku vnesi dejanska plačila (znesek postavke)«: brez nje se vnese povezan znesek, z njo pa dejanski znesek priliva, preplačilo pa na zadnji povezani dokument.

{"error":false,"message":"Uspešno ste vnesli plačila in zaključili dokument. Vnesenih plačil: 2.","data":{"id":16731,"zakljucen":true,"ze_zakljucen":false,"vneseno":2,"popravljeno":0,"prerazporejeno":0,"preplacil":0}}

• vneseno – število vnesenih plačil
• popravljeno – plačila, ki so bila zmanjšana ali izpuščena, ker je bil dokument že (delno) plačan
• prerazporejeno – prerazporejeni dobropisi
• preplacil – vnesena preplačila

Ponovljen klic na zaključen izpisek ne vnese ničesar in vrne "ze_zakljucen": true. Ponovitev je varna tudi pri hkratnih klicih, ker Quibi izpisek med zaključevanjem zaklene. Odklepanje izpiska prek API ni mogoče; izpisek odklenete v programu.