Jak zbudowane są schematy plików CSV?

Warto wiedzieć

Dotyczy tylko aplikacji Wapro PPK 365.

Schematy plików CSV (Comma-Separated Values) są najważniejszym elementem w zarządzaniu i wymianie danych między różnymi systemami. Aby zapewnić ich poprawne wykorzystanie w różnych aplikacjach, należy zadbać o poprawność ich struktury. Jakie elementy składają się na plik CSV, jak prawidłowo formatować dane oraz jakie są najlepsze praktyki przy tworzeniu i edytowaniu tych plików? Wiedza na ten temat pozwoli użytkownikowi efektywnie zarządzać danymi i unikać typowych błędów związanych z formatowaniem plików CSV.

Do importu danych z innych programów przeznaczone są dwa pliki w formacie CSV, zgodne z opisanymi schematami:

• pliku do importu danych uczestników PPK,
• pliku do importu naliczonych składek uczestników programu PPK.

Jaki jest schemat pliku importu danych uczestników?

Struktura pliku CSV:

• pierwszy wiersz w pliku jest pomijany - może zawierać nagłówki,
• wszystkie pola muszą być zawarte w "",
• pola muszą być oddzielone średnikiem,
• pola nie mogą być pomijane - w przypadku wartości pustej należy wstawić "",
• kolejność pól musi zostać zachowana,
• w przypadku, gdy uczestnik istnieje w bazie w danej firmie, jego dane zostaną nadpisane,
• adresu korespondencyjnego nie trzeba wypełniać, jeśli jest taki sam jak zamieszkania,
• strona kodowa: CP 1250 / Windows 1250. Nie zalecamy importu plików ze stroną kodową CP 852 albo ISO-8559-2 z uwagi na możliwość wystąpienia błędów w interpretacji polskich znaków,
• koniec linii należy oznaczyć znakiem CLRF,
• gwiazdka - pole wymagane,
• zawartość:
  • Numer ewidencyjny,
  • *Pierwsze imię,
  • Drugie imię,
  • *Nazwisko,
  • Płeć - dopuszczalne wartości N, M, K (nie podano, mężczyzna, kobieta),
  • Kod kraju obywatelstwa - wymagane dwa znaki, domyślnie wstawiane jest PL,
  • *PESEL - jeśli brak wymagane są pola data urodzenia oraz seria i numer dokumentu tożsamości,
  • *Data urodzenia - format rrrr-mm-dd,
  • *Typ dokumentu tożsamości - dopuszczalne wartości D, P, K, I (dowód, paszport, karta pobytu, inne),
  • *Seria i numer dokumentu tożsamości,
  • *Data zatrudnienia - format rrrr-mm-dd,
  • *Adres e-mail,
  • *Numer telefonu,
  • Adres zamieszkania - kod kraju - wymagane dwa znaki, domyślnie wstawiane jest PL,
  • *Adres zamieszkania - kod pocztowy,
  • Adres zamieszkania - poczta,
  • *Adres zamieszkania - miejscowość,
  • Adres zamieszkania - ulica,
  • *Adres zamieszkania - numer domu,
  • Adres zamieszkania - numer mieszkania,
  • Adres korespondencyjny - kod kraju - wymagane dwa znaki, domyślnie wstawiane jest PL,
  • *Adres korespondencyjny - kod pocztowy,
  • Adres korespondencyjny - poczta,
  • *Adres korespondencyjny - miejscowość,
  • Adres korespondencyjny - ulica,
  • *Adres korespondencyjny - numer domu,
  • Adres korespondencyjny - numer mieszkania.

Jaki jest schemat pliku importu naliczonych składek uczestników programu?

Struktura pliku CSV:

• pierwszy wiersz w pliku jest pomijany - może zawierać nagłówki,
• wszystkie pola muszą być zawarte w "",
• pola muszą być oddzielone średnikiem,
• pola nie mogą być pomijane - w przypadku wartości pustej należy wstawić "",
• kolejność pól musi zostać zachowana,
• w przypadku, gdy składka istnieje w bazie w danej firmie, zostanie nadpisana pod warunkiem, że nie została wysłana,
• strona kodowa: CP 1250 / Windows 1250. Nie zalecamy importu plików ze stroną kodową CP 852 albo ISO-8559-2 z uwagi na możliwość błędów w interpretacji polskich znaków,
• koniec linii należy oznaczyć znakiem CLRF,
• gwiazdka - pole wymagane,
• zawartość:
  • *Pierwsze imię,
  • *Nazwisko,
  • *PESEL - jeśli brak wymagane są pola data urodzenia oraz seria i numer dokumentu tożsamości,
  • *Data urodzenia - format rrrr-mm-dd,
  • *Typ dokumentu tożsamości - dopuszczalne wartości D, P, K, I (dowód, paszport, karta pobytu, inne),
  • *Seria i numer dokumentu tożsamości,
  • *Rok - format rrrr,
  • *Miesiąc - format mm,
  • *Korekta - 0 - nie; 1 - tak,
  • *Składka podstawowa uczestnika - format #,##,
  • *Składka dodatkowa uczestnika - format #,##,
  • *Składka podstawowa pracodawcy- format #,##,
  • *Składka dodatkowa pracodawcy- format #,##,
  • *Obniżona składka podstawowa uczestnika - T lub N.