> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flextell.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Satış — Genel Bakış

> Satış kaydının yapısı, kalemler, KDV ve indirim mantığı.

Satış, Flextell'de **tahsil edilecek tutarı** temsil eden kayıttır. Bir randevuya bağlı oluşabilir (tedavi sonrası) veya randevudan bağımsız açılabilir (ürün satışı, paket).

## Yapı

```mermaid theme={null}
flowchart LR
    S[Satış] --> K1[Kalem 1<br/>tedavi/ürün]
    S --> K2[Kalem 2]
    S --> K3[Kalem n]
    K1 --> KDV[KDV hesabı]
    K2 --> KDV
    K3 --> KDV
    KDV --> T[Toplam tutar]
    T --> P[Ödeme akışı]
```

## Bir satış kaydının alanları

| Alan             | Açıklama                                                 |
| ---------------- | -------------------------------------------------------- |
| `customer_id`    | Hangi hasta/hasta                                        |
| `appointment_id` | Bağlı randevu (opsiyonel)                                |
| `items`          | Satış kalemleri (en az 1)                                |
| `discount`       | Genel indirim (tutar veya %)                             |
| `status`         | `draft`, `pending`, `completed`, `invoiced`, `cancelled` |
| `note`           | Serbest not                                              |

## Kalem yapısı

| Alan           | Açıklama                                                     |
| -------------- | ------------------------------------------------------------ |
| `type`         | `treatment` (tedavi) / `product` (ürün) / `service` (hizmet) |
| `reference_id` | Tedavi veya ürün ID'si                                       |
| `name`         | Görünür ad                                                   |
| `unit_price`   | Birim fiyat                                                  |
| `quantity`     | Adet                                                         |
| `discount`     | Kalem bazında indirim                                        |
| `tax_rate`     | KDV oranı (% — 0, 1, 10, 20 gibi)                            |

## KDV ve indirim mantığı

```mermaid theme={null}
flowchart LR
    BF[Birim fiyat × adet] --> KI[- Kalem indirimi<br/>tutar veya %]
    KI --> ARA[Ara toplam]
    ARA --> GI[- Genel indirim]
    GI --> KDV[+ KDV<br/>kalem bazlı tax_rate]
    KDV --> T[Toplam]
```

Her satış kaleminde kendi `tax_rate` değeri bulunur; KDV oranı kalem bazlı uygulanır.

## Durum geçişleri

| Aksiyon                       | Yeni durum  | Etiket           |
| ----------------------------- | ----------- | ---------------- |
| Taslak kaydet                 | `draft`     | Taslak           |
| Tahsilat veya işleme bekliyor | `pending`   | Beklemede        |
| Tahsilat tamamlandı           | `completed` | Tamamlandı       |
| e-Fatura kesildi              | `invoiced`  | Faturalandırıldı |
| İptal et                      | `cancelled` | İptal Edildi     |

## Randevu ile ilişki

Randevu `completed` olduktan sonra üstüne satış açılır (gerekirse `approved` aşamasında da). Tek randevuya birden fazla satış bağlanabilir (örn. tedavi + üzerine satılan bakım ürünü).

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Ödemeler" icon="credit-card" href="/documentation/finance/payments">
    Tahsilat, taksit, kısmi ödeme.
  </Card>

  <Card title="Stok" icon="boxes-stacked" href="/documentation/finance/stock">
    Ürün satışında stok düşümü.
  </Card>

  <Card title="Raporlar" icon="chart-line" href="/documentation/clinic/ai-reports">
    Günlük ciro, doktor performansı.
  </Card>

  <Card title="API: Satış kaydı" icon="code" href="/guides/record-sale">
    Programatik satış oluşturma.
  </Card>
</CardGroup>