Faturalar

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

Örnek istek

curl 'https://api.sarraf.pro/v1/invoices?startDate=2026-09-01T00:00:00.000Z&pageSize=25' \
  -u 'apiUserId:secretKey'

Sorgu parametreleri

Ortak parametreler için Genel Bakış.

Parametre	Tür	Açıklama
`idNo`	string	Müşteri TCKN/VKN tam eşleşme
`invoiceNumber`	string	Fatura numarası tam eşleşme
`type`	string	Belge türü: `earchive` (e-arşiv) veya `einvoice` (e-fatura)
`startDate` / `endDate`	date-time	`transactionDate` (fatura/resmileştirme tarihi) aralığı

Sıralama whitelist’i: transactionDate, 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`	Belge türü: `earchive` veya `einvoice`
`invoiceStatus`	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

Cevap — `200`

{
  "success": true,
  "data": [
    {
      "id": "6aae937b8d76c7a547248699",
      "transactionDate": "2026-09-19T12:00:00.000Z",
      "invoiceNumber": "SAR2026000000123",
      "invoiceType": "earchive",
      "invoiceStatus": true,
      "linesTotal": 99988.4,
      "kdvTotal": 11.6,
      "allowanceTotal": 0,
      "payableTotal": 100000,
      "customer": {
        "taxNumber": "1976926558",
        "name": "ÖRNEK MÜŞTERİ"
      },
      "idNo": "1976926558"
    }
  ],
  "meta": {
    "requestId": "c6c85e42-dd06-4cb3-885b-c0ca551ee866",
    "timestamp": "2026-09-20T09:00:00.000Z",
    "page": 1,
    "limit": 25,
    "total": 114,
    "pages": 5
  }
}

`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 — belge bilgisi: type, uuid (ETTN), invoiceNumber, status
pdfUrl — faturanın PDF görüntüleme bağlantısı; belge kaynağı uygun değilse null
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

Fatura modelinde para birimi alanı tutulmaz; tutarlar kayıtlı haliyle döner.

pdfUrl doğrudan açılabilen bir görüntüleme bağlantısıdır; API’den ayrıca dosya indirmeniz gerekmez. Bağlantı yalnız detay ve fatura oluşturma cevaplarında döner, liste ucunda yer almaz.

Fatura oluşturma, gönderim ve taslak iptali için Fatura işlemleri sayfasına bakın. API üzerinden kesilen faturalar da bu uçlarda görünür.

Örnek istek

curl 'https://api.sarraf.pro/v1/invoices/6aae937b8d76c7a547248699' \
  -u 'apiUserId:secretKey'

Cevap — `200`

{
  "success": true,
  "data": {
    "id": "6aae937b8d76c7a547248699",
    "transactionDate": "2026-09-19T12:00:00.000Z",
    "invoiceNumber": "SAR2026000000123",
    "invoiceType": "earchive",
    "invoiceStatus": true,
    "linesTotal": 99988.4,
    "kdvTotal": 11.6,
    "allowanceTotal": 0,
    "payableTotal": 100000,
    "idNo": "1976926558",
    "customer": {
      "taxNumber": "1976926558",
      "name": "ÖRNEK MÜŞTERİ",
      "taxOffice": "BAHÇELİEVLER",
      "address": "ÖRNEK MAH. ÖRNEK SOK. NO:1",
      "district": "Bahçelievler",
      "city": "İstanbul",
      "country": "TÜRKİYE"
    },
    "invoiceInfo": {
      "type": "earchive",
      "uuid": "0075cc68-e90b-49c2-8434-0d5f779c72bf",
      "invoiceNumber": "SAR2026000000123",
      "status": true
    },
    "pdfUrl": "https://printer.sarraf.pro/PdfPreview?UUID=0075cc68-e90b-49c2-8434-0d5f779c72bf",
    "lines": [
      {
        "name": "GRAM SAF ALTIN",
        "quantity": 14.5,
        "unitType": "GRM",
        "stockCode": "GRALTIN",
        "price": 6891.75,
        "amount": 99930.4,
        "lineTotal": 99930.4,
        "kdvPercent": 0,
        "kdvTotal": 0,
        "allowancePrice": 0,
        "allowanceTotal": 0,
        "ozelMatrahTotal": 99930.4,
        "isExtra": false,
        "isDefault": true,
        "isLabor": false
      }
    ]
  },
  "meta": {
    "requestId": "c6c85e42-dd06-4cb3-885b-c0ca551ee866",
    "timestamp": "2026-09-20T09:00:00.000Z"
  }
}

Başlangıç

API'ye Giriş

Müşteriler

Banka

Giderler

KMTS

Faturalar

`GET /v1/invoices` — fatura listesi

Örnek istek

Sorgu parametreleri

Cevap alanları (liste öğesi)

Cevap — `200`

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

Örnek istek

Cevap — `200`

​GET /v1/invoices — fatura listesi

​Örnek istek

​Sorgu parametreleri

​Cevap alanları (liste öğesi)

​Cevap — 200

​GET /v1/invoices/{id} — fatura detayı

​Örnek istek

​Cevap — 200

`GET /v1/invoices` — fatura listesi

Örnek istek

Sorgu parametreleri

Cevap alanları (liste öğesi)

Cevap — `200`

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

Örnek istek

Cevap — `200`