Interfejsi
Putem interfejsa (API) drugi programi razgovaraju direktno s fineelikom. To vam treba samo ako želite povezati vlastiti softver. Ova stranica objašnjava postavljanje, a tehničke pojedinosti nalaze se u API referenci (engleski).
Sve se nalazi pod Postavke, Interfejsi i dio je osnovnog paketa.
Dva puta za podatke
Odjeljak „Dva puta za podatke“- Preuzimanje (pull): Vaš sistem redovno pita fineelik za nove događaje i podatke računa. Za to vam treba API ključ.
- Webhookovi: fineelik sam javlja događaje na HTTPS adresu. Primalac zatim preko API-ja preuzima podatke računa.
API ključevi
Odjeljak „API ključevi“API ključ je pristup za jednu mašinu. Kreiraju ga administratori.
- Kreirajte ključ. Dajte mu naziv (do 32 znaka) i odaberite trajanje: 90, 180 ili 365 dana.
- Dodijelite ga svojoj firmi. Ključ uvijek radi samo u tačno jednoj firmi. Bez dodjele važi zadana firma. Za više firmi kreirajte po jedan ključ.
- Odmah ga kopirajte. Pojavljuje se samo jednom.
- Pohranite ga u drugom sistemu.
Ključ smije samo isporučivati dokumente, čitati račune i javljati odobrenje izvana. Povratna informacija o odobrenju uspijeva samo ako je vlasnik administrator. Ključ pripada osobi koja ga kreira. Ako se njen račun deaktivira, ključ više ne radi. Može se u svakom trenutku povući. Šta smije, piše pod Authentication.
Uz modul Ugovori ključ još predaje ugovore iz ELO-a i čita njihovo stanje (prava agreements.integration_write i agreements.integration_read). Ta prava ima samo administrator, pa ključ mora pripadati administratoru.
Kreiranje webhooka
Odjeljak „Kreiranje webhooka“- Kliknite na Kreiraj webhook.
- Unesite adresu, mora počinjati s
https://. - Odaberite događaje i firma.
- Kopirajte tajnu. Vidljiva je samo jednom. Primalac njome provjerava potpis.
- Kliknite u ladici na Pošalji test.
| Događaj | Kada ga fineelik javlja |
|---|---|
| Dokument primljen | Dokument je stigao, učitavanjem, e-poštom ili iz vodećeg sistema |
| Status promijenjen | Svaka promjena statusa, na primjer odobreno ili odbijeno |
| Podaci promijenjeni nakon provjere | Kontiranje ili iznosi su ispravljeni, a da se status ne mijenja |
| Obrada nije uspjela | Obrada nije uspjela nakon svih pokušaja |
| Ugovor: uslovi odobreni | Uslovi usklađivanja ugovora koji se vodi u ELO-u odobreni su u fineeliku. |
| Ugovor: uslovi promijenjeni | Uslovi usklađivanja ugovora koji se vodi u ELO-u su promijenjeni ili čekaju odobrenje. |
| Ugovor: partner dodijeljen | Partner ugovora koji se vodi u ELO-u dodijeljen je dobavljaču. |
| Ugovor: ključne riječi promijenjene | Ključne riječi ugovora koji se vodi u ELO-u su promijenjene. |
| Ugovor: automatika promijenjena | Prekidač “automatski odobri” ugovora koji se vodi u ELO-u je promijenjen. |
Ugovori u podacima računa
Odjeljak „Ugovori u podacima računa“Uz modul Ugovori podaci računa i svaki događaj nose i blok ugovora: kojem ugovoru račun pripada, rezultat usklađivanja (očekivani iznos, stvarni iznos, odstupanje i dozvoljeno odstupanje) i da li bi fineelik račun automatski odobrio, zajedno s razlozima protiv. Tako vodeći sistem kao što je ELO može preskočiti svoje odobrenje kada sve odgovara. Kod povjerljivih ugovora mašine vide samo rezultat i da li bi automatsko odobrenje bilo moguće, bez broja i bez iznosa. Pojedinačna polja nalaze se u API referenci.
Ugovori iz ELO-a
Odjeljak „Ugovori iz ELO-a“Uz modul Ugovori ELO komponenta predaje ugovore iz ELO Contracta fineeliku i dobija nazad ono što fineelik za njih vodi:
- Predaja: komponenta šalje ugovor s njegovom oznakom u ELO-u pri svakom kreiranju i promjeni. Isto stanje ponovo ništa ne mijenja, starije stanje se ne preuzima.
- Dokument: dokument ugovora stiže zasebno. Isti dokument fineelik čuva samo jednom.
- Povratni put: događaji Ugovor: … gore javljaju odobrenje, promijenjene uslove, dodjelu partnera, ključne riječi i automatiku, svaki s cijelim stanjem ugovora.
- U podacima računa blok ugovora kod ugovora iz ELO-a nosi oznaku ugovora u ELO-u. Ako se promijeni samo blok ugovora već provjerenog računa, fineelik javlja Podaci promijenjeni nakon provjere.
- Ako se odobrenje odvija izvan fineelika, povratna poruka iz ELO-a broji se za uzorak automatskog odobrenja tačno jednom po računu.
Pojedinosti za programere nalaze se pod Contracts from ELO (na engleskom).
Ako dostava ne uspije
Odjeljak „Ako dostava ne uspije“Lista prikazuje stanje po webhooku: Radi, Pauzirano, Ne uspijeva od … ili Nema pristupa.
- fineelik pokušava ponovo u sve dužim razmacima: nakon 1, 5, 15 i 60 minuta, zatim svakih 6 sati. Događaji ostaju sačuvani.
- Primalac mora u roku od 10 sekundi odgovoriti statusom 2xx.
- Pauziraj zaustavlja dostavu, nakon Nastavi fineelik dostavlja naknadno. I nova adresa odmah pokreće novi pokušaj.
- Nakon Obnovi tajnu dostave ne uspijevaju dok primalac ne zna novu tajnu.
- Nema pristupa znači: Osoba koja je kreirala webhook više nema pristup firmama webhooka, ne smije više vidjeti račune ili je njen račun deaktiviran. Vratite pristup, tada fineelik dostavlja naknadno. Ili webhook kreirajte ponovo.
- Webhookove kreira i mijenja samo administracija. Ko smije čitati postavke, vidi ih.
- Protokol dostave prikazuje svaku dostavu, unosi stariji od 30 dana se brišu.
AI asistenti
Odjeljak „AI asistenti“Kartica AI asistenti (Claude, ChatGPT) na istoj stranici uključuje pristup za Claude i ChatGPT i određuje koje uloge ih smiju povezati. Više pod AI asistenti.
Otvaranje računa u ELO-u
Odjeljak „Otvaranje računa u ELO-u“Kartica Upravljanje dokumentima na istoj stranici povezuje fineelik s ELO-om, vidi fineelik s ELO-om.