O decizie de creditare se bazează rar doar pe ce scrie solicitantul în formular. Majoritatea fluxurilor de decizie întreabă un birou de credit ce știe despre persoană: credite existente, istoric de plată, interogări anterioare, adesea un scor. Articolul privește integrarea cu Biroul de Credit și cu alte birouri de credit prin API din partea creditorului: ce trimiteți și ce primiți, temeiul legal, ce faceți când biroul nu răspunde, cum stocați rapoartele și cum testați totul.

Sursele publice sunt descrise ca prezentare generală, nu ca sfat juridic. Regulile de protecție a datelor și de credit pentru consumatori diferă de la o țară la alta și se schimbă în timp: verificați regulile în vigoare și contractul cu biroul înainte de a le construi într-un proces.

Ce trimite și ce primește creditorul

O interogare identifică persoana și spune de ce întrebați: date de identificare, produsul sau scopul și propria referință a cererii. Răspunsul este un raport și uneori un scor. Conținutul raportului depinde de birou. Două exemple publice arată diversitatea.

În România, nota de informare a unei bănci privind prelucrarea datelor în Sistemul Biroului de Credit (BRD, 2019) descrie Biroul de Credit ca entitatea de drept privat care administrează sistemul. Participanții sunt instituții de credit, instituții financiare nebancare, societăți de asigurare și societăți de recuperare a creanțelor care au semnat un contract de participare. Datele includ:

  • date de identificare și angajatorul;
  • produse de credit: tip, sume, stare a plăților, restanțe, zile de întârziere, data închiderii;
  • evenimente din viața unui produs, cum ar fi restructurarea, refinanțarea sau cesiunea;
  • codebitori și giranți, proceduri de insolvență și numărul de interogări.

Aceeași notă spune că biroul poate calcula pentru participanți un FICO® Score între 300 și 850 și că datele se păstrează patru ani de la actualizare.

În Germania, SCHUFA își descrie verificările de credit ca livrate în timp real și integrate în procesele clientului, cu date care vin de la parteneri pe bază de reciprocitate.

Reciprocitatea contează pentru design. O integrare are de obicei două fluxuri, nu unul: interogarea în momentul deciziei și raportarea propriilor credite și plăți către birou pe durata creditului. Echipele planifică adesea primul flux și îl uită pe al doilea.

Detaliile interfeței nu se află pe paginile publice citate aici; așteptați-le de la birou la integrarea ca participant. Țineți-le în spatele unui adaptor: logica de decizie lucrează cu propriul model de raport, iar doar adaptorul cunoaște formatul biroului. Un al doilea birou sau o versiune nouă a primului schimbă atunci o singură componentă.

Temeiul legal al interogării depinde de țară și de birou. Nota BRD de mai sus, de exemplu, întemeiază prelucrarea pe interesul legitim al participanților și al biroului. Înregistrați temeiul aplicabil la fiecare interogare.

Decizia are propriile reguli. Articolul 22 din GDPR dă unei persoane dreptul de a nu face obiectul unei decizii bazate exclusiv pe prelucrare automată, inclusiv crearea de profiluri, care produce efecte juridice sau o afectează în mod similar într-o măsură semnificativă. Permite excepții: când decizia este necesară pentru un contract, este autorizată prin lege cu garanții sau se bazează pe consimțământul explicit. Pentru cazurile contractului și consimțământului, operatorul trebuie să ofere cel puțin intervenție umană, posibilitatea de a-și exprima punctul de vedere și de a contesta decizia.

Curtea de Justiție a UE a aplicat asta scorurilor de credit. În cauza C-634/21 (SCHUFA, 7 decembrie 2023), a hotărât că scorul unui birou este o decizie individuală automatizată atunci când creditorul îi dă un rol determinant în acordarea creditului.

Noua Directivă (UE) 2023/2225 privind creditul de consum se aplică de la 20 noiembrie 2026. Considerentele ei spun că evaluarea bonității ar trebui să folosească cel puțin veniturile și cheltuielile, nu ar trebui să folosească categorii speciale de date personale sau informații din rețelele sociale și, când implică prelucrare automată, ar trebui să ofere consumatorului intervenție umană, o explicație și o reevaluare. Mai spun că creditorii ar trebui să consulte bazele de date de credit și că un consumator refuzat pe baza unei consultări ar trebui informat despre rezultat, baza de date și categoriile de date folosite.

Pentru software, asta înseamnă:

  • fiecare interogare își stochează temeiul legal și cererea căreia îi aparține;
  • decizia păstrează motivele, nu doar rezultatul;
  • fluxul are un pas de analiză umană care poate schimba rezultatul;
  • sistemul poate produce explicația și detaliile biroului pentru un solicitant refuzat.

Timeout și alternative la integrarea cu un birou de credit

Apelul către birou este o dependență externă pe calea critică a fiecărei cereri. La un moment dat va fi lent sau indisponibil, iar fluxul trebuie să spună ce se întâmplă atunci.

Nu reîncercați orbește. Nota din România enumeră numărul de interogări printre datele păstrate de birou, așa că o cerere repetată poate apărea ca a doua interogare în înregistrarea persoanei. Înregistrați interogarea înainte de apel, cu propria referință a interogării, și verificați acea înregistrare înainte să întrebați din nou. Dacă o interogare anterioară este încă în așteptare sau a expirat, biroul ar putea să o fi înregistrat deja, așa că nu o retrimiteți automat. Reconciliați-o cu biroul prin referința interogării, acolo unde biroul permite o astfel de căutare; altfel trimiteți cererea la analiză manuală.

Java
Optional<CreditInquiry> existing = inquiries.findByApplication(applicationId);
if (existing.isPresent()) {
  CreditInquiry earlier = existing.get();
  if (earlier.hasReport()) {
    return earlier.report();                     // a retry does not send a second inquiry
  }
  // pending or timed out: the bureau may have recorded it, so never resend automatically
  return reconciler.lookUp(earlier.reference())  // empty if not found or no lookup exists
      .map(body -> inquiries.complete(earlier, body))
      .orElseThrow(() -> new ManualReviewRequired(earlier.id()));
}
CreditInquiry inquiry = inquiries.save(CreditInquiry.pending(applicationId, legalBasis));
HttpRequest request = HttpRequest.newBuilder(bureauUri)
    .timeout(Duration.ofSeconds(10))             // an example value, set per bureau and product
    .POST(HttpRequest.BodyPublishers.ofString(mapper.toBureauRequest(inquiry)))
    .build();
try {
  HttpResponse<String> response = http.send(request, HttpResponse.BodyHandlers.ofString());
  return inquiries.complete(inquiry, response.body());   // the raw body is stored as received
} catch (HttpTimeoutException e) {
  inquiries.markTimedOut(inquiry);               // the bureau may still have recorded it
  throw new BureauUnavailable(inquiry.id(), e);
}

Ce se întâmplă după timeout este o decizie de business, nu una tehnică. Variantele obișnuite:

  • Verificare din nou mai târziu, cu o limită, în timp ce cererea așteaptă: reconciliați interogarea deschisă prin referința ei, acolo unde biroul permite asta, în loc să trimiteți una nouă.
  • Analiză manuală: un om decide cu datele disponibile.
  • Refuz doar dacă politica o spune. Un refuz pentru că un sistem extern a fost indisponibil îl afectează pe solicitant, așa că tratați-l ca pe o regulă aprobată de cineva, nu ca pe o valoare implicită.

Într-un flux de decizie BPMN, acesta este o activitate de serviciu cu un eveniment de frontieră timer, întrerupător, care duce la o activitate de utilizator pentru analiză. Puneți un circuit breaker în fața adaptorului, ca o indisponibilitate să trimită cererile imediat pe calea alternativă, în loc ca fiecare să-și aștepte propriul timeout.

Stocarea rapoartelor

O decizie trebuie să poată fi explicată și după luni de zile, așa că stocați pe ce s-a bazat:

  • răspunsul brut exact cum a fost primit, niciodată modificat;
  • câmpurile extrase, cu versiunea mapării care le-a produs;
  • momentul interogării, referința ei și temeiul legal;
  • o legătură de la decizie la raportul folosit.

Un raport conține date personale despre finanțele unei persoane. Limitați accesul la rolurile care au nevoie de el, înregistrați cine l-a deschis, criptați-l la stocare și țineți-l departe de logurile aplicației. Stabiliți propria perioadă de păstrare din obligațiile dumneavoastră: perioada de păstrare a biroului este a biroului, nu a dumneavoastră. Decideți și cât timp rămâne valabil un raport pentru o decizie și când trebuie fluxul să întrebe din nou.

Testarea cu un mediu de test

Dacă un birou oferă un mediu de test și persoane de test este o întrebare pentru etapa de integrare ca participant. Oricum, nu testați niciodată cu datele unor persoane reale.

Majoritatea testelor nu au nevoie deloc de birou:

  • Teste de adaptor cu răspunsuri sintetice: raport complet, nicio înregistrare găsită, istoric subțire, restanțe, mai multe potriviri posibile, răspuns malformat.
  • Teste ale fluxului de decizie cu un birou simulat care poate fi făcut lent, să eșueze sau să depășească timpul, pentru a verifica că fiecare cale alternativă este atinsă.
  • Teste de raportare pentru credite noi, plăți, restanțe, corecții și închideri.

Rulați un set mic pe mediul de test al biroului, dacă există, înainte de fiecare release care atinge adaptorul.

Cum vă putem ajuta

Construim software de creditare cu integrare cu birourile de credit: interogări către un birou de credit și rapoartele primite, acolo unde biroul oferă o interfață, păstrate în spatele unui adaptor clar, și fluxuri de decizie cu timeout și analiză umană.