Bank

• Plik bankowy (pole COD)

• Bank (pole BAN)

To pole nie jest kontrolowane. Jest ono używane do personalizacji struktury pliku dla danego banku. Rekord z pustym plikiem bankowym zostanie użyty dla banków bez konkretnego rekordu.

• Legislacja (pole LEG)

Opcjonalne pole zawierające kod legislacji (tabela dodatkowa 909).

Wprowadzona wartość jest używana podczas tworzenia i zatwierdzania folderu oraz dodawania danych w przypadku kopii legislacji.

Podczas tworzenia folderu, wyodrębniane są dane dotyczące wybranych legislacji oraz dane podstawowe (pusty kod legislacji).

Podczas zatwierdzania folderu, pobierane są wyłącznie rekordy powiązane z legislacjami folderu.

Pole Legislacja służy również do odfiltrowywania oraz kontrolowania podczas wyboru i wprowadzania przesunięć (wprowadzanie faktur, rozliczeń, dokumentów itp.).

Jeśli pole jest puste, bieżący rekord może zostać użyty niezależnie od tego, jaka jest legislacja firmy, której dotyczy przesunięcie.

• Rodzaj rekordu (pole RECTYP)

• Szczegóły numeru zamówienia (pole ORDNUM)

Ten numer zamówienia jest używany do rozbicia lub sortowania rekordów typu „Szczegóły”.

• Opis (pole DESTRA)

• Krótki tytuł (pole SHOTRA)

• Prefiks nazwy pliku (pole FILREF)

Ta sekwencja będzie używana jako prefiks w nazwach plików generowanych przez deskryptor.

• Typ formatu (pole FMT)

Należy wybrać typ formatu:

Stały

Ten format jest używany do wymiany plików o stałym formacie z bankiem takich, jak wyciągi bankowe czy weksle.

Wygenerowany plik bankowy opiera się o formułę wprowadzoną w polu Formuła. Umiejscowienie i długość danych są ustawiane w tym pliku.

Zmienny

Ten format jest używany do wymiany plików XML z bankiem takich, jak przelewy SEPA i nie-SEPA oraz polecenia zapłaty.

Wygenerowany plik bankowy opiera się o formułę wprowadzoną w polu Formuła. Dane wyświetlane w tagu wprowadzane są w polach Separator początkowy i Separator końcowy. Wybranie tego formatu wyświetla kolumny Wymagane i Warunek konieczne w ustawieniach.

Dla pliku bankowego, który podlega standardowi SEPA (typ Zmienna i grupa pliku bankowego przelew bankowy SEPA (SCT) lub polecenie zapłaty SEPA (SDD)), dozwolone są tylko następujące znaki:
a b c d e f g h i j k l m n o p q r s t u v w x y z
A B C D E F G H I J K L M O P Q R S T U V W X Y Z
0 1 2 3 4 5 6 7 8 9
- ? : ( ) . , " oraz / (tylko w ramach obszaru)
Spacja
Kontrola znaków wykonywana jest podczas generowania pliku.
- Jeśli w ciągu znaków użyte są zabronione znaki to są one automatycznie zastępowane spacją.
- Jeśli zabronione znaki są umieszczone na początku lub końcu ciągu to są one automatycznie usuwane.
Przykład:
<Nm>/COMPANY FATHER&SONS/</Nm>
Po przetworzeniu w Sage X3:
<Nm>COMPANY FATHER SONS</Nm> (usunięcie znaków „/” w tagach oraz zastąpienie znaku „&” spacją).

Kolumny Długość, Formuła i Tytuł są wspólne dla obydwu typów formatów.

CSV

Ten typ formatu generuje plik zawierający wartości rozdzielone przecinkiem. Dla tego formatu można wprowadzić Separator pola i Ogranicznik pola. Jeśli plik wyjściowy jest generowany za pomocą procesu generowania pliku bankowego to są one automatycznie stosowane do pól zdefiniowanych jako rekordy. Można również użyć definicji pozycji Nagłówka, Stopki i Szczegółów, jeśli jest to konieczne.

Nie ma już potrzeby ręcznego definiowana separatorów pól w ramach definicji typu Długości pola.

W sekcji Rekordy należy wprowadzić definicje dla każdego pola pliku CSV. Każdy wiersz w tabeli odpowiada jednemu polu.

Należy uzupełnić następujące kolumny w tabeli:

• Typ pola – kontroluje typ danych pola
• Formuła – definiuje zawartość pola (=dane). Wspierane są takie same opcje, jak dla innych formatów (tzn. odniesienie do pola w bazie danych, stałe teksty).
• Opis – opcjonalny

Uwagi dodatkowe:

Jako ostatni rekord należy wprowadzić znak określający koniec linii w polu binarnym (zob. przykład). Znaki końca linii nie są dodawane automatycznie.

Jeśli znak separatora pola jest częścią pola alfanumerycznego, jak to ma miejsce np. w nazwie kontrahenta lub w informacjach o liście płatności, to jest on usuwany w momencie generowania pliku w celu zapewnienia integralności struktury pliku.

Zdefiniować można tylko jeden rekord nagłówka lub stopki. Jeśli nagłówek lub stopka zawierają wiele linii to można zdefiniować całą strukturę w ramach pliku.

Ze względów technicznych konieczne jest zawsze utworzenie rekordu nagłówka dla definicji pliku bankowego nawet, jeśli nie potrzebne są żadne linie nagłówka. W takim przypadku należy utworzyć pusty rekord. Przykład:

W rekordzie nagłówka, w polu Warunek można wprowadzić [F:TFB]BAN = 'DUMMY’ lub 1=2 i przynajmniej jedną linię rekordu (tzn. pole bez tekstu). Ten ostatni warunek zawsze równa się FAŁSZ i zatrzymuje generowanie rekordu.

Przykład definicji pliku bankowego CSV:

Typ pola	Formuła	Opis
Alfanumeryczne	„Opis partii”
Alfanumeryczne	func NEDBANKLIB.BATCHDATE_AND_INT_SUM(datetime$)
Alfanumeryczne	[F:BAN]SENNUM
Binarne	chr$(13)+chr$(10)

Ta definicja tworzy następujący plik CSV, zakładając, że średnik ; został ustawiony jako separator pola:

Opis partii;20201051200;234AB3222XYZ945;<CR><LF>

Linia 1 = pierwsze pole: stały tekst „Opis partii”

Linia 2 = drugie pole: użycie funkcji do wygenerowania wymaganej daty i konkretnego formatu

Linia 3 = trzecie pole: to pole w pliku jest uzupełniane bezpośrednio na podstawie pola w bazie danych z wartością 234AB3222XYZ945

Linia 4 = znak końca linii w formie reprezentacji binarnej (tutaj: powrót karetki+nowy wiersz)

• Separator pól (pole FLDSEP)

Wyłącznie dla formatów typu CSV należy zdefiniować znak oddzielający pola. Zazwyczaj używany jest przecinek lub średnik.

• Ogranicznik pola (pole FLDDEL)

Wyłącznie dla formatów typu CSV należy zdefiniować znak oznaczający pola alfanumeryczne. Zazwyczaj używany jest cudzysłów lub apostrof.

• Kodowanie znaków (pole FILFMT)

• Rozszerzenie pliku (pole FILEXO)

Należy wprowadzić rozszerzenie nazw plików, które zostaną wygenerowane dla przelewów elektronicznych. Może ono liczyć do czterech znaków.

• Warunek (pole FORCND)

Należy wprowadzić formułę warunkującą wprowadzanie bieżącego rekordu.

To pole jest wskazywane na poziomie szczegółów numeru zamówienia.

Dla formatów typu CSV z tego pola należy skorzystać, aby zdefiniować pusty nagłówek w pliku, jeśli faktyczny nagłówek nie istnieje. Można wprowadzić [F:TFB]BAN = 'DUMMY’ lub po prostu 1=2 i przynajmniej jedną linię w rekordzie. Ten ostatni warunek zawsze równa się FAŁSZ i zatrzymuje generowanie rekordu.

• Nr (pole NUM)

Numer faktury.
Ten numer jest używany do identyfikacji faktury w unikalny sposób. Jest on wprowadzany podczas każdego tworzenia lub automatycznego generowania w zależności od numeru sekwencji powiązanego z typem faktury.

• Typ pola (pole FLDTYP)

Brak pomocy dla tego pola.

• Pozycja (pole POS)

• Długość (pole LNG)

Brak pomocy dla tego pola.

• Separator początkowy (pole STRSEP)

Należy wprowadzić separator początkowy. Kontrola wykonywana jest między tagami początkowymi i końcowymi, aby upewnić się, że są one ze sobą spójne.

W tagu XML można dodać atrybut:

• W tagu należy użyć kodu $1$ jako wartości.
• W pliku XML kod $1$ jest zastępowany przez wynik obliczeń formuły wprowadzonej w polu Formuła.

Na przykład:

• Separator początkowy to <InstdAmt Ccy="$1$">.
• Formuła w polu Formuła to [F:PYH]CUR.
• W wygenerowanym pliku XML $1$ jest zastępowany walutą. Przykład: <InstdAmt Ccy= "EUR">1000</InstdAmt>

Jeśli separator początkowy zawiera kod $1$ to pierwsze wystąpienie $1$ jest zastępowane przez wynik obliczonej formuły. Inne wystąpienia $1$ nie są modyfikowane.

Jeśli separator początkowy nie zawiera kodu $1$ to wynik obliczeń formuły wyświetla się w pliku XML po tagu.

• Formuła (pole FRM)

Dla plików bankowych typu Zmienna zdefiniować można zmienne używane w pliku XML.

Przykłady:

[L]MSGID Ta zmienna zawiera wartość użytego numeru sekwencji. Ten numer sekwencji jest definiowany w funkcji Przypisanie numerów sekwencji.

[L]NBPYH Ta zmienna zawiera liczbę płatności zawartych w pliku.

[L]TOTCUR Ta zmienna zawiera sumę wszystkich płatności zawartych w pliku bez uwzględnienia walut i konwersji.

• Obowiązkowy (pole OBY)

Ta kolumna wyświetla się tylko dla plików bankowych typu Zmienna.

Jeśli wprowadzono formułę to można wskazać, czy te wartości są wymagane, czy nie. Jeśli wybrano Tak i nie wprowadzono formuły w kolumnie Warunek dla generowania pliku bankowego XML to podczas generowania tego pliku w logu wyświetla się komunikat o błędzie.

• Separator końcowy (pole ENDSEP)

Należy wprowadzić separator końcowy. Kontrola wykonywana jest między tagami początkowymi i końcowymi, aby upewnić się, że są one ze sobą spójne. W przeciwnym razie wyświetla się komunikat o błędzie. „Wymagany separator końcowy to </XX>. Zmodyfikować?”

• Warunek (pole CND)

To pole jest używane do wprowadzenia formuły warunkującej wprowadzanie bieżącego rekordu.

Reguły zarządzania XML wymagają, żeby początkowe i końcowe tagi nie były generowane, jeśli nie ma między nimi wartości.

W przypadku grupy elementów XML z opcjonalnymi wartościami to pole, jeśli nie jest uzupełnione, zapobiega utworzeniu rekordu.

Wprowadzenie warunku nie jest konieczne dla tagów z opcjonalnymi wartościami (jeśli pole Wymagane jest ustawione jako „Nie”), jeśli te tagi nie są bezpośrednio uwzględniane w grupie elementów XML.

• Opis (pole DESLIN)

Brak pomocy dla tego pola.

• Całkowita długość (pole TOTLNG)

• Grupa plików (pole NATPAY)

Typy płatności umożliwiają powiązanie pliku bankowego z transakcją płatniczą. Kilka formatów pliku bankowego może odpowiadać temu samemu typowi płatności. W zależności od instytucji bankowej lub jeśli płatność jest krajowa lub międzynarodowa to format pliku może się różnić.

• Pozwól na grupowanie list płatności (pole FRMGRP)

• Wielowalutowość (pole CURMULT)

To pole należy zaznaczyć, jeśli plik listy płatności jest w jednej walucie, jeśli użycie wielu walut jest zabronione przez format pliku.

• Kontrola waluty (pole CURCTL)

• Waluta (pole CUR)