E-Defter Arşivi Klasörleri

# E-Defter Arşivi Klasörleri

Bir firmanın e-defter arşiv klasörlerini (dönemlerini) listeler; her klasör için dosya sayısı ve kontör toplamı döner. Klasör adı YYYYAA biçimindedir, dönem yıl/ay olarak da ayrıştırılır. Giriş gerektirir (bearer ya da basic auth). Firma, edefter_arsiv_firmalari listesinde olmalıdır; sorgu yalnızca doğrulanmış firmanın taxHolder_reference değeriyle çalışır.

## Parametreler

- **firma_reference** (integer, zorunlu): Klasörleri listelenecek firmanın referansı — edefter_arsiv_firmalari servisindeki firmalar[].reference değeri. Örnek: `3057`
- **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
}
```

## Örnek Yanıt (olumlu)

```json
{
    "basarili": true,
    "mesaj": "E-defter arşivi klasörleri",
    "veri": {
        "firma": {
            "reference": 3057,
            "kod": "ORNEK",
            "vkn": "1751012715",
            "unvan": "Örnek Firma A.Ş."
        },
        "sayfa": 1,
        "sayfa_boyutu": 50,
        "devamVar": false,
        "klasorler": [
            {
                "reference": 18491,
                "ad": "202604",
                "donem_yil": 2026,
                "donem_ay": 4,
                "olusturma_tarihi": "2026-06-27 09:45:15",
                "grup_tipi": 1,
                "dogrulama_sonucu": 0,
                "dosya_sayisi": 5,
                "kontor": 1
            }
        ]
    }
}
```

## Örnek Yanıt (olumsuz)

```json
{
    "basarili": false,
    "mesaj": "Bu firmanın e-defter arşivine erişim yetkiniz yok.",
    "veri": null
}
```