4. Wyszukiwanie podmiotu

Podmiot możemy wyszukać podając jeden z numerów ewidencyjnych, którymi są:

• NIP
• KRS
• REGON

Wyszukanie podmiotu jest bardzo proste wystarczy że z poziomu klienta wykonamy jedną z poniższych metod.

//Jeżeli chcemy wyszukać znając tylko numer NIP, pozostałe wartości przedstawiamy jako null.
//Działa to adekwatnie w dwóch innych przypadkach
Podmiot p = gusClient.SzukajPodmiot("numer nip","numer krs","numer regon");
//Wyszukanie po nip
Podmiot pNIP = gusClient.SzukajPodmiot("numer nip",null,null);
//Wyszukanie po regon
Podmiot pRegon = gusClient.SzukajPodmiot(null,"numer regon",null);
//Wyszukanie po krs
Podmiot pKrs = gusClient.SzukajPodmiot(null,null,"numer krs");

W przypadku nieodnalezienia danego podmiotu w bazie obiektem zwracanym będzie wartość null.

Istnieje prostszy i bardziej intuicyjny sposób wyszukiwania podmiotu po poszczególnym numerze, korzystając z zaimplementowanych aliasów:

//Wyszukanie po nip
Podmiot pNIP = gusClient.SzukajPodmiotNip("numer nip");
//Wyszukanie po regon
Podmiot pRegon = gusClient.SzukajPodmiotRegon("numer regon");
//Wyszukanie po krs
Podmiot pKrs = gusClient.SzukajPodmiotKrs("numer krs");

Biblioteka umożliwia również wyszukiwanie wielu podmiotów jednocześnie:

//Metoda ogólnna
List<Podmiot> lista = gusClient.SzukajPodmioty(string[] nipy,string[] regony9,string[] regony14,string[] krsy);
//Wyszukanie po nip
List<Podmiot> pNIP = gusClient.SzukajPodmiotyNip("nip1","nip2"...);

//Wyszukanie po regon
//Numer regon 9 cyfrowy
List<Podmiot> pRegon9 = gusClient.SzukajPodmiotyRegon9("regon1","regon22"...);
//Numer regon 14 cyfrowy
List<Podmiot> pRegon9 = gusClient.SzukajPodmiotyRegon14("regon1","regon22"...);

//Wyszukanie po krs
List<Podmiot> pKrs_2 = gusClient.SzukajPodmiotyKrs("krs1","krs2"...);

W przypadku nieodnalezienia żadnego z podmiotów, zwracana jest pusta lista.

Warto pamiętać, że:
W każdym z przypadków może wystąpić błąd, więcej na temat błędów można znaleźć w rozdziale:
Obsługa błędów