Obsługa plików CSV — import i eksport danych między programami

Pliki CSV wydają się proste, ale w praktyce bywają źródłem powtarzających się problemów — polskie znaki zamieniające się w krzaki, przesunięte kolumny, błędny separator dziesiętny przy liczbach.

Na czym polega ta usługa

Wsparcie obejmuje poprawne skonfigurowanie kodowania znaków przy imporcie i eksporcie plików CSV, dostosowanie separatora kolumn i dziesiętnego do wymagań docelowego programu oraz weryfikację poprawności przeniesionych danych po całej operacji.

Dla kogo ma sens

Usługa jest przydatna przy jednorazowym lub cyklicznym przenoszeniu danych między programami niewspółpracującymi bezpośrednio ze sobą — na przykład eksporcie z systemu bankowego do arkusza kalkulacyjnego.

Ile to trwa

Wsparcie przy imporcie lub eksporcie CSV to zabieg realizowany zwykle w ramach jednej wizyty.

Warunki

Diagnoza laptopa w trybie door-to-door jest bezpłatna, diagnoza komputera stacjonarnego kosztuje 200 zł. Dojazd na terenie Warszawy i okolic jest bezpłatny, a usługa objęta jest gwarancją do 12 miesięcy.

Najczęstsze problemy techniczne przy wymianie danych CSV

Plik CSV (skrót od Comma-Separated Values, czyli wartości rozdzielane przecinkami) to plik tekstowy przeznaczony do przechowywania danych tabelarycznych w ustrukturyzowanej postaci. Choć format ten jest powszechnie stosowany ze względu na uniwersalność i prostotę, brak jednego, sztywnego standardu technicznego sprawia, że przenoszenie informacji między różnymi aplikacjami biznesowymi często kończy się błędami. Poniżej przedstawione są główne źródła problemów, z którymi spotykają się użytkownicy podczas operacji importu i eksportu.

Niezgodność kodowania znaków i uszkodzenia tekstu

Jednym z najczęstszych problemów jest niepoprawne kodowanie znaków (sposób przyporządkowania znaków tekstu do wartości binarnych). W polskich warunkach najczęściej stosuje się standardy UTF-8 (uniwersalny system kodowania znaków), Windows-1250 (strona kodowa typowa dla starszych aplikacji w systemie Windows) oraz ISO-8859-2 (międzynarodowy standard dla języków środkowoeuropejskich). Jeżeli plik wygenerowany w formacie UTF-8 zostanie wczytany przez program oczekujący kodowania Windows-1250, polskie litery diakrytyczne (ą, ć, ę, ł, ń, ó, ś, ź, ż) zostaną zamienione na nieczytelne ciągi symboli, znane w żargonie informatycznym jako mojibake lub krzaki. Dodatkową komplikacją bywa obecność znacznika BOM (Byte Order Mark, czyli niewidocznego znacznika kolejności bajtów umieszczanego na początku pliku), którego niektóre moduły importujące w systemach księgowych nie potrafią zinterpretować, traktując go jako błąd składni pierwszego wiersza.

Konflikt separatorów kolumn i ustawień regionalnych

Zgodnie z pierwotną koncepcją formatu CSV znakiem rozdzielającym poszczególne kolumny powinien być przecinek. W systemach z polskimi ustawieniami regionalnymi przecinek pełni jednak funkcję separatora dziesiętnego w liczbach. Z tego powodu programy takie jak Microsoft Excel czy polskie systemy magazynowe domyślnie wykorzystują średnik jako separator kolumn. Gdy aplikacja eksportująca zapisze dane z przecinkami, a moduł importujący oczekuje średników, cały wiersz danych zostanie wczytany do jednej kolumny. W rzadszych przypadkach jako separatory stosuje się tabulatory (format TSV, czyli Tab-Separated Values, wartości rozdzielane tabulatorem) lub znak potoku (pionową kreskę |), co wymaga precyzyjnego dopasowania parametrów odczytu w programie docelowym.

Błędna interpretacja liczb, walut i separatorów dziesiętnych

Nieprawidłowe rozpoznanie separatora dziesiętnego (znaku oddzielającego część całkowitą liczby od ułamkowej) prowadzi do poważnych błędów księgowych i magazynowych. W systemach anglosaskich separatorem dziesiętnym jest kropka, a przecinek służy do oddzielania tysięcy. W polskim standardzie jest odwrotnie: separatorem dziesiętnym jest przecinek, a separatorem tysięcy spacja lub brak znaku. Jeśli program importujący nie zostanie odpowiednio skonfigurowany, liczba 1,500 oznaczająca półtora może zostać zinterpretowana jako 1500 (tysiąc pięćset), co całkowicie zniekształca stany magazynowe, ceny jednostkowe lub wartości faktur. Ponadto obecność symboli walutowych (np. PLN, zł, EUR) wewnątrz komórek liczbowych często uniemożliwia ich automatyczne przetworzenie, powodując odrzucenie całego rekordu.

Formatowanie dat, czasu i stref czasowych

Kolejną barierą jest różnorodność formatów zapisu daty i czasu. Systemy informatyczne mogą oczekiwać formatu międzynarodowego zgodnego z normą ISO (RRRR-MM-DD), formatu polskiego (DD.MM.RRRR) lub formatu amerykańskiego (MM/DD/YYYY). W przypadku braku standaryzacji data 04/05/2026 może zostać błędnie odczytana jako 5 kwietnia zamiast 4 maja. W przypadku transakcji finansowych i logistycznych błędy w interpretacji dat uniemożliwiają poprawne zaksięgowanie dokumentów w odpowiednim okresie rozliczeniowym lub przypisanie terminów płatności.

Utrata zer wiodących w identyfikatorach

Wielu użytkowników spotyka się ze zjawiskiem usuwania początkowych zer w kluczowych numerach identyfikacyjnych, takich jak NIP (Numer Identyfikacji Podatkowej), PESEL, kody pocztowe, numery rachunków bankowych (w standardzie IBAN) czy kody kreskowe towarów (np. EAN-13, czyli trzynastocyfrowy europejski kod towarowy). Programy kalkulacyjne, traktując te ciągi jako zwykłe wartości liczbowe zamiast tekstu, automatycznie usuwają cyfrę zero z początku wartości (np. kod pocztowy 01-234 zmienia się w 1234, a NIP zaczynający się od zera traci pierwszą cyfrę). Taka modyfikacja sprawia, że dane stają się bezużyteczne i są odrzucane przez mechanizmy walidacji w systemach ERP.

Znaki specjalne, podziały wierszy i cudzysłowy

Gdy pole tekstowe w pliku CSV zawiera znak separatora (np. przecinek w opisie towaru) lub znak nowego wiersza (np. wielolinijkowy adres kontrahenta), cała zawartość tego pola musi zostać ujęta w cudzysłowy (tzw. kwalifikator tekstu). Jeżeli system eksportujący nie zastosuje odpowiednich znaków ucieczki (ang. escape characters, czyli znaków informujących parser o dosłownym traktowaniu cudzysłowu) lub nie zamknie poprawnie cudzysłowu, wiersz ulegnie rozerwaniu. W efekcie dolna część opisu trafi do kolejnego wiersza tabeli, przesuwając wszystkie pozostałe kolumny i uniemożliwiając poprawny import.

Obsługiwane oprogramowanie i typowe scenariusze wymiany danych

Wsparcie techniczne obejmuje analizę, korektę i automatyzację przepływu danych w plikach CSV pomiędzy różnymi platformami używanymi w przedsiębiorstwach oraz przez użytkowników indywidualnych. Prace realizowane są bezpośrednio na stanowiskach pracy u klienta.

Systemy magazynowo-sprzedażowe i finansowo-księgowe (ERP)

Prawidłowe przygotowanie plików CSV jest kluczowe przy zasilaniu baz danych programów do zarządzania przedsiębiorstwem (systemów ERP, czyli Enterprise Resource Planning). Pomoc obejmuje przygotowanie struktur danych dla takich systemów jak:

InsERT GT oraz InsERT nexo (w tym Subiekt, Rewizor, Rachmistrz, Gratyfikant, Gestor, Biuro) — import kartotek towarowych, cenników, baz kontrahentów oraz dokumentów handlowych.
Comarch ERP (Optima, XL, Altum) — zasilanie słowników towarowych, import wyciągów bankowych oraz operacji kasowych.
WAPRO ERP (dawniej WF-Mag, Fakir, Kaper, Gang) — migracja stanów magazynowych, cenników od dostawców i rejestrów VAT.
Sage Symfonia, enova365 oraz RAKS — dostosowywanie formatów wymiany dokumentów księgowych i płacowych.
Program Płatnik ZUS — weryfikacja i przygotowanie zestawień do importu danych ubezpieczonych.

Integracje e-commerce, marketplace i systemów zamówień

W handlu internetowym pliki CSV stanowią podstawowe narzędzie masowej aktualizacji asortymentu. Wsparcie obejmuje konwersję plików wymiany pomiędzy platformami sprzedażowymi (takimi jak WooCommerce, PrestaShop, Magento, Shoper), serwisami typu marketplace (np. Allegro) a integratorami zamówień (np. BaseLinker). Odpowiednie przetworzenie plików pozwala na masową zmianę cen, aktualizację stanów magazynowych, uzupełnienie atrybutów produktów czy powiązanie kodów EAN z numerami katalogowymi producenta.

Import wyciągów bankowych i historii transakcji

Pobieranie historii rachunków bankowych w formacie CSV z serwisów bankowości elektronicznej (m.in. PKO BP, mBank, Santander, ING, Bank Millennium) i ich import do modułów finansowo-księgowych wymaga zgodności nagłówków, układu kolumn oraz formatu kwot. Usługa obejmuje stworzenie schematów i profili importu, które automatycznie mapują numery kont, tytuły przelewów oraz dane nadawców na odpowiednie konta rozrachunkowe w programie księgowym.

Platformy księgowości internetowej i fakturowania

Wsparcie dotyczy również przenoszenia danych do serwisów księgowości online, takich jak iFirma, wFirma czy Fakturownia. Dotyczy to zarówno migracji historycznych baz klientów, jak i importu okresowych zestawień sprzedaży z zewnętrznych systemów płatności lub platform sprzedażowych.

Typowe błędy popełniane przy samodzielnej obsłudze plików CSV

Próby ręcznego dostosowania plików CSV za pomocą nieodpowiednich narzędzi często prowadzą do trwałego uszkodzenia struktury danych lub utraty istotnych informacji. Do najczęstszych błędów należą:

Otwieranie pliku CSV bezpośrednio przez dwuklik w arkuszu kalkulacyjnym — program taki jak Microsoft Excel przy standardowym otwarciu natychmiast dokonuje automatycznej konwersji typów danych, usuwając wiodące zera w numerach NIP, przekształcając długie kody kreskowe w zapis wykładniczy (np. 5,90123E+12) oraz konwertując niektóre wartości tekstowe na daty.
Zapisywanie zmodyfikowanego pliku w formacie skoroszytu (.xlsx) zamiast pliku tekstowego — próba zaimportowania pliku w formacie binarnym lub XML do modułu oczekującego czystego tekstu skutkuje natychmiastowym błędem odczytu.
Globalna zamiana znaków funkcją „Znajdź i zamień" w prostych edytorach tekstowych — zamiana wszystkich przecinków na średniki w pliku bez uwzględnienia cudzysłowów powoduje uszkodzenie przecinków znajdujących się wewnątrz opisów produktów, nazw firm czy adresów, co całkowicie rozbija układ kolumn.
Brak utworzenia kopii zapasowej przed importem — wykonanie masowego importu niezweryfikowanego pliku CSV do produkcyjnej bazy danych może doprowadzić do nadpisania istniejących kartotek, zdublowania tysięcy rekordów lub uszkodzenia powiązań relacyjnych, co w przypadku braku świeżego backupu (kopii zapasowej) wymaga czasochłonnego, ręcznego czyszczenia bazy.
Ignorowanie limitów znaków i wymagań walidacji bazy danych — wklejanie zbyt długich opisów lub niedozwolonych znaków kontrolnych w polach o ograniczonej długości (np. symbol towaru o limicie 20 znaków) skutkuje przerwaniem procesu importu w połowie i częściowym, niespójnym zapisaniem danych.

Kiedy problem nie leży w strukturze pliku CSV

Nie każde niepowodzenie podczas importu lub eksportu wynika z wadliwej budowy samego pliku tekstowego. W trakcie diagnostyki u klienta weryfikowane są również inne potencjalne przyczyny:

Brak wymaganych elementów słownikowych w programie docelowym — system ERP może odrzucić import towarów, jeżeli plik zawiera przypisane jednostki miary (np. szt., kpl.), grupy towarowe, stawki podatku VAT lub waluty, które nie zostały wcześniej zdefiniowane w konfiguracji programu.
Uprawnienia użytkownika i blokady bazy danych — brak odpowiednich praw zapisu dla konta użytkownika w systemie bazodanowym (np. Microsoft SQL Server) lub blokady transakcyjne wywołane przez pracę innych stanowisk sieciowych mogą uniemożliwić wykonanie operacji masowej.
Uszkodzenie struktury bazy danych — błędy integralności tabel relacyjnych mogą blokować wstawianie nowych rekordów powiązanych z kluczami obcymi.
Zabezpieczenia systemowe i zapory sieciowe — w przypadku automatycznego pobierania plików CSV ze zdalnych serwerów FTP lub SFTP (protokołów bezpiecznego transferu plików), program antywirusowy lub reguły zapory mogą blokować transfer plików lub poddawać je kwarantannie.

Procedura realizacji usługi podczas wizyty serwisanta

Prace związane z przygotowaniem i transferem danych realizowane są w siedzibie firmy lub w miejscu wskazanym przez klienta z zachowaniem pełnego bezpieczeństwa przetwarzanych informacji:

Weryfikacja środowiska i utworzenie kopii bezpieczeństwa — pierwszym krokiem jest zawsze wykonanie pełnego backupu bazy danych programu docelowego, co gwarantuje możliwość natychmiastowego powrotu do stanu początkowego w razie wystąpienia jakichkolwiek problemów.
Analiza struktury danych źródłowych — sprawdzenie kodowania znaków, separatorów kolumn, formatów liczb, dat oraz spójności logicznej pól w pliku wyjściowym.
Przygotowanie transformacji i konwersji — zastosowanie dedykowanych narzędzi do przekształcania danych (np. Power Query w Excelu, czyli narzędzia do pobierania i transformacji danych, skryptów filtrujących lub edytorów z obsługą wyrażeń regularnych) w celu doprowadzenia struktury pliku do idealnej zgodności ze schematem wymaganym przez system docelowy.
Import próbny na wyselekcjonowanej próbie danych — wczytanie kilku rekordów testowych w celu potwierdzenia, że wszystkie pola trafiły do właściwych kolumn, a znaki diakrytyczne i wartości liczbowe wyświetlają się prawidłowo.
Wykonanie pełnego importu i weryfikacja sum kontrolnych — przeprowadzenie właściwego transferu danych, sprawdzenie liczby zaimportowanych pozycji oraz weryfikacja poprawności powiązań kartotek.
Przygotowanie instrukcji lub szablonu dla klienta — w przypadku operacji cyklicznych konfigurowany jest gotowy profil importu lub szablon arkusza, który umożliwia pracownikom samodzielne i bezbłędne powtarzanie procedury w przyszłości.

Dodatkowe pytania i odpowiedzi

Dlaczego po otwarciu pliku CSV w programie Excel znikają zera na początku numerów NIP i kodów pocztowych?

Program Excel domyślnie analizuje zawartość każdej kolumny i automatycznie rozpoznaje ciągi cyfr jako wartości liczbowe. W matematyce zera na początku liczby nie mają znaczenia, dlatego aplikacja je usuwa (zmieniając np. kod pocztowy 02-500 w liczbę 2500 po usunięciu myślnika lub zera). Aby temu zapobiec, nie należy otwierać pliku bezpośrednio przez kliknięcie, lecz skorzystać z kreatora importu tekstu lub narzędzia Power Query (funkcji pobierania i przekształcania danych), w którym można ręcznie zdefiniować typ danej kolumny jako tekst, co wymusza zachowanie wszystkich znaków w ich oryginalnej postaci.

Jak trwale rozwiązać problem z polskimi znakami (tzw. krzakami) w zaimportowanych kartotekach?

Problem wynika z niezgodności strony kodowej pliku źródłowego z ustawieniami modułu importującego. Aby go wyeliminować, należy przekonwertować plik do odpowiedniego standardu (najczęściej UTF-8 lub Windows-1250) przed jego wczytaniem. Można to zrobić za pomocą zaawansowanego edytora tekstu z opcją konwersji kodowania lub ustawiając odpowiednie kodowanie źródłowe w parametrach schematu importu w programie docelowym. Ważne jest także zwrócenie uwagi na obecność znacznika BOM, który w niektórych systemach ERP musi zostać usunięty, a w innych jest wymagany do prawidłowego rozpoznania standardu UTF-8.

Czy przed importem pliku CSV do bazy Subiekta lub Optimy konieczne jest wykonanie kopii zapasowej?

Tak, wykonanie kopii zapasowej (archiwizacji) bazy danych przed każdym masowym importem jest podstawową zasadą bezpieczeństwa danych. Błędnie przygotowany plik może nadpisać aktualne ceny towarów, przypisać niepoprawne stawki VAT lub utworzyć tysiące zdublowanych pozycji kartotekowych. Cofnięcie takich zmian bez posiadania świeżej kopii zapasowej bywa niezwykle trudne lub wręcz niemożliwe, podczas gdy odtworzenie bazy z archiwum zajmuje zazwyczaj tylko kilka minut.

Czy można zautomatyzować cykliczny import cenników od dostawcy w formacie CSV?

Tak, w przypadku firm, które regularnie otrzymują od swoich hurtowni lub dostawców zaktualizowane pliki z ofertą i stanami magazynowymi, możliwe jest przygotowanie zautomatyzowanego procesu. Rozwiązanie polega na stworzeniu dedykowanego szablonu w narzędziu Power Query, skonfigurowaniu profilu wymiany danych w systemie ERP lub wdrożeniu skryptu, który automatycznie pobiera plik, dostosowuje jego strukturę (separatory, kodowanie, mapowanie kolumn) i zasila bazę danych o określonych porach dnia.

Co zrobić, gdy program księgowy odrzuca plik CSV z wyciągiem bankowym?

Odrzucenie pliku przez moduł księgowy najczęściej wynika z drobnych niezgodności formatowania, takich jak obecność pustych wierszy na początku lub końcu pliku, niestandardowe znaki w tytułach przelewów, brak nagłówków kolumn lub zastosowanie innego formatu daty niż zdefiniowany w profilu banku. Pomoc polega na zweryfikowaniu struktury pliku pod kątem wymagań danego programu księgowego, usunięciu błędnych wpisów oraz poprawnym skonfigurowaniu schematu importu wyciągów.

Pewny transfer i spójność danych biznesowych w środowisku IT

Poprawna wymiana danych w formacie CSV eliminuje konieczność żmudnego, ręcznego przepisywania dokumentów, minimalizuje ryzyko pomyłek w kartotekach towarowych oraz zapewnia pełną zgodność rejestrów finansowo-księgowych. W przypadku trudności z importem lub eksportem danych między programami magazynowymi, księgowymi, sklepami internetowymi a arkuszami kalkulacyjnymi, pomoc realizowana jest na miejscu w siedzibie firmy lub biurze klienta. Zgłoszenia przyjmowane są pod numerem telefonu 22 378 48 09, a dojazd serwisanta realizowany jest na terenie całej Warszawy oraz w promieniu 40 km, obejmując powiaty grodziski, legionowski, otwocki, piaseczyński, pruszkowski, warszawski zachodni oraz wołomiński.

22 378 48 09