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

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

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 cari ekstre için hazır bir uç yoktur, ama ekstreyi üretmeye yetecek verinin büyük kısmı okunabilir. Aşağıdaki tablo, Paraşüt'ün resmî API belgesindeki (API V4, OpenAPI tanımı) karşılıkları gösteriyor.

İki satır özellikle önemli. Birincisi, faturaya bağlanmadan girilmiş tahsilat ve ödemeler. Belgede cariye tahsilat ve ödeme kaydetmek için uçlar var, ama bu hareketleri cari bazında listeleyen bir uç bulamadık. Bu hareketler ekstrede görünmezse hesapladığınız bakiye Paraşüt'teki bakiyeyle tutmaz. Kurulumda bu hareketlerin hangi yoldan okunacağı Paraşüt'le teyit edilir.

İ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.

Belge ayrıca 10 saniyede 10 istek sınırını yayımlar. Kırk carinin ekstresi için cari başına birkaç sayfa fatura ve tahsilat okumak gerekir; bu, dakikalar süren ve gece çalıştırılan bir iştir.

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

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.

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ı

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ı?

Resmî API belgesinde hazır bir ekstre ucu bulamadık; kurulumda teyit edilir. Cari bakiyesi, faturalar, vadeler ve faturaya bağlı tahsilatlar okunabildiği için ekstre bu verilerden hesaplanır. Faturaya bağlı olmayan cari hareketlerinin hangi yoldan okunacağı ayrıca netleştirilir.

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.

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.