Vmesniki
Prek vmesnika (API) drugi programi govorijo neposredno s fineelikom. To potrebujete le, če želite povezati lastno programsko opremo. Ta stran razlaga nastavitev, tehnične podrobnosti so v referenci API (angleško).
Vse je pod Nastavitve, Vmesniki in spada v osnovni paket.
Dve poti za podatke
Razdelek „Dve poti za podatke“- Prevzem (pull): vaš sistem redno sprašuje fineelik po novih dogodkih in podatkih računov. Za to potrebujete ključ API.
- Webhooki: fineelik dogodke sam sporoča na naslov HTTPS. Prejemnik potem podatke računa prevzame prek API.
Ključ API
Razdelek „Ključ API“Ključ API je dostop za stroj. Ustvarijo ga administratorji.
- Ustvarite ključ. Dodelite mu ime (do 32 znakov) in izberite veljavnost: 90, 180 ali 365 dni.
- Dodelite ga svojemu podjetju. Ključ vedno deluje samo v natanko enem podjetju. Brez dodelitve velja privzeto podjetje. Za več podjetij ustvarite po en ključ.
- Takoj ga kopirajte. Prikaže se samo enkrat.
- Shranite ga v drugem sistemu.
Ključ sme samo dostavljati, brati račune in sporočati odobritev od zunaj. Sporočilo odobritve uspe samo, če je lastnik skrbnik. Ključ pripada osebi, ki ga ustvari. Če je njen račun deaktiviran, ne deluje več. Mogoče ga je kadar koli umakniti. Kaj sme, piše pod Authentication.
Z modulom Pogodbe ključ tudi preda pogodbe iz ELO in bere njihovo stanje (pravici agreements.integration_write in agreements.integration_read). Ti pravici ima samo skrbnik, zato mora ključ pripadati skrbniku.
Ustvarjanje webhooka
Razdelek „Ustvarjanje webhooka“- Kliknite Ustvari webhook.
- Vnesite naslov, začeti se mora z
https://. - Izberite dogodke in podjetje.
- Kopirajte skrivnost. Vidna je samo enkrat. Prejemnik z njo preveri podpis.
- V stranski plošči kliknite Pošlji test.
| Dogodek | Kdaj ga fineelik sporoči |
|---|---|
| Dokument sprejet | Dokument je prispel, z nalaganjem, e-pošto ali iz vodilnega sistema |
| Status spremenjen | Vsaka menjava statusa, na primer odobreno ali zavrnjeno |
| Podatki spremenjeni po pregledu | Kontiranje ali zneski so bili popravljeni, ne da bi se status spremenil |
| Obdelava ni uspela | Obdelava je po vseh poskusih spodletela |
| Pogodba: pogoji odobreni | Pogoji usklajevanja pogodbe, ki se vodi v ELO, so bili odobreni v fineeliku. |
| Pogodba: pogoji spremenjeni | Pogoji usklajevanja pogodbe, ki se vodi v ELO, so se spremenili ali čakajo na odobritev. |
| Pogodba: partner dodeljen | Partner pogodbe, ki se vodi v ELO, je bil dodeljen dobavitelju. |
| Pogodba: ključne besede spremenjene | Ključne besede pogodbe, ki se vodi v ELO, so se spremenile. |
| Pogodba: samodejnost spremenjena | Stikalo “samodejno odobri” pogodbe, ki se vodi v ELO, je bilo spremenjeno. |
Pogodbe v podatkih računa
Razdelek „Pogodbe v podatkih računa“Z modulom Pogodbe podatki računa in vsak dogodek nosijo tudi blok pogodbe: kateri pogodbi račun pripada, rezultat usklajevanja (pričakovani znesek, dejanski znesek, odstopanje in dovoljeno odstopanje) in ali bi fineelik račun samodejno odobril, skupaj z razlogi proti. Tako lahko vodilni sistem, kot je ELO, preskoči svojo odobritev, ko se vse ujema. Pri zaupnih pogodbah stroji vidijo le rezultat in ali bi bila samodejna odobritev mogoča, brez številke in brez zneskov. Posamezna polja so v referenci API.
Pogodbe iz ELO
Razdelek „Pogodbe iz ELO“Z modulom Pogodbe komponenta ELO preda pogodbe iz ELO Contract fineeliku in dobi nazaj, kar fineelik zanje vodi:
- Predaja: komponenta pošlje pogodbo z njeno oznako v ELO ob vsakem ustvarjanju in spremembi. Isto stanje znova ne spremeni ničesar, starejše stanje se ne prevzame.
- Dokument: dokument pogodbe pride posebej. Isti dokument fineelik shrani samo enkrat.
- Povratna pot: dogodki Pogodba: … zgoraj sporočajo odobritev, spremenjene pogoje, dodelitev partnerja, ključne besede in samodejno odobritev, vsak s celotnim stanjem pogodbe.
- V podatkih računa blok pogodbe pri pogodbah iz ELO nosi oznako pogodbe v ELO. Če se spremeni samo blok pogodbe že preverjenega računa, fineelik sporoči Podatki spremenjeni po pregledu.
- Če odobritev poteka zunaj fineelika, se povratno sporočilo iz ELO za vzorec samodejne odobritve šteje natanko enkrat na račun.
Podrobnosti za razvijalce so pod Contracts from ELO (v angleščini).
Če dostava ne uspe
Razdelek „Če dostava ne uspe“Seznam kaže stanje vsakega webhooka: Deluje, Začasno ustavljeno, Ne uspeva od … ali Ni dostopa.
- fineelik poskuša znova v vse daljših presledkih: po 1, 5, 15 in 60 minutah, nato vsakih 6 ur. Dogodki ostanejo.
- Prejemnik mora v 10 sekundah odgovoriti s statusom 2xx.
- Začasno ustavi ustavi dostavo, po Nadaljuj fineelik dostavi, kar je zamudil. Tudi nov naslov takoj sproži nov poskus.
- Po Obnovi skrivnost dostave spodletijo, dokler prejemnik ne pozna nove skrivnosti.
- Ni dostopa pomeni: oseba, ki je webhook ustvarila, nima več dostopa do podjetij webhooka, ne sme več videti računov ali je njen račun deaktiviran. Vrnite dostop, nato fineelik dostavi, kar je zamudil. Ali pa webhook ustvarite znova.
- Webhooke lahko ustvarja in spreminja samo administracija. Kdor sme brati nastavitve, jih vidi.
- Dnevnik dostave kaže vsako dostavo, vnosi, starejši od 30 dni, se izbrišejo.
Pomočniki UI
Razdelek „Pomočniki UI“Kartica Pomočniki UI (Claude, ChatGPT) na isti strani vklopi dostop za Claude in ChatGPT in določi, katere vloge ju smejo povezati. Več pod Pomočniki UI.
Odpiranje računov v ELO
Razdelek „Odpiranje računov v ELO“Kartica Upravljanje dokumentov na isti strani povezuje fineelik z ELO, glejte fineelik z ELO.