Ayarları Kaydet

# Ayarları Kaydet

Firma geneli ya da kullanıcı bazlı e-fatura ayarlarını kaydeder (eski sistemdeki Ayarlar ekranının karşılığı). Yalnızca istekte gönderilen alanlar güncellenir; boş gönderilen alan temizlenir. Kayıt yerel veritabanına yazılır — eski sistemdeki ayarlar değişmez. Firma serileri (seri_efatura / seri_earsiv) de yerel ayarlarda tutulur; mükellef kaydındaki seriler salt okunur olduğundan güncellenmez. Giriş gerektirir (bearer ya da basic auth).

## Parametreler

- **firma_reference** (integer, isteğe bağlı): Ayarları kaydedilecek firmanın (mükellefin) referansı. Verilmezse oturumun seçili firması kullanılır. Örnek: `42`
- **kullanici_bazli** (boolean, isteğe bağlı): true verilirse giriş yapan kullanıcının kullanıcı bazlı firma ayarları kaydedilir; varsayılan firma geneli ayarlardır. Örnek: `false`
- **unvan** (string, isteğe bağlı): Fatura üzerinde görünecek firma ünvanı. Örnek: `"Örnek Firma A.Ş."`
- **vergi_dairesi** (string, isteğe bağlı): Firma vergi dairesi. Örnek: `"Osmangazi"`
- **street** (string, isteğe bağlı): Adres satır 1. Örnek: `"Örnek Mah. Deneme Cad. No: 1"`
- **building** (string, isteğe bağlı): Adres satır 2.
- **ilce** (string, isteğe bağlı): Adres ilçe. Örnek: `"Osmangazi"`
- **il** (string, isteğe bağlı): Adres il. Örnek: `"Bursa"`
- **postakodu** (string, isteğe bağlı): Adres posta kodu. Örnek: `"16000"`
- **email** (string, isteğe bağlı): Firma e-posta adresi. Örnek: `"muhasebe@ornek.com"`
- **tel** (string, isteğe bağlı): Firma telefonu. Örnek: `"0224 000 00 00"`
- **web** (string, isteğe bağlı): Firma web sitesi. Örnek: `"https:\/\/www.ornek.com"`
- **ticaretsicil** (string, isteğe bağlı): Ticaret sicil numarası. Örnek: `"123456"`
- **mersis** (string, isteğe bağlı): Mersis numarası. Örnek: `"0123456789000001"`
- **xslt_efatura** (integer, isteğe bağlı): E-fatura XSLT tasarımı (xslt_listesi servisindeki yerel tasarım id değeri; 0 = varsayılan tasarım). Örnek: `3`
- **xslt_earsiv** (integer, isteğe bağlı): E-arşiv XSLT tasarımı (yerel tasarım id; 0 = varsayılan). Örnek: `0`
- **xslt_ihracat** (integer, isteğe bağlı): E-ihracat XSLT tasarımı (yerel tasarım id; 0 = varsayılan). Örnek: `0`
- **xslt_irsaliye** (integer, isteğe bağlı): E-irsaliye XSLT tasarımı (yerel tasarım id; 0 = varsayılan). Örnek: `0`
- **xslt_mustahsil** (integer, isteğe bağlı): E-müstahsil XSLT tasarımı (yerel tasarım id; 0 = varsayılan). Örnek: `0`
- **fatura_tipi** (string, isteğe bağlı): Varsayılan fatura tipi: temel, ticari, ihracat, yb. Boş verilirse temizlenir. Örnek: `"temel"`
- **seri_efatura** (string, isteğe bağlı): Varsayılan e-fatura serisi (3 harf). Boş verilirse temizlenir. Örnek: `"ABC"`
- **seri_earsiv** (string, isteğe bağlı): Varsayılan e-arşiv serisi (3 harf). Örnek: `"ARS"`
- **seri_ihracat** (string, isteğe bağlı): Varsayılan ihracat e-fatura serisi (3 harf). Örnek: `"IHR"`
- **seri_irsaliye** (string, isteğe bağlı): Varsayılan e-irsaliye serisi (3 harf). Örnek: `"IRS"`
- **seri_cirsaliye** (string, isteğe bağlı): Varsayılan e-irsaliye cevap serisi (3 harf). Örnek: `"CIR"`
- **seri_emustahsil** (string, isteğe bağlı): Varsayılan e-müstahsil serisi (3 harf). Örnek: `"MUS"`
- **earsiv_metod** (string, isteğe bağlı): Varsayılan e-arşiv satış yeri: MAGAZA, INTERNET. Boş verilirse temizlenir. Örnek: `"INTERNET"`
- **earsiv_dagitim** (string, isteğe bağlı): Varsayılan e-arşiv dağıtımı: KAGIT, ELEKTRONIK. Örnek: `"ELEKTRONIK"`
- **earsiv_odeme** (string, isteğe bağlı): Varsayılan e-arşiv ödemesi: kk, eft, kapida, araci, diger. Örnek: `"kk"`
- **earsiv_webshop** (string, isteğe bağlı): Varsayılan e-arşiv web satış adresi. Örnek: `"www.ornek.com"`
- **earsiv_shipagent** (string, isteğe bağlı): Varsayılan e-arşiv kargo firması ünvanı.
- **earsiv_shipvkn** (string, isteğe bağlı): Varsayılan e-arşiv kargo firması vergi kimlik numarası.
- **smtp_server** (string, isteğe bağlı): E-posta gönderimi için SMTP sunucu adresi. Örnek: `"smtp.ornek.com"`
- **smtp_port** (string, isteğe bağlı): SMTP portu. Örnek: `"587"`
- **smtp_user** (string, isteğe bağlı): SMTP kullanıcı adı. Örnek: `"efatura@ornek.com"`
- **smtp_pass** (string, isteğe bağlı): SMTP şifresi. Örnek: `"gizli"`
- **smtp_from** (string, isteğe bağlı): Gönderimlerde görünecek e-posta adresi. Örnek: `"efatura@ornek.com"`
- **imzali_pdf** (integer, isteğe bağlı): İmzalı PDF hazırlama: 0 = hazırlama, 1 = imzalı PDF kullan. Örnek: `0`
- **sms** (integer, isteğe bağlı): SMS gönderimi: 0 = varsayılan, 1 = gönderme, 2 = gönder, 3 = özel şablonla gönder. Örnek: `0`
- **eposta_sablonu** (string, isteğe bağlı): E-posta şablonu anahtarı.
- **islendi_metodu** (integer, isteğe bağlı): Fatura işlenme durumu: 0 = varsayılan, 1 = yazdırıldığında işlendi işaretle, 2 = işaretleme yapma. Örnek: `0`
- **web_pdf** (integer, isteğe bağlı): Yazdırma seçeneği: 0 = standart, 1 = portal, 2 = servis. Örnek: `0`
- **line_extension** (integer, isteğe bağlı): Satır toplam değeri: 0 = standart, 1 = brüt. Örnek: `0`
- **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,
    "unvan": "Örnek Firma A.Ş.",
    "vergi_dairesi": "Osmangazi",
    "fatura_tipi": "temel",
    "seri_efatura": "ABC",
    "xslt_efatura": 3
}
```

## Örnek Yanıt (olumlu)

```json
{
    "basarili": true,
    "mesaj": "Ayarlar kaydedildi",
    "veri": {
        "firma": {
            "reference": 42,
            "kod": "ORNEK",
            "vkn": "1234567890",
            "unvan": "Örnek Firma A.Ş."
        },
        "kullanici_bazli": false,
        "kaydedilen_alanlar": [
            "unvan",
            "vergi_dairesi",
            "fatura_tipi",
            "seri_efatura",
            "xslt_efatura"
        ],
        "ayarlar": {
            "unvan": "Örnek Firma A.Ş.",
            "vergi_dairesi": "Osmangazi",
            "seri_efatura": "ABC",
            "fatura_tipi": "temel",
            "fatura_tipi_adi": "Temel Fatura",
            "xslt_efatura": 3
        }
    }
}
```

## Örnek Yanıt (olumsuz)

```json
{
    "basarili": false,
    "mesaj": "seri_efatura 3 harften oluşmalıdır; sayı veya noktalama işareti kullanmayınız.",
    "veri": null
}
```

## Seçim Alanları

- **fatura_tipi**: `temel` = Temel Fatura, `ticari` = Ticari Fatura, `ihracat` = İhracat Faturası, `yb` = Yolcu Beraberi Eşya Faturası
- **earsiv_metod**: `MAGAZA` = Mağaza, `INTERNET` = İnternet
- **earsiv_dagitim**: `KAGIT` = Kağıt, `ELEKTRONIK` = Elektronik
- **earsiv_odeme**: `kk` = Kredi Kartı / Banka Kartı, `eft` = EFT / Havale, `kapida` = Kapıda Ödeme, `araci` = Ödeme Aracısı, `diger` = Diğer
- **imzali_pdf**: `0` = Hazırlama, `1` = İmzalı PDF Kullan
- **sms**: `0` = Varsayılan, `1` = Gönderme, `2` = Gönder, `3` = Özel Şablonla Gönder
- **islendi_metodu**: `0` = Varsayılan, `1` = Yazdırıldığında İşlendi Olarak İşaretle, `2` = İşaretleme Yapma
- **web_pdf**: `0` = Standart, `1` = Portal, `2` = Servis
- **line_extension**: `0` = Standart, `1` = Brüt