Finans

Kataloğun bir parçası. Aynı anahtar, zarf ve faturalandırma diğer tüm uçları da kapsar.

RF Alacaklı Referansı · EPC QR Yükü · TR IBAN Oluştur · e-Fatura Belgesi Üretici · e-Fatura (UBL-TR) Ayrıştırma · Tutarı Türkçe Yazıya Çevirme · Türk FAST / TR Karekod Yükü

Bu sayfadaki her ucu hesap açmadan deneyebilirsiniz.
Deterministik uçlar önbellekten tek haneli milisaniyede yanıtlar.
Her yanıt bir fiş taşır: harcanan kredi, önbellek durumu, süre.

Bu sayfada ücretsiz dene → anahtar gerektiğinde Ödemeye geç · API erişimi.

Ücretsiz dene Ödemeye geç · API erişimi Şemayı oku

POST/v1/finance/creditor-ref

İstek

{
  "reference": "RF18 5390 0754 7034"
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

7uç nokta

—biriken veri noktası

—zaman serisi

—ortanca yanıt

Neden var

Düşman girdi için tasarlandı

Türkçe adres "Cd." de olur "Cad." da "Caddesi" de; daire numarası bina numarasına yapışık gelir. Genel ayrıştırıcılar yarısını sessizce düşürür. Bu, yerleştiremediğini size söyler.

Her sayı kaynağını taşır

Arşivlenen her nokta, geldiği sayfanın kaynak URL’i ve içerik özetiyle saklanır; arşiv Merkle köküyle Bitcoin’e çıpalanır. Her taahhüt — kesim anı, yaprak sayısı ve çıpalarıyla — /proof adresinde yayımlanır, yani sonuncusunun ne kadar güncel olduğunu kendiniz görebilirsiniz. Bültenlerin kendisi herkese açık, isteyen okur; bunun eklediği şey, alıntıladığınız sayının o tarihte elimizde olan sayı olduğunun ve sonradan değiştirilmediğinin gösterilebilmesi.

Yalnız yapılan işe ödersiniz

Tekrarlanan girdi önbellekten gelir, sıfır kredi yakar. Bir yanıt kendi şemasına uymazsa çağrı otomatik iade edilir.

Uç noktalarparametreleri görmek ve canlı çağırmak için satırı açın

Finans7

/v1/finance/creditor-ref RF Alacaklı Referansı deterministik 1 kredi

ISO 11649 RF alacaklı referansını doğrular veya üretir (mod-97 sağlama).

SEPA havalesinde RF alacaklı referansı ödeme zincirinde açıklamayı korur. Sağlama IBAN ile aynı ISO 7064 mod-97'dir: RF ve iki hane sona alınır, harfler 10–35 olur, kalan 1 olmalıdır. Girdi RF ve iki hane ile başlıyorsa doğrulanır; değilse 1–21 alfasayısal yük kodlanır. Bozuk sağlama 400 ile reddedilir — tutarsız referans ödeme dosyasına yazılmaz.

Parametreler

reference*

string

ISO 11649 RF creditor reference, or a 1–21 character payload to encode.

POST/v1/finance/creditor-ref

İstek

{
  "reference": "RF18 5390 0754 7034"
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

/v1/pay/epc-qr EPC QR Yükü deterministik 1 kredi

EPC069-12 v3.1 V2 (002) SCT yükü üretir. Para göndermez; yalnız metin döner, PNG yok.

Avrupa ödemelerinde QR, EPC069-12 havale yükünü taşır. Bu uç metni sürüm 002 (V2) ile kurar: BCD, UTF-8, SCT, isteğe bağlı BIC, ad, elektronik IBAN, EUR tutar. Purpose ve yapılandırılmış açıklama boş bırakılır; serbest açıklama varsa kopyalanır. Satırlar LF'dir, CRLF değil. IBAN boşlukları atılır ve büyük harfe çevrilir; mod-97 bu uçta zorunlu değildir. TRY, USD ve EUR dışı birimler reddedilir. Para göndermez ve QR görüntüsü üretmez.

Parametreler

name*	string	Beneficiary name (SCT Name).
iban*	string	Beneficiary IBAN, with or without spaces.
amountEur*	number	Transfer amount in EUR (positive).
remittance	string	Unstructured remittance (e.g. invoice number).
bic	string	Beneficiary BIC; optional in V2 (002).
currency	string	Must be EUR if provided. Other currencies are rejected.

POST/v1/pay/epc-qr

İstek

{
  "name": "Franz Mustermänn",
  "iban": "DE71110220330123456789",
  "amountEur": 12.3,
  "remittance": "RF18539007547034"
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

/v1/tr/iban/build TR IBAN Oluştur deterministik 1 kredi

5 haneli banka kodu ve hesap numarasından TR IBAN oluşturur; ISO 7064 sağlama hanelerini hesaplar.

TR IBAN: TR + 2 sağlama + 5 haneli banka kodu + 1 rezerv hane + 16 karakter hesap. Hesap soldan doldurulur, rezerv varsayılan 0’dır, mod-97 sağlama hesaplanır; bilinen kodlarda banka adı IBAN doğrulama ile aynı ulusal tablodan gelir. Bilinmeyen kodda yapı geçerli IBAN üretilir, bankName null kalır — bankada varlık iddia edilmez.

Parametreler

bankCode*	string	5-digit Turkish national bank / EFT code (e.g. 00062).
accountNumber*	string	Account number, up to 16 alphanumeric characters (padded left with zeros).
reserved	string	Reserved BBAN digit after the bank code. Defaults to 0.

POST/v1/tr/iban/build

İstek

{
  "bankCode": "00062",
  "accountNumber": "0000005197864578"
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

/v1/tr/invoice/build e-Fatura Belgesi Üretici 3 kredi

Düz JSON’dan UBL-TR e-Fatura / e-Arşiv XML belgesi üretir; tüm toplamları kendisi hesaplar, tarafları doğrular.

Türkiye’ye fatura kesmek, öğe sırası şemayla sabitlenmiş ve toplamları kuruşu kuruşuna tutması gereken bir UBL-TR belgesi üretmek demek; tutmazsa entegratör geri çevirir. Bu uç faturayı sıradan JSON olarak alır, XML döndürür. Gönderdiğiniz toplamlara bilerek bakılmaz: kalem tutarları, orana göre KDV alt toplamları ve ödenecek tutar burada yeniden hesaplanır — bir kuruşluk yuvarlama farkı en sık ret sebebidir. VKN/TCKN sağlamaları doğrulanır, tutar faturaların istediği gibi Türkçe yazıyla yazılır. Belge İMZALANMAZ ve GİB’e GÖNDERİLMEZ: mali mühür sizin sertifikanızın, gönderim entegratörünüzün işidir. Dönen belge o adıma girmeye hazır hâldedir.

Parametreler

profile	"TEMELFATURA" \| "TICARIFATURA" \| "EARSIVFATURA"	TEMELFATURA: no formal objection flow. TICARIFATURA: buyer may accept/reject. EARSIVFATURA: buyer is not an e-Invoice user. varsayılan "TEMELFATURA"
invoiceTypeCode	"SATIS" \| "IADE"	varsayılan "SATIS"
id	string	Invoice number. Omit and supply `series` to have it built from the series and sequence.
series	string	Three-letter series code, used with `sequence`.
sequence	integer	Sequence number within the series and year.
uuid	string	Document UUID (ETTN). Generated when omitted.
issueDate*	string
issueTime	string
currency	string	ISO 4217. Anything other than TRY requires `exchangeRate`. varsayılan "TRY"
exchangeRate	number	Units of TRY per one unit of `currency`.
supplier*	object
customer*	object
lines*	object[]
notes	string[]	varsayılan []
amountInWords	boolean	Adds the payable amount written out in Turkish words as a note, the way invoices require. varsayılan true
despatchDocumentId	string	Delivery note number, if the goods shipped separately.
orderReferenceId	string

POST/v1/tr/invoice/build

İstek

{
  "series": "ABC",
  "sequence": 123,
  "issueDate": "2026-07-26",
  "supplier": {
    "name": "Örnek Yazılım A.Ş.",
    "taxNumber": "4840847211",
    "taxOffice": "Kadıköy",
    "street": "Moda Cad.",
    "buildingNumber": "12",
    "district": "Kadıköy",
    "city": "İstanbul"
  },
  "customer": {
    "name": "Alıcı Ticaret Ltd. Şti.",
    "taxNumber": "3250566341",
    "taxOffice": "Beşiktaş",
    "city": "İstanbul"
  },
  "lines": [
    {
      "name": "Yazılım geliştirme hizmeti",
      "quantity": 10,
      "unitCode": "HUR",
      "unitPrice": 1500,
      "vatRate": 20
    }
  ]
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

/v1/tr/invoice/parse e-Fatura (UBL-TR) Ayrıştırma deterministik 3 kredi

UBL-TR e-Fatura/e-Arşiv XML belgesini kalem, taraf, vergi ve toplam bilgileriyle temiz JSON'a çevirir.

Ad alanı öneki (cbc:, cac:, ns0:) ne olursa olsun çalışır; tek kalemli belgelerde dizi normalleştirmesi yapar, tutar tutarsızlıklarını `warnings` ile bildirir. Muhasebe, ön muhasebe ve gider yönetimi yazılımlarının en çok vakit kaybettiği iş.

Parametreler

xml*

string

UBL-TR e-Invoice / e-Archive (e-Arsiv) XML body.

POST/v1/tr/invoice/parse

İstek

{
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\"\n         xmlns:cbc=\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\"\n         xmlns:cac=\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\">\n  <cbc:UBLVersionID>2.1</cbc:UBLVersionID>\n  <cbc:ProfileID>TEMELFATURA</cbc:ProfileID>\n  <cbc:ID>ABC2026000000123</cbc:ID>\n  <cbc:UUID>3f2504e0-4f89-11d3-9a0c-0305e82c3301</cbc:UUID>\n  <cbc:IssueDate>2026-07-20</cbc:IssueDate>\n  <cbc:InvoiceTypeCode>SATIS</cbc:InvoiceTypeCode>\n  <cbc:DocumentCurrencyCode>TRY</cbc:DocumentCurrencyCode>\n  <cac:AccountingSupplierParty><cac:Party>\n    <cac:PartyIdentification><cbc:ID schemeID=\"VKN\">1234567890</cbc:ID></cac:PartyIdentification>\n    <cac:PartyName><cbc:Name>Örnek Yazılım A.Ş.</cbc:Name></cac:PartyName>\n    <cac:PostalAddress><cbc:StreetName>Moda Cad.</cbc:StreetName><cbc:BuildingNumber>12</cbc:BuildingNumber>\n      <cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName><cbc:CityName>İstanbul</cbc:CityName></cac:PostalAddress>\n    <cac:PartyTaxScheme><cac:TaxScheme><cbc:Name>Kadıköy</cbc:Name></cac:TaxScheme></cac:PartyTaxScheme>\n  </cac:Party></cac:AccountingSupplierParty>\n  <cac:AccountingCustomerParty><cac:Party>\n    <cac:PartyIdentification><cbc:ID schemeID=\"VKN\">9876543210</cbc:ID></cac:PartyIdentification>\n    <cac:PartyName><cbc:Name>Alıcı Ticaret Ltd. Şti.</cbc:Name></cac:PartyName>\n  </cac:Party></cac:AccountingCustomerParty>\n  <cac:TaxTotal><cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount>\n    <cac:TaxSubtotal><cbc:TaxableAmount currencyID=\"TRY\">1000.00</cbc:TaxableAmount>\n      <cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount><cbc:Percent>20</cbc:Percent>\n      <cac:TaxCategory><cac:TaxScheme><cbc:Name>KDV</cbc:Name><cbc:TaxTypeCode>0015</cbc:TaxTypeCode></cac:TaxScheme></cac:TaxCategory>\n    </cac:TaxSubtotal></cac:TaxTotal>\n  <cac:LegalMonetaryTotal>\n    <cbc:LineExtensionAmount currencyID=\"TRY\">1000.00</cbc:LineExtensionAmount>\n    <cbc:TaxExclusiveAmount currencyID=\"TRY\">1000.00</cbc:TaxExclusiveAmount>\n    <cbc:TaxInclusiveAmount currencyID=\"TRY\">1200.00</cbc:TaxInclusiveAmount>\n    <cbc:PayableAmount currencyID=\"TRY\">1200.00</cbc:PayableAmount>\n  </cac:LegalMonetaryTotal>\n  <cac:InvoiceLine>\n    <cbc:ID>1</cbc:ID>\n    <cbc:InvoicedQuantity unitCode=\"C62\">10</cbc:InvoicedQuantity>\n    <cbc:LineExtensionAmount currencyID=\"TRY\">1000.00</cbc:LineExtensionAmount>\n    <cac:TaxTotal><cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount>\n      <cac:TaxSubtotal><cbc:TaxableAmount currencyID=\"TRY\">1000.00</cbc:TaxableAmount>\n        <cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount><cbc:Percent>20</cbc:Percent>\n        <cac:TaxCategory><cac:TaxScheme><cbc:Name>KDV</cbc:Name><cbc:TaxTypeCode>0015</cbc:TaxTypeCode></cac:TaxScheme></cac:TaxCategory>\n      </cac:TaxSubtotal></cac:TaxTotal>\n    <cac:Item><cbc:Name>Yıllık Lisans</cbc:Name></cac:Item>\n    <cac:Price><cbc:PriceAmount currencyID=\"TRY\">100.00</cbc:PriceAmount></cac:Price>\n  </cac:InvoiceLine>\n</Invoice>"
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

/v1/tr/money/to-words Tutarı Türkçe Yazıya Çevirme deterministik 1 kredi

Para tutarını fatura/çek/senet metinlerinde kullanılan Türkçe yazıya çevirir.

Türkçeye özgü kuralları uygular: "bir bin" değil "bin"; kuruş kısmı ayrı okunur; "1.234,56" ile "1,234.56" yazımlarını otomatik ayırt eder. e-Fatura, çek ve senet üreten her sistemin zorunlu alanı — ve hazır bir API'si yok.

Parametreler

amount*	string \| number	Amount. Accepts both "1.234,56" and 1234.56.
currency	"TRY" \| "USD" \| "EUR" \| "GBP"	varsayılan "TRY"
style	"lower" \| "title" \| "upper"	Output letter case. varsayılan "lower"
wrapHash	boolean	varsayılan false

POST/v1/tr/money/to-words

İstek

{
  "amount": "1.234,56"
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

/v1/tr/pay/qr Türk FAST / TR Karekod Yükü deterministik 1 kredi

IBAN, ad ve isteğe bağlı TRY tutardan kişiden kişiye TR Karekod (FAST) ödeme yükü üretir. Yalnız metin — PNG yok.

FAST ödemeleri, alıcı IBAN ve adını EMV tarzı TLV ile taşıyan TR Karekod ile başlayabilir. Bu uç kişiden kişiye düzeni (biçim göstergesi 750210) kurar: IBAN’lı uygulama şablonu, alıcı adı, isteğe bağlı 12 haneli kuruş tutarı, serbest açıklama ve CRC-16/CCITT-FALSE. TR IBAN normalize edilip ISO 7064 mod-97 ile denetlenir; TR dışı IBAN ve TRY dışı para birimi reddedilir. Para göndermez ve QR görüntüsü üretmez.

Parametreler

iban*	string	Beneficiary Turkish IBAN (with or without spaces).
name*	string	Payee name shown to the payer (2–26 chars after trim).
amount	number	TRY amount; omitted → static QR (payer enters amount).
explanation	string	Optional remittance note (application free field 10).
currency	string	Must be TRY if provided.
generatorCode	string	QR generator / EFT code (4 digits). Defaults to last 4 of the IBAN bank code.

POST/v1/tr/pay/qr

İstek

{
  "iban": "TR33 0006 1005 1978 6457 8413 26",
  "name": "Ali Yilmaz"
}

henüz istek gönderilmedi

Yanıt

Çalıştır’a bas — ücretsiz dene, anahtar gerekmez.

Fiyatlandırmatek anahtar tüm uçları kapsar

Bu sayfada ücretsiz dene → anahtar gerektiğinde Ödemeye geç · API erişimi.

Ödemeye geç · API erişimi Tüm planlar →

Kredi çağrı başına düşer, önbellekten gelen yanıt ücretsizdir. Anahtarsız istekler IP başına dar bir demo kotasıyla çalışır; kaydolmadan değerlendirebilirsiniz.

API anahtarı ödeme onaylanır onaylanmaz e-postayla gelir. Plan yükseltmede anahtar DEĞİŞMEZ, entegrasyonunuz kırılmaz.

Ödemeden önce entegrasyonu bitirmek ister misiniz?

Yapay zekâ asistanından kullanaynı katalog, MCP aracı olarak

Her uç aynı zamanda Model Context Protocol üzerinden yayınlanıyor; Claude, ChatGPT ya da kendi ajanınız doğrudan çağırabilir — ara kod yok, sarmalayıcı fonksiyon yok. Asistan aynı girdi şemalarını ve aynı ölçümü görür.

Şu an 68 araç. Yeni uçlar kendiliğinden görünür; sizin tarafınızda güncellenecek bir şey yok.

claude_desktop_config.json

{
  "mcpServers": {
    "temsor": {
      "url": "https://api.temsor.com/mcp",
      "headers": { "x-api-key": "fk_live_…" }
    }
  }
}

Hızlı başlangıç

Resmî istemci: npm install temsor-api · npmjs.com/package/temsor-api

Node.js

import Client from "temsor-api";

const api = new Client({ apiKey: KEY });
const r = await api.${(() => {
  const first = apis[0];
  return first.slug.split(/[/-]/).map((p, i) => (i === 0 ? p : p[0].toUpperCase() + p.slice(1))).join('');
})()}(${esc(JSON.stringify(apis[0].examples[0]?.input ?? {}))});
console.log(r, r.$meta);

cURL

curl -s https://api.temsor.com/v1/finance/creditor-ref \
  -H "content-type: application/json" \
  -H "x-api-key: fk_live_…" \
  -d '{"reference":"RF18 5390 0754 7034"}'

JavaScript

const res = await fetch("https://api.temsor.com/v1/finance/creditor-ref", {
  method: "POST",
  headers: { "content-type": "application/json", "x-api-key": KEY },
  body: JSON.stringify({"reference":"RF18 5390 0754 7034"})
});
const { data } = await res.json();

Python

import httpx
r = httpx.post("https://api.temsor.com/v1/finance/creditor-ref",
    headers={"x-api-key": KEY},
    json={"reference":"RF18 5390 0754 7034"})
data = r.json()["data"]