Anexa nr. 1

la normele tehnice

https://www.domeniu_institutie_publica.ro/ghiseu_institutie_publica/ghiseu/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 instituția care furnizează web service-ul, de ex.:

https://www.domeniu_institutie_publica.ro/ghiseu_institutie_publica/ghiseu/server.php">

https://www.domeniu_institutie_publica.ro/ghiseu_institutie_publica/ghiseu/server.php">

Metoda care returnează sumele de plată cu detaliile acestora pentru un CUI dat

Metoda care primește sumele și tipurile pentru care s-a făcut plata pe un CUI

https://www.domeniu_institutie_publica.ro/ghiseu_institutie_publica/ghiseu/server.php

#getSumeDePlataPePersoana"/>

https://www.domeniu_institutie_publica.ro/ghiseu_institutie_publica/ghiseu/server.php#inregistrareIncasari"/>

https://www.domeniu_institutie_publica.ro/ghiseu_institutie_publica/ghiseu/server.php"/>

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:

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

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.

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)

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.

Web-service - înregistrare plăți acceptate

Cerere:

Denumire: inregistrareIncasari

Descriere: Web-service-ul client de pe ghiseul.ro trimite un mesaj spre web-service-ul server de la instituție cu detalii despre încasarea acceptată de procesatorul de plăți electronice. Mesajul conține numărul plății, data plății și sumele totale pe tipuri de sume plătite de persoana respectivă.

Parametri:

Explicațiile parametrilor:

order - numărul încasării

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

data - data plății de forma aaaa-ll-zz oo:mm:ss (ex.: 2010-09-15 08:38:12)

sume - array de obiecte SumaIncasata; listă cu sumele plătite pe tipuri de sume

SumaIncasata conține câmpurile:

idTipSuma - codul tipului de sumă

valoare - totalul plătit pe tipul de sumă idTipSuma de forma întreg.douăzecimale (ex.: 1234.50)

timestamp - timestamp în formatul aaaallzzoommss (ex.: 20100915083812), 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.: 12)

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

Răspuns:

Denumire: inregistrareIncasariResponse

Descriere: Web-service-ul server al instituției răspunde web-service-ului client de la ghiseul.ro. Va răspunde cu 1 dacă a reușit să facă descărcarea plății în sistemul local al instituției. Altfel va răspunde cu 0.

Parametri:

Explicațiile parametrilor:

inregistrareIncasariResult - este 1 dacă s-a înregistrat încasarea cu succes, 0 dacă înregistrarea nu s-a putut efectua.

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 - s-a produs o eroare și serviciul este indisponibil.

EXEMPLU DE SOAP FAULT:

Response de la:

1

Mesaj invalid