Ana içeriğe geç

Kayıtlı Kullanıcı Sorgulama

GET https://webservis.ekupbilisim.com/api/outsource/gib/reg-user
Bu, canlı tabandır. Geliştirme ve entegrasyon testleri için /api/outsource-test tabanını kullanın — bkz. Test Ortamı / Sandbox.

GİB üzerinde kayıtlı kullanıcı bilgilerini sorgulamak için kullanılan API uç noktası.

  • e-Fatura Kayıtlı Mükellef Bilgisi
  • e-İrsaliye Kayıtlı Mükellef Bilgisi

Üst Bilgi (Header) Parametreleri​

Authorization string required
Bearer token ile kimlik doğrulama yapılmalıdır.

QUERY Parametreleri​

vkn string required
Vergi Kimlik No / T.C. Kimlik No
type string Varsayılan = Invoice
e-Fatura veya e-İrsaliye için sorgulama yapılacağını belirtir. (Invoice / DespatchReceipt)
direction string Varsayılan = pk
Posta Kutusu için 'pk' değeri, gönderici birimleri için 'gb' değeri kullanılır.

Cevaplar ( Responses )​

200
OK
[
  {
      "docType": "Invoice",
      "name": "urn:mail:defaultgb@ekupbilisim.com",
      "creationTime": "2025-05-21T16:22:38",
      "firstCreationTime": "2025-05-21T12:01:20",
      "title": "EKÜPSOFT BİLİŞİM TEKNOLOJİLERİ ANONİM ŞİRKETİ",
      "accountType": "ENTEGRASYON",
      "type": "OZEL",
      "identifier": "3292081878"
  }
]
422
İş Kuralı Hatası — Hesap Bulunamadı
{
"error": 1,
"message": "Bu vergi numarasına ait hesap bulunamadı veya erişim izniniz yok."
}
422
İş Kuralı Hatası — Yetkisiz VKN
{
"error": 1,
"message": "Bu vergi numarasına erişim izniniz yok."
}
401
Unauthorized
{
  "error": 1,
  "message": "e-Posta veya şifre hatalı."
}
404
Not Found
{
  "error": 1,
  "message": "The route api/outsource/auth/login1 could not be found."
}
500
Server Error
{
  "error": 1,
  "message": "Sunucu Hatası"
}

Örnek İstek ( Curl )​


curl --location 'https://webservis.ekupbilisim.com/api/outsource-test/gib/reg-user?vkn=9130525440&type=Invoice&direction=gb' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: ••••••'