Creștere Startup4 minute citire

Importul datelor clienților într-un SaaS B2B: cum previi dublurile și modificările greșite

Un import CSV poate crea dubluri sau suprascrie date corecte. Cum proiectezi verificarea fișierului, previzualizarea, potrivirea și raportul de rezultat.

Echipa Pentru Fondatori

Echipa Pentru Fondatori

Platforma fondatorilor din România

Laptop cu tabel gol, fișe albe și lupă pe un birou; imagine ilustrativă pentru verificarea datelor înainte de import

Un import de date într-un SaaS B2B trebuie să arate ce va crea și ce va modifica înainte ca administratorul să apese „Confirmă”. Un fișier cu contacte poate conține aceeași adresă de e-mail de două ori, coloane cu denumiri neclare ori identificatori care corespund unor înregistrări existente. Dacă aplicația scrie direct fiecare rând, clientul află prea târziu că a dublat contactele sau a înlocuit informații corecte.

Laptop cu tabel gol, fișe albe și lupă pe un birou; imagine ilustrativă pentru verificarea datelor înainte de import

Imagine editorială generată cu OpenAI; scenă ilustrativă fără date reale ale clienților.

Începe cu tipul fișierului și dreptul de acces

Precizează ce format accepți, dimensiunea maximă și codarea recomandată. Nu presupune că extensia .csv ori tipul declarat de browser garantează conținutul. Ghidul OWASP pentru încărcarea fișierelor recomandă verificarea tipului, limite de dimensiune, nume generate de aplicație și controlul permisiunilor celui care încarcă. Pentru un import B2B, verificarea trebuie să includă și organizația în care utilizatorul are dreptul să scrie. Un administrator al unui cont nu trebuie să poată alege printr-un parametru alt cont drept destinație.

Stochează fișierul temporar într-o zonă inaccesibilă publicului și stabilește când îl ștergi. Dacă raportezi erori, nu copia integral numele, adresele și numerele de telefon în jurnalul tehnic. Un identificator al importului, numărul rândului și codul erorii sunt de regulă mai utile pentru depanare. Pentru evenimentele administrative, ghidul despre jurnalul de audit explică separat ce merită consemnat fără a păstra secrete sau conținut inutil.

Arată maparea coloanelor înainte de scriere

Un fișier poate avea Companie, Firmă sau Nume client pentru același câmp din produs. Afișează potrivirea propusă și lasă utilizatorul să o corecteze. Marchează câmpurile obligatorii, coloanele ignorate și conversiile care pot schimba sensul: o dată ambiguă, un număr de telefon cu zero la început sau o valoare numerică introdusă ca text. Nu transforma în tăcere o coloană necunoscută într-un câmp existent.

Microsoft descrie în importul Dynamics 365 maparea coloanelor și examinarea înregistrărilor reușite, eșuate sau parțial importate. Acesta este un exemplu de comportament al unui produs, nu o regulă obligatorie pentru orice SaaS. Pentru propria aplicație, oferă o previzualizare cu câteva rânduri, dar și un rezumat al întregului fișier: câte rânduri sunt valide, câte au erori și câte pot actualiza date existente. O probă de cinci rânduri nu poate demonstra că restul fișierului este curat.

Stabilește explicit ce înseamnă o dublură

Potrivirea după nume este fragilă: două persoane pot avea același nume, iar aceeași companie poate apărea cu prescurtări. Pentru datele venite dintr-un sistem cunoscut, un identificator extern stabil este mai sigur decât o comparație aproximativă de text. Salesforce arată că instrumentul său de import poate potrivi contacte după ID, e-mail sau identificator extern. Alegerea metodei schimbă rezultatul, așa că trebuie afișată înainte de confirmare.

Nu lăsa aplicația să decidă singură că un contact cu același e-mail aparține aceluiași client dacă produsul permite adrese comune sau conturi separate. O regulă utilă poate include atât organizația destinatară, cât și identificatorul contactului. Pentru fiecare tip de potrivire, spune ce faci: creezi o înregistrare, actualizezi doar câmpurile selectate, o omiți sau oprești importul pentru verificare. Dacă două rânduri din același fișier indică aceeași înregistrare, arată conflictul înainte de a alege arbitrar ultimul rând.

Rezultatul trebuie să poată fi verificat și corectat

După confirmare, oferă un raport cu numărul de înregistrări create, actualizate, omise și respinse. Pentru un rând respins, indică numărul rândului, câmpul și motivul într-o formă care ajută utilizatorul să repare sursa. Microsoft descrie inclusiv exportul rândurilor eșuate pentru corectare și reluare. Dacă produsul permite reluarea, documentează cum împiedici reimportarea rândurilor deja acceptate. Altfel, un utilizator care retrimite fișierul după o eroare de rețea poate genera dubluri noi.

Nu promite un buton „Anulează” fără să definești ce poate reface. O tranzacție în baza de date poate fi anulată înainte de confirmare, însă modificările deja confirmate au nevoie de o operațiune distinctă: jurnal de schimbări, import invers sau restaurare controlată. Dacă importul declanșează e-mailuri ori sincronizări externe, revenirea în baza de date nu retrage automat acele efecte. Ghidul despre cheile de idempotență ajută la proiectarea reluărilor fără operațiuni duplicate.

Înainte să lansezi funcția, testează un fișier care conține caractere românești, coloane lipsă, valori vide, două rânduri cu același identificator și o actualizare a unei înregistrări existente. Confirmă cu un cont de test că previzualizarea și raportul final dau aceleași categorii de rezultat. Abia apoi verifică fluxul cu un client pilot și notează unde terminologia din interfață diferă de cea din fișierul său. Ghidul despre onboardingul B2B poate lega această verificare de momentul în care clientul ajunge efectiv să folosească datele importate.

Transparență AI: acest conținut poate fi redactat sau structurat cu ajutorul unor instrumente AI și este verificat editorial înainte de publicare. Imaginile generate sau modificate cu AI sunt folosite cu rol ilustrativ.

SaaS B2Bimport dateCSVdublurionboarding

Întrebări frecvente

Ce trebuie să vadă utilizatorul înainte să confirme un import?

Câmpurile potrivite, numărul de rânduri noi, actualizate sau respinse, exemple de erori și regula folosită pentru identificarea dublurilor.

Poate fi anulat orice import după confirmare?

Nu automat. O tranzacție poate fi anulată înainte de confirmarea în baza de date; după confirmare este necesar un mecanism separat de revenire sau o restaurare controlată.

Ți-a fost util acest articol? Distribuie-l:

Aplică ce ai citit — alătură-te platformei

Validează-ți ideea, construiește echipa și găsește finanțare pe Pentru Fondatori.

Creează cont gratuit