pytania i odpowiedzi
płatności Elixir
Reguły walidacyjne dla importowanego pliku z definicjami przelewów
Import pliku z przelewami będzie poprzedzony sprawdzeniem następujących elementów:
1) czy plik jest w formacie tekstowym
2) czy nie przekroczono maksymalnego rozmiaru ilości przelewów do zaimportowania w pliku – maksymalna ilość przelewów w pliku to 50 sztuk
3) czy każdy wiersz z definicją przelewu zawiera 15 pól
4) czy numer rachunku zleceniodawcy z definicji przelewu zgadza się z numerem rachunku znajdującym się aktualnie w kontekście
5) struktury pliku pod kątem formatu poszczególnych pól oraz ich wymagalności. Poszczególne wiersze z definicjami przelewów posiadają następującą strukturę:
| Lp. | Opis pola | E/W | D/R Ogólny | Opis walidacji |
| 1 | Typ polecenia: 110: Polecenie przelewu | W | 3 n F |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 3 znakowe o stałej długości - dopuszczalnych wartości: 110 Rozwiń
|
| 2 | Data płatności: RRRRMMDD | W | 8 d F |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 8 znakowe o stałej długości. - poprawności podanej daty Rozwiń
|
| 3 | Kwota do zapłaty w groszach bez przecinka i separatorów | W | 15 n V |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 15 znakowe o zmiennej długości Rozwiń
|
|
4 | Numer Rozliczeniowy Banku zleceniodawcy 7 cyfr + cyfra kontrolna | W | 8 n F |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 8 znakowe o stałej długości. Dopuszczalne jest występowanie pustego Rozwiń
|
| 5 | Niewykorzystane: wartość 0 | E | 8 n V |
Sprawdzenie:
- czy pole jest numeryczne, 8 znakowe o zmiennej długości. Dopuszczalne jest występowanie pustego. Rozwiń
|
|
6 | Nr rachunku zleceniodawcy | W | 26 n F |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 26 znakowe o stałej długości. Pole wymagane Rozwiń
|
| 7 | Nr rachunku kontrahenta | W | 26 n F |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 26 znakowe o stałej długości. Pole wymagane Rozwiń
|
|
8 | Nazwa i adres zleceniodawcy Poszczególne wiersze oddzielone od siebie symbolem "|" | W | 4*35 a V |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 4*35 znakowe o zmiennej długości. - zakres znaków ELIXIR Pole będzie ignorowane. Dane zleceniodawcy będą podstawiane na podstawie danych zarejestrowanych w systemie finansowym mBanku Rozwiń
|
| 9 | Nazwa i adres kontrahenta Poszczególne wiersze oddzielone od siebie symbolem "|" | W | 4*35 a V |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 4*35 - zakres znaków ELIXIR znakowe o zmiennej długości Rozwiń
|
|
10 | Niewykorzystane; wartość 0 | E | 8 n V |
Sprawdzenie:
- czy pole jest numeryczne, 8 znakowe o zmiennej długości. Dopuszczalne jest występowanie pustego Rozwiń
|
| 11 | Numer Rozliczeniowy Banku kontrahenta 7 cyfr + cyfra kontrolna | W | 8 n V |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 8 znakowe o zmiennej długości. Dopuszczalne jest występowanie pustego Rozwiń
|
|
12 | Szczegóły płatności Poszczególne wiersze oddzielone od siebie symbolem "|" | E | 4*35 an |
Sprawdzenie:
- czy pole jest alfanumeryczne, 4*35 znakowe o zmiennej długości. - zakres znaków ELIXIR - dopuszczalne pole puste Rozwiń
|
| 13 | Pola puste - puste cudzysłowy | W | 2* a F |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 2 znakowe o stałej długości. Dwa pola puste ””,”” Rozwiń
|
|
14 | Klasyfikacja polecenia "51" lub "71" dla pola Typ polecenia = 110 | W | 2 a F |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 2 znakowe o stałej długości. - dopuszczalne wartości: 51 Rozwiń
|
| 15 | Informacje międzybankowe (nie przesyłane do kontrahenta) | 6*35 an |
Sprawdzenie:
- czy pole jest alfanumeryczne, 6*35 znakowe o zmiennej długości. - zakres znaków ELIXIR Dopuszczalne jest występowanie pustego pola. W przypadku gdy pola nie będą puste, dane w nich zawarte będą ignorowane przy imporcie Rozwiń
|
| Lp. | Opis pola | E/W | D/R Ogólny | Opis walidacji |
| 1 | Typ polecenia: 110: Polecenie przelewu | W | 3 n F |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 3 znakowe o stałej długości - dopuszczalnych wartości: 110 Rozwiń
|
| 2 | Data płatności: RRRRMMDD | W | 8 d F |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 8 znakowe o stałej długości. - poprawności podanej daty Rozwiń
|
| 3 | Kwota do zapłaty w groszach bez przecinka i separatorów | W | 15 n V |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 15 znakowe o zmiennej długości Rozwiń
|
|
4 | Numer Rozliczeniowy Banku zleceniodawcy 7 cyfr + cyfra kontrolna | W | 8 n F |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 8 znakowe o stałej długości. Dopuszczalne jest występowanie pustego Rozwiń
|
| 5 | Niewykorzystane: wartość 0 | E | 8 n V |
Sprawdzenie:
- czy pole jest numeryczne, 8 znakowe o zmiennej długości. Dopuszczalne jest występowanie pustego. Rozwiń
|
|
6 | Nr rachunku zleceniodawcy | W | 26 n F |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 26 znakowe o stałej długości. Pole wymagane Rozwiń
|
| 7 | Nr rachunku kontrahenta | W | 26 n F |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 26 znakowe o stałej długości. Pole wymagane Rozwiń
|
|
8 | Nazwa i adres zleceniodawcy Poszczególne wiersze oddzielone od siebie symbolem "|" | W | 4*35 a V |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 4*35 znakowe o zmiennej długości. - zakres znaków ELIXIR Pole będzie ignorowane. Dane zleceniodawcy będą podstawiane na podstawie danych zarejestrowanych w systemie finansowym mBanku Rozwiń
|
| 9 | Nazwa i adres kontrahenta Poszczególne wiersze oddzielone od siebie symbolem "|" | W | 4*35 a V |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 4*35 - zakres znaków ELIXIR znakowe o zmiennej długości Rozwiń
|
|
10 | Niewykorzystane; wartość 0 | E | 8 n V |
Sprawdzenie:
- czy pole jest numeryczne, 8 znakowe o zmiennej długości. Dopuszczalne jest występowanie pustego Rozwiń
|
| 11 | Numer Rozliczeniowy Banku kontrahenta 7 cyfr + cyfra kontrolna | W | 8 n V |
Sprawdzenie:
- wymagalności pola, - czy pole jest numeryczne, 8 znakowe o zmiennej długości. Dopuszczalne jest występowanie pustego Rozwiń
|
|
12 | Szczegóły płatności Poszczególne wiersze oddzielone od siebie symbolem "|" | E | 4*35 an |
Sprawdzenie:
- czy pole jest alfanumeryczne, 4*35 znakowe o zmiennej długości. - zakres znaków ELIXIR - dopuszczalne pole puste Rozwiń
|
| 13 | Pola puste - puste cudzysłowy | W | 2* a F |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 2 znakowe o stałej długości. Dwa pola puste ””,”” Rozwiń
|
|
14 | Klasyfikacja polecenia "51" lub "71" dla pola Typ polecenia = 110 | W | 2 a F |
Sprawdzenie:
- wymagalności pola, - czy pole jest alfanumeryczne, 2 znakowe o stałej długości. - dopuszczalne wartości: 51 Rozwiń
|
| 15 | Informacje międzybankowe (nie przesyłane do kontrahenta) | 6*35 an |
Sprawdzenie:
- czy pole jest alfanumeryczne, 6*35 znakowe o zmiennej długości. - zakres znaków ELIXIR Dopuszczalne jest występowanie pustego pola. W przypadku gdy pola nie będą puste, dane w nich zawarte będą ignorowane przy imporcie Rozwiń
|
Opis kolumn w tabelach
E / W = Występowanie pól
W = Wymagane
E = Ewentualne
D / R = Długość i rodzaj pola
n = numeryczne 0 - 9
a = alfanumeryczne; zapisane są w cudzysłowie " " (Hex 22)
Poszczególne linie oddzielone są znakiem "|" (Hex 7C)
d = pole daty, format: RRRRMMDD
F = pole stałej długości (fixed)
V = pole zmiennej długości (variable)
Informacje dodatkowe
Możliwe do uzyskania błędy:
plik ma nieprawidłową strukturę (nie jest tekstowy, lub nie w formacie CSV)
zbyt duża ilość przelewów w paczce. Maksymalna ilość przelewów w pliku to 50 sztuk
przelew nr X jest nieprawidłowy
nr rachunku zleceniodawcy nie jest rachunkiem aktualnie wybranym do kontekstu
Pamiętaj, że:
pole numer 6 – Nr rachunku zleceniodawcy - musi być numerem rachunku mBiznes konto, który posiadamy
pole numer 2 – Data płatności - nie może być starsza od aktualnej daty (musi być większa bądź równa dacie bieżącej)
plik nie może zawierać nagłówka ani stopki
każde polecenie zaczyna się symbolem rodzaju (np. 110 = Polecenie przelewu)
poszczególne pola wewnątrz zlecenia rozdzielone są przecinkiem ( , )
jeśli jakieś pole składa się z kilku podpól, to poszczególne podpola są oddzielone kreską "|" (Hex 7C)
pola tekstowe zawsze znajdują się w cudzysłowach (" ")
obsługiwane rodzaje strony kodowej pliku to UTF-8, CP852 i WIN 1250
jeden plik może zawierać maksymalnie dane 50 przelewów
Przykład rekordu zawierającego przelew krajowy zwykły został umieszczony w plikach csv zapisanych przy pomocy kodowania UTF-8, WIN1250 i CP852.
W powyższym przykładzie oprócz wprowadzenia odpowiednich zmian w polach 6 oraz 2 (numer rachunku zleceniodawcy - który musi być numerem rachunku mBiznes konto który posiadamy, oraz data płatności) warto również zmodyfikować kwotę (pole numer 3), nr rachunku kontrahenta (pole numer 7) i numer rozliczeniowy banku kontrahenta (pole 11).
Rekomendujemy, aby zmian w plikach csv dokonywać przy pomocy notatnika (Notepad) systemu Windows XP, który standardowo zapisuje pliki w formacie WIN1250, lub po wybraniu opcij "Zapisz jako...", "Kodowanie" w systemie UTF-8.