Co to jest usługa sieciowa
To usługa, która umożliwia przesyłanie elektronicznych komunikatów (zgłoszeń, wniosków, potwierdzeń itp.) bezpośrednio między twoim systemem a PUESC. Struktura przesyłanych komunikatów musi być zgodna ze strukturą XML (schematem XSD).
Aby skorzystać z kanału webservice konieczne jest specjalne oprogramowanie. Możesz zakupić program komercyjny, który umożliwia korzystanie z tej usługi, lub dostosować oprogramowanie własne. Oprogramowanie takie musi umożliwiać przesłanie komunikatów w wymaganej strukturze (specyfikacja XML komunikatu) za pośrednictwem udostępnionego kanału (specyfikacja kanału webservice).
Uwaga: Zarówno strukturę XML i specyfikację wymagań kanału komunikacyjnego znajdziesz poniżej. Pamiętaj, że mogą one ulegać zmianom, które wynikają najczęściej z konieczności dostosowania do zmian prawnych. To z kolei powoduje konieczność każdorazowego dostosowania Twojego oprogramowania do nowych wymagań.
Zmiany są sygnalizowane przez KAS z odpowiednim wyprzedzeniem, tak aby klienci lub producenci oprogramowania mogli dostosować na czas własne systemy. Jeśli zdecydujesz się na zakup programu komercyjnego, sprawdź czy licencja na nie obejmuje również jego aktualizację, w tym dostosowanie do zmieniających się wymagań KAS.
Usługa sieciowa SEAP jest podstawowym kanałem komunikacyjnym użytkowników zewnętrznych z Systemem Informacyjnym Skarbowo-Celnym (SISC), który wykorzystuje webservice i umożliwia przesyłanie komunikatów elektronicznych w strukturze XML. Obsługuje on komunikację dwustronną. Oznacza to, że umożliwia zarówno przesyłanie komunikatów elektronicznych z Twojego systemu bezpośrednio do PUESC, jak i pobieranie odpowiedzi.
Jeśli Twój system będzie komunikował się z usługą sieciową zgodnie ze specyfikacją, to PUESC będzie zwrotnie przesyłać do niego odpowiedzi (bez konieczności cyklicznego odpytywania usługi sieciowej SEAP). Poniżej znajdziesz informacje m.in. o skonfigurowaniu komunikacji za pośrednictwem tego kanału, uwierzytelnianiu usługi sieciowej, strukturze i zawartości informacyjnej komunikatu, kopercie. Jeśli używasz oprogramowania komercyjnego, informacje o wykorzystaniu usługi sieciowej powinny znajdować się w instrukcji obsługi tego oprogramowania.
Wykaz komponentów SISC udostępniających usługi sieciowe
- Automatyczny System Eksportu (AES),
- Automatyczny System Importu (AIS),
- System Przemieszczania i Nadzoru Wyrobów Akcyzowych (EMCS PL2),
- System Zintegrowanej Taryfy Celnej (ISZTAR4),
- System Kontroli Tranzytu – Nowy Skomputeryzowany System Tranzytowy (NCTS2),
- Zintegrowany System Obsługi Zabezpieczeń (OSOZ2),
- Platforma Koordynacji i Wymiany Danych – Single Window (PKWD–SINGLE WINDOW),
- System do Rozliczania Procedur Specjalnych (RPS),
- System Awizacji Towarów i Osób (SATOS),
- System Pojedynczy Elektroniczny Punkt Dostępu (SEAP),
- System Elektronicznego Nadzoru Transportu (SENT),
- System Zwrot VAT dla Podróżnych (TAX FREE),
- Zintegrowany System Poboru Należności i Rozliczania z UE i Budżetem (ZEFIR2).
Informacja dla integratorów i programistów
- Potraktuj poniższe specyfikacje jako dokument źródłowy przy projektowaniu i implementacji systemu informatycznego, który będzie wykorzystywać kanał webservice.
- Zapoznaj się również z informacjami o dostępnych środowiskach testowych, w których możesz sprawdzić poprawność działania tworzonego przez ciebie oprogramowania.
Kanał komunikacyjny SEAP
- SEAP PLUS Specyfikacja Techniczna Publiczna PL <dokumentacja jest jeszcze procedowana w Projekcie P4.4, termin publikacji nie jest znany>
Materiały informacyjne
Materiały do publikacji w przygotowaniu
Środowisko testowe SISC
Jeśli chcesz sprawdzić funkcjonalności kanału webservice skorzystaj ze środowiska testowego:
System AES
Specyfikacje usług sieciowych
Specyfikacje komunikatów AES
- AES Specyfikacja techniczna XML errata wraz z załącznikiem 1.26 PL
- AES Specyfikacja techniczna XML wraz z załącznikami 1.26 PL
- AES Technical Specification XML including attachments 1.26 EN
- AES Specyfikacja techniczna XML wraz z załącznikami 1.24 PL
- AES Technical Specification XML including attachments 1.24 EN
Materiały informacyjne AES
- AES Formularz uwag do specyfikacji publicznej AES
- AES Wstępne informacje o specyfikacji publicznej XML systemu AES
- AES Formularz uwag do specyfikacji publicznej AES wersja 12.5
- AES Instrukcja Wypełniania Zgłoszeń Celnych AIS/IMPORT, AES/ECS2, NCTS2 wersja 2.2
- AES Wykaz zmian do Instrukcji wypełniania zgłoszeń celnych AIS/IMPORT, AES/ECS2, NCTS2 w wersji 2.2 24.07.2020 r
- AES Instrukcja w zakresie obsługi w Systemie AES (Instrukcja dla użytkowników zewnętrznych) wersja 1.0
- AES Informacja uzupełniająca do „Instrukcji w zakresie obsługi w Systemie AES dla użytkowników zewnętrznych, wersja 1.0 16.05.2018r
System AIS
Specyfikacje usług sieciowych
Specyfikacje komunikatów AIS
AIS/IMP
- AIS/IMP Specyfikacja techniczna XML wersja 3.12.100 PL
- AIS/IMP Specyfikacja techniczna XML załączniki wersja 3.12.100 PL
- AIS/IMP Specyfikacja techniczna XML wraz z załącznikami wersja 3.14.100. PL
- AIS/IMP Specyfikacja techniczna XML załączniki wersja 3.14.0. PL
AIS/ICS
- AIS/ICS Specyfikacja techniczna XML wraz z załącznikami wersja 1.07.000 PL
- AIS/IMP Technical Specification XML including attachments version 1.07.000. EN
AIS e-Commerce
- AIS/IMP Specyfikacja techniczna XML dla H6 i H7 (publiczna) wraz z załącznikami
- AIS/IMP Specyfikacja techniczna XML załączniki wersja 3.12.1. PL
AIS/INTRASTAT
- AIS/INTRASTAT Specyfikacja techniczna XML wersja 1.10.000 PL
- AIS/INTRASTAT Specyfikacja techniczna XML wersja 1.10.000 EN
- AIS/INTRASTAT pliki schematów XSD komunikatów XML
Materiały informacyjne AIS
AIS/IMP
- AIS Formularz uwag do specyfikacji publicznej AIS
- AIS Pytania i odpowiedzi (FAQ) 28.01.2021
- AIS Instrukcja Wypełniania Zgłoszeń Celnych AIS/IMPORT, AES/ECS2, NCTS2 wersja 2.2
- AIS/IMP Wykaz zmian do Instrukcji wypełniania zgłoszeń celnych AIS/IMPORT, AES/ECS2, NCTS2 w wersji 2.2 24.07.2020
- Instrukcja wypełniania deklaracji do czasowego składowania w systemie AIS/IMPORT wersja 1.01
- AIS/IMP Informator dla podmiotów zaangażowanych w przywozowe procesy celne realizowane drogą elektroniczną, wersja 1.0
AIS/ICS
- AIS Formularz uwag do specyfikacji publicznej AIS
- AIS/ICS Rejestracja na potrzeby nowych systemów AIS/ICS
- AIS Pytania i odpowiedzi (FAQ)
- AIS/ICS Wytyczne dotyczące zasad przesyłania komunikatów PTW do systemu AIS/ICS
AIS E-COMMERCE
- AIS/e-Commerce Informacja o publikacji sxml dla H6 i H7 w AIS_IMPORT (e-commerce)
- AIS/e-Commerce Formularz uwag do specyfikacji publicznej AIS/IMPORT dla H6 i H7 (e-commerce) 06.08.2020
- AIS/e-Commerce Instrukcja wypełniania zgłoszeń celnych dla potrzeb przesłania komunikatu ZC215H7 do systemu AIS/IMPORT (projekt) (e-commerce) wersja 1.0 04.06.2020
- AIS/e-Commerce Zasady działania nowego kalkulatora w ISZTAR4 dla H6 I H7 wersja 24.07.2020
- AIS/e-Commerce H6 Towary akcyzowe do 45 EUR
- AIS/e-Commerce H7 Towary akcyzowe do 45 EUR
- AIS/e-Commerce Kody HS stosowane w deklaracji H7 do 150 EUR
- AIS/e-Commerce Kody CN stosowane w deklaracji H6 do 1000 EUR
- AIS/e-Commerce Wykaz towarów, które nie mogą być zgłaszane w deklaracjach H6 i H7
- AIS/e-Commerce Ewidencja USZ dla operatorów pocztowych innych niż operator wyznaczony
- AIS/e-Commerce Wymagania ewidencji USZ
- AIS/e-Commerce (FAQ)
AIS/INTRASTAT
- AIS/INTRASTAT Podstawowe informacje nt. składania zgłoszeń
- AIS/INTRASTAT Instrukcja wypełniania i przesyłania zgłoszeń INTRASTAT wersja 1.11 PL
- AIS/INTRASTAT Instrukcja wypełniania i przesyłania zgłoszeń INTRASTAT wersja 1.11 EN
- AIS/INTRASTAT Instrukcja wypełniania i przesyłania zgłoszeń INTRASTAT wersja 1.12 PL
- AIS/INTRASTAT Instrukcja wypełniania i przesyłania zgłoszeń INTRASTAT wersja 1.12 EN
- AIS/INTRASTAT Pytania i odpowiedzi (FAQ)
- AIS/INTRASTAT Najczęściej popełniane błędy
Generowanie elektronicznych zgłoszeń INTRASTAT
- AIS/INTRASTAT Program do generowania zgłoszeń INTRASTAT w postaci elektronicznej (ist@t)
- AIS/INTRASTAT Formularz zgłoszenia INTRASTAT (komunikat IST)
Brexit w kontekście INTRASTAT
- AIS/INTRASTAT Brexit w kontekście INTRASTAT
- AIS/INTRASTAT Brexit w kontekście INTRASTAT Załącznik 1
- AIS/INTRASTAT pliki schematów XSD komunikatów XML
Informacje szczegółowe o INTRASTAT
System EMCS PL2
Specyfikacje komunikatów EMCS PL2
- EMCS Specyfikacja techniczna XML dla e-DD v800 20200213
- EMCS Specyfikacja techniczna XML dla e-AD załączniki
- EMCS Specyfikacja techniczna XML dla e-DD v500 20210201
- EMCS Specyfikacja techniczna XML dla e-DD załączniki
Materiały informacyjne EMCS PL2
- Instrukcja użytkownika systemu EMCSPL 2 (e-DD)
- Instrukcja użytkownika systemu EMCSPL 2 (e-AD) <w przygotowaniu>
- Instrukcja dotycząca procedury awaryjnej dla systemu EMCS PL 2
System ISZTAR4
Specyfikacje usług sieciowych
Specyfikacje komunikatów ISZTAR4
ISZTAR4 Specyfikacja techniczna XML wersja 3.10 z dnia 22.01.2020
Materiały informacyjne ISZTAR4
Materiały do publikacji w przygotowaniu
System NCTS2
Specyfikacje usług sieciowych
Specyfikacje komunikatów NCTS2
NCTS2 Specyfikacja techniczna XML wersja 10.09 z dnia 11.02.2017
Materiały informacyjne NCTS2
- NCTS2 FAQ do specyfikacji technicznej XML
- NCTS2 Informacje wstępne o specyfikacji NCTS2
- NCTS2 Formularz uwag do specyfikacji technicznej XML
- NCTS2 Instrukcja - Rejestracja podmiotu na potrzeby NCTS2
- NCTS2 Informacja o udostępnieniu instrukcji e-Załączniki
- NCTS2 e-Załączniki Instrukcja dla podmiotów wersja 1.2 z dnia 1.04.2019
- NCTS2 Załącznik nr 1(e-Załączniki)
- NCTS2 Załącznik nr 2 (e-Załączniki)
- NCTS2 Załącznik nr 3 (e-Załączniki)
- NCTS2 Załącznik nr 4 (e-Załączniki)
- NCTS2 Instrukcja wypełniania zgłoszeń celnych AIS_IMPORT AES_ECS2 NCTS2 wersja 2.2
- NCTS2 Wykaz zmian do Instrukcji wypełniania zgłoszeń celnych wersja 2.2
System OSOZ2
Specyfikacje komunikatów OSOZ2
<specyfikacja komunikatów usługi sieciowej OSOZ2 nie jest publikowana. Specyfikacja ta jest jedynie udostępniana na żądanie>
Materiały informacyjne OSOZ2
Materiały do publikacji w przygotowaniu
System PKWD-SINGLE WINDOW
Specyfikacje komunikatów PKWD-SINGLE WINDOW
- PKWD-SINGLE WINDOW Specyfikacja techniczna Systemu Publiczna 3.10 08.10.2020 PL <Podana została obecna wersja dokumentacji. Materiały do publikacji są aktualnie w fazie aktualizacji/modyfikacji przez Wykonawcę. Przewidywany termin dostawy 26.02.2021, wersja i data dokumentacji może ulec zmianie. Docelowo będzie to paczka zip z dokumentacją w formie tekstowej oraz załącznikami w formie plików xsd>
Materiały informacyjne PKWD-SINGLE WINDOW
Materiały do publikacji w przygotowaniu
System RPS
Specyfikacje komunikatów RPS
Materiały informacyjne RPS
System SATOS
Specyfikacje usług sieciowych
Specyfikacje komunikatów SATOS
Materiały informacyjne SATOS
System SENT
Specyfikacje usług sieciowych
- Specyfikacja techniczna usługi sieciowej SEAP
- Specyfikacja techniczna usługi sieciowej DIRECT SENT
Specyfikacje komunikatów SENT
- Specyfikacja Techniczna Komunikatów systemu SENT (wersja 20210118)
- Specyfikacja Techniczna Komunikatów Usług ZSL_OBU (wersja 20210118)
- Specyfikacja Techniczna usługi SENT-GEO.zip
Materiały informacyjne SENT
Materiały do publikacji w przygotowaniu
System SZPROT
Specyfikacje usług sieciowych
Specyfikacje komunikatów SZPROT
Materiały do publikacji w przygotowaniu
Materiały informacyjne SZPROT
Materiały do publikacji w przygotowaniu
System TAX FREE
Dokumentacja opublikowana w serwisie Tax Free (link otwiera się w nowym oknie lub na nowej karcie przeglądarki).
System ZEFIR2
Specyfikacje komunikatów ZEFIR2
- Specyfikacja_XML_inicjalna_z_25.05.2017- Specyfikacja komunikatów XML systemu ZEFIR 2 - inicjalna
- Specyfikacja_XML_v2_0_z_06.11.2019 - Specyfikacja komunikatów XML systemu ZEFIR 2 - v2
- Specyfikacja_XML_v3_0_z_18.02.2020 - Specyfikacja komunikatów XML systemu ZEFIR 2 - v3
- Specyfikacja_XML_v4_0_z_18.02.2020 - Specyfikacja komunikatów XML systemu ZEFIR 2 - v4
- Specyfikacja_XML_v5_0_z_19.02.2020 - Specyfikacja komunikatów XML systemu ZEFIR 2 - v5
- Wykaz błędów powodujących odrzucenie elektronicznej deklaracji
Materiały informacyjne ZEFIR2
- ZF2_ewidencja_VAT14_20160930.zip - Plik zawiera: skoroszyt Excel do prowadzenia ewidencji VAT-14 oraz instrukcję obsługi. Skoroszyt umożliwia wyeksportowanie wprowadzonych danych do pliku XML. Następnie tak stworzony plik XML można zaimportować do formularza deklaracji VAT-14.
- ZF2_ewidencja_AKCU_20160930.zip - Plik zawiera: skoroszyt Excel do prowadzenia ewidencji AKC-U oraz instrukcję obsługi. Skoroszyt umożliwia wyeksportowanie wprowadzonych danych do pliku XML. Następnie tak stworzony plik XML można zaimportować do formularza deklaracji AKC-U.
- ZF2_ewidencja_AKCUS_20190717.zip - Plik zawiera skoroszyt Excel do prowadzenia ewidencji AKC-U/S oraz instrukcję obsługi wraz z przykładowym plikiem XML zawierającym dane z samochodami osobowymi. Skoroszyt umożliwia wyeksportowanie wprowadzonych danych do pliku XML. Następnie tak stworzony plik XML można zaimportować do formularza deklaracji AKC-U/S. W tej wersji ewidencji użytkownik będzie mógł zaznaczyć w rekordzie czy auto ma posiadać zwolnienie z podatku akcyzowego w związku z rodzajem napędu: elektryczne, hybrydowe etc.
- ZF2_ewidencja_AKCUS_v2_1_20200227.zip - Plik zawiera skoroszyt Excel do prowadzenia ewidencji AKC-U/S dla wersji formularza nr 2_1 oraz instrukcję obsługi wraz z przykładowym plikiem XML zawierającym dane z samochodami osobowymi. Skoroszyt umożliwia wyeksportowanie wprowadzonych danych do pliku XML. Następnie tak stworzony plik XML można zaimportować do formularza deklaracji AKC-U/S w wersji 2_1. W tej wersji ewidencji użytkownik będzie mógł zaznaczyć w rekordzie „Typ zwolnienia": mienie przesiedleńcze; samochód elektryczny / napędzany wodorem; samochód specjalistyczny; samochód hybrydowy; pozostałe zwolnienia bądź pozostawić puste pole.
- ZF2_ewidencja_AKCUS_v3_20200229.zip - Plik zawiera skoroszyt Excel do prowadzenia ewidencji AKC-U/S dla wersji formularza nr 3 oraz instrukcję obsługi wraz z przykładowym plikiem XML zawierającym dane z samochodami osobowymi. Skoroszyt umożliwia wyeksportowanie wprowadzonych danych do pliku XML. Następnie tak stworzony plik XML można zaimportować do formularza deklaracji AKC-U/S w wersji 3.