E-Defter Arşivi Firmaları

# E-Defter Arşivi Firmaları

Kullanıcının e-defter arşivinde gezebileceği firmaları (mükellefleri) listeler. Giriş gerektirir (bearer ya da basic auth). Bu listedeki kapsam diğer servislerden farklıdır: erişim OINT_USER.roleArchive yetkisi, kullanıcının müşterisine bağlı mükellefler ve OINT_USER.taxNrArchive VKN kısıtından türer — etiket (WORKLABEL) yetkisi aranmaz. Klasör ve dosya servisleri yalnızca buradaki firma referanslarını kabul eder.

## Parametreler

- **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"
}
```

## Örnek Yanıt (olumlu)

```json
{
    "basarili": true,
    "mesaj": "E-defter arşivi firmaları",
    "veri": {
        "firmalar": [
            {
                "reference": 3057,
                "kod": "ORNEK",
                "vkn": "1751012715",
                "unvan": "Örnek Firma A.Ş."
            }
        ]
    }
}
```

## Örnek Yanıt (olumsuz)

```json
{
    "basarili": false,
    "mesaj": "E-defter arşivi için yetkiniz yok.",
    "veri": null
}
```