1. Se emite un jeton
Din contul propriu, cu o denumire care spune pentru ce este. Valoarea se vede o singură dată, la emitere.
Modul al platformei Edilo
API pentru integrări cu celelalte programe ale primăriei
Platforma expune o interfață de programare pe care primăria o poate folosi ca să lege Edilo de programul de contabilitate, de cel de taxe și impozite sau de orice altă aplicație. Jetoanele de acces se emit și se revocă din interfață, de către primărie, fără să ne ceară nouă nimic.
- REST peste HTTPS, cu răspunsuri în format JSON
- Jetoane emise și revocate de primărie, din interfață
- Limitare 60 de cereri pe minut, per instituție
Cum se face integrarea
Cum se face o integrare
Pașii sunt aceiași fie că integrarea o face informaticianul primăriei, fie furnizorul celuilalt program.
2. Se dă jetonul celui care integrează
Furnizorului celuilalt program sau informaticianului primăriei. Jetonul poartă drepturile contului care l-a emis, nu mai multe.
3. Se citesc și se scriu datele
Prin adrese stabile, cu răspunsuri în format JSON. Fiecare apel rămâne consemnat, cu momentul și cu jetonul folosit.
4. Se revocă la final
Când integrarea se încheie sau când persoana pleacă din instituție. Revocarea este imediată și se face din aceeași interfață.
Înainte și după
Ce rezolvă, concret
Datele introduse de două ori
O dată în Edilo și o dată în programul de contabilitate. Integrarea elimină a doua introducere și, odată cu ea, diferențele dintre cele două.
Furnizorul care „nu are API”
Într-o achiziție, întrebarea despre interoperabilitate primește aici un răspuns verificabil, nu o promisiune pentru versiunea următoare.
Cerința din caietul de sarcini
Multe documentații cer explicit interfață de programare și autentificare prin jeton. Cerința este acoperită, nu negociată.
Acces care nu se mai poate opri
Jetonul se revocă din interfață, imediat, de către primărie. Nu se trimite o cerere către furnizor.
Un raport care lipsește din platformă
Datele se pot citi și prelucra în instrumentul propriu al primăriei, fără să așteptați o funcție nouă de la noi.
Teama că un jeton scurs deschide tot
Jetonul poartă exact drepturile contului care l-a emis, iar izolarea între instituții se aplică și aici: nu există jeton care să vadă altă primărie.
Ce există astăzi și ce nu există
Există interfața de programare, autentificarea prin jeton, limitarea de debit și consemnarea în jurnalul de audit. Cu ele se poate construi o integrare reală, iar primăria nu depinde de noi ca să o pornească sau ca să o oprească.
Nu există integrări gata făcute cu programe anume de contabilitate, de taxe și impozite sau de urbanism. O integrare concretă se construiește de partea celuilalt program, iar dacă aveți nevoie de una anume, ea se discută ca lucrare separată, cu termen și cost, nu ca funcție inclusă în abonament.
Nu există nici notificări trimise de noi către alte sisteme la fiecare eveniment. Un sistem care vrea să afle ce s-a schimbat interoghează, la intervalul care îi convine. Când această limitare contează pentru dumneavoastră, spuneți-ne înainte de contractare, nu după.
Nu doar întrebat, ci și anunțat
O interfață de programare obișnuită răspunde când este întrebată. Asta obligă celălalt program să întrebe des, ca să nu piardă nimic — iar dacă întreabă rar, află târziu.
Platforma poate anunța singură: la evenimentele alese, trimite un apel către adresa indicată de sistemul extern, semnat cu un secret care se poate schimba oricând. Există și o trimitere de probă, ca legătura să fie verificată înainte de punerea în funcțiune, nu la primul eveniment real.
Contează la achiziție: interoperabilitatea cerută în caiete de sarcini înseamnă, de obicei, exact asta — nu doar că datele se pot citi, ci că celălalt sistem află când s-a schimbat ceva.
Ce se poate scrie într-un caiet de sarcini
Afirmațiile pe care le putem susține în scris, într-o ofertă: interfață REST peste HTTPS; autentificare prin jeton revocabil, emis de instituție; limitare de debit per instituție; izolarea completă a datelor între instituții, inclusiv pe această interfață; consemnarea fiecărui acces în jurnalul de audit; export tabelar în format deschis.
Afirmațiile pe care nu le facem, ca să nu vă puneți într-o poziție dificilă la evaluare: nu avem integrări certificate cu sisteme naționale și nu avem conectori gata făcuți cu programe de contabilitate anume. Dacă documentația dumneavoastră cere așa ceva, este mai bine să aflăm înainte de depunerea ofertei.
Restul criteriilor pe care le întâlnim frecvent în caiete de sarcini — securitate, protecția datelor, portabilitate — sunt strânse pe pagina de ghid de achiziție.
Disponibilitate pe pachete
De la ce pachet este inclus modulul
Interfața de programare și jetoanele de acces sunt incluse din pachetul COMUNĂ. Limitarea de debit este aceeași pentru toate pachetele.
Întrebări frecvente despre modul
Despre API și integrări
Cine poate emite un jeton de acces?
Fiecare utilizator, pentru contul propriu, din pagina de cont. Jetonul poartă exact drepturile acelui cont, nu mai multe.
Ce se întâmplă dacă un jeton ajunge unde nu trebuie?
Se revocă din interfață, imediat, de către primărie. Accesul încetează din acea clipă, iar tot ce s-a făcut cu el rămâne consemnat în jurnalul de audit.
Există integrări gata făcute cu programele de contabilitate?
Nu. Există interfața cu care se poate construi una, de partea celuilalt program. O integrare anume se discută ca lucrare separată, cu termen și cost.
Câte cereri se pot face?
Șaizeci pe minut, per instituție. Limita protejează platforma pentru toate primăriile deservite și este suficientă pentru sincronizări obișnuite.
Un jeton poate ajunge la datele altei primării?
Nu. Izolarea între instituții se aplică la nivelul platformei, inclusiv pe interfața de programare, nu prin drepturi care s-ar putea configura greșit.
Platforma anunță alt sistem când se schimbă ceva?
Nu. Sistemul interesat interoghează la intervalul care îi convine. Dacă acest lucru contează pentru dumneavoastră, spuneți-ne înainte de contractare.
Este nevoie de un informatician angajat?
Pentru folosirea obișnuită a platformei, nu. Pentru o integrare cu alt program, da — fie al primăriei, fie al furnizorului celuilalt program.
Dacă nu integrez nimic, îmi pot lua totuși datele?
Da, prin export tabelar, din interfață, oricând, fără să ne cereți nouă și fără cost.
Vedeți platforma pe datele dumneavoastră
Cont demonstrativ gratuit, 14 zile, fără obligații și fără date de plată. Îl configurăm noi, cu structura primăriei dumneavoastră.