Dokumentacja protokołu BIG InfoMonitor
Informacje o zgonach

Weryfikacja informacji o osobie fiycznej w zakresie żyje/nie żyje jest dostępna wyłącznie w ramach raportów specjalnych, które zawierają komponent peselAliveVerification. Źródłem danych jest rejestr PESEL, który jest prowadzony przez ministra właściwego do spraw informatyzacji.

Weryfikacja imienia i nazwiska w celu ujawnienia danych

Zamówienie komponentu wymaga przekazania danych o imionach, nazwiskach i numerze PESEL weryfikowanej osoby. Informacja o stanie żyje/nie żyje 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ę zwróceniem statusu noDataFound. 

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

Przkazanie imion i nazwisk w danych peselAliveVerification
Kopiuj
<components>
   <peselAliveVerification>
       <firstnames>Julia Aneta</firstnames>
       <lastnames>Nowak-Kowalska</lastnames>
    </peselAliveVerification>
</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 peselAliveVerification.

Zapytanie

peselAliveVerification
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>NNNNNNNN</unitId>
   </client>
   <repeatedRequestMarker>false</repeatedRequestMarker>
   <reportComposition xsi:type="br:FinancialReportComposition">
      <!-- Raport o konsumencie -->
      <product>specialReport1</product>
      <components select="custom">
         <peselAliveVerification>
            <componentRequestId>34344343</componentRequestId>
            <firstnames>IMGARDA</firstnames>
            <lastnames>WANTOCH REKOWSKA</lastnames>
         </peselAliveVerification>
      </components>
      <reportSubject xsi:type="bc:NaturalPerson">
         <splitName>
            <forename>IMGARDA</forename>
            <surname>WANTOCH</surname>
            <secondSurname>REKOWSKA</secondSurname>
         </splitName>
         <identity>
            <pesel>97050700028</pesel>
            <document>
               <id>AMJ020959</id>
               <type>idCard</type>
            </document>
         </identity>
      </reportSubject>
   </reportComposition>
</br:getReportRequest>

Raport

peselAliveVerification
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>NNNNNNNN</clientId>
            <unitId>NNNNNNNN</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">
               <peselAliveVerification>
                  <componentRequestId>34344343</componentRequestId>
                  <firstnames>IMGARDA</firstnames>
                  <lastnames>WANTOCH REKOWSKA</lastnames>
               </peselAliveVerification>
            </components>
            <reportSubject xmlns:ns5="http://api.big.pl/bimo/v1" xsi:type="ns5:NaturalPerson">
               <splitName>
                  <forename>IMGARDA</forename>
                  <surname>WANTOCH</surname>
                  <secondSurname>REKOWSKA</secondSurname>
               </splitName>
               <identity>
                  <pesel>97050700028</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>6wVITETXHlwcboXv4G9YQkTU0yo=</componentId>
            <componentType>peselAliveVerification</componentType>
            <validityDateTime>2023-03-21T10:37:20.391</validityDateTime>
            <processingResult>success</processingResult>
            <data xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ns3:PeselAliveVerificationData">
               <verificationOutcome>true</verificationOutcome>
            </data>
         </reportComponent>
      </components>
   </success>
</ns3:getReportResponse>