Anexa nr. 2

la normele tehnice

2.1. Standardul de interfațare și interconectare pentru actualizarea în SNEP a informațiilor privind contribuabilii, precum și a registrului tipurilor de taxe pentru instituțiile publice beneficiare care dețin un sistem de gestiune a obligațiilor bugetare

xmlns:tns="https://www.ghiseul.ro/ghiseul_admin/public/transfer/transfer"

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="Transfer"

targetNamespace="https://www.ghiseul.ro/ghiseul_admin/public/transfer/transfer">

Returneaza o valoare

Returneaza 0 dacă operatia de scriere a datelor s-a efectuat cu succes

Returneaza 0 dacă operatia de scriere a datelor s-a efectuat cu succes

Returneaza 0 dacă operatia de scriere a datelor s-a efectuat cu succes

Returneaza cea mai recenta data a unei persoane pentru institutia data sau '0' dacă nu exista o ultima data

Returneaza 0 dacă operatia de actualizare a datelor s-a efectuat cu succes

Returneaza cea mai recenta data a unei persoane fizice autorizate pentru institutia data sau '0' dacă nu exista o ultima data

Returneaza 0 dacă operatia de actualizare a datelor s-a efectuat cu succes

Returneaza cea mai recenta data tipuri_sume pentru institutia data sau '0' dacă nu exista o ultima data

Returneaza 0 dacă operatia de actualizare a datelor s-a efectuat cu succes

Returneaza ultimul cod din tabela de stergeri pentru institutia data sau '0' dacă nu exista ultimul cod

Returneaza 0 dacă operatia de stergere a datelor s-a efectuat cu succes

2.2. Descrierea standardului de interfațare și interconectare pentru actualizarea în SNEP a informațiilor privind contribuabilii, precum și a registrului tipurilor de taxe pentru instituțiile publice beneficiare care dețin un sistem de gestiune a obligațiilor bugetare

Servicii web-server actualizare regiștri

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 - transfer persoane

Cerere:

Denumire: transferPersoane

Descriere: Cererea cu datele persoanelor care se transferă este trimisă de web-service-ul client al instituției către webservice-ul server de la ghiseul.ro. Se vor transfera toate persoanele care sunt în evidența instituției, nedecedate și care au CNP/NIF sau CIF/CUI (pentru persoane fizice autorizate) valid. Transmiterea datelor se va face pe pachete. Într-un pachet se pot trimite maximum 1.000 de persoane.

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de la ghiseul.ro

userClient - numele userului care a înrolat instituția la ghiseul.ro

date - un array de obiecte PersoanaTransfer; listă cu datele persoanelor

PersoanaTransfer conține câmpurile:

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

nume - numele și prenumele

adresa - adresa persoanei

cod - identificatorul unic al persoanei în baza de date a instituției

data - data creării sau data ultimei modificări (dacă a fost modificată) a persoanei în baza de date a instituției; de forma aaaa-ll-zz oo:mm:ss (ex.: 2010-10-22 16:06:12)

utilizator - numele utilizatorului care face transferul, de forma idClient.userWindows@numeStatie

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)

primulPachet = 1 dacă este primul pachet din transfer, 0 dacă nu e primul pachet

ultimulPachet = 1 dacă este ultimul pachet din transfer, 0 dacă nu e ultimul pachet

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

algoritmul se aplică pe stringul obținut prin concatenarea în ordine a valorilor din arrayul date: cod, CUI, nume, adresa, data.

Răspuns:

Denumire: transferPersoaneResponse

Descriere: Web-service-ul server de la ghiseul.ro răspunde web-service-ului client al instituției. Va răspunde cu 0 dacă a reușit transferul persoanelor.

Parametri:

Explicațiile parametrilor:

transferPersoaneResult:

0 - transfer reușit

Soap Fault - la transfer nereușit (vezi "Tratarea erorilor")

Web service - transfer persoane fizice autorizate

Cerere:

Denumire: transferFirme

Descriere: Cererea cu datele de transfer este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro . Transmiterea datelor se va face pe pachete. Într-un pachet se pot trimite maximum 1.000 de persoane. Se vor transfera toate persoanele care sunt în evidența instituției și care au CIF/CUI (pentru persoane fizice autorizate) valid.

Parametri:

Explicațiile parametrilor

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

date - un array de obiecte FirmaTransfer; listă cu datele firmelor

FirmaTransfer conține câmpurile:

CUI - CIF/CUI (pentru persoane fizice autorizate)

nume - denumirea persoanei

adresa - adresa persoanei

cod - identificatorul unic al persoanei în baza de date a instituției

data - data creării sau data ultimei modificări a persoanei în baza de date a instituției, de forma

aaaa-ll-zz oo:mm:ss (ex.: 2010-10-22 16:06:12)

utilizator - numele utilizatorului care face transferul, de forma idClient.userWindows@numeStatie

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)

primulPachet = 1 dacă este primul pachet din transfer, 0 dacă nu e primul pachet

ultimulPachet = 1 dacă este ultimul pachet din transfer, 0 dacă nu e ultimul pachet

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

algoritmul se aplică pe stringul obținut prin concatenarea în ordine a valorilor din arrayul date: cod, CUI, nume, adresa, data.

Răspuns:

Denumire: transferFirmeResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Va răspunde cu 0 dacă a reușit transferul persoanelor.

Parametri:

Explicațiile parametrilor:

transferFirmeResult:

0 - transfer reușit

Soap Fault - la transfer nereușit (vezi "Tratarea erorilor")

Web-service - transfer tipuri de sume (tipuri de taxe)

Cerere:

Denumire: transferTipuriSume

Descriere: Cererea cu datele de transfer este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Se vor transfera toate tipurile de sume care sunt în evidența instituției ce au codul IBAN valid. Transmiterea datelor se va face pe pachete. Într-un pachet se pot trimite maximum 1.000 de tipuri de sume.

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

date - un array de obiecte TipVenitTransfer; listă cu tipurile de sume

TipVenitTransfer conține câmpurile:

cod - identificatorul unic al tipului de sumă din baza de date a instituției

idNomUnic - identificatorul unic al tipului de taxă din Nomenclatorul unic de tipuri de taxe

nume - denumirea tipului de sumă

iban - codul IBAN corespunzător tipului de venit (în combinație cu câmpul platitor) debit = 1 tipul de sumă cu debit reprezintă tipurile de venit pentru care există solduri în baza de date a instituției; vor fi afișate în secțiunea Plăți cu autentificare (se va afișa suma totală de plată adusă prin web-service de la instituție) și în secțiunea Plăți fără autentificare

= 0 tipul de venit fără debit - la aceste tipuri de sume utilizatorul poate să completeze suma pe care dorește să o plătească; se vor transfera doar cele care se dorește să apară în interfața utilizatorului; vor fi afișate numai în secțiunea Plăți fără autentificare

= 2 tipul de venit amenda - vor apărea în secțiunea Plăți fără autentificare; în această secțiune se vor putea plăti amenzile în maximum 48 de ore; utilizatorul trebuie să completeze numărul, seria procesului-verbal și suma pe care o are de plătit

valInitiala - va fi completată pentru tipurile de sume cu debit = 0; va apărea în secțiunea Plăți fără autentificare ca suma propusă de plată, cu posibilitate de modificare

inactiv = 1 nu mai e folosit de instituție; = 0 folosit

data - data creării sau data ultimei modificări a tipului de sumă în baza de date a instituției, de forma aaaa-ll-zz oo:mm:ss (ex.: 2010-10-22 16:06:12)

platitor = 0 persoană fizică și juridică, = 1 persoană fizică, = 2 persoană juridică (în combinație cu iban)

utilizator - numele utilizatorului care face transferul, de forma idClient.userWindows@numeStatie

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)

primulPachet = 1 dacă este primul pachet din transfer, 0 dacă nu e primul pachet

ultimulPachet = 1 dacă este ultimul pachet din transfer, 0 dacă nu e ultimul pachet

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

algoritmul se aplică pe stringul obținut prin concatenarea în ordine a valorilor din arrayul date: cod, idNomUnic, nume, iban, debit, valInitiala, inactiv, platitor, data

Răspuns:

Denumire: transferTipuriSumeResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Va răspunde cu 0 dacă a reușit transferul tipurilor de sume.

Parametri:

Explicațiile parametrilor:

transferTipuriSumeResult:

0 - transfer reușit

Soap Fault - la transfer nereușit (vezi "Tratarea erorilor")

Web-service - getUltimaDataPersoane

Cerere:

Denumire: getUltimaDataPersoane

Descriere: Cererea este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Se cere cea mai mare dată de creare sau dată de modificare din persoane de pe ghiseul.ro.

Cererea este utilă pentru web-service-ul actualizare persoane care va trimite toate persoanele modificate după această dată.

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

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)

Răspuns:

Denumire: getUltimaDataPersoaneResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Serverul va răspunde cu 0 sau un string în format de dată.

În funcție de răspunsul dat prin getUltimaDataPersoaneResponse se vor alege înregistrările care trebuie trimise la actualizare persoane.

Parametri:

Explicațiile parametrilor:

getUltimaDataPersoaneResult:

0 dacă nu există înregistrări cu Data modificare diferită de null (la updatePersoane se vor trimite toate înregistrările ca la transferPersoane)

un string în formatul aaaa-ll-zz oo:mm:ss (numit "ultimaDataModificarePersoane"), reprezentând cea mai recentă Data modificare din persoane; (la updatePersoane se vor trimite înregistrările cu Data modificare locală >= ultimaDataModificarePersoane primită ca răspuns la acest serviciu)

Web-service - actualizare persoane

Cerere:

Denumire: actualizarePersoane

Descriere: Cererea cu datele de actualizare este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Vor trimite toate persoanele modificate după data returnată de getUltimaDataTipuriSumeResponse

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția la ghiseul.ro

date - un array de obiecte PersoanaTransfer; listă cu datele persoanelor

PersoanaTransfer conține câmpurile:

CUI - CNP/NIF al persoanei fizice

nume - numele și prenumele

adresa - adresa persoanei

cod - identificatorul unic al persoanei în baza de date a instituției

data - data creării sau data ultimei modificări a persoanei în baza de date a instituției, de forma aaaa-ll-zz oo:mm:ss (ex.: 2010-10-22 16:06:12)

utilizator - numele utilizatorului care face transferul, de forma idClient.userWindows@numeStatie

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

primulPachet = 1 dacă este primul pachet din transfer, 0 dacă nu e primul pachet

ultimulPachet = 1 dacă este ultimul pachet din transfer, 0 dacă nu e ultimul pachet

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

algoritmul se aplică pe stringul obținut prin concatenarea în ordine a valorilor din arrayul date: cod, cui, nume, adresa, data

Răspuns:

Denumire: actualizarePersoaneResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Va răspunde cu 0 dacă a reușit actualizarea persoanelor.

Parametri:

Explicațiile parametrilor:

actualizarePersoaneResult:

0 - actualizare reușită

Soap Fault - la actualizare nereușită (vezi "Tratarea erorilor")

Web-service - getUltimaDataFirme

Cerere:

Denumire: getUltimaDataFirme

Descriere: Cererea este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Se cere cea mai mare dată creare sau dată modificare de pe ghiseul.ro

Cererea este utilă pentru web-service-ul actualizare persoane fizice autorizate care va trimite toate datele modificate după această dată.

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

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)

Răspuns:

Denumire: getUltimaDataFirmeResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Serverul va răspunde cu 0 sau un string în format de dată.

În funcție de răspunsul dat prin getUltimaDataFirmeResponse se vor alege înregistrările care trebuie trimise la actualizare.

Parametri:

Explicațiile parametrilor:

getUltimaDataFirmeResult:

0 dacă nu există înregistrări cu data diferită de null (la actualizareFirme se vor trimite toate înregistrările ca la transferFirme)

un string în formatul aaaa-ll-zz oo:mm:ss (numit "ultimaDataModificareFirme"), reprezentând cea mai recentă dată (la actualizareFirme se vor trimite înregistrările cu Data modificare locală >= ultimaDataModificareFirme primită ca răspuns la acest serviciu)

Web-service - actualizare persoane fizice autorizate

Cerere:

Denumire: actualizareFirme

Descriere: Cererea cu datele de actualizare este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Vor trimite toate datele modificate după data returnată de getUltimaDataTipuriSumeResponse

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

date - un array de obiecte FirmaTransfer; listă cu datele persoanelor fizice autorizate

FirmaTransfer conține câmpurile:

cui - CIF/CUI persoanei fizice autorizate

nume - denumirea persoanei fizice autorizate

adresa - adresa persoanei fizice autorizate

cod - identificatorul unic al persoanei fizice autorizate în baza de date a instituției

data - data creării sau data ultimei modificări a persoanei fizice autorizate în baza de date a instituției, de forma aaaa-ll-zz oo:mm:ss (ex.: 2010-10-22 16:06:12)

utilizator - numele utilizatorului care face transferul de forma idClient.userWindows@numeStatie

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)

primulPachet = 1 dacă este primul pachet din transfer, 0 dacă nu e primul pachet

ultimulPachet = 1 dacă este ultimul pachet din transfer, 0 dacă nu e ultimul pachet

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

algoritmul se aplică pe stringul obținut prin concatenarea în ordine a valorilor din arrayul date: cod, cui, nume, adresa, data

Răspuns:

Denumire: actualizareFirmeResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Va răspunde cu 0 dacă a reușit actualizarea datelor.

Parametri:

Explicațiile parametrilor:

actualizareFirmeResult:

0 - actualizare reușită

Soap Fault - la actualizare nereușită (vezi Tratarea erorilor)

Web-service - getUltimaDataTipuriSume

Cerere:

Denumire: getUltimaDataTipuriSume

Descriere: Cererea este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Se cere cea mai mare dată creare sau dată modificare din tipurile de sume de pe ghiseul.ro

Cererea este utilă pentru web-service-ul actualizare tipuri sume care va trimite toate tipurile de sume modificate după această dată.

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

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)

Răspuns:

Denumire: getUltimaDataTipuriSumeResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Serverul va răspunde cu 0 sau un string în format de dată.

În funcție de răspunsul dat prin getUltimaDataTipuriSumeResponse se vor alege înregistrările care trebuie trimise la actualizare tipuri sume.

Parametri:

Explicațiile parametrilor:

getUltimaDataTipuriSumeResult:

0 dacă nu există înregistrări cu data diferită de null (la actualizareTipuriSume se vor trimite toate înregistrările ca la transferTipuriSume)

un string în formatul aaaa-ll-zz oo:mm:ss (numit "ultimaDataModificareTipuriSume"), reprezentând cea mai recentă dată din tipuri sume (la actualizareTipuriSume se vor trimite înregistrările cu Data modificare locală >= ultimaDataModificareTipuriSume primită ca răspuns la acest serviciu)

Web-service - actualizare tipuri sume

Cerere:

Denumire: actualizareTipuriSume

Descriere: Cererea cu datele de actualizare este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Vor trimite toate tipurile de sume modificate după data returnată de getUltimaDataTipuriSumeResponse

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

date - un array de obiecte TipSumaTransfer; listă cu tipurile de sume

TipSumaTransfer conține câmpurile:

cod - identificatorul unic al tipului de sumă din baza de date a instituției

idNomUnic - identificatorul unic al tipului de taxă din Nomenclatorul unic de tipuri de taxe

nume - denumirea tipului de sumă

iban - codul IBAN corespunzător tipului de venit (în combinație cu câmpul plătitor)

debit = 1 tipul de sumă cu debit - reprezintă tipurile de venit pentru care există solduri în baza instituției; vor fi afișate în secțiunea Plăți cu autentificare (se va afișa suma totală de plată adusă prin web-service de la instituție) și în secțiunea Plăți fără autentificare

= 0 tipul de venit fără debit - la aceste tipuri de sume utilizatorul poate să completeze suma pe care dorește să o plătească; se vor transfera doar cele care se dorește să apară în interfața utilizatorului; vor fi afișate numai în secțiunea Plăți fără autentificare

= 2 tipul de venit Amenda - vor apărea în secțiunea Plăți fără autentificare; în această secțiune se vor putea plăti amenzile în maximum 48 de ore; utilizatorul trebuie să completeze numărul, seria procesului-verbal și suma ce o are de plătit

valInitiala - poate fi completată pentru tipurile de sume cu debit = 0;

inactiv = 1 nu mai e folosit de instituție; = 0 folosit

data - data creării sau data ultimei modificări a tipului de sumă în baza de date a instituției; de forma aaaa-ll-zz oo:mm:ss (ex.: 2010-10-22 16:06:12)

platitor = 0 persoană fizică și juridică, = 1 persoană fizică, = 2 persoană juridică (în combinație cu iban)

utilizator - numele utilizatorului care face transferul; de forma idClient.userWindows@numeStatie

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)

primulPachet = 1 dacă este primul pachet din transfer, 0 dacă nu e primul pachet

ultimulPachet = 1 dacă este ultimul pachet din transfer, 0 dacă nu e ultimul pachet

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

algoritmul se aplică pe stringul obținut prin concatenarea în ordine a valorilor din arrayul date: cod, idNomUnic, nume, iban, debit, valInitiala, inactiv, platitor, data

Răspuns:

Denumire: actualizareTipuriSumeResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Va răspunde cu 0 dacă a reușit actualizarea tipurilor de sume.

Parametri:

Explicațiile parametrilor:

actualizareTipuriSumeResult:

0 - actualizare reușită

Soap Fault - la actualizare nereușită (vezi Tratarea erorilor)

Web-service - getUltimCodStergeri

Cerere:

Denumire: getUltimCodStergeri

Descriere: Cererea este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Se cere cel mai mare cod al ștergerilor reușite de instituția respectivă pe ghiseul.ro

Poate fi util pentru web-service-ul Stergere care va trimite toate codurile de șters mai mari decât acest cod.

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

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)

Răspuns:

Denumire: getUltimCodStergeriResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Serverul va răspunde cu 0 sau un string cu codul.

În funcție de răspunsul dat prin getUltimCodStergeriResponse se vor alege înregistrările care trebuie trimise la ștergere transfer.

Parametri:

Explicațiile parametrilor:

getUltimCodStergeriResult:

0 dacă nu există înregistrări pentru instituția respectivă

un string reprezentând cel mai recent cod șters de la instituția respectivă (la ștergere se vor trimite înregistrările cu cod local >= cod primit ca răspuns la acest serviciu)

Web-service - stergere

Cerere:

Denumire: stergere

Descriere: Cererea cu datele de șters este trimisă de web-service-ul client al instituției către web-service-ul server de pe ghiseul.ro. Se vor trimite un set de date, persoane și persoane fizice autorizate, care se doresc a fi șterse la ghiseul.ro. Acestea se vor alege în funcție de răspunsul dat de getUltimCodStergeriResult. Aceasta presupune implementarea la instituție a unei cozi de așteptare a operațiilor de ștergere.

Parametri:

Explicațiile parametrilor:

idClient - codul de client primit de pe ghiseul.ro

userClient - numele userului care a înrolat instituția pe ghiseul.ro

date - un array de obiecte StergereTransfer; listă cu codurile de șters

StergereTransfer conține câmpurile:

cod -identificatorul unic al ștergerii

codObiectSters - identificatorul unic (id) al persoanei sau persoanei fizice autorizate în baza de date a instituției

fizjur =1 persoana, = 2 persoana fizică autorizată

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)

primulPachet = 1 dacă este primul pachet din transfer, 0 dacă nu e primul pachet

ultimulPachet = 1 dacă este ultimul pachet din transfer, 0 dacă nu e ultimul pachet

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

algoritmul se aplică pe stringul obținut prin concatenarea în ordine a valorilor din arrayul date: cod, codObiectSters,fizjur

Răspuns:

Denumire: stergereResponse

Descriere: Web-service-ul server de pe ghiseul.ro răspunde web-service-ului client al instituției. Va răspunde cu 0 dacă a reușit ștergerea datelor.

Parametri:

Explicațiile parametrilor:

stergereResult:

0 - actualizare reușită

Soap Fault - la actualizare nereușită (vezi Tratarea erorilor)

Tratarea erorilor Soap Fault

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

1 - în cazul în care nu s-a verificat integritatea mesajului (valoarea check incorectă)

2 - în cazul în care codul instituției nu este corect (valoarea idClient incorectă)

3 - în cazul în care utilizatorul instituției nu este corect (valoarea userClient incorectă)

4 - s-a produs o eroare și serviciul este indisponibil

5 - "Introducere TIP SUMA se face manual" - nu se pot face operații pe tipuri de sume decât manual (dacă în profil instituție din modulul Ghișeul administrare este setat "Introducere manuală tipuri de venit")

6 - "Error. Există mai multe persoane cu același CNP (".$cui.") în pachet" - se parcurge lista de persoane trimise, iar la primul CNP care apare de 2 ori în același pachet se va răspunde cu acest Soap Fault

6 - "Error. Există mai multe persoane fizice autorizate cu același CUI (".$cui.") în pachet" - se parcurge lista de persoane fizice autorizate trimise, iar la primul CUI care apare de 2 ori în același pachet se va răspunde cu acest Soap Fault

7- "Error. CNP-uri invalide": ".$cui1, $cui2,.... " - se parcurge lista de persoane trimise, se concatenează CNP-urile invalide și răspunde cu acest Soap Fault dacă există cel puțin unul invalid

7 - "Error. CIF-uri invalide": ".$cui1, $cui2,.... " - se parcurge lista de persoane fizice autorizate trimise, se concatenează CF-urile invalide și răspunde cu acest SoapFault dacă există cel puțin unul invalid

7 - "Error. Tip suma fără IBAN": ".$nume1, $nume2,..." Tip suma cu debit invalid: ".$nume1, $nume2,... " IBAN-uri invalide: ".$iban1, $iban2,... " Tip suma cu IdNomUnic invalid: ".$nume1, $nume2,... " Tip suma cu plătitor invalid: ".$nume1, $nume2,.... " se parcurge lista de tipuriSume trimise și se concatenează numele celor care nu au niciun IBAN, separat numele celor care nu au debit valid (0, 1 sau 2), separat IBAN-urile invalide, separat numele celor care nu au IdnomUnic valid (completat dar invalid - dacă nu e completat nu se consideră invalid), separat numele celor care nu au plătitor valid (0, 1 sau 2). Dacă cel puțin una dintre categorii are ceva completat atunci se răspunde cu acest Soap Fault. (dacă la una dintre categorii nu există niciun item, atunci nu va apărea deloc categoria respectivă.)

Ex.: "7", "Error. Tip suma fără IBAN: Taxa Auto" IBAN-uri invalide: RO88TREZ02121340202XXXXX, RO88TREZ02121340202XXXXX

8 - "Număr prea mare de entități per pachet (maximum 1000)" - dacă numărul de obiecte (persoane, persoane fizice autorizate sau tipuriSume) din array-ul "$data" este mai mare decât 1000, atunci se răspunde cu acest Soap Fault.

9", "Testare nefinalizată pentru operația ".$nume_operație."! Vă rugăm să folosiți modulul de testare!

(Ex.: "Testare nefinalizată pentru operația TRANSFER TIPURI SUME! Vă rugăm să folosiți modulul de testare!")

10", "Instituție fără trimitere date prin web-services

(Dacă în tabela instituții, pentru instituția curentă, câmpul B_CU_SERVICES e pus pe 0 să nu poată transfera nimic. Se returnează un soap fault prin care se anunță că este pusă bifa pe "Fără trimitere date prin web-services" în profil instituție.

Verificarea se face la orice apel al unei funcții.

Sursă: legislatie.just.ro (Monitorul Oficial). Textul afișat este forma consolidată curentă.