Webservis
Na odosielanie Intrastat-SK hlásení môže spravodajská jednotka využiť aj webservis poskytovaný týmto portálom. URL adresa webservisu je https://intrastat.financnasprava.sk/service/server.php. Wsdl dokument pre tento webservis je dostupný tu.
Webservis využíva tzv. basic authentication na overenie používateľa, t. j. meno a heslo, ktoré ŠÚ SR pridelil spravodajskej jednotke. Zároveň musí byť v hlavičke požiadavky (headers) zadaná položka X-Custom-Data, ktorá obsahuje identifikačné číslo pre DPH spravodajskej jednotky.
Webservis obsahuje tri metódy:
- UploadXML - metóda slúži na zaslanie XML správy, ktorá obsahuje Intrastat-SK hlásenia v rovnakom formáte ako je uvedené v sekcii Formát XML správy v tagu <INSTAT>, navyše je možné vyplniť parameter <Description> obsahujúci popis správy. Metóda vráti hodnotu 1 v tagu <Result> a zároveň identifikátor výpisu o doručení správy v tagu <ID> v prípade, ak je komunikácia s portálom úspešná alebo vráti hodnotu 0 v tagu <Result> a zároveň popis chyby v tagu <ResultMsg>, ak je komunikácia neúspešná.
- GetDeliveryStatusByID - metóda slúži na získanie výpisu o doručení zaslanej XML správy podľa identifikátora <ID>, ktorý bol vrátený metódou UploadXML. Metóda teda očakáva parameter <ID>. Metóda vráti hodnotu 1 v tagu <Result> a zároveň výpis o doručení správy v tagu <Data> v prípade, ak je komunikácia s portálom úspešná alebo vráti hodnotu 0 v tagu <Result> a zároveň popis chyby v tagu <ResultMsg>, ak je komunikácia neúspešná.
- GetCompleteDeliveryStatus - metóda slúži na získanie kompletného výpisu o doručení všetkých zaslaných XML správ spravodajskej jednotky. Metóda je bez parametrov. Metóda vráti počet položiek výpisu v tagu <Result> a zároveň výpis o doručení správ v tagu <Data> v prípade, ak je komunikácia s portálom úspešná (jednotlivé správy sú obsiahnuté v tagu <Item>) alebo vráti hodnotu 0 v tagu <Result> a zároveň popis chyby v tagu <ResultMsg>, ak je komunikácia neúspešná.