REST API dla SI*GIIF

Ogólne założenia API

Schemy

Definicje schem można pobrać poniżej:

http://www.giif.mofnet.gov.pl/xsd/rest/slowniki20171017
Obsługa słowników
http://www.giif.mofnet.gov.pl/xsd/rest/certyfikaty20171017
Obsługa certyfikatów
http://www.giif.mofnet.gov.pl/xsd/rest/komunikaty20171017
Obsłga plików
http://www.giif.mofnet.gov.pl/xsd/rest/pliki20171017
Obsłga przesyłania plików
http://www.giif.mofnet.gov.pl/xsd/rest/instytucje20181218
Lista instytucji obowiązanych
http://www.giif.mofnet.gov.pl/xsd/upo/2018
Struktura logiczna urzędowego poświadczenia odbioru.
http://crd.gov.pl/wzor/2018/10/19/5991/
Rejestracja instytucji obowiązanej, dane instytucji obowiązanej. Schema do pobrania z powyższego linku, jest rozszerzona w porównaniu do schemy opublikowanej w CRD o opcjonalny element csr, który może zostać użyty do przesłania csr do wystawienia certyfikatu komunikacyjnego wraz z rejestracją instytucji obowiązanej.
http://crd.gov.pl/wzor/2019/06/11/7925/
Karta transakcji gotówkowej
http://crd.gov.pl/wzor/2019/06/11/7924/
Karta transakcji notarialnej
http://crd.gov.pl/wzor/2019/06/11/7927/
Karta transakcji transferu
http://crd.gov.pl/wzor/2019/06/11/7926/
Karta transakcji wymiany

Certyfikaty Komunikacyjne

Certyfikaty komunikacyjne pozwalają na uwierzytelnienie w systemie bez konieczności wielokrotnego wpisywania PINu podpisu kwalifikowanego.

Certyfikaty komunikacyjne wystawiane są po przedstawieniu podpisanego podpisem kwalifikowanym żądania wystawienia certyfikatu.

Certyfikat komunikacyjny ma Distinguished Name składające się z:

Data notAfter certyfikatu komunikacyjnego ustawiana jest na taką samą wartość jak data notAfter certyfikatu kwalifikowanego dla którego wystawiany jest certyfikat komunikacyjny.

Certyfikat komunikacyjny jest powiązany w bazie z certyfikatem kwalifikowanym, dla którego został wystawiony. Jeżeli certyfikat kwalifikowany zostanie zablokowany dla Instutucji Obowiązanej, to certyfikat komunikacyjny wystawiony dla tego certyfikatu kwalifikowanego nie pozwoli na dostęp do Instytucji Obowiązanej. Jeżeli certyfikat kwalifikowany zostanie w systemie oznaczony jako zastrzeżony, to certyfikat komunikacyjny nie zostanie przyjęty.

Ponadto istnieje możliwość zastrzeżenia certyfikatu komunikacyjnego, powoduje to, że certyfikat komunikacyjny nie zostanie przyjęty, ale nie wpływa na ważność powiązanego z nim certyfikatu kwalifikowanego. (Use case: skradziono komputer, na którym znajdował się klucz do certyfikatu komunikacyjnego, ale nie skradziono karty podpisu elektronicznego).

System SI*GIIF gwarantuje, że numer seryjny certyfikatu komunikacyjnego będzie unikalny (nawet w przypadku zmiany CA dla certyfikatów komunikacyjnych).

Certyfikaty komunikacyjne.

Pobranie certyfikatu CA

URL

/api/rest2018/certyfikatyKomunikacyjne/CA

Metoda

GET

Accept

application/x-pem-file

Parametry zapytania

brak

Uwierzytelnienie

brak

Zwraca

Lista certyfikatów CA dla certyfikatów komunikacyjnych. Zwracana jako konkatenacja plików PEM z certyfikatami CA.

Pobranie certyfikatu komunikacyjnego

URL

/api/rest2018/certyfikatyKomunikacyjne/:hash

Metoda

GET

Accept

application/pkix-cert
Zwrócony zostanie certyfikat w formacie DER
application/x-pem-file
Zwrócony zostanie certyfikat w formacie PEM.

Parametry zapytania

hash
suma kontrolna CSR, wyliczona jako SHA-256 z reprezentacji DER pliku CSR. 32 bajty zapisane w formacie hexBinary, każdemu bajtowi odpowiadają dwie cyfry hexadecymalne. Wielkość liter nie jest istotna.

Uwierzytelnienie

brak

Zwraca

Certyfikat komunikacyjny.

Błędy

404
hash nie odpowiada żadnemu zarejestrowanemu CSRowi.
410
Certyfikat wystawiony dla CSR o przedstawionym hash jest został zastrzeżony lub anulowany.
503
CSR któremu odpowiada przedstawiony hash czeka na przetworzenie. Przetworzenie certyfikatu powinno trwać kilka sekund. Jeżeli certyfikat kwalifikowany użyty do podpisania żądania nie jest zatwierdzony dla instytucji, to certyfikat komunikacyjny pozostanie w stanie oczekującym, aż do zatwierdzenia certyfikatu kwalifikowanego.

Certyfikat do szyfrowania

Pobranie certyfikatu do szyfrowania

To wywołanie pozwala pobrać certyfikat używany do szyfrowania plików z transakcjami, zawiadomień i załączników zawiadomień.

URL

/api/rest2018/certyfikatSzyfrowania

Metoda

GET

Accept

application/x-pem-file application/pkix-cert

Parametry zapytania

brak

Uwierzytelnienie

brak

Zwraca

Zwraca certyfikat odpowiednio w formacie PEM lub DER.

Instytucje

Dane Instytucji

Rejestracja nowej Instytucji Obowiązanej

To wywołanie pozwala zarejestrować nową Instytucję Obowiązaną.

URL

/api/rest2018/instytucje

Metoda

POST

Content-Type

application/xml

Accept

text/plain

Dane

Podpisany dokument zgodny z http://crd.gov.pl/wzor/2018/10/19/5991/

Uwierzytelnienie

Dane muszą być podpisane kwalifikowanym podpisem elektronicznym.

Zwraca

201
Jeżeli przesłano wraz z rejestracją instytucji plik CSR, oprócz statusu zwracany jest link do pobrania certyfikatu komunikacyjnego.
200
Jeśli nie przesłano CSRa, zwracany jest tekstowy komunikat o powodzeniu rejestracji.

Błędy

409
Taka instytucja już istnieje w systemie, a plik nie jest oznaczony jako aktualizacja.

Lista instutucji

To wywołanie zwraca listę instytucji obowiązanych, do których można uzyskać dostęp z użyciem przedstawionego certyfikatu komunikacyjnego.

URL

/api/rest2018/instytucje

Metoda

GET

Accept

application/xml

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

Dokument XML zgodny z namespace http://www.giif.mofnet.gov.pl/xsd/rest/instytucje20181218

Dane instytucji obowiazanej

To wywołanie zwraca informacje o jednej Instytucji Obowiązanej. Aby pobrać informacje o instutucji, użytkownik musi być uwierzytelniony certyfikatem komunikacyjnym zapewniającym dostęp do tej instytucji.

URL

/api/rest2018/instutucje/:nip

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

Dokument XML o formacie zbliżonym do opisanego w namespace http://crd.gov.pl/wzor/2018/10/19/5991/

Dane w zwracanym dokumencie XML odzwierciedlają zatwierdzone dane Instytucji w systemie SI*GIIF. W szczególności mogą one nie zawierać zmian wprowadzonych przez zakualizacje wykonane w ostatnim dniu roboczym.

Dla instytucji zarejestrowanych zgodnie z przepisami ustawy z 2001 roku, które nie dokonały aktualizacji danych, niektóre pola uważane w schemie za obowiązkowe, pozostaną nie wypełnione (np. OsobaKontaktowa).

Modyfikacja informacji o Instytucji Obowiązanej

To wywołanie pozwala zarejestrować zmianę informacji o instytucji obowiązanej.

Uwaga: Taka zmiana, nim zostanie uwzględniona w systemie oczekuje na akceptację operatora (pracownika GIIFa) w systemie SI*GIIF.

URL

/api/rest2018/instutucje/:nip

Metoda

PUT

Content-Type

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.

Dane

Podpisany dokument XML zgodny z namespace http://crd.gov.pl/wzor/2018/10/19/5991/

Uwierzytelnienie

Dane muszą być podpisane kwalifikowanym podpisem elektronicznym.

Zwraca

200
Przyjęto żądanie aktualizacji instytucji.
400
Żądanie niepoprawne.

Certyfikaty

Lista certyfikatów instytucji obowiązanej

To wywołanie zwraca listę certyfikatów kwalifikowanych zarejestrowanych dla Instytucji Obowiązanej.

URL

/api/rest2018/instutucje/:nip/certyfikaty

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

Element certyfikaty z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/certyfikaty20171017

Lista certyfikatów dla certyfikatu komunikacyjnego

To wywołanie zwraca listę certyfikatów komunikacyjnych powiązanych ze wskazanym certyfikatem kwalifikowanym

URL

/api/rest2018/instutucje/:nip/certyfikaty/:cioId/komunikacyjne

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.
cioId
Identyfikator certyfikatu kwalifikowanego, pobrany z atrybutu id elementu certyfikat z listy certyfikatów dla instytucji.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

Element certyfikaty z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/certyfikaty20171017

Rejestracja certyfikatu dla Instytucji Obowiązanej

To wywołanie pozwala zarejestrować certyfikaty kwalifikowane w Instytucji Obowiązanej oraz zarejestrować CSR.

Jeżeli wywołanie jest używane do rejestracji CSR, to lista przekazywanych certyfikatów kwalifikowanych musi być pusta lub zawierać wyłącznie certyfikat użyty do podpisania tego żądania.

URL

/api/rest2018/instutucje/:nip/certyfikaty

Metoda

POST

Content-Type

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.

Dane

Element RejestracjaCertyfikatu z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/certyfikaty20171017

Uwierzytelnienie

Dane muszą być podpisane kwalifikowanym podpisem elektronicznym.

Zwraca

201
Jeśli rejestracja powiodła się, zwracane jest URI do pobrania certyfikatu komunikacyjnego (o ile wysłano CSR).
202
Jeśli rejestracja powiodła się, ale nie przekazano CSR.
400
Jeśli format żądania nie był poprawny.
409
Jeśli przesłane certyfikaty lub CSRy były wcześniej zarejestrowane.

Blokada certyfikatu.

To wywołanie pozwala zablokować dostęp certyfikatu kwalifikowanego do Instytucji Obowiązanej oraz zablokować certyfikaty komunikacyjne.

URL

/api/rest2018/instutucje/:nip/certyfikaty/zablokuj

Metoda

POST

Content-Type

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.

Dane

Element BlokadaCertyfikatu z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/certyfikaty20171017

Element certyfikat zawiera certyfikat kwalifikowany do zablokowania. Jeśli blokowany jest certyfikat komunikacyjny to można wskazać, elementem nip, listę instytucji w których certyfikat zostanie zablokowany, domyślnie certyfikat blokowany jest w instytucji wskazanej w NIPie podanym w URL.

Element certyfikatKomunikacyjny zawiera certyfikat komunikacyjny do zablokowania.

Nie można jednocześnie blokować certyfikatów kwalifikowanych i certyfikatów komunikacyjnych.

Uwierzytelnienie

Dane muszą być podpisane kwalifikowanym podpisem elektronicznym.

Zwraca

200
Blokada powiodła się.
403
Blokada nie powiodła się z powodu braku uprawnień.
400
Nieprawiłowe dane w zapytaniu.

Wykazy Transakcji

Lista plikow przesłanych przez Instytucję Obowiązaną

To wywołanie zwraca listę plików przesłanych przez Instytucję Obowiązaną. Lista plików jest sortowana po dacie otrzymania pliku, malejąco.

URL

/api/rest2018/instutucje/:nip/pliki?wyslanePo&wyslanePrzed&hashZaszyfrowany&hashJawny&status&od&ilosc

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju. Wymagane
wyslanePo
ogranicz do plików wysłanych po wskazanej dacie, przyjmuje daty w formacie yyyy-MM-dd (xsd:date), yyyy-MM-ddThh:mm:ss i wariant ze strefą czasową: yyyy-MM-ddThh:mm:ss+hh:mm (xsd:dateTime). Jeżeli nie wskazano strefy czasowej, to przyjmowana jest Europe/Warsaw. Opcjonalne
wyslanePrzed
ogranicz do plików wysłanych przed wskazaną datą. Format taki sam jak dla pola wyslanePo. Opcjonalne
hashZaszyfrowany
ogranicz do pliku o wskazanej sumie kontrolnej pliku zaszyfrowanego. Sumę kontrolną należy przekazać jako xsd:hexBinary. Opcjonalne
hashJawny
ogranicz do pliku o wskazanej sumie kontrolnej pliku jawnego. Sumę kontrolną należy przekazać jako xsd:hexBinary. Opcjonalne
status
ogranicz do plików o wskazanym statusie. To pole mozna powtarzać, wówczas wyświetlone zostaną pliki o statusie pasującym do dowolnego z przekazanych. Statusy to “Z” - plik zarejestrowany, “O” - podpis oczekuje na sprawdzenie (deszyfrowanie przebiegło poprawnie), “P” - podpis poprawny (plik oczekuje na walidację zawartości), “R” - plik poprawny (walidacja przebiegła poprawnie), “X” - plik niepoprawny, “W” - plik niepoprawny-wyjaśniony. Opcjonalne
od
paginacja, pierwszy rezultat do pokazania, domyślnie 0.
ilosc
paginacja, liczba resultatów do pokazania, domyślnie 25.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

200 :Element pliki z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/pliki20171017

Przesyłanie pliku z transakcjami.

To wywołanie pozwala przesłać plik z transakcjami.

URL

/api/rest2018/instytucje/:nip/pliki

Metoda

POST

Dane

Zaszyfrowany plik z transakcjami.

Content-Disposition

Nazwę pliku można przekazać ustawiając nagłówek Content-Disposition na attachment z nazwą pliku w polu filename lub filename*

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

200 :Element plik z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/pliki20171017

409 :Plik powtórnie przesłany.

413 :Plik większy niż dopuszczalny rozmiar.

UPO do wykazu transakcji

To wywołanie zwraca Urzędowe Poświadczenie Odbioru dla wskazanego pliku

URL

/api/rest2018/instutucje/:nip/pliki/:plzId/upo

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju. Wymagane
plzId
Identyfikator zawiadomienia.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

200
XML z Urzędowym Poświadczeniem Odbioru
403
Przedstawiony certyfikat komunikacyjny nie umożliwia dostępu do Instytucji
404
Instytucja Obowiązana nie przekazała pliku o tym identyfikatorze.
503
Plik oczekuje na przetworzenie
410
Plik zawiera błędy uniemożliwiające przetworzenie.

Komunikaty do Instytucji Obowiązanej

Lista komunikatów do Instytucji Obowiązanej

To wywołanie zwraca listę komunikatów do Instytucje Obowiązanej.

URL

/api/rest2018/instutucje/:nip/komunikaty

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

Element komunikaty z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/komunikaty20171017

Pobierz listę wyróżników komunikatów do Instucji Obowiązanej

To wywołanie zwraca listę wyróżników komunikatów do Instytucje Obowiązanej.

URL

/api/rest2018/instutucje/:nip/komunikaty/wyrozniki?q

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.
q
Część numeru, jeśli parametr jest ustawiony, to zwraca wyłącznie wyróżniki, które zawierają przekazany ciąg znaków. Opcjonalne

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

Element wyrozniki z namespace http://www.giif.mofnet.gov.pl/xsd/rest/komunikaty20171017

Pobierz komunikat do Instytucji Obowiązanej

To wywołanie zwraca komunikat do Instytucji Obowiązanej.

URL

/api/rest2018/instutucje/:nip/komunikaty/:rodzaj/:kmkId

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.
rodzaj
Rodzaj komunikatu, zgodne z atrybutem rodzaj elementu komunikat.
kmkId
Identyfikator komunikatu.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

Element komunikat z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/komunikaty20171017

Pobierz załącznik komunikatu do Instytucji Obowiązanej

To wywołanie zwraca komunikat do Instytucji Obowiązanej.

URL

/api/rest2018/instutucje/:nip/komunikaty/:rodzaj/:kmkId/zalaczniki/:id

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.
rodzaj
Rodzaj komunikatu, zgodne z atrybutem rodzaj elementu komunikat.
kmkId
Identyfikator komunikatu.
id
Identyfikator załącznika z atrybutu id elementu zalacznik.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

Plik załącznika.

eZawiadomienia i eOdpowiedzi

Lista zawiadomień

To wywołanie zwraca listę zawiadomień otrzymanych od Insytucji Obowiązanej Lista zawiadomień jest sortowana po dacie otrzymania pliku, malejąco.

URL

/api/rest2018/instutucje/:nip/zawiadomienia?wyslanePo&wyslanePrzed&hashZaszyfrowany&hashJawny&status&typZawiadomienia&od&ilosc

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju. Wymagane
wyslanePo
ogranicz do zawiadomień wysłanych po wskazanej dacie, przyjmuje daty w formacie yyyy-MM-dd (xsd:date), yyyy-MM-ddThh:mm:ss i wariant ze strefą czasową: yyyy-MM-ddThh:mm:ss+hh:mm (xsd:dateTime). Jeżeli nie wskazano strefy czasowej, to przyjmowana jest Europe/Warsaw. Opcjonalne
wyslanePrzed
ogranicz do zawiadomień wysłanych przed wskazaną datą. Format taki sam jak dla pola wyslanePo. Opcjonalne
hashZaszyfrowany
ogranicz do zawiadomień o wskazanej sumie kontrolnej pliku zaszyfrowanego. Sumę kontrolną należy przekazać jako xsd:hexBinary. Opcjonalne
hashJawny
ogranicz do zawiadomień o wskazanej sumie kontrolnej pliku jawnego. Sumę kontrolną należy przekazać jako xsd:hexBinary. Opcjonalne
status
ogranicz do zawiadomień o wskazanym statusie. To pole mozna powtarzać, wówczas wyświetlone zostaną zawiadomienia o statusie pasującym do dowolnego z przekazanych statusów. Statusy to “Z” - zawiadomienie zarejestrowany, “O” - zawiadomienie oczekuje na sprawdzenie (deszyfrowanie przebiegło poprawnie), “P” - podpis poprawny (plik oczekuje na walidację zawartości), “R” - zawiadomienie poprawny (walidacja przebiegła poprawnie), “X” - zawiadomienie niepoprawne. Opcjonalne
typZawiadomienia
ogranicz do zawiadomień o wskazanym typie Zawiadomienia.
od
paginacja, pierwszy rezultat do pokazania, domyślnie 0.
ilosc
paginacja, liczba resultatów do pokazania, domyślnie 25.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

200
Element zawiadomienia z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/pliki20171017

Szczegóły zawiadomienia

To wywołanie zwraca informacje o jednym zawiadomieniu otrzymanym od Insytucji Obowiązanej

URL

/api/rest2018/instutucje/:nip/zawiadomienia/:zwdId

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju. Wymagane
zwdId
Identyfikator zawiadomienia.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

200
Element zawiadomienie z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/pliki20171017

UPO do zawiadomienia

To wywołanie zwraca Urzędowe Poświadczenie Odbioru dla wskazanego Zawiadomienia

URL

/api/rest2018/instutucje/:nip/zawiadomienia/:zwdId/upo

Metoda

GET

Accept

application/xml

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju. Wymagane
zwdId
Identyfikator zawiadomienia.

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

200
XML z Urzędowym Poświadczeniem Odbioru
403
Przedstawiony certyfikat komunikacyjny nie umożliwia dostępu do Instytucji
404
Instytucja Obowiązana nie przekazała zawiadomienia o tym identyfikatorze.
503
Zawiadomienie oczekuje na przetworzenie
410
Zawiadomienie zawiera błędy uniemożliwiające przetworzenie.

Przekazywanie eZawiadomień

To wywołanie pozwala przesłać eZawiadomienie lub eOdpowiedź.

URL

/api/rest2018/instytucje/:nip/zawiadomienia

Metoda

POST

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.

Dane

Zaszyfrowany, podpisany plik eZawiadomieniem. Zgodny z elementem rejestracjaZawiadomienia ze schemy http://www.giif.mofnet.gov.pl/xsd/zawiadomienia20171017

Content-Disposition

Nazwę pliku można przekazać ustawiając nagłówek Content-Disposition na attachment z nazwą pliku w polu filename lub filename*

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

200
Element zawiadomienie z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/pliki20171017
409
Plik powtórnie przesłany.

Przekazywanie załączników do eZawiadomień

To wywołanie pozwala przesłać załącznik do eZawiadomienia lub eOdpowiedzi. Po przesłaniu zawiadomienia, zwrotny XML zawiera id wskazujące numer zawiadomienia w systemie (zwiId)

URL

/api/rest2018/instytucje/:nip/zawiadomienia/:zwiId/zalaczniki

Metoda

POST

Parametry

nip
NIP Instytucji Obowiązanej, zapisany jako 10 cyfr, bez spacji, bez kresek, bez kodu kraju.
zwiId
Identyfikator zawiadomienia.

Dane

Zaszyfrowany plik z załącznikiem.

Content-Disposition

Nazwę pliku można przekazać ustawiając nagłówek Content-Disposition na attachment z nazwą pliku w polu filename lub filename*

Uwierzytelnienie

Wzajemny TLS z wykorzystaniem certyfikatu komunikacyjnego

Zwraca

200
Element zalacznikZawiadomienia z namespace’a http://www.giif.mofnet.gov.pl/xsd/rest/pliki20171017
409
Plik powtórnie przesłany.