Fatura Listesi

# Fatura Listesi

Kullanıcının yetkili olduğu etiketlere (WORKLABEL) ait belgeleri listeler. Giriş gerektirir (bearer ya da basic auth). Belge tipi zorunludur; gelen_efatura, giden_efatura gibi özel servisler bu servisin belge tipi sabitlenmiş halleridir. Belge tarihi ya da gönderim tarihi aralıklarından en az biri zorunludur ve bir aralık en fazla 40 gün olabilir; 16 haneli belge_no ya da ettn ile tam eşleşme araması yapılıyorsa tarih aralığı istenmez.

## Parametreler

- **belge_tipi** (string, zorunlu): Listelenecek belge tipi: gelen_efatura, giden_efatura, gelen_eirsaliye, giden_eirsaliye, giden_earsiv, giden_mustahsil. Örnek: `"gelen_efatura"`
- **belge_tarihi_baslangic** (string, isteğe bağlı): Belge tarihi aralığının başlangıcı (YYYY-AA-GG ya da YYYY-AA-GG SS:DD:SS). Saat verilmezse gün başı kabul edilir. Örnek: `"2026-07-01"`
- **belge_tarihi_bitis** (string, isteğe bağlı): Belge tarihi aralığının bitişi. Saat verilmezse gün sonu (23:59:59) kabul edilir. Örnek: `"2026-07-31"`
- **gonderim_tarihi_baslangic** (string, isteğe bağlı): Gönderim/alım (kayıt) tarihi aralığının başlangıcı. Örnek: `"2026-07-01"`
- **gonderim_tarihi_bitis** (string, isteğe bağlı): Gönderim/alım (kayıt) tarihi aralığının bitişi. Örnek: `"2026-07-31"`
- **belge_no** (string, isteğe bağlı): Belge numarası (docCode). 16 hane verilirse tam eşleşme aranır ve tarih aralığı zorunlu olmaz; daha kısa değerlerde içinde geçen araması yapılır ve tarih aralığı gerekir. Örnek: `"ABC2026000000123"`
- **ettn** (string, isteğe bağlı): Belgenin ETTN değeri (docGuid). Tam eşleşme aranır, tarih aralığı zorunlu olmaz. Örnek: `"3f2b8c1a-9d4e-4f77-b3a1-6c5d4e3f2b1a"`
- **gonderen** (string, isteğe bağlı): Gönderen filtresi. 10/11 haneli rakam verilirse VKN/TCKN tam eşleşmesi, aksi halde unvan içinde geçen araması yapılır. Örnek: `"1234567890"`
- **alici** (string, isteğe bağlı): Alıcı filtresi. 10/11 haneli rakam verilirse VKN/TCKN tam eşleşmesi, aksi halde unvan içinde geçen araması yapılır. Örnek: `"Örnek Ticaret"`
- **cevap** (string, isteğe bağlı): Uygulama yanıtı durumu: bekleyen, kabul, red. Yalnızca e-fatura ve e-irsaliye tiplerinde geçerlidir. Örnek: `"bekleyen"`
- **firma_reference** (integer, isteğe bağlı): Yalnızca bu firmanın (mükellefin) etiketlerinde ara. Verilmezse kullanıcının yetkili olduğu tüm etiketler taranır. Örnek: `42`
- **page** (integer, isteğe bağlı): Sayfa numarası (1 tabanlı, varsayılan 1). Örnek: `1`
- **pageSize** (integer, isteğe bağlı): Sayfa başına kayıt sayısı (varsayılan 50, en fazla 200). Örnek: `50`
- **bearer** (string, isteğe bağlı): Bearer GUID (Authorization: Bearer başlığı yerine payload ile de gönderilebilir). Örnek: `"9b2f6c1e-0d4a-4a7e-9c3b-1f2e3d4c5b6a"`
- **musteri** (string, isteğe bağlı): Basic auth için müşteri (firma) kodu. Örnek: `"demo"`
- **kullanici** (string, isteğe bağlı): Basic auth için kullanıcı adı. Örnek: `"ali"`
- **sifre** (string, isteğe bağlı): Basic auth için şifre. Loglara asla yazılmaz. Örnek: `"gizli123"`

## Örnek İstek

```json
{
    "bearer": "9b2f6c1e-0d4a-4a7e-9c3b-1f2e3d4c5b6a",
    "belge_tipi": "gelen_efatura",
    "belge_tarihi_baslangic": "2026-07-01",
    "belge_tarihi_bitis": "2026-07-31",
    "page": 1,
    "pageSize": 50
}
```

## Örnek Yanıt (olumlu)

```json
{
    "basarili": true,
    "mesaj": "Gelen E-Fatura listesi",
    "veri": {
        "belge_tipi": "gelen_efatura",
        "belge_tipi_adi": "Gelen E-Fatura",
        "sayfa": 1,
        "sayfa_boyutu": 50,
        "devamVar": false,
        "kayitlar": [
            {
                "reference": 987654,
                "belge_no": "ABC2026000000123",
                "ettn": "3f2b8c1a-9d4e-4f77-b3a1-6c5d4e3f2b1a",
                "belge_tarihi": "2026-07-14 00:00:00",
                "gonderim_tarihi": "2026-07-14 10:32:11",
                "para_birimi": "TRY",
                "tutar": 11800,
                "belge_turu": 1,
                "belge_turu_adi": "Satış",
                "profil": 1,
                "profil_adi": "Temel Fatura",
                "yon": 1,
                "yon_adi": "Gelen Fatura",
                "gonderen_vkn": "1234567890",
                "gonderen_unvan": "Örnek Ticaret A.Ş.",
                "alici_vkn": "9876543210",
                "alici_unvan": "Demo Bilişim A.Ş.",
                "cevap_durumu": 1,
                "cevap_durumu_adi": "Cevap Bekliyor",
                "islenme_durumu": 1,
                "kaynak_etiket": "urn:mail:defaultpk@ornekfirma.com.tr",
                "etiket_reference": 501,
                "zarf_reference": 445566,
                "zarf_gib_kodu": 1300,
                "zarf_gib_durumu": 5,
                "zarf_gib_mesaji": "Basarili",
                "boyut": 18422
            }
        ]
    }
}
```

## Örnek Yanıt (olumsuz)

```json
{
    "basarili": false,
    "mesaj": "Belge tarihi ya da gönderim tarihi aralığından en az biri zorunludur. 16 haneli belge_no ya da ettn ile arama yapıyorsanız tarih aralığı gerekmez.",
    "veri": null
}
```