Sučelja
Putem sučelja (API) drugi programi razgovaraju izravno s fineelikom. To vam treba samo ako želite povezati vlastiti softver. Ova stranica objašnjava postavljanje, tehničke pojedinosti nalaze se u API referenci (na engleskom).
Sve se nalazi pod Postavke, Sučelja i pripada osnovnom paketu.
Dva puta za podatke
Odjeljak „Dva puta za podatke“- Preuzimanje (pull): Vaš sustav redovito 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. Primatelj zatim preuzima podatke računa putem API-ja.
API ključ
Odjeljak „API ključ“API ključ je pristup za stroj. Izrađuju ga administratori.
- Izradite ključ. Dodijelite mu naziv (do 32 znaka) i odaberite trajanje: 90, 180 ili 365 dana.
- Dodijelite ga svojoj tvrtki. Ključ uvijek radi u točno jednoj tvrtki. Bez dodjele vrijedi zadana tvrtka. Za više tvrtki izradite po jedan ključ.
- Odmah ga kopirajte. Prikazuje se samo jednom.
- Pohranite ga u drugom sustavu.
Ključ smije samo isporučivati dokumente, čitati račune i javljati odobrenje izvana. Javljanje odobrenja uspijeva samo ako je vlasnik administrator. Ključ pripada osobi koja ga izrađuje. Ako se njezin korisnički račun deaktivira, ključ više ne radi. Može se u svakom trenutku povući. Što smije, stoji 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.
Izrada webhooka
Odjeljak „Izrada webhooka“- Kliknite Izradi webhook.
- Upišite adresu, mora počinjati s
https://. - Odaberite događaje i tvrtku.
- Kopirajte tajnu. Vidljiva je samo jednom. Primatelj njome provjerava potpis.
- U bočnoj ploči kliknite Pošalji test.
| Događaj | Kada ga fineelik javlja |
|---|---|
| Dokument primljen | Dokument je stigao, učitavanjem, e-poštom ili iz vodećeg sustava |
| Status promijenjen | Svaka promjena statusa, na primjer odobreno ili odbijeno |
| Podaci promijenjeni nakon provjere | Kontiranje ili iznosi ispravljeni su, a status se nije promijenio |
| Obrada nije uspjela | Obrada nije uspjela nakon svih pokušaja |
| Ugovor: uvjeti odobreni | Uvjeti usklađivanja ugovora koji se vodi u ELO-u odobreni su u fineeliku. |
| Ugovor: uvjeti promijenjeni | Uvjeti usklađivanja ugovora koji se vodi u ELO-u promijenjeni su 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 promijenjene su. |
| Ugovor: automatika promijenjena | Prekidač “automatski odobri” ugovora koji se vodi u ELO-u promijenjen je. |
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 dopušteno odstupanje) i bi li fineelik račun automatski odobrio, zajedno s razlozima protiv. Tako vodeći sustav kao što je ELO može preskočiti svoje odobrenje kada sve odgovara. Kod povjerljivih ugovora strojevi vide samo rezultat i bi li 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 dobiva natrag ono što fineelik za njih održava:
- Predaja: komponenta šalje ugovor s njegovom oznakom u ELO-u pri svakoj izradi i promjeni. Isto stanje ponovno ništa ne mijenja, starije stanje se ne preuzima.
- Dokument: dokument ugovora stiže zasebno. Isti dokument fineelik sprema samo jednom.
- Povratni put: događaji Ugovor: … gore javljaju odobrenje, promijenjene uvjete, 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 toč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“Popis prikazuje stanje svakog webhooka: Radi, Pauzirano, Ne uspijeva od … ili Nema pristupa.
- fineelik pokušava ponovno u sve duljim razmacima: nakon 1, 5, 15 i 60 minuta, zatim svakih 6 sati. Događaji se čuvaju.
- Primatelj 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 primatelj ne zna novu tajnu.
- Nema pristupa znači: osoba koja je izradila webhook više nema pristup tvrtkama webhooka, više ne smije vidjeti račune ili je njezin korisnički račun deaktiviran. Vratite pristup, tada fineelik dostavlja naknadno. Ili ponovno izradite webhook.
- Webhookove izrađuje i mijenja samo administracija. Tko smije čitati postavke, vidi ih.
- Zapisnik dostave prikazuje svaku dostavu, unosi stariji od 30 dana se brišu.
UI asistenti
Odjeljak „UI asistenti“Kartica UI asistenti (Claude, ChatGPT) na istoj stranici uključuje pristup za Claude i ChatGPT i određuje koje ih uloge smiju povezati. Više pod UI 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.