Stripe'tan İçe Aktarma

Bu kılavuz, bir içe aktarım şablonu aracılığıyla Stripe ödemelerinin dosya içe aktarımını ele alır: neyin dışarı aktarılacağı, şablonun nasıl ayarlanacağı ve içe aktarımın ne oluşturduğu. API ayrıntıları Banka ve ödeme içe aktarımları bölümündedir.

1. Ödemeler dosyasını Stripe'tan dışarı aktarın

Stripe kontrol panelinde Payments (Ödemeler) → Export (Dışa Aktar) seçeneğine gidin, tarih aralığını seçin, All columns (Tüm sütunlar) seçeneğini koruyun ve kullandığınız meta veri (metadata) sütunlarını dahil edin (Stripe her meta veri anahtarını <key> (metadata) şeklinde, örneğin orderNo (metadata) adında bir sütun olarak dışarı aktarır). CSV'yi indirin. Hem canlı (live) hem de test modu dışa aktarımları çalışır.

Para hareketi oluşturmayan satırlar içe aktarım sırasında atlanır: başarısız olan, iptal edilen veya hâlâ bir ödeme yöntemi gerektiren ödeme denemeleri ve hiçbir zaman tahsil edilmeyen (captured) masraflar.

2. Stripe için bir banka hesabı oluşturun

Her içe aktarım bir banka hesabına düşer. Bank (Banka) altında New bank account (Yeni banka hesabı) seçeneğine basın, Type: Stripe (Stripe hesabının IBAN'ı yoktur) seçeneğini seçin, örneğin "Stripe" adını verin, tahsilat yaptığınız para birimini ve ilgili yevmiye hesabını (ledger account) seçin. Stripe bakiyesi bir banka hesabı gibi davranır: tahsilatlar gelir, masraflar çıkar, ödemeler (payouts) bakiyeyi gerçek bankanıza taşır.

3. İçe aktarım şablonunu oluşturun

Bank (Banka) → Import templates (İçe aktarım şablonları) altında New import template (Yeni içe aktarım şablonu) seçeneğine basın, Stripe tipini seçin ve bir ad verin.

Alanlar (Fields). Stripe dışa aktarımının her sütunu bir satırdır. Required in file (Dosyada zorunlu) kutusu, sütunun yüklenen dosyada bulunması gerektiğini belirtir; zorunlu bir sütunu eksik olan bir dosya reddedilir ve eksik adlar gösterilir. 19 adet Card … sütunu, Stripe bunları bazı hesaplar için atladığı için varsayılan olarak seçilmemiştir.

Yevmiye hesabı (Ledger account). Para taşıyan satırlar (Amount, Fee, Amount Refunded) mevcut bir yevmiye hesabına veya aynı satırdan oluşturulan yeni bir hesaba atanabilir. Atanan bir alandan üretilen her hareket, içe aktarım sırasında muhasebeleştirilir: gelen para Stripe banka hesabını borçlandırır (debit) ve atanan hesabı alacaklandırır (credit), giden para bunun tersini yapar ve banka hareketi o yevmiye kaydıyla eşleştirilmiş olarak işaretlenir. Olağan kurulum şöyledir:

Alan	Hesap	Etki
Fee	bir ÖHS (PSP) masraf gider hesabı (standart planda 6800)	Her Stripe masrafı bir gider olarak kaydedilir
Amount	"Not posted" (Muhasebeleştirilmedi) olarak bırakın	Tahsilatlar fatura eşleştirmesi için açık kalır (bkz. adım 5)
Amount Refunded	"Not posted" (Muhasebeleştirilmedi) olarak bırakın	İadeler alacak dekontları aracılığıyla işlenir (bkz. adım 5)

Eksik müşterileri oluştur (Create missing customers). Bunu Customer Email satırında işaretleyin. Dosyadaki henüz hiçbir iş ortağı (partner) ile eşleşmeyen her e-posta için bir müşteri oluşturulur: adı Customer Description alanından (boşsa e-posta), adresi varsa Card Address … sütunlarından alınır. Mevcut iş ortakları büyük/küçük harf duyarsız olarak e-posta ile tanınır, böylece hiçbir şey iki kez oluşturulmaz.

İş ortağı olarak Stripe'ı oluştur (Create partner Stripe). Bunu Fee satırında işaretleyin. İçe aktarım, bir kez Stripe adında bir tedarikçi iş ortağı oluşturur (bu ada sahip mevcut bir iş ortağı yeniden kullanılır) ve yevmiyedeki her masraf kaydını iş ortağı Stripe olacak şekilde kaydeder, böylece masraf kayıtları kime ödeme yapıldığını gösterir.

Meta veri alanları (Metadata fields). İçe aktarımın okumasını istediğiniz her meta veri anahtarı için (örneğin orderNo) bir satır ekleyin. Bu satırlarda iki bayrak (flag) ayarlanabilir:

• Faturalar oluştur veya bağla (Create or link invoices) - bir siparişi tanımlayan anahtarı işaretler (adım 5). Yalnızca bir satır bunu taşıyabilir. Oluşturulan faturalar için bir KDV (VAT) oranı bunun yanında görünür ve isteğe bağlı bir Catalog item (Katalog kalemi) seçilebilir: seçildiğinde, içe aktarımın oluşturduğu her fatura kalemi o ürüne veya hizmete atıfta bulunur, böylece gelir kalemin hesabına işlenir; kalem metni yine de masraftan gelir.
• Şirket bayrağı (Company flag) - alıcının bir şirket olduğunu belirten bir değeri (true, 1, yes, company, business veya b2b) taşıyan bir anahtarı işaretler. Bu tür masraflardan oluşturulan müşteriler şirket tipinde iş ortaklarıdır; diğerleri ise gerçək kişidir.

Şablonu kaydedin.

4. Dosyayı içe aktarın

Bank (Banka) altında Stripe banka hesabını, şablonu ve dosyayı seçin, ardından Import (İçe aktar) seçeneğine basın. Düğme, içe aktarım tamamlanana kadar bir dönme çarkı (spinner) gösterir; büyük bir dosya, faturalar birer birer düzenlendiği için dakikalar sürebilir. Sonuç satırı kaç işlemin içe aktarıldığını, kaçının zaten mevcut olduğunu, kaç hareketin muhasebeleştirildiğini ve kaç müşteri, fatura ve alacak dekontunun oluşturulduğunu bildirir. Uyarılar, işlenemeyen siparişleri ve nedenini listeler.

Aynı dosyayı tekrar içe aktarmak güvenlidir: işlemler Stripe masraf kimliğine göre, müşteriler e-postaya göre, siparişler meta veri değerine göre tanınır.

5. "Faturalar oluştur veya bağla" ne yapar?

Masraflar ve iadeler, seçilen meta veri anahtarının (sipariş numarası) değerine göre gruplandırılır.

• Bu değer için bir satış faturası zaten mevcutsa (harici referansı o değer olan bir satış siparişi veya numarası o değer olan bir fatura), masraflar ödeme olarak bu faturayla eşleştirilir.
• Aksi takdirde müşteri için bir satış faturası oluşturulur: masraf başına bir kalem, masrafın kalem metni ve şablonun KDV oranında KDV dahil fiyat olarak masraf tutarı ile ilk masraf tarihine sahip olur. Derhal düzenlenir ve muhasebeleştirilir ve masraflar buna eşleştirilir, böylece ödenmiş olarak görünür. stripe kanalına sahip bir satış siparişi, sipariş numarasıyla kaydedilir, böylece bir sonraki içe aktarım oluşturmak yerine bağlama işlemi yapar.
• Gruptaki her iade, iade edilen tutar için o faturaya karşı düzenlenen bir alacak dekontu (credit note) haline gelir ve iade işlemi buna eşleştirilir.

Müşteri e-postası olmayan, farklı para birimlerinde masrafları olan veya mevcut faturası hâlihazırda taslak durumunda ya da ödenmiş olan gruplar atlanır ve uyarılarda listelenir. İşlemleri Bank (Banka) → Transactions (İşlemler) altında eşleştirilmemiş olarak kalır.

Fatura numaraları, önceki yıllara ait tarihlere sahip masraflar için bile cari yılın serisinden gelir, böylece geçmişe dönük içe aktarımlar mevcut numaralarla çakışmaz.

6. Şablonun alt kısmındaki altı isteğe bağlı alan

Çoğu şirket altısını da boş bırakır ve içe aktarım tamamen aynı şekilde çalışır. Bunlar iki dar durum için mevcuttur: kart rezervasyonlarının belge olarak kaydedilmesini istiyorsunuz veya kısmen başkasına ait olan parayı topluyorsunuz.

Açılır menüler neden boş görünüyor?

Üç "işlem tipi" açılır menüsü, şirketinizin Account (Hesap) → Operation types (İşlem tipleri) altında oluşturduğu işlem tiplerini listeler. Hiç oluşturmadıysanız, açılır menüde hiçbir şey yoktur. Bu bir hata değildir; önce bir işlem tipi oluşturun veya alanı boş bırakın.

Lender metadata field (Ödünç veren meta veri alanı) açılır menüsü, aynı formda daha yukarılarda bulunan Metadata fields (Meta veri alanları) listesine yazdığınız meta veri sütun adlarını listeler. Önce oraya bir meta veri alanı ekleyin ve burada görünecektir.

Kısmi iade etiketi ve Tam iade etiketi (Partial refund label and Full refund label)

İçe aktarım bir iade için alacak dekontu oluşturduğunda, bunlar o alacak dekontunun PDF'sinin üst kısmına yazdırılan kelimeyi sağlar.

Durum	Kullanılan kelime	Varsayılan
İade, fatura toplamından küçük	Kısmi iade etiketi	DEPOZITAS
İade, fatura toplamına eşit	Tam iade etiketi	ANULIAVIMAS
---	---	---

Bunları yalnızca şirketiniz bu tür belgelerde farklı kelimeler yazdırıyorsa değiştirin. Numaralandırmayı ve muhasebeyi etkilemezler.

Yetkilendirme işlem tipi (Authorization operation type)

Kart yetkilendirmesi, müşterinin kartında rezerve edilen ve henüz almadığınız bir paradır. Stripe dışa aktarımında bu satırların Captured değeri false olarak ayarlanmıştır. İçe aktarım normalde bunları yoksayar, çünkü hiçbir para hareketi olmamıştır.

Bu alanı doldurun; bu tür her satır, bu işlem tipini ve bu işlem tipinin işaret ettiği belge serisini kullanarak düzenlenen bir satış belgesi haline gelir. Boş bırakın ve bu satırlar atlanır; içe aktarım sonucu "authorization(s) skipped: template has no authorization operation type" (yetkilendirme(ler) atlandı: şablonun yetkilendirme işlem tipi yok) uyarısını gösterir.

İşletmenizin rezervasyonları belge olarak göstermesi gerektiğini zaten bilmiyorsanız, boş bırakın.

Ödeme aktarımı işlem tipi, Komisyon işlem tipi ve Ödünç veren meta veri alanı (Payout operation type, Commission operation type and Lender metadata field)

İşletmeniz başkasına ait olan parayı toplamıyorsa - satıcılara ödeme yapan bir pazar yeri (marketplace) veya borç verenlere ödeme yapan bir platform - bu bölümü tamamen atlayın. Sıradan bir dükkan bunları asla doldurmaz.

Stripe bu hikayeyi iki dosyada anlatır. Payments (Ödemeler) dışa aktarımı her müşterinin ne ödediğini söyler. Ayrı bir transfers (transferler) dışa aktarımı, bunun ne kadarını diğer tarafa gönderdiğinizi söyler. İçe aktarımın neyi tuttuğunuzu hesaplamak için her ikisine de ihtiyacı vardır.

Bank (Banka) üzerinde, en az bir Stripe şablonu mevcut olduğunda içe aktarım formu bir Stripe transfers export (Stripe transferleri dışa aktarımı) dosya kutusu gösterir; ödemeler dosyasının yanındaki transferler dosyasını orada seçin. API aracılığıyla bu, bank/statements/import adresinin transfersCsv alanıdır.

Her iki dosya da mevcut olduğunda:

Alan	Ne yapar
Payout operation type (Ödeme işlem tipi)	Diğer tarafa yapılan her transfer için, aktarılan tutar için bir yevmiye kaydı yazılır. Borç ve alacak hesapları bu işlem tipinden gelir. Boş bırakılırsa, kayıt bunun yerine satıcıya borç ve tedarikçiye borç muhasebeleştirme kurallarını kullanır.
Commission operation type (Komisyon işlem tipi)	Elinizde tuttuğunuz kısım; masraf tutarından Stripe masrafı çıkarılıp dışarı aktarılan tutar düşülerek hesaplanır ve yalnızca sıfırdan büyük olduğunda yazılır. Hesaplar bu işlem tipinden gelir, aksi takdirde satıcıya borç ve komisyon geliri muhasebeleştirme kurallarından alınır.
Lender metadata field (Ödünç veren meta veri alanı)	Paranın kime gittiğini tutan Stripe meta veri sütununun adı. Bu değere sahip bir iş ortağı oluşturulur veya varsa yeniden kullanılır ve yukarıdaki her iki kayda da atanır. Boş bırakılırsa veya değere sahip olmayan bir satır için "lender not identified" (ödünç veren tanımlanamadı) uyarısı verilir ve kayıt iş ortağı olmadan yazılır.

Her iki işlem tipi alanı da boşsa, başka ne ayarlanmış olursa olsun hiç transfer veya komisyon kaydı yazılmaz.

7. Bankanıza yapılan ödemeler (Payouts)

Ödemeler dışa aktarımında ödeme (payout) satırı yoktur, bu nedenle Stripe'ın gerçek bankanıza gönderdiği para bunun yerine ödeme raporundan muhasebeleştirilir. Stripe kontrol panelinde Reports (Raporlar) → Payouts (Ödemeler) → Payout reconciliation, itemized (Ödeme mutabakatı, kalem kalem) seçeneğine gidin, indirin ve Bank (Banka) → Settlements (Mutabakatlar) altında gerçek banka hesabınıza aktarın, ardından her ödemeyi muhasebeleştirin.

Bu içe aktarımın ücretini, masrafını veya iadesini zaten Stripe banka hesabına koyduğu her ödeme satırı için, muhasebeleştirme işlemi satırın net tutarını Stripe banka hesabından gerçek banka hesabına taşır. Masraflar ve fatura ödemeleri ikinci kez muhasebeleştirilmez. Stripe'ın ödediği ve bu içe aktarımın hiç görmediği satırlar Bank & payment imports bölümünde açıklandığı gibi muhasebeleştirilir.

Her ödeme Difference to imported payments (İçe aktarılan ödemelerden fark) gösterir: ödemenin taşıdığı tutar eksi Stripe banka hesabının aynı masraflar ve iadeler için tuttukları. Sıfır, ödemenin Stripe hesabını sıfırladığını gösterir. Bir farkı olan veya Stripe hesabında hâlâ muhasebeleştirilmemiş bir hareketi olan bir satır Lines to check (Kontrol edilecek satırlar) altında sayılır. Ödemeler dışa aktarımı yalnızca masraf başına iade edilen toplamı tutar, bu nedenle bir masrafın tüm iade satırları bu toplamaya karşı birlikte karşılaştırılır.

Bir ödeme, ödemeler dosyası içe aktarılmadan önce muhasebeleştirildiyse, içe aktarım bu ödemenin masraflarını, masraflarını (fees) ve iadelerini atlar ve uyarılarda bunu adlandırır.

8. Sonrasında nereye bakılmalı?

• Bank (Banka) → Transactions (İşlemler) - içe aktarılan her hareket; eşleştirilenler faturaya veya yevmiye kaydına bağlanır.
• Invoices (Faturalar) - notlarda sipariş numarasıyla birlikte oluşturulan faturalar ve alacak dekontları.
• Partners (İş ortakları) - oluşturulan müşteriler.
• Ledger (Defter) → Journal (Yevmiye) - masraflar, ödemeler ve faturalar için muhasebe kayıtları.

Faturalandırma (Billing)

10 MB'a kadar dosyalar ve 50.000 hareket. İçe aktarılan her 10 hareket bir API isteği olarak sayılır.