E-Defter Arşivi Dosyaları

# E-Defter Arşivi Dosyaları

Bir firmanın e-defter arşiv dosyalarını listeler (berat, kebir, defter raporu). Klasör, dosya adı ve GUID ile daraltılabilir. Giriş gerektirir (bearer ya da basic auth). Firma, edefter_arsiv_firmalari listesinde olmalıdır; her sorgu doğrulanmış firmanın taxHolder_reference değeriyle kısıtlanır, dolayısıyla GUID araması da başka bir firmanın dosyasına erişemez. Dosya içeriği bu servisle indirilemez.

## Parametreler

- **firma_reference** (integer, zorunlu): Dosyaları listelenecek firmanın referansı — edefter_arsiv_firmalari servisindeki firmalar[].reference değeri. Örnek: `3057`
- **klasor_reference** (integer, isteğe bağlı): Yalnızca bu klasördeki (dönemdeki) dosyaları getir. Klasör verilen firmaya ait olmalıdır. Örnek: `18491`
- **dosya_adi** (string, isteğe bağlı): Dosya adı içinde geçen arama. Örnek: `"202604"`
- **guid** (string, isteğe bağlı): Dosyanın GUID değeri, tam eşleşme. Sonuç yine firmanın arşiviyle sınırlıdır — başka firmanın GUID değeri sonuç döndürmez. Örnek: `"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"`
- **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",
    "firma_reference": 3057,
    "klasor_reference": 18491
}
```

## Örnek Yanıt (olumlu)

```json
{
    "basarili": true,
    "mesaj": "E-defter arşivi dosyaları",
    "veri": {
        "firma": {
            "reference": 3057,
            "kod": "ORNEK",
            "vkn": "1751012715",
            "unvan": "Örnek Firma A.Ş."
        },
        "sayfa": 1,
        "sayfa_boyutu": 50,
        "devamVar": false,
        "dosyalar": [
            {
                "reference": 174574,
                "ad": "GIB-1751012715-202604-YB-000000.xml",
                "guid": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
                "defter_turu": "YB",
                "defter_turu_adi": "Yevmiye Beratı",
                "klasor_reference": 18491,
                "klasor_adi": "202604",
                "donem_yil": 2026,
                "donem_ay": 4,
                "olusturma_tarihi": "2026-06-27 09:45:15",
                "boyut": 8142,
                "acik_boyut": 23584,
                "acik_boyut_okunabilir": "23,03 KB",
                "kontor": 1,
                "ozet": "e3b0c44298fc1c149afbf4c8996fb924",
                "gib_durumu": 10,
                "gib_durumu_adi": "Yüklendi",
                "gib_yukleme_tarihi": "2026-06-27 10:02:44",
                "gib_belge_id": "GIB-20260627-000123"
            }
        ]
    }
}
```

## Örnek Yanıt (olumsuz)

```json
{
    "basarili": false,
    "mesaj": "Klasör bulunamadı ya da bu firmaya ait değil.",
    "veri": null
}
```