Specyfikacja importu danych formularza FAT

WORD Software
Specyfikacja importu FAT-1
Wersja 2.0
Specyfikacja importu danych
formularza FAT-1
w programie
eDek – Elektroniczne Deklaracje
Wstęp
Dokument zawiera informacje określające zakres danych oraz warunki techniczne, których spełnienie
pozwoli na poprawne zaimportowanie danych do formularza FAT-1 z pliku tekstowego.
Z uwagi na fakt, że struktura logiczna formularza jest hierarchiczna i zawiera wiele elementów, które
mogą się powtarzać, prosty import danych w postaci pliku tekstowego CSV, w którym każdy wiersz
ma identyczną strukturę pól nie jest możliwy.
Zastosowano wiec rozwiązanie oparte na koncepcji pliku tekstowego o zmiennej strukturze wierszy.
W tym dokumencie opisano, jak należy konstruować taki plik tekstowy, aby można było poprawnie
zaimportować dane.
Struktura formularza FAT-1
Uproszczony schemat blokowy sekcji formularza
str. 1
WORD Software
Symbol
I
F
A
O
R
Sekcja
FAT-1
FATCA
AccountReport
SubstantialOwner
RaportInstWyl
Specyfikacja importu FAT-1
Wersja 2.0
Opis
Nagłówek formularza oraz dane instytucji przekazującej informacje
Dane instytucji raportującej
Dane rachunku raportowanego
Dane znaczącego udziałowca
Płatności na rzecz instytucji wyłączonych
Każda sekcja formularza zawiera ustalona liczbę pól i może być reprezentowana jako pojedynczy
wiersz w pliku tekstowym. Każdy wiersz rozpoczynać się będzie od identyfikatora sekcji (symbolu),
której dane zawiera.
Powiązania pomiędzy poszczególnymi sekcjami będą odzwierciedlone w oparciu o określoną
kolejność wierszy.
Przykład
Przyjmijmy, że formularz FAT-1 zawiera jedną instytucję raportującą, która raportuje dwa rachunki
oraz dwie płatności na rzecz instytucji wyłączonych. Pierwszy raportowany rachunek ma dwóch
współwłaścicieli, a drugi – jednego.
Schemat sekcji takiego formularza wygląda następująco:
str. 2
WORD Software
Specyfikacja importu FAT-1
Wersja 2.0
Zgodnie z regułą kolejności wiersze w pliku powinny być ułożone następująco:
Nr
wiersza
1
2
3
4
5
6
7
8
9
Symbol
sekcji
I
F
A
O
O
A
O
R
R
Opis
Wiersz zawierający nagłówek formularza i dane instytucji przekazującej
Dane instytucji raportującej
Dane pierwszego rachunku
Dane pierwszego właściciela pierwszego rachunku
Dane drugiego właściciela pierwszego rachunku
Dane drugiego rachunku
Dane właściciela drugiego rachunku
Raport pierwszej instytucji wyłączonej
Raport drugiej instytucji wyłączonej
Poniżej fragment pliku tekstowego rozdzielanego średnikami zawierającego omawiane dane.
Pierwszy znak w każdym wierszu oznacza rodzaj sekcji:
Specyfikacja struktury pól poszczególnych sekcji
Poniżej znajduje się specyfikacja pól poszczególnych sekcji formularza.
Sekcja FAT-1 (I)
Nr
pola
1
2
3
4
5
6
Typ
tekst
tekst
tekst
tekst
tekst
tekst
Długość
1
4
15
15
13
240
Nazwa elementu schematu
logicznego XSD
(nie występuje)
Rok
IdWiadomosci
IdWiadomosciKorygowanej
NIP
NazwaPodmiotu
Opis
Typ wiersza - zawsze 'I'
Rok
Id wiadomości
Id wiadomości korygowanej
NIP
Nazwa instytucji przekazującej
str. 3
WORD Software
Specyfikacja importu FAT-1
Wersja 2.0
Sekcja FATCA (F)
Nr
pola
1
2
3
4
5
6
7
8
9
10
11
12
13
14
Typ
Długość
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
1
19
2
240
13
2
240
20
20
20
50
20
240
250
Nazwa elementu schematu
logicznego XSD
(nie występuje)
TIN
ResCountryCode
Name
NIP
CountryCode
Street
BuildingIdentifier
SuiteIdentifier
FloorIdentifier
POB
PostCode
City
AddressFree
Opis
Typ wiersza - zawsze 'F'
TIN
Kod kraju rezydencji
Nazwa instytucji raportującej
Nip
Kod kraju siedziby
Ulica
Numer domu
Numer lokalu
Piętro
Skrytka pocztowa
Kod pocztowy
Miejscowość
Adres opisowy
Sekcja AccountReport (A)
Nr
pola
1
2
3
4
5
6
7
8
Typ
Długość
tekst
tekst
tekst
tekst
tekst
tekst
tekst
liczba
1
6
23
23
240
19
2
9
10
11
12
13
14
15
16
17
18
19
20
21
tekst
tekst
tekst
tekst
tekst
tekst
data
tekst
tekst
tekst
tekst
tekst
tekst
240
8
240
240
240
2
240
2
2
240
20
20
Nazwa elementu schematu
logicznego XSD
(nie występuje)
DocTypeIndic
DocRefId
CorrDocRefId
AccountNumber
TIN
ResCountryCode
(nie występuje)
Name
AccHolderType
LastName
FirstName
MiddleName
Nationality
BirthDate
(Birth)City
(Birth)CountryCode
CountryCode
Street
BuildingIdentifier
SuiteIdentifier
Opis
Typ wiersza - zawsze 'A'
Typ danych
Id danych
Id danych korygowanych
Nr rachunku
TIN
Kod kraju rezydencji
Rodzaj posiadacza rachunku:
1 – osoba indywidualna
2 – organizacja
Nazwa instytucji
Typ posiadacza
Nazwisko
Imię
Drugie imię
Narodowość
Data urodzenia
Miejsce urodzenia
Kod kraju urodzenia
Kod kraju siedziby
Ulica
Numer domu
Numer lokalu
str. 4
WORD Software
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
tekst
tekst
tekst
tekst
tekst
kwota
tekst
kwota
tekst
kwota
tekst
kwota
tekst
kwota
tekst
Specyfikacja importu FAT-1
20
50
20
240
250
3
3
3
3
3
FloorIdentifier
POB
PostCode
City
AddressFree
AccountBalance
currCode
PaymentAmnt_501
currCode_501
PaymentAmnt_502
currCode_502
PaymentAmnt_503
currCode_503
PaymentAmnt_504
currCode_504
Wersja 2.0
Piętro
Skrytka pocztowa
Kod pocztowy
Miejscowość
Adres opisowy
Saldo rachunku
Kod waluty
Kwota płatności FATCA501
Kod waluty FATCA501
Kwota płatności FATCA502
Kod waluty FATCA502
Kwota płatności FATCA503
Kod waluty FATCA503
Kwota płatności FATCA504
Kod waluty FATCA504
Sekcja SubstantialOwner (O)
Nr
pola
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Typ
Długość
tekst
tekst
tekst
tekst
tekst
tekst
tekst
data
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
tekst
1
19
2
240
240
240
2
240
2
2
240
20
20
20
50
20
240
250
Nazwa elementu schematu
logicznego XSD
(nie występuje)
TIN
ResCountryCode
LastName
FirstName
MiddleName
Nationality
BirthDate
(Birth)City
(Birth)CountryCode
CountryCode
Street
BuildingIdentifier
SuiteIdentifier
FloorIdentifier
POB
PostCode
City
AddressFree
Opis
Typ wiersza - zawsze 'O'
TIN
Kod kraju rezydencji
Nazwisko
Imię
Drugie imię
Narodowość
Data urodzenia
Miejsce urodzenia
Kod kraju urodzenia
Kod kraju siedziby
Ulica
Numer domu
Numer lokalu
Piętro
Skrytka pocztowa
Kod pocztowy
Miejscowość
Adres opisowy
str. 5
WORD Software
Specyfikacja importu FAT-1
Wersja 2.0
Sekcja RaportInstWyl (R)
Nr
Typ
pola
1 tekst
2 tekst
3 kwota
Długość
Nazwa elementu schematu
logicznego XSD
1 (nie występuje)
240 Name
PaymentAmnt
Opis
Typ wiersza - zawsze 'P'
Nazwa instytucji
Kwota płatności
Uwagi techniczne
Plik zawierający dane formularza FAT-1 powinien spełniać następujące wymogi:




polskie znaki powinny być kodowane w systemie Windows-1250
separatorem mogą być znaki tabulator lub średnik (;), przy czym:
o plik z separatorem tabulator powinien mieć rozszerzenie „txt”
o plik z separatorem średnik powinien mieć rozszerzenie „csv”
jeśli pole tekstowe zawiera znak separatora, to powinno być zamknięte w cudzysłów
jeśli pole tekstowe zawiera cudzysłów, to powinno również być zamknięte w cudzysłów, a
wewnętrzne znaki cudzysłowu powinny być podwojone
Importowanie pliku dopisuje dane do już istniejących w formularzu za wyjątkiem sekcji FAT-1, która
może wystąpić tylko raz – w jej wypadku importowane dane zastępują te już istniejące w formularzu.
Takie rozwiązanie pozwala na niezależne tworzenie i importowanie plików dla różnych instytucji
raportujących oraz plików zawierających transakcje na rzecz instytucji wyłączonych.
Podsumowanie
Dokument
Wersja
Data utworzenia
Zmiany
Specyfikacja importu danych formularza FAT-1
2.0
11.05.2016
Zmieniono kolejność niektórych pól, aby dostosować ją do układu
formularza i wydruku.
str. 6