İzibiz Developer Portal
E-Müstahsil REST API

Gelen E-Müstahsil Listeleme

GET{{baseUrl}}/{{v2}}/ecreditnotes/inbox

GİB İnteraktif Vergi Dairesi (5.000/30.000 portalı) üzerinden müşterilerimize kesilen gelen e-Müstahsil Makbuzu belgeleri için kullanılır.

Gelen belgeleri sayfalı olarak listeler. Tüm filtreler opsiyoneldir.

Yanıttaki id değeri; Gelen E-Müstahsil Görüntüleme ve Gelen E-Müstahsil İndirme servislerinde belge kimliği olarak, portalReadStatus ise belgenin portalda okunup okunmadığı bilgisi olarak kullanılır.

Yanıt alanları (data.contents[]):

Alan Açıklama
id Belge kimliği. Görüntüleme ve indirme işlemlerinde kullanılır.
uuid Belgenin ETTN değeri.
documentNo Belge numarası.
issueDate Belge tarihi.
direction Yön (IN: gelen).
amount / taxAmount / currency Tutar, vergi tutarı ve para birimi.
portalReadStatus Portalda okunma durumu.
documentStatus Belge durumu.
sender / receiver Gönderici ve alıcı bilgileri.

Sayfalama bilgisi data.pageable (page, size, totalElements, totalPages) altında döner.

Header Parametreleri

AdTipZorunluAciklama
Authorization text Evet v1/auth/token endpointten alınan token

Query Parametreleri

AdTipZorunluAciklama
startDate date Hayir Başlangıç tarihi (YYYY-MM-DD)
endDate date Hayir Bitiş tarihi (YYYY-MM-DD)
page number Hayir Sayfa numarası (0'dan başlar)
pageSize number Hayir Sayfa başına kayıt sayısı
documentNo text Hayir Belge numarası
uuid text Hayir Belgenin ETTN değeri
senderIdentifier text Hayir Göndericinin VKN/TCKN değeri
portalReadStatus text Hayir Portalda okunma durumu (true / false)

Ornek Yanit

{
    "data": {
        "contents": [
            {
                "id": 73502,
                "uuid": "3f6a1c2e-1b2d-4e5f-8a9b-0c1d2e3f4a5b",
                "documentNo": "MST2026000000052",
                "issueDate": "2026-10-10",
                "direction": "IN",
                "amount": 1180,
                "taxAmount": 180,
                "currency": "TRY",
                "portalReadStatus": false,
                "documentStatus": {},
                "sender": {},
                "receiver": {}
            }
        ],
        "pageable": {
            "page": 0,
            "size": 20,
            "totalElements": 1,
            "totalPages": 1
        }
    },
    "error": null
}

Yanit Kodlari

KodAciklama
200Gelen E-Müstahsil listesi