> ## 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.

# Ödemeler

> Tahsilat yöntemleri, taksitlendirme ve kısmi ödeme mantığı.

Ödeme, bir satışa karşılık alınan tahsilattır. Bir satışın birden fazla ödemesi olabilir (kısmi ödeme, taksit).

## Yapı

```mermaid theme={null}
flowchart LR
    S[Satış<br/>Toplam: 1000] --> O1[Ödeme 1<br/>300 ₺]
    S --> O2[Ödeme 2<br/>400 ₺]
    S --> O3[Ödeme 3<br/>300 ₺]
    O1 --> ST[status: pending<br/>kalan var]
    O2 --> ST
    O3 --> ST2[status: completed<br/>tahsilat tamam]
```

## Ödeme yöntemleri

Flextell'de tanımlı ödeme yöntemi değerleri (`PaymentMethod` enum):

| Değer              | Açıklama                       |
| ------------------ | ------------------------------ |
| `BankAccount`      | Banka hesabı / havale-EFT      |
| `TransferCash`     | Kasa devri (elden)             |
| `CreditCard`       | Kredi kartı                    |
| `ClinicCreditCard` | Firma kredi kartı (kuruma ait) |
| `PrivateInsurance` | Özel sigorta                   |
| `SGK`              | SGK kapsamı                    |
| `Other`            | Yukarıdakilere uymayan         |

Tüm ödemeler `CustomerTransaction` kaydı olarak işlenir — `debit/credit` alanlarıyla yön bilgisi tutulur.

## Ödeme alanları (`CustomerTransaction`)

| Alan                                        | Açıklama                        |
| ------------------------------------------- | ------------------------------- |
| `sale_id`                                   | Hangi satışa ait (opsiyonel)    |
| `customer_id`                               | Hangi kişi                      |
| `debit` / `credit`                          | Tutar (yön ile birlikte)        |
| `payment_method`                            | Ödeme yöntemi (yukarıdaki enum) |
| `is_installment`                            | Taksitli mi                     |
| `installment_number` / `total_installments` | Kaçıncı/toplam taksit           |
| `due_date`                                  | Vade tarihi (taksitliyse)       |

## Kısmi ödeme akışı

<Steps>
  <Step title="Satış oluşturuldu">
    Toplam: 1000 ₺. Durum `pending` (tahsilat bekliyor).
  </Step>

  <Step title="İlk ödeme alındı (300 ₺)">
    Durum `pending` (kalan var). Kalan: 700 ₺.
  </Step>

  <Step title="İkinci ödeme alındı (400 ₺)">
    Durum hâlâ `pending`. Kalan: 300 ₺.
  </Step>

  <Step title="Son ödeme alındı (300 ₺)">
    Durum `completed`. Kalan: 0 ₺.
  </Step>
</Steps>

## Taksitlendirme

Taksit, **planlı kısmi ödemeler** olarak kaydedilir.

| Taksit | Tutar | Vade       | Durum    |
| ------ | ----- | ---------- | -------- |
| 1      | 333 ₺ | 25 Nisan   | Alındı   |
| 2      | 333 ₺ | 25 Mayıs   | Bekliyor |
| 3      | 334 ₺ | 25 Haziran | Bekliyor |

Vadesi gelen taksit panel `Kasa → Vadesi Gelen` listesinde görünür; ödeme alındığında işaretlenir.

## İade

İade için ayrı bir işlem türü yoktur; ters yönlü bir `CustomerTransaction` kaydı (debit/credit yönü ters) kullanılır. Toplam tahsil edilen tutar düşer; satış durumu `completed`'tan `pending`'e geri dönebilir.

<Warning>
  İadeden önce **e-Faturayı iptal etmeyi/iade kesmeyi** unutmayın — aksi halde mali kayıt fiili durumla uyumsuz olur.
</Warning>

## API tarafı

Programatik ödeme kaydı için bkz. API tarafı [Satış kaydı](/guides/record-sale).