Legăm sistemele care astăzi comunică prin export manual, plus interfețe proprii pentru partenerii tăi. Construite cu reîncercări, cozi vizibile și reconciliere, nu doar cu o cerere trimisă și o speranță.
Într-o companie care a crescut, fiecare sistem funcționează. Ce nu funcționează este spațiul dintre ele, iar spațiul acela este acoperit de oameni care copiază date dintr-un loc în altul.
Este muncă ce nu apare în niciun raport. Nimeni nu are în fișa postului „copiez comenzile din platformă în sistemul de facturare”, dar cineva o face în fiecare dimineață. Costă ore zilnic, produce erori pe care le descoperi peste luni și creează o dependență periculoasă de persoana care știe exact cum se face.
Cel mai des nu ai nevoie să înlocuiești niciun sistem. Ai nevoie ca ele să vorbească.
Codul care mută date dintr-un sistem în altul se scrie într-o zi. Ce ia timp și ce decide dacă integrarea rămâne stabilă sunt situațiile de mai jos, toate inevitabile.
| Ce se întâmplă | Ce cedează fără tratare | Ce facem |
|---|---|---|
| Celălalt sistem nu răspunde | Datele se pierd tăcut sau procesul tău se blochează | Reîncercare automată cu pauze crescătoare, coadă persistentă și alertă. Sistemul tău continuă să funcționeze |
| Aceeași informație ajunge de două ori | Comenzi duble, facturi duble, stoc greșit | Chei de idempotență: aceeași operație trimisă de zece ori produce un singur rezultat |
| Ambele părți modifică simultan | Una o suprascrie pe cealaltă, fără urmă | Reguli explicite despre cine deține fiecare câmp, plus detectarea conflictelor |
| Partenerul limitează traficul | Cererile sunt respinse și sincronizarea se oprește | Trimitere ritmată sub limita lor, cu coadă care se golește treptat |
| Formatul lor se schimbă | Integrarea se rupe brusc, adesea în weekend | Validare la intrare, alertă la orice câmp neașteptat, versionare acolo unde se poate |
| Datele diferă între sisteme | Descoperi la inventar sau la audit că lipsesc înregistrări | Reconciliere automată periodică, cu raport al diferențelor |
| Ceva a mers prost acum trei zile | Nimeni nu poate spune ce s-a trimis și ce s-a primit | Jurnal complet al schimburilor, căutabil, cu posibilitatea de a retrimite |
O integrare trebuie să presupună că celălalt sistem va cădea, va răspunde lent, va trimite date invalide și își va schimba formatul fără să anunțe. Toate acestea se vor întâmpla, este doar o chestiune de când. O integrare care presupune că totul merge bine funcționează impecabil în teste și te lasă fără date exact în ziua în care contează.
Platforma de vânzare cu sistemul de facturare. Gestiunea cu magazinul online. Aplicația de relații cu clienții cu formularele de pe site. Sistemul de salarizare cu evidența prezenței.
De obicei începem cu legătura care consumă cele mai multe ore de muncă manuală, pentru că acolo se recuperează investiția cel mai repede și pentru că succesul acela cumpără încrederea pentru restul.
Când partenerii, distribuitorii sau clienții tăi au nevoie de acces la date, un API bine făcut înlocuiește complet omul care exportă fișiere la cerere.
Construim cu autentificare pe chei revocabile individual, permisiuni pe fiecare cheie, limitare de trafic care protejează sistemul, versionare ca o schimbare să nu strice integrările existente, și documentație pe care un dezvoltator din afară o poate folosi fără să vă sune.
Multe sisteme, mai ales cele vechi din industrie, nu oferă nicio interfață. Se lucrează atunci cu export automat de fișiere la interval, citire dintr-o bază de date secundară, sau preluare din emailuri structurate.
Sunt soluții mai puțin elegante, dar stabile dacă sunt construite cu validare și alertare. Îți spunem clar care variantă e robustă și care e o cârjă, ca să decizi în cunoștință de cauză.
Partea fără de care restul nu contează. O integrare care eșuează silențios este mai periculoasă decât una care nu există, pentru că tu crezi în continuare că datele sunt corecte.
Alertă la orice eșec repetat, tablou cu starea fiecărei legături, reconciliere automată care compară cele două sisteme și raportează diferențele înainte să le descopere contabilul.
Este întrebarea de care depinde tot restul și cea pe care aproape nimeni nu o pune la început. Dacă adresa unui client există în trei sisteme, iar cineva o modifică în al doilea, ce se întâmplă în celelalte două?
Fără un răspuns explicit, integrarea produce haos: sistemele se suprascriu reciproc, iar după câteva luni nimeni nu mai știe care versiune este corectă. Cu un răspuns explicit, adică fiecare câmp are un singur proprietar, restul devine mecanică.
Stabilim asta în scris, câmp cu câmp, pe entitățile importante, înainte să scriem prima linie de cod. Este o discuție incomodă de o oră care previne luni de curățare a datelor.
Există aproape întotdeauna o cale: export automat de fișiere la interval, citire dintr-o bază de date secundară, sau, în ultimă instanță, automatizare peste interfața lor. Ultima variantă este fragilă, pentru că se strică la orice schimbare de ecran, și ți-o propunem doar când chiar nu există alta, spunându-ți clar ce risc îți asumi.
Între două și șase săptămâni pentru o legătură între două sisteme, în funcție de cât de bine este documentată interfața celuilalt și de câte cazuri speciale are procesul tău. Documentația proastă sau inexistentă a partenerului este cel mai frecvent motiv de întârziere, și nu depinde de noi.
Este întrebarea corectă, și tratarea ei este jumătate din lucrare. Cererile eșuate se reîncearcă automat, cu pauze crescătoare. Ce nu trece intră într-o coadă vizibilă, nu dispare. Tu primești alertă, iar sistemul tău continuă să funcționeze în loc să se blocheze pentru că altcineva are o problemă.
Da, și este adesea mai valoros decât pare. Un API bine făcut înseamnă că partenerii se integrează singuri, fără ca cineva de la voi să exporte manual fișiere. Îl construim cu autentificare pe chei revocabile, limitare de trafic, versionare și documentație pe care un dezvoltator din afară o poate folosi fără să vă sune.
Prin reconciliere automată, nu prin încredere. Comparăm periodic ce există în cele două sisteme și raportăm diferențele. Fără acest pas, o integrare poate pierde tăcut înregistrări luni de zile, iar asta se descoperă de obicei la inventar sau la audit, adică în cel mai prost moment.
Răspunsul la întrebarea asta este de obicei și lista integrărilor care merită făcute, în ordinea corectă.