STAT-SASP

Spis treści

1. Wstęp

1. Cel

Celem specyfikacji jest zdefiniowanie standardu wymiany danych pomiędzy podmiotami, dla których wydane zostało pozwolenie na stosowanie SASP, w którym Polska jest krajem uczestniczącym, a jednostkami celnymi za pośrednictwem plików XML (eXtensible Markup Language).

Specyfikacja zawiera opis struktury i zawartości informacyjnej przesyłanych dokumentów w postaci plików XML.

2. Układ specyfikacji

Każdy dokument definiowany przez niniejszą specyfikację jest opisany przez rozdziały:

1. Struktura

fragmentaryczny przykład:

SAD	1
— Zgloszenie	1
— — UC	1
— — — Wartośćtowaru	1

gdzie:

Kolumna określająca strukturę dokumentu XML - drzewo elementów. Poziom zagłębienia elementu w drzewie elementów określa liczba znaków „—” poprzedzająca jego nazwę.

Kolumna określająca liczność elementu (powielarność). Możliwe są warianty „n” oraz „n..k”, gdzie n, k to liczby całkowite. Wartość „n” oznacza, że element musi wystąpić dokładnie n razy. Wartość „n..k” oznacza, że element musi wystąpić, co najmniej n-krotnie i maksymalnie k-krotnie.
Typowe przypadki to: „1” element musi wystąpić tylko raz; „0..1” element może wystąpić, ale tylko raz; „1..9” element musi wystąpić, co najmniej raz, a maksymalnie 9-krotnie; „0..9” element może wystąpić, ale maksymalnie 9-krotnie.

2. Zawartość informacyjna

fragmentaryczny przykład:

/SAD/Zgloszenie/MiejsceData

Lokalizacja

0..1

Miejsce Miejsce sporządzania deklaracji. Tekstowy opis np. "Kraków".

z14

84

Z

gdzie:

Nazwa elementu wraz ze ścieżką prezentującą elementy nadrzędne. Definiowany element oznaczony jest czcionką pogrubioną.

Tekst komentarza do elementu.

Liczność elementu (powielarność). Liczność jest też podawana w rozdziale „Struktura”.

Specyfikacja atrybutów elementu zawiera się w kolumnach:

Nazwa atrybutu (czcionka pogrubiona) i pod nim tekst komentarza do atrybutu.

Typ atrybutu (patrz rozdział „Typy danych”).

Kod słownika, definiującego możliwe wartości dla atrybutu (patrz rozdział „Słowniki”). Jeśli wartość atrybutu nie jest definiowana przez żaden słownik wówczas podany jest znak „-”.

Wymagalność atrybutu: "W" - wymagany, "O" - opcjonalny.

3. Schemat

Odsyła do pliku schematu według standardu World Wide Web Consortium - W3C Recommendation, 2 May 2001, definiującego dokument XML.

4. Przykłady

Odsyła do przykładowych plików.

Specyfikacja zawiera też rozdział:

• Słowniki

Zawiera listę słowników (ich kody i nazwy), które mają zastosowanie w dokumentach opisywanych w niniejszej specyfikacji.

1. Typy danych

1. Typ znakowy oznaczany jako „zn” lub „z..n”, gdzie n to liczba całkowita. Definiuje ciąg znaków o ściśle określonej długości - oznaczenie „zn” lub maksymalnej długości - oznaczenie „z..n” (dopuszczalne znaki opisano w rozdziale „Zestaw dopuszczalnych znaków”). W specyfikacji dla danych, które mogą zawierać tylko znaki cyfr, ale nie są traktowane jak liczby np. kod transportu stosuje się także typ znakowy.
   
   Przykłady typów znakowych i odpowiadających im poprawnych wartości:
   z10 1234567890
   z2 PL
   z..35 Firma Handlowo-Usługowa ABC S.A.

5. Typ numeryczny oznaczany jako „nk,l”, gdzie k to liczba całkowita większa od zera określająca maksymalną liczbę cyfr łącznie z częścią dziesiętną, a l to liczba całkowita większa lub równa zeru określająca maksymalną liczbę cyfr dziesiętnych. Typ ten definiuje liczby. Znakiem rozdzielającym cześć dziesiętną liczb jest „.” - kropka, która nie jest wliczana do całkowitej i dziesiętnej liczby cyfr.
   
   Przykłady typów numerycznych i odpowiadających im poprawnych wartości:
   n15,2 100.87 2300 100.8
   n7,0 2300 7777777
   Dla przykładowego typu n3,2 niepoprawna wartość to np. 333.22 (poprawne są np. 1.22, 111, 11.2)

6. Typ daty oznaczany jako „d”. Definiuje datę. Wartości tego typu należy podawać w formacie rrrr-mm-dd, gdzie: rrrr oznacza rok, mm miesiąc, dd dzień. Znakiem rozdzielającym jest znak „-” (myślnik). Numer miesiąca i dnia należy podawać z zerami poprzedzającymi.
   
   Przykład poprawnej wartości typu daty:
   2003-03-30
   

7. Typ daty i czasu oznaczany jako „dt”. Definiuje datę i czas. Wartości tego typu są zgodne z regułami typu daty zakończone znakiem „T” oraz wartością czasu w formacie gg:mm:ss, gdzie gg oznacza godzinę, mm minutę, ss sekundę. Znakiem rozdzielającym minuty od godzin i sekund jest znak „:” (dwukropek). Godziny minuty i sekundy należy podawać z zerami poprzedzającymi . Godziny podaje się w trybie 24 godzinnym.
   
   Przykład poprawnej wartości typu daty i czasu:
   2003-03-30T16:01:55

8. Typ logiczny oznaczany jako „b”. Definiuje dwie możliwe wartości „1” - tak oraz „0” - nie.

9. Typ numeryczny - liczby naturalne (integer) - oznaczany jako „i”.

1. Budowa dokumentu XML

Dokument XML zgodny z niniejszą specyfikacją powinien składać się z:

• deklaracji XML, która ma za zadanie określenie wersji standardu dokumentu XML (atrybut version) i strony kodowej (atrybut encoding), w jakiej zapisany jest dokument. Wspierana jest wersja 1.0 standardu XML. Przykład:
  
  <?xml version="1.0" encoding="UTF-8"?>
  

• ciała dokumentu XML zbudowanego na podstawie definicji elementów i atrybutów niniejszej specyfikacji.

1. Zestaw dopuszczalnych znaków

Zestaw dopuszczalnych znaków w wartościach atrybutów i elementów określa podana w deklaracji XML strona kodowa w postaci:

<?xml version="1.0" encoding="strona_kodowa"?>

np.: <?xml version="1.0" encoding="UTF-8"?>.

Dopuszczalne strony kodowe dokumentów przesyłanych przez podmioty to: UTF-8, ISO-8859-2, windows-1250.

Dokumenty przesyłane do podmiotów są zapisywane w stronie kodowej UTF-8.

Niezależnie od strony kodowej kilka znaków jest zastrzeżonych przez standard XML. Znaki te w przypadku konieczności ich użycia, w atrybutach lub elementach, muszą być zastępowane przez następujące sekwencje znaków:

• znak "&" należy zastąpić przez "&amp;"

• znak cudzysłowu " " " należy zastąpić przez "&quot;"

• znak apostrofu " ' " należy zastąpić przez "&apos;"

• znak mniejszości "<" należy zastąpić przez "&lt;"

• znak większości ">" należy zastąpić przez "&gt;"

Przykładowo ciąg znaków:

Firma Handlowo-Usługowa "ABC" Kowalski & Synowie S.C.

należy zamienić na:

Firma Handlowo-Usługowa &quot;ABC&quot; Kowalski &amp; Synowie S.C.

1. Wskazywanie elementów i atrybutów

Dla jednoznacznego wskazania elementu XML stosuje się wyrażenia zawierające kolejne nazwy elementów nadrzędnych rozdzielone znakiem „/”. Wyrażenie rozpoczyna się od znaku „/”, a wskazywany element jest umieszczany na końcu.

Przykładowo by wskazać element „UC” umieszczony w elemencie „Zgloszenie”, który jest umieszczony w elemencie „SAD” podaje się wyrażenie:

/SAD/Zgloszenie/UC.

Dla jednoznacznego wskazania atrybutu XML stosuje się wyrażenia jak dla wskazania elementu dodatkowo zakończone znakami „/@” i nazwą atrybutu.

Przykładowo by wskazać atrybut „UCZgloszenia” elementu „UC” umieszczonego w elemencie „Zgloszenie”, który jest umieszczony w elemencie „SAD” podaje się wyrażenie:

/SAD/Zgloszenie/UC/@ UCZgloszenia.

2. Rola załączonego schematu

Załączony plik o rozszerzeniu „xsd” zawiera definicje dokumentów xml specyfikacji według standardu „XML Schema” (maj 2001) organizacji W3C.

Wykorzystując parsery xml zgodne z powyższym standardem oraz załączony plik „xsd” możliwe są następujące rodzaje walidacji na dokumentach xml tworzonych zgodnie z niniejszą specyfikacją:

• sprawdzenie struktury,

• sprawdzenie typów danych,

Plik załączonego schematu nie umożliwia sprawdzenia zgodności dokumentu z regułami, a także sprawdzenia zgodności danych z wartościami przewidzianymi dla tych danych w słownikach.

2. Deklaracja statystyczna SASP

Deklaracje statystyczne w systemie STAT-SASP przekazywane są w postaci plików XML.

1. Struktura

SAD	1
— Zgłoszenie	1
— — UC	1
— — ZglaszajacyPrzedstawiciel	1
— — Transport	1
— — TransportNaGranicy	1
— — WarunkiDostawy	1
— — WartoscTowarow	1
— — Towar	1..999
— — — WartoscTowaru	1
— — MiejsceData	1

2. Zawartość informacyjna

/SAD

Element główny. Zawiera wszystkie pozostałe elementy.

1




xmlns Deklaracja przestrzeni nazw. Musi być podana w postaci: xmlns="http://www.krakow.uc.gov.pl/SASP/SASP-XML/xsd/SASPw1.xsd"	z..255	-	W
EmailPodmiotu Adres email, na który mogą być przesyłane dokumenty zwrotne dotyczące tego dokumentu.	z..35	-	W


/SAD/Zgloszenie

Zgłoszenie. Element grupujący dane zgłoszenia.

1




NrWlasny Musi być podany w formacie Rok+Rodzaj+Id, gdzie: - Rok to dwie ostatnie cyfry roku dokumentu (zgodne z /SAD/Zgloszenie/MiejsceData/@Data); - Rodzaj to znak "S"; - Id to ciąg maksymalnie 7 znaków cyfr od 0 do 9 i dużych liter od A do Z.	z4..10	-	W
P1a Określenie kierunku handlu - IM - import, EX - eksport.	z2	-	W
P1b Typ deklaracji - D - deklaracja, Z - zamiana deklaracji, A - anulowanie deklaracji	z1	-	W
P1c Okres sprawozdawczy - Miesiąc, Rok w układzie MM-RR (np. „06-09” dla czerwca 2009 roku)	Z5	-	W
LiczbaPozycji Liczba pozycji towarowych.	n3,0	-	W
RodzajTransakcji Kod rodzaju transakcji.	z..2	4	W
KrajWysylki Kod kraju wysyłki.	z2	7	W
KrajPrzeznaczenia Kod kraju przeznaczenia.	z2	7	W
Kontenery Informacja o występowaniu kontenerów. "0" - nie występują, "1" - występują.	b	-	W


/SAD/Zgloszenie/UC

Izba Celna. Element grupujący informacje o jednostkach celnych.

1




UCZgloszenia Kod Izby Celnej: tworzony przez dwie pierwsze cyfry kodu polskiej jednostki celnej podawanej w polu 10 Pozwolenia, uzupełnionej czterema zerami, bez poprzedzających liter `PL' (6 cyfr - 2 identyfikujące Izbę oraz cztery zera np. „350000”)

Z6

1

W





/SAD/Zgloszenie/ZglaszajacyPrzedstawiciel

Zgłaszający lub przedstawiciel.

1




REGON Numer EORI Numery EORI nadawane w Polsce mają następującą strukturę: • dla podmiotów krajowych składają się z: liter PL oraz numeru NIP uzupełnionego o pięć zer lub (dla podmiotów posiadających 14-znakowy numer REGON, ostatnie pięć znaków numeru REGON), • dla podmiotów z krajów trzecich składają się z: liter PL oraz sekwencyjnego, unikalnego ciągu 14 cyfr ze znakiem „Z” na końcu. w przypadku numerów EORI nadanych w innych krajach członkowskich, posiadających długość mniejszą niż 17 znaków, do numeru EORI należy podczas wypełniania dopisać na końcu odpowiednią ilość zer, do długości 17 znaków	z17	-	W
NrWpisu Numer pozwolenia na stosowanie SASP.	z..35	-	W

/SAD/Zgloszenie/Transport

Dane dotyczące transportu wewnętrznego.

1




Rodzaj Kod rodzaju transportu.

z1

5

W


/SAD/Zgloszenie/TransportNaGranicy

Dane dotyczące transportu na granicy.

1




Rodzaj Kod rodzaju transportu	z1	5	W
Kraj Kod kraju określający przynależność państwową środka transportu zapewniającego napęd.	z2	7	W


/SAD/Zgloszenie/WarunkiDostawy

Warunki dostawy.

1




Kod Kod warunków dostawy

z3

2

W


/SAD/Zgloszenie/WartoscTowarow

Wartość towarów. Element grupujący informacje dotyczące wartości towarów wszystkich pozycji towarowych.

1




Waluta Symbol waluty

z3

26

W

/SAD/Zgloszenie/Towar

Pozycja towarowa. Grupuje informacje o towarze.

1..999




PozId Identyfikator pozycji. Kolejny numer elementu w ramach elementu nadrzędnego. Numer pozycji towarowej.	n3,0	-	W
OpisTowaru Opis towaru.	z..260	-	W
KodTowarowy Kod towarowy zgodny z Nomenklaturą Scaloną.	z8	28	W
KodTaric Kod Taric. Rozszerzenie kodu towarowego o dwa znaki.	z2	28	O
KrajPochodzenia Kod kraju pochodzenia.	z2	7	W
MasaBrutto Masa brutto pozycji towarowej.	n11,3	-	W
Procedura Kod procedury celnej.	z4	3	W
MasaNetto Masa netto pozycji towarowej.	n11,3	-	W
IloscUzupelniajacaJm Ilość towaru w uzupełniającej jednostce miary.	n11,3	-	O

/SAD/Zgloszenie/Towar/WartoscTowaru

Wartość towaru. Element grupujący informacje dotyczące wartości pozycji towarowej.

1




WartoscPozycji Wartość pozycji.	n15,2	-	W
WartoscStatystyczna Wartość statystyczna.	n15,0	-	W


/SAD/Zgloszenie/MiejsceData

Element grupujący dane o miejscu, dacie złożenia deklaracji i osobie zgłaszającej lub przedstawicielu.

1




Miejsce Miejsce sporządzania deklaracji. Tekstowy opis np. "Kraków".	z..35	-	W
Data Data sporządzenia deklaracji.	d	-	W
NazwiskoImie Nazwisko i imię osoby sporządzającej deklarację.	z..35	-	W
Telefon Telefon kontaktowy osoby sporządzającej deklarację.	z..15	-	O







1. Schemat

Schemat elektronicznej deklaracji statystycznej SASP znajduje się w pliku SASP_schem_w1.xsd, który jest załączony do specyfikacji.

2. Przykłady

Przykłady deklaracji SASP znajdują się w plikach SASP_przyklady_w1_n.xml, załączonych do specyfikacji (n to kolejny numer pliku).

3. Słowniki


Słowniki wykorzystywane w dokumentach opisywanych w niniejszej specyfikacji dostępne są pod adresem www.e-clo.pl/slowniki/pdr.


Poniższa tabela zawiera zestawienie kodowych oznaczeń słowników oraz ich nazw.

Kod (numer) słownika	Nazwa słownika
001	Kody urzędów celnych
002	Symbole warunków dostaw według INCOTERMS 2000
003	Kody przeznaczeń i procedur celnych
004	Kody rodzajów transakcji
005	Kody rodzajów transportu
007	Kody krajów
026	Wykaz walut
028	Kody towarowe według nomenklatury towarowej

Przez parser rozumie się tu oprogramowanie umożliwiające sprawdzenie zgodności podanego pliku xml z podanym schematem - czyli plikiem typu „xsd”. Na rynku dostępnych jest wiele tego typu parserów, również darmowych.

Nazwa projektu: STAT-SASP
Nazwa dokumentu: Specyfikacja elektronicznych zgłoszeń celnych XML dla SASP

strona 7/13

Specyfikacja elektronicznych deklaracji statystycznych XML dla SASP

i

i

---