Mali Belge

Kesilen e-Arşiv / e-Fatura / ÖKC fişinin numarasını ve bağlantısını siparişe bağlayın.

Paket ve online satışta mali belgeyi hizmeti ifa eden işletme düzenler; platform yalnız kendi komisyonu için fatura keser. Kasa sisteminiz belgeyi kestiğinde numarasını ve varsa bağlantısını PUT /orders/{id}/invoice ucuna besler. Uç restoran ve Çarşı işletmelerinde aynıdır.

Bu sayfadaki uçlar

Her satır API referansındaki tam tanıma gider — alanlar, yanıt kodları ve deneme konsolu orada.

PUT/orders/{id}/invoice

Bu uç belge üretmez

Yalnız sizin kestiğiniz belgenin bilgisini kaydeder. Belgeyi kesme, saklama ve mevzuata uygunluk sorumluluğu işletmededir; biz o bilgiyi sipariş kaydına bağlarız.

Bu ayrım hukuki, kozmetik değil. Uç "fatura kes" diye okunursa, kasa sistemi belgeyi hiç düzenlemeden siparişi kapatabilir ve ortada mali belgesi olmayan bir satış kalır.

Saklama süresi ve bağlantı erişilebilirliği

Beslediğiniz bağlantı belgenin saklama süresi boyunca erişilebilir kalmalıdır. Ticari defter ve belgeler için bu süre on yıldır (6102 sayılı TTK m.82). Belge sizde durur, biz kopyasını almayız; bağlantı kırılırsa müşteri ve platform belgeye ulaşamaz.

Bağlantı yazım anında yoklanır ve haftada bir yeniden denetlenir. Yanıt link.reachable alanını taşır; erişilemeyen bağlantı reddedilmez (belgeyi biz kaydettikten sonra yayınlıyor olabilirsiniz) ama warnings: ["invoice_url_unreachable"] ile bildirilir. Haftalık taramada kırık çıkan bağlantı için işletme yönetimine bildirim gider; bağlantıyı aynı uca yeniden göndererek yenileyebilirsiniz.

Yanıt

{
  "invoice": { "number": "GIB2026000000123", "url": "https://ornek-entegrator.example/belge/GIB2026000000123.pdf", "at": "2026-01-31T14:31:02.000Z" },
  "link": { "reachable": true, "httpStatus": 200, "checkedAt": "2026-01-31T14:31:03.000Z" }
}

Beslenen belge sipariş nesnesinde invoice alanı olarak döner (number, url, at). Yanıttaki link yalnız invoiceUrl gönderildiğinde bulunur.

Alanlar

Alan	Tip	Açıklama
`invoiceNumber`	string	Belgenin numarası (e-Arşiv / e-Fatura / ÖKC fiş no).
`invoiceUrl`	string (https)	`https://` zorunlu; belge saklama süresi boyunca erişilebilir kalmalı (fatura için on yıl, TTK m.82).

En az biri zorunludur; ikisi de yoksa 400 bad_request döner. İkisinin birlikte gönderilmesi önerilir: numara kayıt için, bağlantı müşteri için. Bağlantı https:// ile başlamalıdır.

Gövde

{
  "invoiceNumber": "GIB2026000000123",
  "invoiceUrl": "https://ornek-entegrator.example/belge/GIB2026000000123.pdf"
}

Tekrar gönderim ve silme

Tekrar gönderim son değeri yazar — yanlış numarayı düzeltmek için siparişi iptal etmeniz gerekmez. Bir alanı temizlemek için boş dize gönderin.

Bir alanı göndermemek ile boş dize göndermek farklı anlamlara gelir: gönderilmeyen alan korunur, boş dize alanı temizler. Bu ayrım olmadan yalnız bağlantıyı güncelleyen bir istek belge numarasını da silerdi.

Ne zaman çağırılır

Belgeyi kestiğiniz anda. Siparişin durumunu beklemeyin: müşteri belgeyi sipariş akışının herhangi bir noktasında görebilmeli, teslimden sonra değil.

Kapıda ödemeli siparişte belge çoğunlukla teslimde kesilir; online ödemede sipariş onaylanır onaylanmaz kesilebilir. İkisinde de kural aynıdır: belgeyi kestiğiniz anda besleyin.