İçeriğe geç
Entegrasyonlar & GİB

Paraşüt Cari Ekstre Gönderme: Otomatik Ekstre İçin API'de Ne Var?

Paraşüt'te cari ekstre arayüzde nasıl gönderilir, API'de hangi veri var, planlı e-posta ve WhatsApp gönderimi nasıl kurulur, KVKK'da nelere dikkat edilir.

Doğuhan BulutGüncellendi: 9 dk okuma

Paraşüt'te cari ekstre gönderme arayüzde nasıl yapılır?

Kılavuzdaki "Ekstre Gönder" penceresi; toplu ve takvime bağlı gönderim burada yok

Paraşüt'te cari ekstre, müşteri ya da tedarikçi kaydının sayfasındaki "Ekstre Gönder" düğmesiyle oluşturulup e-postayla gönderilir. Paraşüt'ün "Cari hesap ekstresi oluşturmak" kılavuzuna göre adımlar şöyledir:

  1. Müşteriler ya da Tedarikçiler sayfasından ilgili kaydı açın.
  2. "Ekstre Gönder" düğmesine basın.
  3. Fatura kalemlerinin ve fatura açıklamalarının ekstrede görünüp görünmeyeceğini seçin.
  4. Bir tarih aralığı belirleyin ya da "Tüm işlemler" ile devam edin.
  5. Alıcı adresini girin; birden fazla adres virgülle ayrılır. Metni düzenleyip gönderin.

Kılavuza göre ekstre iki biçimde ulaşır. Birincisi e-postaya eklenen PDF'tir: iki firmanın bilgileri, işlem dökümü, toplam alacak, borç ve bakiye ile oluşturma tarihi bu dosyada yer alır. İkincisi Müşteri Ekranı bağlantısıdır: müşteri işlem dökümünü ve fatura ayrıntılarını görür, ekstreyi PDF olarak indirir ve soru ya da yorum bırakabilir. Kılavuza göre bu yorumlar için size e-posta gönderilir; kılavuz bu alanı karşılıklı mutabakat için kullanmayı önerir.

Ayrıca Paraşüt'te "Ödeme Hatırlat" özelliği var. Kılavuza göre bu özellik açıldığında vadesi gelen faturalar için müşteriye otomatik hatırlatma e-postası gider; vade tarihi olmayan faturalar için e-posta gönderilmez.

Kılavuzda anlatılmayan tek şey, ekstrenin bir takvime bağlanmasıdır. "Her ayın birinde bakiyesi olan tüm carilere ekstre gönder" gibi toplu ve zamanlanmış bir gönderim kılavuzda yer almıyor. Bu ihtiyaç yoksa arayüz yeterlidir ve ek yazılım önermeyiz.

Paraşüt API'de cari ekstre için ne var, ne yok?

Paraşüt API'de ekstreyi PDF ya da e-posta olarak gönderen bir uç bulamadık, ama ekstrenin verisi okunabilir: 23 Ekim 2026 tarihli güncellemeyle carinin hesap hareketlerini yürüyen bakiyeyle döndüren bir uç (transaction_history_items) eklendi. Aşağıdaki tablo, Paraşüt'ün resmî API belgesindeki (API V4, OpenAPI tanımı) karşılıkları gösteriyor.

İhtiyaçAPI'de karşılığıNot
Cari bakiyeMüşteri kaydında bakiye alanları (TL, USD, EUR, GBP ayrı)Salt okunur
Açık faturalar ve vadelerSatış faturası listesi; cari, vade tarihi ve tahsilat durumuna göre süzmeÖdenmemiş tutar alanı var
Faturaya bağlı tahsilatlarFatura okunurken tahsilatlar ve işlemleri birlikte alınabilirTarih ve tutar gelir
Tedarikçi tarafıAlış faturası listesi; tedarikçiye ve vadeye göre süzmeBorç ekstresi için
Cari hesap hareketleriHesap ekstresi ucu: carinin borç ya da alacak tarafında yer aldığı işlemler, en yeniden en eskiye, her satırda yürüyen bakiyeyleTarih ya da işlem türü filtresi verilince yürüyen bakiye yeniden hesaplanmaz
Hazır ekstre PDF'i ya da ekstre e-postasıBulamadıkKurulumda teyit edilir
Değişiklik bildirimi (webhook)Cari ve satış faturası gibi kayıtlar için tanımlı; yalnızca paketi webhook içeren istemcilerdeTeslimat taahhüt edilmediği için zamanlanmış okuma yine gerekir

İki satır özellikle önemli. Birincisi, hesap ekstresi ucu. Belgeye göre bu uç carinin borç ya da alacak tarafında yer aldığı tüm işlemleri döner; faturaya bağlanmadan girilen tahsilat ve ödemelerin de bu listede göründüğü kurulumda örnek bir cariyle teyit edilir. Açılış bakiyesi kaydından eski satırlarda bakiye boş gelir. Tarih ya da işlem türü filtresi verildiğinde yürüyen bakiye yeniden hesaplanmaz, her satır güncel bakiyeyi tekrar eder; bu yüzden dönem ekstresinin devreden ve yürüyen bakiyesi sizin tarafınızda hesaplanır.

İkincisi, e-posta. Belgedeki e-posta paylaşım ucunun tanımında paylaşılacak kaynak türü olarak yalnızca teklifler sayılıyor. Bu nedenle ekstre e-postası, kendi e-posta altyapınızdan gönderilecek şekilde kurulur.

İstek sınırı API paketine bağlıdır; 2026 itibarıyla başvuruya açık Temel pakette 10 saniyede 10 istek ve ayda 25.000 istektir. Hesap ekstresi ucu sayfa başına en fazla 25 satır döndüğü için kırk carinin ekstresi cari başına birkaç sayfa okuma demektir; bu, dakikalar süren ve gece çalıştırılan bir iştir.

Ekstre verisi nasıl üretilir: fatura, tahsilat ve bakiye

Kapanış bakiyesi Paraşüt'ün bakiyesiyle tutmuyorsa ekstre gönderilmez

Cari ekstre, belirli bir tarih aralığında cariyle olan borç ve alacak hareketlerinin, devreden bakiyeyle başlayıp yürüyen bakiyeyle biten dökümüdür. API'den üretilen ekstrenin güvenilir olması için üç kural uygulanır.

Devreden bakiye hesaplanır, tahmin edilmez. Dönem başındaki bakiye, o tarihten önceki tüm hareketlerin toplamıdır. Her ay sıfırdan hesaplamak yerine kapanan ayın bakiyesi saklanır.

Bakiye karşılaştırması yapılır. Hesaplanan kapanış bakiyesi, Paraşüt'ün cari kaydındaki bakiyeyle aynı olmalıdır. Tutmuyorsa ekstre gönderilmez; fark bir kontrol listesine düşer. Bu tek kural, yanlış ekstre göndermenin önüne geçer.

Döviz ayrı tutulur. Paraşüt'te bakiyeler para birimine göre ayrı alanlarda tutulur. Döviz cinsinden çalışan carinin ekstresi TL'ye çevrilerek tek satıra indirgenmez; her para birimi kendi sütunuyla gösterilir.

Aşağıda örnek bir ekstre şablonu var. Kalem ve sütunlar işletmeye göre değişir.

TarihİşlemBorçAlacakBakiye
Dönem başıDevreden bakiyeDönem başı tutarı
Fatura tarihiSatış faturası, numara ve vadeFatura tutarıYürüyen bakiye
Tahsilat tarihiTahsilat, banka ya da kasaTahsilat tutarıYürüyen bakiye
Dönem sonuKapanış bakiyesiParaşüt bakiyesiyle aynı

Ekstrenin altına vadesi geçmiş faturaların ayrı bir listesi eklenir. Müşteri için en işe yarayan bilgi "toplam borcum" değil, "hangi fatura, kaç gündür açık" sorusunun cevabıdır.

Planlı gönderim: e-posta, takvim ve gönderim kaydı

Planlı ekstre gönderimi, belirli günlerde bakiyesi olan carilerin ekstresini hazırlayıp onların kayıtlı adreslerine gönderen zamanlanmış bir iştir. Tipik bir akış şöyle işler:

  1. Belirlenen gün gece, bakiyesi sıfırdan farklı cariler listelenir.
  2. Her cari için ekstre hesaplanır ve Paraşüt bakiyesiyle karşılaştırılır.
  3. Tutan ekstreler PDF'e çevrilir; tutmayanlar kontrol listesine düşer.
  4. Sabah, isteğe bağlı bir onay ekranında liste gözden geçirilir.
  5. Onaylanan ekstreler gönderilir; her gönderim kaydedilir.

Gönderim kaydı bu akışın en çok unutulan parçasıdır. Hangi cariye, hangi adrese, hangi dönemin ekstresi, ne zaman gitti, hata aldı mı; bunların hepsi bir tabloda tutulur. Müşteri "ekstre bana gelmedi" dediğinde cevap bu tablodadır.

Bu akış tek başına bir Paraşüt entegrasyonu olarak kurulabileceği gibi, tahsilat hatırlatma ve vade raporuyla birlikte daha geniş bir iş süreci otomasyonunun parçası da olabilir.

WhatsApp ile ekstre göndermek: Meta'nın kuralları

Otomatik WhatsApp ekstresi izin ve onaylı şablon olmadan gönderilemez

WhatsApp üzerinden otomatik ekstre göndermek, WhatsApp Business Platform'un kurallarına bağlıdır ve bu kurallar e-postadan daha sıkıdır. Meta'nın geliştirici belgelerinde öne çıkan şartlar şunlardır:

  • Önceden izin: İşletmenin, mesaj göndermeden önce kişiden izin alması gerekir. İzin metninde mesajı gönderecek işletmenin adı açıkça yazılmalıdır.
  • Şablon mesaj: Müşteri hizmeti penceresi dışında gönderilebilen tek mesaj türü, Meta'nın onayladığı şablon mesajdır. Şablonlar oluşturulduğunda incelenir; belgeye göre inceleme 24 saate kadar sürebilir.
  • Belge eklemek: Şablonun başlık bölümünde görsel, video ya da belge gösterilebilir. Ekstre PDF'i bu yolla şablona eklenebilir.
  • Kategori: Her şablon pazarlama, hizmet bildirimi (utility) ya da kimlik doğrulama kategorisine girer. Hizmet bildirimi şablonuna tanıtım içeriği eklenirse şablon otomatik olarak pazarlama kategorisine alınır.
  • Ücret: Meta, 1 Temmuz 2025'ten beri mesaj başına ücretlendirir; ücret mesaj kategorisine ve alıcının ülkesine göre değişir. Güncel tarife Meta'nın fiyat sayfasından kontrol edilir.
  • Gönderim limiti: Meta'nın belgesine göre yeni oluşturulan işletme portföyleri, müşteri hizmeti penceresi dışında kayan 24 saatte 250 farklı numaraya ulaşabilir; limit portföydeki tüm numaralarca paylaşılır. İşletme doğrulaması, limitin 2.000'e çıkarılması için sayılan yollardan biridir.

Türk mevzuatı tarafında da bir ayrıntı var. Ticari İletişim ve Ticari Elektronik İletiler Hakkında Yönetmelik'in 6. maddesine göre tahsilat ve borç hatırlatma gibi bildirimleri içeren iletiler için önceden onay alma zorunluluğu aranmaz, ama bu bildirimlerde herhangi bir mal ya da hizmet özendirilemez ya da tanıtılamaz. Bu istisna Türk mevzuatına aittir; Meta'nın opt-in şartını ortadan kaldırmaz. Ekstre mesajına kampanya duyurusu eklemek hem bu kuralı hem de Meta'nın kategori kuralını bozar.

KVKK açısından ekstre içeriği

Cari ekstre, alıcı gerçek kişi olduğunda kişisel veri içerir. Şahıs firması, serbest meslek sahibi ya da bireysel müşteriye giden ekstrede ad, borç tutarı ve satın alınan hizmetin kalemleri yer alır. Tüzel kişi carilerde bile ekstreyi alan yetkilinin adı, e-postası ve telefonu kişisel veridir.

Otomasyon tasarlanırken şu kontroller baştan yazılır:

  • Doğru alıcı: Ekstre yalnızca carinin kayıtlı ve doğrulanmış adresine ya da numarasına gider. Yanlış kişiye giden bir ekstre, başka birinin borç bilgisini paylaşmak demektir.
  • En az veri: Paraşüt'ün arayüzünde olduğu gibi, fatura kalemlerinin ekstrede görünüp görünmeyeceği seçilebilir olmalıdır. Kalem ayrıntısı gerekmiyorsa gönderilmez.
  • Süreli bağlantı: PDF yerine bağlantı gönderiliyorsa bağlantı süreli ve tahmin edilemez olur.
  • Kayıt ve silme: Gönderim kayıtları ve üretilen PDF'lerin ne kadar saklanacağı yazılı olarak belirlenir.
  • Yurt dışı hizmet sağlayıcı: E-posta ya da mesajlaşma hizmeti yurt dışındaki bir sağlayıcı üzerinden çalışıyorsa bunun yurt dışına aktarım sayılıp sayılmadığı değerlendirilir. KVKK'nın 9. maddesi 2024'te 7499 sayılı Kanun'la değişti; hangi güvencenin uygulanacağı hukuk danışmanınızla belirlenir.

Bu başlık bilgi amaçlıdır. Aydınlatma metni ve aktarım kararı işletmenin veri sorumlusu sıfatıyla vereceği kararlardır.

Sıkça Sorulan Sorular

Paraşüt'te müşteri ekstresi nasıl gönderilir?

Müşteri kaydını açıp "Ekstre Gönder" düğmesine basarsınız. Fatura kalemlerinin görünüp görünmeyeceğini ve tarih aralığını seçer, alıcı adresini girip gönderirsiniz. Ekstre e-postaya PDF olarak eklenir ve müşteri kendi Müşteri Ekranı'ndan da görüntüleyebilir.

Paraşüt cari ekstreyi kendiliğinden, her ay gönderebilir mi?

Paraşüt'ün ekstre kılavuzunda zamanlanmış ya da toplu ekstre gönderimi anlatılmıyor. Kılavuzda anlatılan otomatik özellik, vadesi gelen faturalar için müşteriye giden "Ödeme Hatırlat" e-postasıdır. Takvime bağlı toplu ekstre için API ile ek bir katman kurulur.

Paraşüt API'de cari ekstre ucu var mı?

Ekstreyi PDF ya da e-posta olarak hazırlayıp gönderen bir uç bulamadık; kurulumda teyit edilir. Ancak 23 Ekim 2026 tarihli API güncellemesiyle carinin hesap hareketlerini yürüyen bakiyeyle döndüren bir uç eklendi. Ekstrenin verisi bu uçtan okunur; belge biçimi, bakiye kontrolü ve gönderim sizin tarafınızda hazırlanır.

Ekstreyi WhatsApp'tan otomatik gönderebilir miyiz?

Gönderilebilir, ama WhatsApp Business Platform üzerinden ve Meta'nın kurallarıyla. Alıcıdan önceden izin alınması, pencere dışında onaylı şablon kullanılması ve hesabın gönderim limitine uyulması gerekir. Mesaja tanıtım içeriği eklenmemelidir. Meta'nın iş politikası borç tahsilatını kısıtlı alanlar arasında saydığı için ekstreyi vadesi geçmiş alacak hatırlatmasına dönüştürmeden önce hesap sağlayıcınızdan yazılı teyit alın.

Ekstre gönderirken KVKK açısından en büyük risk nedir?

En sık risk, ekstrenin yanlış kişiye gitmesidir; bu, başka birinin borç bilgisini paylaşmak anlamına gelir. Bu yüzden alıcı adresleri doğrulanır, gereksiz kalem ayrıntısı gönderilmez ve her gönderim kaydedilir. Hukuki değerlendirme için veri sorumlusu olarak hukuk danışmanınızla çalışın.

Ekstre gönderimini birlikte kurgulayalım

Cari sayınız azsa ve ayda bir elle göndermek size yetiyorsa Paraşüt'ün "Ekstre Gönder" düğmesi ve "Ödeme Hatırlat" özelliği yeterlidir. Toplu ve takvime bağlı gönderim, bakiye kontrolü, WhatsApp kanalı ya da gönderim kaydı istiyorsanız akışı birlikte tasarlayabiliriz.

İlk adım ücretsiz online keşif görüşmesi: kaç cari, hangi kanal, hangi kontroller. Ardından sabit fiyatlı ve kapsamı yazılı bir teklif veririz; teslim sonrası 15 gün ücretsiz hata düzeltme standart maddedir. Görüşme için iletişime geçin; isterseniz WhatsApp'tan da yazabilirsiniz.

YAZAR

Doğuhan Bulut

Kurucu & CTO

Muhasebe/ERP entegrasyonları, otomasyon ve web mimarisi. 10+ yıl yazılım geliştirme deneyimi.

SIRADAKİ ADIM

Programınızı değiştirmeden bağlayalım

Logo, Netsis, Mikro, SAP veya başka bir program: mevcut sisteminiz yerinde kalır, eksik ekranı, raporu veya aktarımı üstüne kurarız. 30 dk ücretsiz online keşif.

Ücretsiz online keşif

İlgili Yazılar

Entegrasyonlar & GİB

Banka Ekstresi Muhasebeye Aktarma: Dosya Yolu ve Eşleştirme Kuralları

Banka hareketlerini muhasebe programına aktarmanın dört yolu, kural tablosuyla cari eşleştirme, eşleşmeyenlerin onayı ve banka portalında neden robot önermediğimiz.

18 Ekim 20269 dk
Entegrasyonlar & GİB

Luca Excel Fiş Aktarımı: Şablon Hazırlığı, Sık Hatalar ve Otomasyon

Luca'ya Excel'den fiş aktarmadan önce şablon nasıl hazırlanır, hangi hatalar en sık çıkar, neye bakılır? Kaynak dosyayı Luca şablonuna çeviren ara katmanın sınırlarıyla.

16 Ekim 202610 dk
Entegrasyonlar & GİB

SAP Business One Service Layer: Okuma, Yazma ve Oturum Yönetimi

SAP'nin resmî Service Layer kılavuzuna dayanan SAP B1 entegrasyon rehberi: Login ve oturum ömrü, salt okunur SQL Query, nesne arayüzüyle yazma, ETag, değişiklik kümeleri ve FP 2602 webhook desteği.

11 Ekim 202610 dk