Bizko · API in webhooki

Vaš sistem. Bizkovi dokumenti. Ena varna povezava.

Povežite svoje poslovne sisteme z Bizkom. Manj ponovnega vnosa, podprti dokumenti in jasna pooblastila za podatke vašega podjetja. Povezavo uredimo po preverbi vašega poslovnega toka.

Dogovorite se za povezavo Primerjajte pakete

V ULTIMATE vključeno po potrditvi povezave.

Podprti poslovni objekti

Kaj lahko povežete

Izberite samo podatke in postopke, ki jih vaša povezava potrebuje.

Stranke brez ponovnega vnosa

Pridobite podatke svojih strank ter ustvarite ali povežite stranko iz zunanjega sistema v podprtem domačem toku.

Katalog na enem mestu

Preberite svoj katalog artiklov in storitev. Pri izdaji povežite postavke z obstoječimi artikli in njihovimi davčnimi nastavitvami.

Računi in dobropisi

Ustvarite račun za podprto zaključeno dobavo ter dobropis, vezan na izvirni račun in njegove postavke.

PDF in XML

Pridobite PDF ali generični Bizko XML dokumentov, ustvarjenih prek te povezave. E-SLOG preverite kot ločeno funkcijo.

Status dokumentov in plačil

Preverite izdajo dokumenta, poravnani znesek in odprto postavko. Plačilo temelji na dejansko povezanem bančnem prilivu.

Podpisani webhooki

Vaš sistem prejme obvestilo o pomembnih spremembah. Podpis omogoča preverbo izvora, enolični dogodek pa varno obravnavo ponovitev.

Pooblastila

Vi odločate o dostopu.

Povezavo odobri lastnik ali skrbnik podjetja. Dostop je vezan na določeno podjetje, trgovino in dogovorjeni obseg.

OAuth s PKCE omogoča odobritev povezave brez posredovanja vašega uporabniškega gesla zunanjemu sistemu. Povezavo lahko pregledate in prekličete v Bizku.

Pred aktivacijo uskladimo štiri stvari

Katere podatke in dokumente potrebuje vaš sistem.
Kdo odobri povezavo in katero podjetje uporablja.
Kateri davčni in plačilni primeri nastajajo pri vašem delu.
Kako boste prevzemali dokumente in obdelovali obvestila.

Webhooki

Sprememba v Bizku. Obvestilo v vašem sistemu.

Podpisano obvestilo vsebuje sklic na dogodek in dokument oziroma plačilo. Podrobnosti prevzamete prek svoje pooblaščene povezave.

document.issuedIzdaja računa ali dobropisa

document.cancelledStorno oziroma preklic dokumenta

document.fiscalizedEvidentirana davčna potrditev dokumenta

payment.recordedEvidentirano preverjeno plačilo

payment.cancelledPreklic evidentiranega plačila

connection.revokedPreklic povezave

Obvestilo se lahko dostavi večkrat. Vaša povezava preveri podpis in enolični dogodek, da ponovitev ne povzroči podvojenega učinka.

Obseg povezave

Najprej preverimo vaš poslovni primer.

Trenutni tok izdaje računa podpira dokončano domačo dobavo v EUR, slovenskega izdajatelja in kupca ter izdajatelja, ki je običajni DDV-zavezanec. Postavke izhajajo iz znanega kataloga; podprte stopnje DDV so 22 %, 9,5 % in 5 %, količine pa cela števila.

Plačilni tok temelji na nakazilu na TRR. Kartična in gotovinska plačila, predplačila, tujina in OSS, oprostitve, boni, delne dobave ter samostojni premiki zaloge niso del te povezave. Dostava z različnimi stopnjami DDV zahteva ločeno preverbo.

To je obseg API povezave. Druge funkcije programa Bizko ostajajo na voljo po pravicah vašega paketa.

Dobro je vedeti

Pogosta vprašanja

Kaj lahko povežem z Bizko API?

Svoj poslovni sistem lahko povežete s strankami, katalogom artiklov, podprtimi računi in dobropisi, dokumenti PDF in XML iz te povezave ter statusi dokumentov in preverjenih plačil. Obseg dostopa je vezan na potrjeno povezavo in vaše pooblastilo.

Kako odobrim dostop do svojega podjetja?

Povezavo odobri lastnik ali skrbnik podjetja prek OAuth. Dostop velja za določeno podjetje in povezavo; dovoljenja lahko pregledate, povezavo pa prekličete.

Ali XML iz API pomeni e-SLOG?

API vrne generični Bizko XML. Izvoz e-SLOG in dostava e-računov sta ločeni funkciji Bizka, zato ju preverite posebej glede na svoj postopek.

Ali webhook potrjuje, da je naročilo plačano?

Webhook obvešča o spremembi. V trenutno podprtem poslovnem toku se plačilo poveže z dejansko ujemanim bančnim prilivom; oznaka plačano v zunanjem sistemu tega ne nadomesti.

V katerem paketu sta API in webhooki?

API in webhooki so vključeni v ULTIMATE po potrditvi povezave. API je vključen tudi v Commerce Connect, zato se isti obseg ne zaračuna dvakrat. Samostojni dodatek Bizko API še ni odprt za neposredno naročilo; za preverbo povezave se obrnite na nas.

Ali lahko prek API ustvarjam ponudbe ali spreminjam zalogo?

Trenutna povezava podpira opisane račune, dobropise, stranke, branje kataloga in preverjena plačila. Ustvarjanje ponudb, samostojni premiki zaloge in zapisovanje artiklov prek te povezave niso na voljo. Obstoječe funkcije Bizka uporabljate po pravicah svojega paketa.

Naslednji korak

Povežite še spletno trgovino.

Opišite nam svoj sistem.

Povejte, katere podatke želite povezati in kako pri vas nastajata račun ter plačilo.

Pogovorimo se o povezavi Skupaj preverimo vaš poslovni primer.