Kurlar ve portföy değerleme

Tahsil Banka API, güncel kurları ve banka hesaplarının seçilen para birimindeki karşılığını tek tenant-safe sözleşmede sunar. Entegrasyonunuz yalnız Tahsil Core’u çağırır.

Güncel kurları okuma

GET /banks/market-rates için bank:read kapsamı gerekir.

curl --request GET \
  --url 'https://api.tahsil.dev/banks/market-rates?channel=piyasa&codes=USD,EUR,XAU' \
  --header 'x-api-key: tahsil_live_example' \
  --header 'x-api-secret: secret_example' \
  --header 'x-company-id: 66a000000000000000000001'

channel, piyasa veya tcmb olabilir. codes verilmezse kanaldaki güncel liste döner. Her kur alış, satış, kaynak zamanı, gözlem zamanı ve tazelik bilgisini taşır. Altın ve gümüş hesaplarında şu birim varsayımları açıkça döndürülür:

Hesap kodu	Kaynak kodu	Varsayım
`XAU`	`GRAM`	1 XAU = 1 gram altın
`GAU`	`GRAM`	1 GAU = 1 gram altın
`XAG`	`XAG`	1 XAG = 1 gram gümüş

Portföyü hedef para biriminde değerleme

GET /banks/portfolio/valuation, banka alt hesaplarındaki muhasebe balance değerini kullanır. Mevcut kullanılabilir bakiye alanını değiştirmez.

curl --request GET \
  --url 'https://api.tahsil.dev/banks/portfolio/valuation?channel=piyasa&quoteCurrency=TRY' \
  --header 'x-api-key: tahsil_live_example' \
  --header 'x-api-secret: secret_example' \
  --header 'x-company-id: 66a000000000000000000001'

TRY varsayılan hedeftir. availableQuoteCurrencies, seçili kanalda kullanabileceğiniz fiat hedefleri bildirir. Cevapta:

toplam karşılık ve kur zamanı,
varlık, firma, banka bağlantısı ve alt hesap kırılımı,
her hesap için özgün bakiye, çevrilmiş tutar ve kullanılan kur tarafı,
kapsanan hesap sayısı ve kapsama oranı,
eksik veya yedi günden eski kur nedeniyle hariç kalan hesaplar

bulunur. Pozitif varlıklar alış kuruyla değerlenir. Negatif bakiye, borcu olduğundan düşük göstermemek için ters kur tarafını kullanır. Eksik kurda toplam sessizce eksilmez; status: partial, warnings ve exclusions birlikte döner.

Hareket giriş kurunu okuma

GET /banks/transactions/{id}/valuation, özgün banka hareketini değiştirmeden giriş kuru durumunu ve bütün revizyonları döndürür.

Yeni hareketler için fetchedAt anını kapsayan 30 dakikalık Piyasa kuru kullanılır.
Özellik öncesi hareketler günlük geçmiş kurla değerlenebilir.
granularity, 30m, 1d veya manual değerini taşır.
origin, otomatik, backfill veya manuel kaynağı ayırır.
TRY hareketleri not_applicable döner.

Manuel giriş kuru revizyonu

PUT /banks/transactions/{id}/valuation, bank:operate kapsamı ve admin/operator rolü gerektirir.

curl --request PUT \
  --url 'https://api.tahsil.dev/banks/transactions/66b000000000000000000001/valuation' \
  --header 'content-type: application/json' \
  --header 'x-api-key: tahsil_live_example' \
  --header 'x-api-secret: secret_example' \
  --header 'x-company-id: 66a000000000000000000001' \
  --data '{"rate":42.375,"note":"Ay sonu kontrolünde düzeltildi"}'

Bu istek hareket tutarını veya para birimini güncellemez. Mevcut değerleme ezilmez; yeni append-only sürüm oluşur ve en yüksek sürüm güncel kabul edilir. Manuel sürüm otomasyon tarafından değiştirilmez.

Bu özellik kâr/zarar hesaplamaz. Saklanan giriş kuru ve kaynak zamanı, gelecekteki maliyet ve kâr/zarar hesaplarının temelidir.

Kur ve portföy değerleri bilgilendirme amaçlıdır. Yatırım tavsiyesi, gerçekleşebilir işlem fiyatı veya resmi muhasebe kuru garantisi değildir.

Hoş geldiniz

Başlangıç

Firma ve erişim

Banka bağlantıları

Banka hareketleri

Otomasyon

Operasyon

Kaynaklar

Güncel kurları okuma

Portföyü hedef para biriminde değerleme

Hareket giriş kurunu okuma

Manuel giriş kuru revizyonu

​Güncel kurları okuma

​Portföyü hedef para biriminde değerleme

​Hareket giriş kurunu okuma

​Manuel giriş kuru revizyonu

Güncel kurları okuma

Portföyü hedef para biriminde değerleme

Hareket giriş kurunu okuma

Manuel giriş kuru revizyonu