İzibiz Developer Portal
SOAP WS · AuthenticationWS-GIBUser

Mükellef Sorgulama (CheckUser)

SOAPCheckUserRequest
  • Mükellefin, Gelir İdaresi Başkanlığı sistemine kayıtlı olup olmadığının kontrol edildiği servistir.
  • Sorgulanan VKN GİB sistemine kayıtlıysa, sistemde tanımlanmış etiket listesi dönülmektedir.
  • Sorgulanan VKN GİB sistemine kayıtlı değilse liste boş dönülür. Sonuç boş ise firma mükellef değildir.

Servisten dönen parametreler şu şekildedir:

Parametre Tip Açıklama
USER.IDENTIFIER String Mükellefe ait VKNsı.
USER.ALIAS String Mükellefe ait GB veya PK etiketi.
USER.TITLE String Firmanın GİB sisteminde tanımlı ünvanı.
USER.TYPE String Firmanın GİB sisteminde tanımlı tipi. OZEL veya KAMU olabilir.
USER.REGISTER_TIME Date Firmanın GİB sistemine ilk kayıt olduğu tarih. formatı: 2013-07-01T15:22:11
USER.UNIT String Etiketin tipi. GB veya PK
USER.ALIAS_CREATION_TIME DateTime Etiketin oluşturulduğu tarih. formatı: 2013-07-01T15:22:11

Parameters

NameTypeRequiredDescription
REQUEST_HEADER object Yes Request Header objesi içerisinde SESSION_ID ve APPLICATION_NAME alanı zorunludur.
└ SESSION_ID text Yes Kimlik doğrulama servisi (AuthenticationWS) oturum açma metodundan (Login) alına oturum/token/session bilgisi.
└ CLIENT_TXN_ID text No İstemci uygulama tarafından işlem için üretilen işlem bilgisi (transaction id) varsa istek esnasında gönderilip, sonuçta alabileceğiniz bir değerdir. request/response eşleşmesi yapmak için kullanılabilir.
└ APPLICATION_NAME text Yes Metodu çağıran uygulamanın adı. Örnek: AppName-v1.4.67
USER object Yes
└ IDENTIFIER text Yes Mükellefiyeti sorgulanacak firmanın vergi kimlik numarası
DOCUMENT_TYPE text Yes Mükelleffiyet kontrol edilecek ürün tipi. E-Fatura için INVOICE, E-İrsaliye için DESPATCHADVICE gönderilmelidir.

Sample Response (XML)

Servisten dönen parametreler şu şekildedir:

Parametre | Tip        | Açıklama
--------- | ----------- | -----------
**USER.IDENTIFIER** | String | Mükellefe ait VKNsı.
**USER.ALIAS** | String | Mükellefe ait GB veya PK etiketi.
**USER.TITLE** | String | Firmanın GİB sisteminde tanımlı ünvanı.
**USER.TYPE** | String | Firmanın GİB sisteminde tanımlı tipi. `OZEL` veya `KAMU` olabilir.
**USER.REGISTER_TIME** | Date | Firmanın GİB sistemine ilk kayıt olduğu tarih. formatı: 2013-07-01T15:22:11
**USER.UNIT** | String | Etiketin tipi. `GB` veya `PK` 
**USER.ALIAS_CREATION_TIME** | DateTime | Etiketin oluşturulduğu tarih. formatı: 2013-07-01T15:22:11


<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns3:CheckUserResponse xmlns:xmime="http://www.w3.org/2005/05/xmlmime" xmlns:ns3="http://schemas.i2i.com/ei/wsdl">
      <USER>
        <IDENTIFIER>4840847211</IDENTIFIER>
        <ALIAS>urn:mail:defaultpk@izibiz.com.tr</ALIAS>
        <TITLE>İZİBİZ AKTİVASYON</TITLE>
        <TYPE>OZEL</TYPE>
        <REGISTER_TIME>2013-07-01T15:22:11</REGISTER_TIME>
        <UNIT>PK</UNIT>
        <ALIAS_CREATION_TIME>2026-06-03T17:47:43</ALIAS_CREATION_TIME>
        <ACCOUNT_TYPE>OZELENTEGRASYON</ACCOUNT_TYPE>
        <DELETED>N</DELETED>
        <DOCUMENT_TYPE>INVOICE</DOCUMENT_TYPE>
      </USER>
    </ns3:CheckUserResponse>
  </S:Body>
</S:Envelope>

Fault Response

<?xml version='1.0' encoding='UTF-8'?>
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
  <S:Body>
    <ns3:CheckUserResponse xmlns:xmime="http://www.w3.org/2005/05/xmlmime" xmlns:ns3="http://schemas.i2i.com/ei/wsdl">
      <ERROR_TYPE>
        <INTL_TXN_ID>0</INTL_TXN_ID>
        <ERROR_CODE>10013</ERROR_CODE>
        <ERROR_SHORT_DES>Geçersiz istek. {0}</ERROR_SHORT_DES>
        <ERROR_LONG_DES>alias,identifier</ERROR_LONG_DES>
      </ERROR_TYPE>
    </ns3:CheckUserResponse>
  </S:Body>
</S:Envelope>