API
Portal API Endpoint Referansı
Portalın listeleme, önizleme, mail ve GİB mükellef sorgulama işlemleri.
Listeleme ve Arama
POST/api/BillApi/GetBillGridList
e-Adisyon grid görünümü için sayfalı ve sıralı belge listesini getirir.
| Request | SearchUIRequestModel<OutgoingBillListRequestModel> |
| Filtreler | ETTN, taraf VKN/TCKN/adı, cari ID listesi, belge no, dış referans, tarih, e-Arşiv/mail/rapor/iptal-rapor durumları, okundu bilgisi |
| Response | SearchResponseModel<OutgoingBillGridResponseModel> |
POST/api/BillApi/GetGlobalSearchBillList
Portal global aramasında e-Adisyon kayıtlarını getirir.
| Request | SearchUIRequestModel<GlobalSearchRequestModel> |
| Response | Sayfalı OutgoingBillGridResponseModel listesi |
Görüntüleme ve Okunma Durumu
POST/api/BillApi/GetOutgoingBillView
Belge görüntüleme ekranı için detay bilgisi döner.
| Request | BillViewRequestModel — { Ettn, IsRead } |
| Response | BillViewResponseModel |
POST/api/BillApi/OutgoingBillIsRead
Belgeyi okundu olarak işaretler.
| Request | BillViewRequestModel |
| Response | bool |
POST/api/BillApi/GetOutgoingBillLog
Belge işlem geçmişini (log) getirir.
| Request | SearchRequestModel<BillLogRequestModel> |
| Response | SearchResponseModel<BillLogResponseModel> |
E-posta İşlemleri
POST/api/BillApi/AddMailOutgoingBillPage
Sayfadan seçilen belgeler için mail gönderimi başlatır.
| Request | MailSendRequestModel |
POST/api/BillApi/AddMailGlobalOutgoingBill
Global arama sonucundaki belgeler için mail gönderimi başlatır.
| Request | GlobalMailRequestModel |
GET/api/BillApi/ResetOutgoingBillMailQueue?id={id}
Belgenin mail gönderim kuyruğunu sıfırlar.
Belge Numarası Prefixleri
POST/api/BillApi/GetOutgingBillPrefixList
Belirtilen yıl için kullanılabilir belge numarası prefixlerini getirir.
| Request | NumberPrefixRequestModel |
| Response | IList<NumberPrefixResponseModel> |
Mükellef ve NACE/KDV Yardımcıları
Bu uçlar, GİB üzerinden mükellef/NACE/KDV oranı bilgisini sorgulamak için kullanılabilecek, her zaman erişilebilir Portal yardımcı endpointleridir.
| Endpoint | HTTP | Açıklama |
|---|---|---|
GetTaxPayerProfile | GET | VKN/TCKN ile mükellef profili (TaxPayer, NACECodes, Activities, Addresses) |
GetAllowedVATRates | GET | Mükellefin NACE koduna göre izinli KDV oranları |
GetNACECodes | GET | Mükellefin NACE faaliyet kodları |
GetActivities | GET | Merkez/şube bazlı detaylı faaliyet bilgisi |
GetAddresses | GET | Mükellefin GİB'de kayıtlı adresleri |
IsActiveOnDate | GET | Mükellefin belirli bir tarihte aktif olup olmadığı |
GetTaxOfficeByCode | GET | Vergi dairesi kodu ile bilgi |
SearchTaxOfficesByName | GET | Vergi dairesi adında kısmi arama |
Portal İşlem Matrisi
| İşlem | Portal kullanıcısının yaptığı | VBT'nin tamamladığı |
|---|---|---|
| Oluşturma | Formu doldurur, kaydeder | Numara üretir, UBL XML oluşturur, imza kuyruğuna alır |
| Mükellef sorgusu | VKN/TCKN ile mükellef bilgisini görüntüler | GİB'den canlı sorgular |
| İptal | İptal talebini başlatır | Signed ön koşulunu kontrol eder, durumu günceller |
| Raporlama | Rapor durumunu izler | Günlük GİB rapor döngüsünü çalıştırır |