Çoğu kişi muhasebe entegrasyonunu şöyle sanır: bir düğme vardır, ona basarsın, satışların muhasebe programına akar, iş biter. Gerçekte olan şey bambaşkadır. Dijital ürün satışında bir sipariş tek bir kayıt değildir; ödeme geçidinin komisyonu, iade edilen bakiye, kupon indirimi, bayi cari hareketi ve stok maliyeti birbirinden bağımsız beş farklı muhasebe olayıdır. Bunları tek satır halinde aktarmaya çalıştığın gün, ay sonunda mizanın tutmaz ve suçu yazılıma atarsın.
Ben sana entegrasyonun süslü tarafını değil, kırıldığı yeri anlatacağım. Çünkü bu işi düzgün kurmuş bir işletme ile kurmamış bir işletme arasındaki fark, ay sonu kapanışında ortaya çıkar: biri 20 dakikada mutabakatı bitirir, diğeri üç gün boyunca Excel'de satır arar. Doğru kurgulanmış bir e-pin satış scripti, muhasebeye veri göndermez; muhasebenin anlayacağı dilde olay üretir. Aradaki fark, bu yazının tamamı.
Neden Satış Adedin Tutuyor da Cirona Kimse İnanmıyor?
Panelinde 1.240 sipariş görüyorsun, muhasebeci 1.198 fatura kesmiş, banka ekstresinde üçüncü bir rakam var. Bu üçlü uyumsuzluk neredeyse her zaman aynı sebepten doğar: brüt satış ile tahsil edilen tutarın aynı kalem sanılması. Müşteri 500 TL öder, ödeme kuruluşu 12,50 TL komisyon keser, sana 487,50 TL geçer. Eğer dijital ürün satış yazılımın muhasebeye 487,50 TL gönderiyorsa ciron eksik, gider kalemin yok demektir. Doğrusu, satışı 500 TL olarak gelir yazıp komisyonu ayrı bir gider fişi olarak geçmektir. Bu tek kural bile ay sonu farkının yarısını bitirir.
Muhasebe Programına Hangi An Veri Gitmeli?
Sipariş oluştuğu an değil. Dijital üründe sipariş oluşur, ödeme beklenir, kod teslim edilir; bu üç aşama arasında iptal, iade ve stok yetmezliği gibi senaryolar vardır. Muhasebeye kayıt üretmesi gereken tek an teslimatın tamamlandığı ve ödemenin kesinleştiği andır. Bir epin yazılım kurgusunda buna "muhasebe tetikleyici durumu" denir ve tek bir sipariş statüsüne bağlanır. Ara statülerde kayıt atarsan, iptal olan her sipariş için muhasebede ters kayıt kovalamak zorunda kalırsın. Pinova tarafında bu mantık, sipariş durumu kesinleşmeden dış sisteme hiçbir belge göndermeyecek şekilde kurulur; aktarım kuyruğu bekler, statü kesinleşince akar.
Popüler Muhasebe Programları Aynı Dili mi Konuşuyor?
Hayır ve bu, entegrasyon maliyetini belirleyen asıl faktör. Bulut tabanlı programlar genelde REST API ile çalışır, token alırsın, JSON gönderirsin. Kurumsal ERP tarafında ise çoğu zaman ara veritabanı tabloları, XML dosya klasörleri veya web servis katmanları devrededir. Bir e-pin satış scripti seçerken sorman gereken soru "muhasebe entegrasyonu var mı" değil, "benim kullandığım programın kabul ettiği formatta çıktı üretebiliyor mu" olmalı. Aşağıdaki tablo, sahada en sık karşılaştığın yöntemleri ve kırılma noktalarını gösteriyor.
| Bağlantı Yöntemi | Tipik Kullanım | Kurulum Süresi | Kırılma Riski | Uygun İşletme |
|---|---|---|---|---|
| REST API (token) | Bulut ön muhasebe | 1-2 gün | Düşük | Aylık 500-5.000 sipariş |
| Web servis (SOAP) | Kurumsal ERP | 3-7 gün | Orta | Bayi ağı olanlar |
| Ara tablo / veritabanı | Yerel kurulum programlar | 2-5 gün | Orta-yüksek | Sunucusu kendinde olanlar |
| XML / CSV klasör aktarımı | Eski sürüm programlar | 1 gün | Yüksek | Düşük hacimli satıcı |
| Manuel dışa aktarma | Geçici çözüm | Anlık | Çok yüksek | Başlangıç aşaması |
Bayi Carisi Neden Ayrı Bir Dünya?
E-pin işinde bayi, normal müşteri değildir. Bakiye yükler, kredili çalışır, ay sonunda ekstre ister. Bu yüzden bayinin her bakiye yüklemesi bir tahsilat, her alışverişi ise cari hesaptan düşüm anlamına gelir. Eğer dijital ürün satış yazılımın bayi bakiyesini sadece kendi içinde bir sayı olarak tutuyorsa, muhasebede bu para hiç görünmez; sen de vergi dairesine "kasada olmayan para"yı açıklamaya çalışırsın. Bakiye bir borç hesabıdır, gelir değil. Yüklenen bakiye avans, harcanan bakiye satıştır. Bu ayrımı yapmayan hiçbir kurulum uzun ömürlü olmaz. Nasıl kurgulandığını özellikler bölümünde daha teknik başlıklarla görebilirsin.
Ay Sonu Mutabakat Farklarının Kaynak Dağılımı
- Ödeme komisyonu ve kesintiler 45%
- İade ve iptal kayıtları 25%
- Bayi bakiye hareketleri 20%
- Kur farkı ve yuvarlama 10%
Entegrasyon Koptuğunda Ne Oluyor, Kim Fark Ediyor?
Hiç kimse. En tehlikeli senaryo budur. API token'ı süresi dolar, muhasebe programı bakım moduna girer, sunucu saat dilimi değişir ve aktarım sessizce durur. Sen bunu 26 gün sonra, muhasebeci arayınca öğrenirsin. Bu yüzden ciddi bir e-pin scripti kurulumunda üç savunma katmanı olmalı: kuyruk mantığı (başarısız kayıt silinmez, tekrar denenir), durum paneli (bekleyen kaç kayıt var, son başarılı aktarım ne zaman) ve bildirim (üst üste hata olursa e-posta veya mesaj). Bu üçü olmadan kurulan entegrasyon, entegrasyon değil şanstır.
Kurmadan Önce Neleri Netleştirmelisin?
Aşağıdaki kontrol listesi, kurulum öncesi tek oturumda cevaplaman gereken maddeleri içeriyor. Her satırı net cevaplamadan geliştiriciye iş açma; çünkü entegrasyonun maliyeti kod yazmak değil, sonradan yön değiştirmektir.
| Kontrol Maddesi | Neden Kritik | Durum |
|---|---|---|
| Muhasebe kaydı hangi sipariş statüsünde oluşacak | İptal/iade ters kayıt yükünü belirler | Zorunlu |
| Komisyon ayrı gider kalemi olarak geçecek mi | Ciro doğruluğu | Zorunlu |
| Bayi bakiyesi avans hesabına bağlandı mı | Kasa-banka uyumu | Zorunlu |
| Ürün kodları muhasebe stok kartlarıyla eşleşti mi | Otomatik eşleşme hataları | Zorunlu |
| KDV oranları ürün bazında tanımlı mı | Beyanname doğruluğu | Zorunlu |
| Başarısız aktarım için tekrar deneme kuyruğu var mı | Sessiz veri kaybı | Önerilir |
| Günlük aktarım özeti bildirimi açık mı | Erken uyarı | Önerilir |
| Test ortamında 20 sipariş denendi mi | Canlı veri kirliliği | Önerilir |
Entegrasyonu canlıya almadan önce bir hafta boyunca çift kayıt modunda çalıştır: hem otomatik aktar hem manuel listeni tut. Yedinci gün iki listeyi karşılaştır. Fark sıfırsa manuel listeyi bırak; fark varsa daha canlıda para kaybetmeden sebebi bulmuş olursun.
Bu İşi Tek Seferde Doğru Kurmanın Bedeli Ne?
Gerçek maliyet lisans bedeli değil, yanlış kurulumun geri dönüş süresidir. Yılda bir kez mizan tutmadığında harcadığın üç gün, muhasebecinin ek mesaisi ve düzeltme beyannamesi riski toplandığında, baştan doğru kurgulanmış bir e-pin satış yazılımı kendini ilk çeyrekte amorti eder. Önemli olan, seçtiğin altyapının muhasebe tarafını sonradan yamanmış bir eklenti olarak değil, sipariş yaşam döngüsünün doğal bir parçası olarak görmesi. Fiyat ve paket farklarını fiyat bölümünde karşılaştırabilir, kurulum konuşmasını başvuru sayfasından başlatabilirsin.
Muhasebe ay sonunu üç günden yirmi dakikaya indir
Pinova, sipariş yaşam döngüsünü muhasebenin anlayacağı olaylara çeviren bir dijital ürün satış yazılımıdır. Komisyon, iade ve bayi carisi ayrı ayrı doğru yere yazılır.
Her muhasebe programına bağlanabilir miyim?
Programın bir API'si, web servisi veya dışa aktarma formatı varsa evet. Tamamen kapalı, hiçbir veri kabul etmeyen bir program kullanıyorsan tek seçenek dönemsel dosya aktarımıdır.
Entegrasyon geçmiş siparişlerimi de aktarır mı?
Genellikle belirli bir tarihten sonrası aktarılır. Geçmiş verinin toplu aktarımı ayrı bir işlemdir ve muhasebecinin dönem kapanışlarıyla çakışmaması için kontrollü yapılmalıdır.
Aktarım sırasında bir hata olursa sipariş kaybolur mu?
Kuyruk mantığı doğru kurulduysa hayır. Başarısız kayıt kuyrukta bekler, tekrar denenir ve panelde "bekleyen aktarım" olarak görünür.
İade ettiğim bir satış otomatik düzeltilir mi?
Sipariş iade statüsüne geçtiğinde karşı kayıt üretilecek şekilde kurgulanabilir. Bunun kurulum aşamasında açıkça tanımlanması gerekir, varsayılan olarak her sistemde açık değildir.
Muhasebe entegrasyonu, dışarıdan bakınca teknik bir detay gibi görünür; içeriden bakınca işletmenin gerçek kârını görebildiğin tek penceredir. Kurduğun yapı doğruysa ay sonu bir rapor okuma seansına dönüşür, yanlışsa bir arkeoloji kazısına. Hangi alanların nasıl eşleştiğini, kuyruk ve bildirim ekranlarının nasıl göründüğünü kendi gözünle görmek istersen canlı demo üzerinden tüm akışı sipariş oluşturarak ucundan ucuna deneyebilirsin.

