Preskoči na sadržaj

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.

  • 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č je pristup za jednu mašinu. Kreiraju ga administratori.

  1. Kreirajte ključ. Dajte mu naziv (do 32 znaka) i odaberite trajanje: 90, 180 ili 365 dana.
  2. 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č.
  3. Odmah ga kopirajte. Pojavljuje se samo jednom.
  4. 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.

  1. Kliknite na Kreiraj webhook.
  2. Unesite adresu, mora počinjati s https://.
  3. Odaberite događaje i firma.
  4. Kopirajte tajnu. Vidljiva je samo jednom. Primalac njome provjerava potpis.
  5. 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.

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.

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).

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.

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.

Kartica Upravljanje dokumentima na istoj stranici povezuje fineelik s ELO-om, vidi fineelik s ELO-om.