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

# Faturalar

> Sistem üzerinden kesilen faturaları kalem satırlarına kadar okuyun

Faturalar kaynağı, SarrafPro üzerinden kesilen e-faturaların kayıtlarını sunar. Liste ucu hafif özet döner; kalem satırları (`lines`) ve tam müşteri bloğu detay ucundadır.

## `GET /v1/invoices` — fatura listesi

### Sorgu parametreleri

Ortak parametreler için [Genel Bakış](/api-reference/genel-bakis).

| Parametre                               | Tür       | Açıklama                                                |
| --------------------------------------- | --------- | ------------------------------------------------------- |
| `filter[idNo]`                          | string    | Müşteri TCKN/VKN tam eşleşme                            |
| `filter[invoiceNumber]`                 | string    | Fatura numarası tam eşleşme                             |
| `filter[type]`                          | string    | Fatura türü                                             |
| `filter[integrator]`                    | string    | Entegratör (Nilvera, GIB vb.)                           |
| `filter[module]`                        | string    | Faturanın üretildiği modül                              |
| `filter[startDate]` / `filter[endDate]` | date-time | `transactionDate` (fatura/resmileştirme tarihi) aralığı |
| `filter[updatedSince]`                  | date-time | Artımlı senkronizasyon                                  |

Sıralama whitelist'i: `transactionDate`, `createdAt`, `updatedAt`, `payableTotal`. Varsayılan `transactionDate:asc`.

### Cevap alanları (liste öğesi)

| Alan                                                       | Anlam                                               |
| ---------------------------------------------------------- | --------------------------------------------------- |
| `id`                                                       | Fatura kayıt kimliği                                |
| `transactionDate`                                          | Fatura / resmileştirme tarihi                       |
| `invoiceNumber`                                            | Fatura numarası                                     |
| `invoiceType` / `integrator` / `invoiceStatus`             | Tür, entegratör ve gönderim durumu                  |
| `linesTotal`, `kdvTotal`, `allowanceTotal`, `payableTotal` | Tutar özeti (kalem toplamı, KDV, iskonto, ödenecek) |
| `customer`                                                 | `{ taxNumber, name }` — müşteri özeti               |
| `idNo`                                                     | Müşteri TCKN/VKN                                    |
| `module`                                                   | Üretildiği modül                                    |

## `GET /v1/invoices/{id}` — fatura detayı

Liste alanlarına ek olarak:

* **`customer`** — tam blok: `taxNumber`, `name`, `taxOffice`, `address`, `district`, `city`, `phone`, `mail`, `webSite`, `country`
* **`invoiceInfo`** — tam entegratör bilgisi: `integrator`, `type`, `uuid`, `invoiceNumber`, `status`
* **`lines[]`** — kalem satırları:

| Kalem alanı                                 | Anlam                                                     |
| ------------------------------------------- | --------------------------------------------------------- |
| `name`, `quantity`, `unitType`, `stockCode` | Ürün/hizmet tanımı, miktar, birim, stok kodu              |
| `price`, `amount`, `lineTotal`              | Birim fiyat, net tutar (KDV ve iskontosuz), satır toplamı |
| `kdvPercent`, `kdvTotal`                    | KDV oranı ve tutarı                                       |
| `allowancePrice`, `allowanceTotal`          | İskonto birim ve toplam tutarı                            |
| `ozelMatrahTotal`                           | Özel matrah tutarı                                        |
| `isExtra`, `isDefault`, `isLabor`           | Ek kalem / varsayılan kalem / işçilik kalemi              |

<Note>
  Fatura modelinde para birimi alanı tutulmaz; tutarlar kayıtlı haliyle döner. Fatura PDF/görsel içeriği bu sürümde API'de yoktur.
</Note>

<Note>
  Bu sürümde faturalar **yalnızca görüntülenebilir**; fatura oluşturma/gönderme API'de yoktur.
</Note>

## `GET /v1/invoice-variables` — kalem şablonları

Şirketinizin fatura kalem şablonlarını (ayar/saflık/işçilik tanımları) görüntüler. Varsayılan listede pasif/silinmiş şablonlar dönmez.

### Sorgu parametreleri

| Parametre            | Tür     | Açıklama                                                                    |
| -------------------- | ------- | --------------------------------------------------------------------------- |
| `filter[statusType]` | string  | `all`, `invoice`, `expense`, `passive` (varsayılan listede pasifler dönmez) |
| `filter[material]`   | string  | `gold`, `silver`, `platin`, `paladyum`, `usd`, `eur`, `try`                 |
| `filter[isDefault]`  | boolean | Varsayılan şablon                                                           |
| `q`                  | string  | Kalem adında arama                                                          |

### Cevap alanları

`id`, `key`, `title`, `lineName`, `material`, `statusType`, `type`, `exchange` (saflık), `vatRate`, `unitType`, `laborDisabled`, `laborName`, `laborType`, `stockCode`, `isDefault`, `isManual`, `order`, `words`, `createdAt`, `updatedAt`