Normal Stripe entegrasyonundan farkı nedir?

Normal entegrasyon OAuth kullanır ve çift yönlüdür: Frihet'ten ödeme alırsınız. Gelir Senkronizasyonu tek yönlüdür: zaten ödenmiş Stripe faturalarını kısıtlı, yalnızca okuma izinli bir API Anahtarı kullanarak içe aktarır. Paranızıza erişimi yoktur.

Birden fazla kez aktarırsam faturalar yinelenir mi?

Hayır. Aktarılan her fatura, Stripe ID'sini meta veri olarak kaydeder. Frihet'te zaten mevcutsa, otomatik olarak yok sayılır.

Aktarılan faturalar VeriFactu uyumlu mu?

Evet. Manuel olarak oluşturulan faturalarla tamamen aynı şekilde, Frihet'in SHA-256 hash zinciri ve boşluksuz numaralandırmasından geçerler. Modelo 303'ünüz ve kayıt defteriniz için hazırlar.

Hangi faturaları aktaracağımı seçebilir miyim?

Bir başlangıç tarihi belirleyebilirsiniz. O tarihten itibaren ödenen tüm faturalar aktarılır. Tekrar etmeme özelliği, hiçbir faturanın yinelenmemesini garanti eder.

Stripe ödemelerinizi 3 tıklamayla fatura olarak aktarın

Stripe ile ödeme alırsınız. Müşterileriniz ödeme yapar. Ancak bu işlemler, biri onları faturaya dönüştürene kadar fatura değildir. Bu “birisi” artık siz olmak zorunda değilsiniz.

Bugün Stripe Gelir Senkronizasyonu’nu piyasaya sürdük: Stripe ödemelerinizi Frihet’e kayıtlı faturalar olarak otomatik olarak aktaran bir entegrasyon. Tekrar etmeme özelliği, VeriFactu hash zinciri ve her 6 saatte bir otomatik senkronizasyon ile.

Sorun: bir yandan tahsilat yapmak, diğer yandan faturalandırmak

Bir SaaS kurucusu, Stripe üzerinden ödeme alan bir freelancer veya dijital ürünler satan biriyseniz, muhtemelen bu durumda yaşıyorsunuzdur:

Stripe tahsilat yapar. Müşterileriniz kartla ödeme yapar, abonelikler yenilenir, düzenli ödemeler gelir.
Muhasebeniz habersiz kalır. Bu tahsilatlar Stripe’ta mevcuttur ancak faturalama yazılımınızda yoktur.
Siz köprü görevi görürsünüz. Her ay, Stripe’tan veri kopyalayarak faturaları manuel olarak oluşturursunuz. Ya da daha kötüsü: bunu yapmazsınız ve muhasebeciniz bir sonraki çeyrekte çıldırır.

Stripe makbuz düzenler, ancak İspanya’da mali açıdan geçerli faturalar düzenlemez. NIF’inizi içermez, Hazine’nin gerektirdiği numaralandırmayı uygulamaz, VeriFactu’nun gerektirdiği hash zincirini oluşturmaz. İspanyol vergi düzenlemelerine uymak için, bir faturalama yazılımında gerçek faturalar oluşturmanız gerekir.

Şimdiye kadar bu, iki kat iş anlamına geliyordu. Artık değil.

Stripe Gelir Senkronizasyonu Nedir

Gelir Senkronizasyonu, Stripe hesabınızı Frihet’e yalnızca okuma izinli kısıtlı bir API Key kullanarak bağlar. OAuth yok, yönlendirme yok, paranız üzerinde yazma izni yok.

Yaptıkları:

Stripe’taki ödenmiş faturalarınızı sorgular — sadece paid durumunda olanları
Her tahsilat için Frihet’te bir fatura oluşturur — müşteri, detay satırları ve tutarlar ile
Faturayı ödenmiş olarak işaretler — VeriFactu pipeline’ı otomatik olarak etkinleşir
Stripe ID’sine göre tekrar etmeyenleri seçer — fatura zaten mevcutsa, onu yok sayar

Sonuç: Stripe tahsilatlarınız, sıralı numaralandırma, SHA-256 hash ile ve Modelo 303’ünüz için hazır olarak Frihet’te kayıtlı faturalar olarak görünür.

Pratikte Nasıl Çalışır

Üç adım. Kodsuz, karmaşık yapılandırmalar yok.

Adım 1: Stripe’ta kısıtlı bir API Key oluşturun

Stripe Dashboard > Developers > API Keys adresine gidin. İki izinle kısıtlı bir anahtar oluşturun:

Invoices → Oku
Customers → Oku

Başka hiçbir şey yok. Yazma iznine veya ödemelere, transferlere veya bakiyelere erişime ihtiyacınız yok. Anahtar rk_live_ ile başlar ve yalnızca okuma iznine sahiptir.

Adım 2: Frihet’e bağlanın

Ayarlar > Entegrasyonlar > Stripe Gelir Senkronizasyonu’na gidin. API Key’inizi yapıştırın ve hangi tarihten itibaren içe aktarmak istediğinizi seçin. Son 90 günü içe aktarabilir veya belirli bir tarih seçebilirsiniz.

Adım 3: İçe Aktarın

“Şimdi İçe Aktar” düğmesine tıklayın. Frihet, Stripe’ı sorgular, ödenmiş faturaları getirir ve hesabınızda oluşturur. Her Fatura, Firestore tetikleyicilerinden geçer: boşluksuz numaralandırma ve VeriFactu hash zinciri.

İlk aktarımdan itibaren VeriFactu uyumlu

Stripe’tan aktarılan faturalar “ikinci sınıf” değildir. Frihet’te manuel olarak oluşturduğunuz faturalarla tamamen aynı pipeline’dan geçerler:

Boşluksuz numaralandırma — Sunucuda atomik sayaç. Boşluk yok, atlama yok.
Hash SHA-256 — AEAT’nin talep ettiği 8 alanlı hash zinciri. Her fatura bir öncekinin hash’ini referans alır.
Değişmezlik — Bir kez kaydedildikten sonra, kritik alanlar kilitlenir. Değişiklikler düzeltme faturaları oluşturur.
Kayıt defteri — Aktarılan faturalar, Hazine’nin istediği 19 sütunla CSV dışa aktarımınızda görünür.

Bu, Stripe tahsilatlarınızın Modelo 303, Modelo 130 ve herhangi bir denetim için hazır olduğu anlamına gelir. Ek adımlar olmadan.

Gelir Senkronizasyonu Kimler İçin

Stripe Billing ile Tahsilat Yapan SaaS Kurucuları

Abonelikleri doğrudan Stripe üzerinden tahsil edersiniz. Her ay onlarca veya yüzlerce müşteri yenilenir. Gelir Senkronizasyonu ile her yenileme otomatik olarak Frihet’te fatura olarak görünür. MRR’niz, üç aylık KDV’niz ve kayıt defteriniz her zaman güncel kalır.

Stripe Üzerinden Projeleri Tahsil Eden Freelancerlar

Müşterileriniz size Stripe üzerinden ödeme yapar ve tüm faturaları üç aylık raporlarınız için tek bir yerde tutmak istersiniz. Her faturayı elle oluşturmadan, Stripe ile e-tablonuz arasında veri karşılaştırması yapmadan.

Doğrudan Stripe Kullanan E-ticaret İşletmeleri

Dijital veya fiziksel ürünler satar ve Stripe ile tahsilat yaparsınız (Shopify veya WooCommerce aracılığıyla değil). Her satış kayıtlı bir faturaya dönüşür. Özellikle AB müşterilerine satış yapıyor ve KDV kontrolüne ihtiyacınız varsa kullanışlıdır.

Karma Faturalamalı Ajanslar

Bazı müşterileriniz size Stripe ile, diğerleri ise havale ile ödeme yapar. Gelir Senkronizasyonu Stripe ödemelerini aktarırken, geri kalanını manuel olarak veya Frihet’in doğrudan faturalama özelliğiyle faturalandırırsınız. Hepsi aynı kayıt defterinde bir arada bulunur.

Gelir Senkronizasyonu Ne DEĞİLDİR

Karışıklığı önlemek için açıklamakta fayda var:

Stripe’ın OAuth entegrasyonu değildir. Bu zaten Frihet’te mevcuttur ve uygulamanın kendisinden ödeme bağlantılarıyla tahsilat yapılmasına olanak tanır. Gelir Senkronizasyonu tek yönlüdür: sadece içe aktarır.
Tahsilat yapmaz. Ödeme işlemez veya Stripe’ta ücret oluşturmaz. Sadece zaten ödenmiş faturaları okur.
Stripe Billing’in yerine geçmez. Onu tamamlar. Stripe tahsilat yapar, Frihet kaydeder.
Müşteriye göre filtrelemez. Seçtiğiniz tarihten itibaren ödenen tüm faturaları içe aktarır. Tekrar etmeme özelliği, yinelenen faturaların olmamasını sağlar.

Güvenlik

Kısıtlı API Key, iki kaynakta yalnızca okuma iznine sahiptir: invoices ve customers. Para taşıyamaz, tahsilat oluşturamaz veya Stripe hesabınızı değiştiremez.

Anahtar, Frihet sunucusunda AES-256-GCM ile şifrelenmiş olarak saklanır. Ön yüze asla maruz kalmaz. Stripe anahtarın süresinin dolduğunu veya iptal edildiğini algılarsa, Frihet entegrasyonu “yeniden bağlantı gerektiriyor” olarak işaretler ve sizi bilgilendirir.

Ayarlar > Entegrasyonlar’dan istediğiniz zaman bağlantıyı kesebilirsiniz. Zaten aktarılmış faturalar Frihet’te kalır.

Şimdi Başlayın

Stripe ile tahsilat yapıyorsanız, faturalarınız zaten orada. Sadece muhasebenize ulaşmaları gerekiyor. Stripe Gelir Senkronizasyonu bunu 3 tıklamayla, OAuth olmadan, tehlikeli izinler olmadan ve ilk günden itibaren VeriFactu uyumlu olarak yapar.

Stripe hesabınızı bağlayın ve tahsilatlarınızın otomatik olarak kayıtlı faturalara dönüşmesine izin verin.