Banka hareketleri

Banka hareketleri, şirketin entegre banka hesaplarına düşen tüm gelen/giden işlemlerdir. Detay ucunda hareketin MASAK sorgu sonucu gömülü olarak döner.

`GET /v1/bank-transactions` — hareket listesi

Örnek istek

curl 'https://api.sarraf.pro/v1/bank-transactions?incoming=true&pageSize=25&sort=transactionDate:desc' \
  -u 'apiUserId:secretKey'

Sorgu parametreleri

Ortak parametreler için Genel Bakış.

Parametre	Tür	Açıklama
`incoming`	boolean	`true`: yalnız gelen, `false`: yalnız giden hareketler
`status`	integer	`0` bekleyen, `1` işlem yapıldı, `2` yok sayıldı
`masakStatus`	integer	`0` sorgulanmadı, `1` sorun yok, `2` sorunlu — sorunlu işlemler için `2` kullanın
`idNo`	string	Gönderici TCKN/VKN tam eşleşme
`currency`	string	Para birimi (büyük harfe normalize edilir)
`bankCode`	string	Banka kodu
`startDate` / `endDate`	date-time	`transactionDate` aralığı (dönem çekimi için)
`updatedSince`	date-time	Artımlı senkronizasyon

Sıralama whitelist’i: transactionDate, createdDate, updatedAt, amount. Varsayılan transactionDate:asc.

Cevap alanları (liste öğesi)

id, stamp (benzersiz işlem damgası), incoming, transactionDate, amount, currency, exchangeRate, balance (işlem sonrası bakiye), bankCode, code (EFT vb.), idNo, nameSurname, iban, description, status, masakStatus, fundsNature (işlemin mahiyeti), isCheck (mahsup/gider pusulası durumu), invoiceNumber, createdDate, updatedAt

Cevap — `200`

{
  "success": true,
  "data": [
    {
      "id": "6aaf616b1ae2463211cf050c",
      "stamp": "0012-2026-09-20-000481",
      "incoming": true,
      "transactionDate": "2026-09-20T08:31:00.000Z",
      "amount": 64050.93,
      "currency": "TRY",
      "exchangeRate": 1,
      "balance": 1284530.44,
      "bankCode": "0012",
      "idNo": "1976926558",
      "nameSurname": "ÖRNEK MÜŞTERİ",
      "iban": "TR000000000000000000000000",
      "description": "HAVALE",
      "status": 0,
      "masakStatus": 0,
      "isCheck": false,
      "invoiceNumber": null,
      "createdDate": "2026-09-20T08:32:10.000Z",
      "updatedAt": "2026-09-20T08:32:10.000Z"
    }
  ],
  "meta": {
    "requestId": "c6c85e42-dd06-4cb3-885b-c0ca551ee866",
    "timestamp": "2026-09-20T09:00:00.000Z",
    "page": 1,
    "limit": 25,
    "total": 114,
    "pages": 5
  }
}

`GET /v1/bank-transactions/{id}` — hareket detayı

Liste alanlarına ek olarak comment (sarraf notu), summaryInfo, expenseData ve invoiceInfo (type, uuid, invoiceNumber, status) döner; ayrıca gömülü masak bölümü bulunur.

Örnek istek

curl 'https://api.sarraf.pro/v1/bank-transactions/6aaf616b1ae2463211cf050c' \
  -u 'apiUserId:secretKey'

Gömülü `masak` bölümü

Hareketin göndericisine (idNo) ait en son MASAK/WANTED/PEP sorgu kaydı detay cevabına eklenir:

{
  "success": true,
  "data": {
    "id": "6a42a5a5afed5527f1074a31",
    "amount": 125000,
    "currency": "TRY",
    "idNo": "1976926558",
    "masakStatus": 1,
    "masak": {
      "status": 1,
      "lastQueriedAt": "2026-09-04T18:22:10.000Z",
      "types": ["masak"],
      "isError": false,
      "data": null
    }
  },
  "meta": { "requestId": "...", "timestamp": "..." }
}

Alan	Anlam
`masak.status`	`0` sorgulanmadı, `1` sorun yok, `2` sorunlu
`masak.lastQueriedAt`	En son sorgu zamanı; hiç sorgulanmadıysa `null`
`masak.types`	Çalıştırılan sorgu türleri (`masak`, `wanted`, `pep`)
`masak.isError`	Sorgu hata ile mi sonuçlandı
`masak.data`	Yaptırım listesi eşleşme içeriği (varsa)

Ayrı bir “masak durumu” ucu yoktur; liste ucunda masakStatus=2 ile sorunlu hareketleri çekebilir, detayda tam sorgu özetini okuyabilirsiniz. Tam sorgu geçmişi için Yaptırım sorguları kaynağına bakın.

Ham banka yükleri ve iç entegrasyon alanları (bankData, aiData, pusulaData vb.) hiçbir uçta dönmez.

Başlangıç

API'ye Giriş

Müşteriler

Banka

Faturalar

Giderler

KMTS

`GET /v1/bank-transactions` — hareket listesi

Örnek istek

Sorgu parametreleri

Cevap alanları (liste öğesi)

Cevap — `200`

`GET /v1/bank-transactions/{id}` — hareket detayı

Örnek istek

Gömülü `masak` bölümü

​GET /v1/bank-transactions — hareket listesi

​Örnek istek

​Sorgu parametreleri

​Cevap alanları (liste öğesi)

​Cevap — 200

​GET /v1/bank-transactions/{id} — hareket detayı

​Örnek istek

​Gömülü masak bölümü

`GET /v1/bank-transactions` — hareket listesi

Örnek istek

Sorgu parametreleri

Cevap alanları (liste öğesi)

Cevap — `200`

`GET /v1/bank-transactions/{id}` — hareket detayı

Örnek istek

Gömülü `masak` bölümü