Firma Seçim

# Firma Seçim

Oturumun (bearer kaydının) çalışma firmasını seçer. Kullanıcı yalnızca yetkili olduğu firmaları seçebilir; seçim bearer kaydının secilen_firma alanına yazılır ve sonraki isteklerde geçerli olur. Giriş gerektirir (bearer ya da basic auth).

## Parametreler

- **firma_reference** (integer, zorunlu): Seçilecek firmanın (mükellefin) referansı — profil servisindeki firmalar[].reference değeri. Örnek: `42`
- **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": 42
}
```

## Örnek Yanıt (olumlu)

```json
{
    "basarili": true,
    "mesaj": "Firma seçildi",
    "veri": {
        "secilen_firma": {
            "reference": 42,
            "kod": "ORNEK",
            "vkn": "1234567890",
            "unvan": "Örnek Firma A.Ş."
        }
    }
}
```

## Örnek Yanıt (olumsuz)

```json
{
    "basarili": false,
    "mesaj": "Bu firma için yetkiniz yok ya da firma bulunamadı.",
    "veri": null
}
```