Jak migrować bazę klientów przy wdrożeniu KSeF

Migracja bazy klientów przy wdrożeniu KSeF nie polega tylko na wgraniu arkusza do nowego narzędzia. Najpierw trzeba ustalić, które rekordy są klientami, które dostawcami, które są duplikatami, a które mają błędny NIP, nieaktualną nazwę albo adres wpisany w kilku wariantach.

KSeF pracuje na fakturach ustrukturyzowanych w XML zgodnych ze strukturą FA(3). Ta struktura zawiera dane podmiotów występujących na fakturze, więc jakość kartoteki kontrahentów wpływa na wystawianie faktur, wyszukiwanie dokumentów, raporty i późniejsze wyjaśnianie błędów.

W KSeFGPT bazę kontrahentów można zasilić masowo z pliku Excel lub CSV, dodać rekordy ręcznie oraz przenieść klientów przez integrację, na przykład z Fakturownia.pl. Najbezpieczniejszy proces to: audyt starej bazy, mapowanie pól, próbny import, deduplikacja, kontrola kilku faktur testowych i dopiero potem praca produkcyjna.

Oficjalne materiały Ministerstwa Finansów opisują KSeF jako system służący m.in. do wystawiania, przesyłania, otrzymywania, dostępu i przechowywania faktur ustrukturyzowanych. To oznacza, że po starcie obowiązkowego KSeF dane kontrahentów przestają być tylko wygodną kartoteką sprzedaży. Stają się podstawą codziennego obiegu dokumentów.

Od 1 lutego 2026 r. obowiązek wystawiania faktur w KSeF objął największych podatników, u których wartość sprzedaży z podatkiem przekroczyła w 2024 r. 200 mln zł. Od 1 kwietnia 2026 r. objął pozostałych podatników, z czasowym wyjątkiem dla podatników, których miesięczna sprzedaż dokumentowana fakturami nie przekracza 10 000 zł brutto do końca 2026 r. Otrzymywanie faktur przez KSeF jest obowiązkowe od 1 lutego 2026 r.

W praktyce problem z bazą klientów ujawnia się bardzo szybko. Jeśli ta sama firma ma trzy rekordy, różne nazwy i raz NIP z myślnikami, a raz bez, zespół zaczyna wybierać kontrahenta na wyczucie. Przy pojedynczej fakturze to drobna niedogodność. Przy setkach dokumentów miesięcznie to źródło błędów i korekt.

Baza klientów przed KSeF powinna zostać potraktowana jak dane produkcyjne, nie jak pomocnicza lista kontaktów. Jeśli rekord jest błędny, niekompletny albo zdublowany, problem wróci przy wystawianiu faktury, odbiorze dokumentów i analizie historii współpracy.

Najbezpieczniejsza migracja zaczyna się od wyboru źródła prawdy dla pól: NIP, nazwa, adres, kraj, rola, status jakości danych i identyfikator ze starego systemu. Dopiero potem warto importować dane do KSeFGPT albo innego narzędzia.

KSeFGPT skraca techniczną część migracji, bo obsługuje import kontrahentów z Excela i CSV oraz integrację z Fakturownia.pl. Nadal jednak warto zrobić import próbny, sprawdzić kilka faktur testowych i ustalić, kto po starcie odpowiada za duplikaty.

Pierwszy krok to nie import. Najpierw trzeba wypisać, gdzie dziś żyją dane klientów i kontrahentów. W małej firmie może to być jeden arkusz i program do faktur. W większej organizacji będzie to CRM, ERP, program magazynowy, sklep internetowy, arkusze handlowców, eksporty dla biura rachunkowego i lista klientów z Fakturownia.pl.

Dopiero po takim spisie widać, które źródło ma być nadrzędne. Jeśli CRM ma aktualne osoby kontaktowe, ale program do faktur ma poprawne NIP-y i adresy, nie warto ślepo przenosić jednego pliku. Lepiej ustalić, które pola pochodzą z którego systemu.

W tym momencie warto też oddzielić klientów od szerszej bazy kontrahentów. KSeF dotyczy faktur, więc w docelowej bazie pojawią się nabywcy, dostawcy, podmioty dodatkowe, jednostki wewnętrzne i rekordy techniczne. Nie każdy kontrahent jest klientem sprzedażowym.

Migracja będzie trudna, jeśli każdy system opisuje klienta inaczej. Dlatego przed importem warto zdefiniować minimalny model rekordu. Nie chodzi o idealny CRM, tylko o taki zestaw pól, który pozwala poprawnie wystawić fakturę, rozpoznać kontrahenta i połączyć go z historią.

Dla polskich firm podstawowym punktem dopasowania jest zwykle NIP. Nie powinien być jednak jedyną kontrolą, bo w starej bazie mogą wystąpić literówki, cudze numery, rekordy testowe albo kilka oddziałów opisanych jednym numerem. Dlatego obok NIP-u warto zachować nazwę, adres, kraj, status jakości danych i identyfikator ze starego systemu.

Oficjalna struktura FA(3) obejmuje dane podmiotów występujących na fakturze, w tym sprzedawcę, nabywcę i podmioty dodatkowe. To dobry argument, żeby w bazie trzymać role, a nie tylko etykietę klient. Ten sam podmiot może być klientem, dostawcą albo partnerem w różnych procesach.

Największy błąd migracyjny to przeniesienie całego bałaganu do nowego narzędzia i nazwanie tego wdrożeniem. Przed importem trzeba znaleźć rekordy bez NIP-u, z NIP-em wpisanym jako tekst z separatorami, z pustą nazwą, z adresem w jednej komórce i z duplikatami tej samej firmy.

Czyszczenie nie musi oznaczać ręcznego poprawiania każdej linijki. Wystarczy podzielić dane na trzy grupy: gotowe do importu, wymagające poprawy i archiwalne. Rekord archiwalny nie musi blokować migracji, ale nie powinien wyskoczyć zespołowi jako pierwszy wybór przy wystawianiu faktury.

Osobno potraktuj klientów jednorazowych. Jeśli firma wystawiła komuś fakturę pięć lat temu i od tamtej pory nie było relacji, taki rekord może zostać przeniesiony jako historyczny albo pominięty z aktywnej kartoteki. Ważne, żeby decyzja była świadoma.

Dobra ścieżka migracji zależy od tego, gdzie dziś firma trzyma klientów. Jeśli baza jest w arkuszu, najprostszy będzie import z Excela albo CSV. Jeśli faktury i klienci są w Fakturownia.pl, lepsza będzie integracja. Jeśli dane siedzą w ERP, warto rozważyć eksport z jasnym mapowaniem pól lub integrację po stronie systemu źródłowego.

Nie ma sensu automatyzować wszystkiego od pierwszego dnia. Często najlepszy proces wygląda tak: najpierw jednorazowy import i czyszczenie, potem kilka tygodni pracy na nowej bazie, a dopiero później integracje cykliczne. Dzięki temu firma widzi, które pola są realnie potrzebne, a które były tylko historycznym nadmiarem.

Przy każdym wariancie zaplanuj import próbny. Weź mały zestaw reprezentatywnych rekordów: aktywnych klientów, dostawców, firmy zagraniczne, duplikaty, stare rekordy i kontrahentów z nietypowym adresem. Jeśli próbka przejdzie dobrze, pełna migracja będzie dużo spokojniejsza.

W module Kontrahenci KSeFGPT bazę można zasilić na kilka sposobów. Przy migracji najważniejsze są dwa: masowy import kontrahentów z pliku Excel lub CSV oraz integracje, na przykład z Fakturownia.pl. To pozwala przenieść istniejącą kartotekę bez przepisywania danych ręcznie.

Import z Excela lub CSV jest dobrym wyborem, gdy masz eksport ze starego programu, arkusz od księgowości albo listę klientów przygotowaną przez sprzedaż. Po imporcie warto sprawdzić, czy NIP, nazwa, adres, kraj i pola pomocnicze trafiły w odpowiednie miejsca.

Integracja z Fakturownia.pl jest wygodna, gdy codzienne wystawianie dokumentów odbywa się właśnie tam. KSeFGPT jest zintegrowany z Fakturownia.pl i może pomóc przenieść faktury z przychodów i wydatków oraz łatwo zaimportować klientów do kontrahentów w KSeFGPT. Po migracji faktury i dane kontrahentów można kontrolować centralnie pod kątem statusów, kompletności i gotowości do pracy z KSeF.

Import próbny powinien kończyć się czymś więcej niż komunikatem sukcesu. Po wgraniu małej próbki trzeba sprawdzić, jak rekord wygląda na liście, czy wyszukiwarka znajduje go po NIP-ie i nazwie, czy rola kontrahenta jest poprawna oraz czy dane dobrze podstawiają się do faktury.

Najlepszy test to kilka faktur roboczych. Wystaw jedną fakturę dla typowego klienta krajowego, jedną dla klienta z nietypową nazwą, jedną dla firmy zagranicznej, jeśli ją obsługujesz, i jedną dla rekordu, który wcześniej był duplikatem. Nie chodzi o wysyłkę na produkcję, tylko o sprawdzenie danych przed realną pracą.

Jeżeli test pokazuje problemy, popraw mapowanie i źródło danych, a nie tylko pojedynczy rekord. Migracja ma usunąć przyczynę, nie maskować objaw.

Migracja kończy się dopiero wtedy, gdy wiadomo, kto odpowiada za jakość danych po starcie. Jeśli każdy może dodać kontrahenta w dowolny sposób, baza znów zacznie się rozjeżdżać. Warto ustalić, kto może importować większe pliki, kto scala duplikaty i kto akceptuje zmianę danych kluczowego klienta.

Druga zasada dotyczy aktualizacji. Nie każda różnica na fakturze oznacza, że trzeba nadpisać kartotekę. Jeśli faktura historyczna ma stary adres, historia dokumentu powinna zostać bez zmian, a aktualny rekord kontrahenta może mieć nowe dane. To chroni raporty i ślad audytowy.

Trzecia zasada to regularne sprzątanie. Raz w miesiącu sprawdź nowe rekordy bez NIP-u, kontrahentów z podobną nazwą, duplikaty po adresie i faktury przypisane do rekordów do wyjaśnienia. To mniej pracy niż duże porządki raz w roku.

Pierwszy błąd to mylenie bazy klientów z bazą kontrahentów. Przy KSeF trzeba myśleć szerzej, bo faktury przychodzące i wychodzące pokazują różne role tego samego podmiotu. Jeśli system przechowuje klienta i dostawcę jako dwa niezależne światy, historia relacji będzie niepełna.

Drugi błąd to import bez zachowania starego identyfikatora. Nawet jeśli nowa baza wygląda czysto, zespół może później potrzebować połączenia z archiwalnym numerem klienta, kontem księgowym albo kodem w ERP. Warto zachować takie pole jako techniczne.

Trzeci błąd to brak planu dla wyjątków. Firmy zagraniczne, jednostki wewnętrzne, stare rekordy bez NIP-u, klienci jednorazowi i podmioty z faktur spornych wymagają decyzji przed pełnym importem.

Jeżeli dopiero porządkujesz temat kontrahentów, zacznij od artykułu Jak zbudować bazę kontrahentów z faktur KSeF i nie zgubić danych klientów. Pokazuje, jak traktować faktury jako źródło danych o klientach i dostawcach.

Przy migracji z arkuszy przyda się poradnik Jak wysłać wiele faktur do KSeF z Excela?, bo wyjaśnia, jak przygotowywać kolumny, walidować dane i unikać błędów formatów.

Jeżeli wdrożenie jest szersze niż sama baza klientów, przeczytaj Najczęstsze wyzwania przy wdrożeniu KSeF i jak je pokonać. Dla szerszego obrazu produktu zobacz też KSeFGPT - aplikacja do importu, eksportu i AI analityki faktur.