Dokumentacja protokołu BIG InfoMonitor
Weryfikacja adresu w rejestrze PESEL

Weryfikacja poprawności adresu stałego osoby fizycznej  jest dostępna wyłącznie w ramach raportów specjalnych, które zawierają komponent  peselAddressVerification. Dane przekazane do weryfikacji są porównywane z danymi zapisanymi w rejestrze PESEL, który jest prowadzony przez ministra właściwego do spraw informatyzacji.

Zlecenie weryfikacji nie wymaga przekazania pełnego adresu osoby fizycznej (elementy danych adresu są opcjonalne). Weryfikacji mogą polegać niżej wymienione składowe adresu, wielkość liter nie jest interpretowana:

  • kod pocztowy (postcode)- przekazywany w postaci xx-xxx, gdzie x to liczba.
  • miejscowość (city)
  • ulica (street) - BIG API dopuszcza przekazanie pustej wartości w tym elemencie w celu potwierdzenia, że adres stały osoby fizycznej nie zawiera ulicy. Analogiczną weryfikację można wykonać przez przekazanie w tym elemencie wartości NO_DATA.
  • numer domu (houseNumber)
  • numer lokalu (localNumber) - BIG API dopuszcza przekazanie pustej wartości w tym elemencie w celu potwierdzenia, że adres stały osoby fizycznej nie zawiera numeru lokalu. Analogiczną weryfikację można wykonać przez przekazanie w tym elemencie wartości NO_DATA.

Zakres danych komponentu peselAddressVerification zwrócony na raporcie, będzie zawierał wynik porównania poszczególnych składowych adresu, które zostały przekazane do weryfikacji:

matched - Dane zgodne z danymi zapisanymi w rejestrze PESEL

mismatched - Dane niezgodne z danymi zapisanymi w rejestrze PESEL

noVerification - Dane nie zostały przekazane do weryfikacji

Weryfikacja imienia i nazwiska w celu ujawnienia danych

Informacja o statusie zgodności przekazanych składników adresu zostanie udostępniona, jeżeli imiona i nazwiska przekazane w zapytaniu, będą zgodne z danymi osoby w rejestrze PESEL. W przypadku niezgodności, imienia i/lub nazwiska, przetwarzanie komponentu (processingResult) zakończy się statusem success ze zwróceniem wartości false w elemencie firstnamesLastnamesMatched.

BIG API umożliwia niezależne przekazanie imion i nazwisk na potrzeby weryfikacji poprzedzającej udostępnienie wyniku porównania adresu. Jest to szczególnie zalecane w przypadku weryfikacji osób z wieloczłonowymi imionami i/lub nazwiskami:

Przkazanie imion i nazwisk w danych peselAddressVerification
Kopiuj 
<components>
   <peselAddressVerification>
       <firstnames>Julia Aneta</firstnames>
       <lastnames>Nowak-Kowalska</lastnames>
      <city>Poznań</city>
    </peselAddressVerification>
</components>

 

Przykładowe komunikaty

Poniżej znajduje się przykładowy komunikat zapytania i raportu dla Raportu specjalnego, który umożliwia zwrócenie danych komponentu peselAddressVerification.

Zapytanie

peselAddressVerification
Kopiuj 
<?xml version="1.0" encoding="UTF-8"?>
<br:getReportRequest xmlns:br="http://api.big.pl/bimoR/v1" xmlns:bc="http://api.big.pl/bimo/v1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://api.big.pl/bimoR/v1 bimoR.v1.xsd ">
   <client>
      <clientId>NNNNNNNN</clientId>
      <unitId>NNNNNNN</unitId>
   </client>
   <repeatedRequestMarker>false</repeatedRequestMarker>
   <reportComposition xsi:type="br:FinancialReportComposition">
      <!-- Raport o konsumencie -->
      <product>specialReport1</product>
      <components select="custom">
         <peselAddressVerification>
            <firstnames>GUIDO</firstnames>
            <lastnames>OWCZAR</lastnames>
            <houseNumber>34</houseNumber>
            <postcode>NO_DATA</postcode>
            <localNumber>12</localNumber>
            <city>NAGŁOWICE</city>
         </peselAddressVerification>
      </components>
      <reportSubject xsi:type="bc:NaturalPerson">
         <splitName>
            <forename>GUIDO</forename>
            <surname>OWCZAR</surname>
         </splitName>
         <identity>
            <pesel>97050200733</pesel>
            <document>
               <id>AMJ020959</id>
               <type>idCard</type>
            </document>
         </identity>
      </reportSubject>
   </reportComposition>
</br:getReportRequest>

Raport

peselAddressVerification
Kopiuj 
<?xml version="1.0" encoding="UTF-8"?>
<ns3:getReportResponse xmlns:ns3="http://api.big.pl/bimoR/v1" xmlns:ns2="http://api.big.pl/iasWrapper/reports/v1">
   <success>
      <currentRequest>
         <client>
            <clientId>1811188456</clientId>
            <unitId>1811188456</unitId>
         </client>
         <repeatedRequestMarker>false</repeatedRequestMarker>
         <reportComposition xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:FinancialReportComposition">
            <product>specialReport1</product>
            <components select="custom">
               <peselAddressVerification>
                  <firstnames>GUIDO</firstnames>
                  <lastnames>OWCZAR</lastnames>
                  <houseNumber>34</houseNumber>
                  <postcode>NO_DATA</postcode>
                  <localNumber>12</localNumber>
                  <city>NAGŁOWICE</city>
                  <street />
               </peselAddressVerification>
            </components>
            <reportSubject xmlns:ns5="http://api.big.pl/bimo/v1" xsi:type="ns5:NaturalPerson">
               <splitName>
                  <forename>GUIDO</forename>
                  <surname>OWCZAR</surname>
               </splitName>
               <identity>
                  <pesel>97050200733</pesel>
                  <document>
                     <id>AMJ020959</id>
                     <type>idCard</type>
                  </document>
               </identity>
            </reportSubject>
         </reportComposition>
      </currentRequest>
      <exchangeRateTable>
         <id>243/A/NBP/2022</id>
         <date>2022-12-16</date>
      </exchangeRateTable>
      <components>
         <reportComponent>
            <componentId>5H5IBWeS8uyX5r6Bh1O79AtDa2k=</componentId>
            <componentType>peselAddressVerification</componentType>
            <validityDateTime>2023-03-21T10:28:30.676</validityDateTime>
            <processingResult>success</processingResult>
            <data xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:PeselAddressVerificationData">
               <firstnamesLastnamesMatched>true</firstnamesLastnamesMatched>
               <houseNumberMatched>matched</houseNumberMatched>
               <postcodeMatched>mismatched</postcodeMatched>
               <localNumberMatched>matched</localNumberMatched>
               <cityMatched>matched</cityMatched>
               <streetMatched>noVerification</streetMatched>
            </data>
         </reportComponent>
      </components>
   </success>
</ns3:getReportResponse>