Anexa nr. 4

la normele tehnice

https://www.domeniu_ANAF.ro/server.php" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap-enc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http: //schemas.xmlsoap.org/wsdl/" name="InformatiiPlataZF" targetNamespace="Aici va apărea namespace-ul aplicației dezvoltate de Ministerul Finanțelor Publice - Agenția Națională de Administrare Fiscală care furnizează web-service-ul, de ex.:

https//www.domeniu_ANAF.ro/server.php">

Metoda care returneaza sumele de plată cu detaliile acestora pentru un cui dat

https://www.domeniu_ANAF.ro/server.php#getSumeDePlataPePersoana" />

Servicii web client

Reguli generale

Datele string se vor trimite codate în format UTF8.

Checksumul (suma de control) din fiecare mesaj se va compune pe valorile codate UTF8.

Requesturile SOAP trebuie să fie valide din punct de vedere XML.

Web-service - debite/sume cu detalii

Cerere:

Denumire: getSumeDePlataPePersoana

Descriere: Cererea este trimisă de ghiseul.ro către web-service-ul instituției, care va răspunde cu date despre persoana corespunzătoare CUI-ului trimis.

Parametri:

Explicațiile parametrilor:

cuiInstitutie - CUI instituție

CUI - CNP/NIF sau CIF/CUI (pentru persoane fizice autorizate)

timestamp - timestamp în formatul aaaallzzoommss (ex.: 20100915083837), unde aaaa este anul (ex.: 2010), ll este luna (ex.: 09), zz este ziua (ex.: 15), oo este ora (ex.: 08), mm sunt minutele (ex.: 38), ss sunt secundele (ex.: 38)

check - suma de control al integrității mesajului; algoritmul folosit este HMAC-SHA1 cu cheie de criptare;

Răspuns:

Denumire: getSumeDePlataPePersoanaResponse

Descriere: Este răspunsul web-service-ului server al instituției la cererea adresată de web-service-ul client de pe ghiseul.ro. Răspunsul conține o listă cu sume de plătit de către persoana al cărei CUI este trimis prin mesajul getSumeDePlataPePersoana. Sumele sunt grupate pe tipuri de sume; tipurile de sume pot fi prioritizate.

Parametri:

Explicațiile parametrilor:

sume - un array cu sumele de plătit grupate pe tipuri de sume

dataCalcul - data la care s-a calculat valoarea obligațiilor de plată, în format aaaallzz, unde aaaa este anul (ex.: 2010), ll este luna (ex.: 09), zz este ziua (ex.: 15)

idTipSuma - codul tipului de sumă

valoare - suma datorată pentru tipul de sumă idTipSuma de forma întreg.douăzecimale (ex.:57.32)

prioritate - prioritatea în care trebuie să se plătească suma; tipurile de sumă pot să fie prioritizate sau nu; fiecare tip de sumă care se dorește a fi prioritizată va avea un număr de prioritizare unic obligatoriu pozitiv;

prioritate = 1 este cel mai prioritar tip de sumă, apoi cel cu prioritate = 2 etc.;

restul tipurilor de sumă care nu se doresc a fi prioritizate vor avea prioritate = 0 și vor putea să fie plătite numai după ce sunt plătite sumele pe tipurile de sumă cu prioritate.

detaliiHeader - un array de stringuri (ex.: Proprietate Debit Rămășiță Majorări Penalități)

detaliiBody - un array de obiecte LinieDetaliiSume; conține detaliile de plată corespunzător tipului de sumă idTipSuma

LinieDetaliiSume - un array de stringuri (ex.: denumire, suma debit, suma rămășiță, suma majorare, suma penalitate); acestea vor apărea utilizatorilor în format tabelar.

timestamp - timestamp în formatul aaaallzzoommss (ex.: 20100915083837),

unde aaaa este anul (ex.: 2010), ll este luna (ex.: 09), zz este ziua (ex.: 15), oo este ora (ex.: 08), mm sunt minutele (ex.: 38), ss sunt secundele (ex.: 38)

check - suma de control al integrității mesajului; algoritmul folosit este HMAC-SHA1 cu cheie de criptare;

OBSERVAȚIE: detaliiHeader și detaliiBody trebuie să conțină același număr de câmpuri.

Tratarea erorilor (Soap Fault) pentru ambele servicii

Se va trimite Soap Fault cu 1, 2 sau 3 în următoarele cazuri specifice:

1 - în cazul în care nu s-a verificat integritatea mesajului;

2 - în cazul în care CUI-ul nu este valid sau nu există în baza de date;

3 - în cazul în care s-a produs o eroare și serviciul este indisponibil.

EXEMPLU DE SOAP FAULT:

Response de la:

1

Mesaj invalid