ReconPilot TR 1.3: kurulum ve kullanım

İlk deneme

Programla iki örnek gelir. Örnek ay, tek bir müşterinin bir aylık dosyalarıdır ve her zaman tam açılır. Örnek ajansta beş örnek müşteri vardır. Lisans yokken panosunda sayılar görünür, tutarlar ve raporların tamamı lisansla açılır. İkisindeki bütün veriler örnektir, kendi dosyalarınızı vermeniz gerekmez. Program şimdiye kadar yalnız örnek ve yapay dosyalarla denendi. Kendi dosyalarınızla denerken pazar yeri ve ödeme kuruluşu dosyalarını ayın tamamı için, banka hareketlerini ise ayın ilk gününden bir sonraki ayın ilk haftasına kadar alın (Eylül için 1 Eylül ile 7 Ekim arası, ayrıntısı "Tek bir ayın raporu" bölümünde). Metinde geçen terimler en sondaki "Kısa sözlük" bölümünde açıklanıyor.

1. İndirdiğiniz zip dosyasına sağ tıklayıp "Özellikler"i açın. En alttaki "Engellemeyi kaldır" kutusunu işaretleyin ve "Tamam"a basın. İndirme sayfasındaki PowerShell satırı "TAMAM" yazdıysa bu iş yapılmıştır, bu adımı geçin.
2. Zip'e yeniden sağ tıklayıp "Tümünü ayıkla"yı seçin ve açılan pencerede "Ayıkla"ya basın. Açılan klasördeki reconpilot-tr.exe dosyasına çift tıklayın. Programı zip'in içinden çalıştırmayın. Küçük siyah bir pencere açılır, ardından tarayıcıda ReconPilot sayfası gelir.
3. Sayfadaki "Örnek ajansı açın" kartında "Örnek ajansı aç" düğmesine basın. Beş örnek müşterinin listelendiği ajans panosu açılır. Program örnek ayları pano açılırken kendisi işler ve kaç ayı işlediğini sayfanın başında yazar. Her müşterinin ayları kendi adının altında, durumlarıyla görünür.
4. Panonun başındaki "Sizden beklenenler" kutusuna bakın. Örnek ajanstaki aylardan birinin banka dosyası eksiktir. Kutu hangi müşterinin hangi ayında neyin eksik olduğunu söyler.
5. Bir ayın satırının sağındaki "Raporu aç" düğmesine basın. O müşterinin o ayki mutabakat raporu açılır. Raporun üstündeki bağlantılardan "Müşteri raporu" aynı ayı müşterinin anlayacağı sözcüklerle gösterir.
6. Sayfanın en üstündeki "Ajans panosu" bağlantısıyla panoya dönün. Bir müşterinin adının yazdığı satırda, sağdaki "Müşteri paneli"ne basın. Program o müşterinin aylarını tek bir dosyaya yazar ve sonucu yeni bir sayfada gösterir. O sayfadaki "Dosyayı indir" düğmesi dosyayı tarayıcınızın indirdiği yere kaydeder. Bu bir HTML dosyasıdır: müşteriniz ona çift tıklayınca dosya internet tarayıcısında açılır.
7. Tek bir ayın nasıl işlendiğini görmek isterseniz sol üstteki ReconPilot yazısına tıklayıp ana sayfaya dönün. Sayfanın altındaki "Tek bir ayı deneyin" bölümünde, "Örnek veriyle deneyin" kartındaki "Örnek ayı aç" düğmesine basın. "Sütunları kontrol edin" sayfası açılır. Sayfanın altındaki "Mutabakatı çalıştır" düğmesi örnek ayın raporunu açar.

Örnek ajansın dosyaları geçicidir. Programı sayfanın altındaki "Programı kapat" düğmesiyle kapatırsanız program onları kapanırken siler. Siyah pencereyi kapatarak çıkarsanız bir sonraki açılışta siler. 6. adımda hazırladığınız paneli saklamak istiyorsanız programı kapatmadan önce "Dosyayı indir" ile kaydedin.

Kurulum

Gerekenler: Windows 10 ya da 11 (64 bit) ve bir tarayıcı (Edge, Chrome ya da Firefox). Program kurulmaz. reconpilot-tr.exe dosyasını istediğiniz klasörde tutabilirsiniz. Program siyah pencere açık kaldıkça çalışır. İşiniz bitince sayfanın altındaki "Programı kapat" düğmesine basın ya da pencereyi kapatın.

Windows internetten inen her dosyayı işaretler. İlk denemenin birinci adımı bu işareti kaldırır ve program uyarısız açılır. O adımı atladıysanız Windows "bilgisayarınızı korudu" diye bir uyarı gösterir: önce "Ek bilgi"ye, sonra "Yine de çalıştır"a tıklayın. Program henüz dijital olarak imzalı değil. Bu yüzden Windows 11'in Akıllı Uygulama Denetimi özelliği açıksa ya da bilgisayarın ayarlarını bir bilgi işlem birimi yönetiyorsa program hiç açılmayabilir. Böyle olursa atilgandev@gmail.com adresine yazın. Sayfa kendiliğinden açılmazsa siyah penceredeki http://127.0.0.1 ile başlayan adresi seçip kopyalayın ve tarayıcının adres çubuğuna yapıştırın.

Sayfalar ilk başta açık renktedir. Koyu renk isterseniz sayfanın üstündeki "Koyu tema" düğmesine basın. Düğme o zaman işaretli görünür; açık renge dönmek için ona yeniden basın. Program Windows'un koyu tema ayarına bakmaz. Seçiminizi tarayıcınız hatırlar, program yeniden açıldığında sayfalar aynı temayla gelir. Yazdırdığınız ya da PDF olarak kaydettiğiniz sayfalar her zaman açık renkte çıkar.

Tek bir ayın raporu

Tek bir ayın raporu için klasör kurmanız gerekmez, dosyaları ana sayfada seçmeniz yeter. Birçok müşteriyle düzenli çalışacaksanız "Kendi ajansınızı kurmak" bölümüne bakın. "Örnek veriyle deneyin" kartındaki "Örnek ayı aç" düğmesi aynı işi programla gelen örnek ayın dosyalarıyla yapar. Kendi ayınız için ana sayfanın altındaki "Tek bir ayı deneyin" kartında "Dosyaları kendim seçeyim"e basın ve açılan "Dosyaları seçin" bölümünde şu dosyaları seçin:
- Pazar yeri ekstresi, ayın ilk gününden son gününe kadar. Trendyol'da satıcı panelinden Excel olarak indirdiğiniz cari hesap ekstresi, Hepsiburada'da yine satıcı panelinden indirdiğiniz hakediş dosyası (Excel). Panelden indirdiğiniz Excel dosyası yeterlidir. Dosyaları pazar yerinden bir yazılımla otomatik çekiyorsanız (API), program bu yolla gelen JSON dosyalarını da okur. Programla gelen örnek Trendyol dosyaları bu türdendir. Program dosyanın hangi pazar yerinden geldiğini sütun başlıklarına bakarak anlar. Bunu bir sonraki sayfada, "Dosya kimden" kutusunda kontrol edin.
- Müşteri iyzico ya da PayTR ile çalışıyorsa ödeme kuruluşunun aynı aya ait hakediş raporu. iyzico için hakediş (settlement) CSV dosyasını müşterinizin iyzico müşteri temsilcisinden isteyin. PayTR'de program "Ödeme Özeti" verisini JSON dosyası olarak okur. Ödeme kuruluşunun panelinden indirdiğiniz bir Excel ya da CSV dosyasını da verebilirsiniz. O zaman bir sonraki sayfada tarih ve tutar sütunlarını elle seçmeniz gerekebilir.
- Banka hesap hareketleri, ayın ilk gününden sonraki ayın ilk haftasına kadar (Eylül için örneğin 1 Eylül ile 7 Ekim arası). Ay sonunda yapılan ödemeler bankaya birkaç gün sonra düşer. Banka dosyası son beklenen ödemeden önce biterse rapor bunu yazar ve dökümü o günden birkaç gün sonrasına kadar almanızı söyler. Sonraki ayın ilk günlerinde gelen pazar yeri ödemeleri bu ayın raporunda "nedeni belirlenemeyen fark" diye görünür, ama açık kalana ve sorulacak tutara girmez (bu iki rakam "Ajans panosu" bölümünde anlatılıyor). Hareketleri internet şubesinden Excel (.xlsx ya da bankanın verdiği eski .xls) ya da CSV olarak alın. PDF döküm okunmaz.

Dosyaları seçip "Devam: sütunları kontrol et" düğmesine bastığınızda "Sütunları kontrol edin" sayfası açılır (aşağıda kısaca sütun sayfası). Program burada her dosyada hangi sütunu hangi bilgi olarak okuduğunu gösterir. Yanlış okunan bir sütunu listeden düzeltirsiniz. Bir Excel dosyasında birden çok çalışma sayfası varsa okunacak sayfayı da burada seçersiniz. Bir dosya türünü ilk kez kullanırken sütun sayfasına mutlaka bakın. Sayfanın altındaki "Mutabakatı çalıştır" düğmesi raporu açar.

Raporun başındaki "Dikkat" notlarını okuyun. Program orada örneğin şunları bildirir:
- okunmayan bir Excel çalışma sayfası,
- pazar yeri ya da ödeme kuruluşu dosyalarında iki kez sayılmış olabilecek satırlar,
- TL dışındaki ödeme satırları,
- döviz ve iade satırları: para birimi ya da işlem türü sütununu sütun sayfasında seçmemiş olsanız da program bu sütunu başlığından tanır ve oradaki döviz ve iade satırlarını bildirir,
- yüklenen dosyalarda ödeme satırı bulunmayan ödeme emirleri (ödeme emri, pazar yerinin tek seferde bankaya gönderdiği ödemedir),
- komisyonun ödemeden nasıl kesildiği anlaşılamayan ödeme emirleri (aşağıda "Komisyon notları"),
- pazar yerinden API ile sayfa sayfa alınan JSON dosyalarında eksik kalan sayfalar (yalnız API ile dosya alanları ilgilendirir).
Aynı hesabın aynı günlerini kapsayan iki döküm yüklemeyin. Program iki dökümdeki aynı hareketi iki ayrı hareket sayar.

Ana sayfada dosyaları seçerken "Müşterinin listeleri" bölümünü açıp müşterinin pazar yeriyle anlaştığı komisyon oranlarını ve ürün maliyetlerini de ekleyebilirsiniz. Bu listeler yalnız o seferlik kullanılır. Yüklediğiniz dosyalar tek bir ayı kapsıyorsa rapor başlığında ve indirilen dosyaların adında o ay görünür.

Raporun yanındaki sayfalar

Raporun üstündeki bağlantılar aynı ayın öbür sayfalarını açar. Bağlantılar dört başlık altında toplanır: "Platforma sorulacaklar" (itiraz dosyası), "Müşteriye gidenler" (çalışma klasöründen açılan aylarda müşteri raporu), "Mali müşavire gidenler" (stopaj çizelgesi ve beyan sağlaması) ve "Ajansın kendi işi" (ürün kârlılığı). Panodaki "Bu programla neler hazırlanır" kutusu da aynı dört başlığı kullanır. İtiraz dosyası, stopaj çizelgesi ve beyan sağlaması yalnız o ayın dosyalarında ilgili satırlar varsa çıkar. Bağlantıların altında mali müşavir paketini indiren düğme, raporun CSV dökümlerini indiren "Dosya olarak indir" satırı ve "Sütunları düzenle" düğmesi bulunur.
- Ürün kârlılığı: barkodu olan ekstre satırlarından ürün başına satış, komisyon, iade, diğer kesintiler ve net tutar. Maliyet listesi verdiyseniz maliyet düşüldükten sonra kalan tutar da görünür. Müşterinin pazar yeriyle anlaştığı oranları verdiyseniz komisyon oranı hücresinde, kesilen oranın altında "anlaşılan" sözcüğünden sonra o oran görünür. Reklam, genel giderler ve vergi bu tabloya girmez. Tablodaki kalan, bu giderler düşülmeden önceki tutardır.
- İtiraz dosyası: kesinti denetiminin bulduğu ve platforma sormanız gereken kalemler. Kesinti denetimi, programın ekstredeki kesintileri kontrol ettiği kısımdır. Program her ürün için bu dönemde en sık kesilen komisyon oranını bulur ve o üründe bu orandan yüksek komisyon kesilmiş satışları listeler. Müşterinin anlaştığı oranları verdiyseniz karşılaştırmayı o oranlarla yapar. Hepsiburada'da ayrıca aynı pakete kesilen ikinci kargo bedelini ve iade edildiği hâlde ekstrede komisyon iadesi görünmeyen siparişleri arar. Aynı pazar yerinde aynı kontrolün bulduğu kalemler bir grupta toplanır. İtiraz dosyasının ilk sayfasında her grup için platformun paneline yapıştıracağınız kısa bir metin ve yanında bir "Metni kopyala" düğmesi bulunur. Grubun siparişleri ve ekstre satırları "Kalemler" sayfasındadır, aynı liste CSV dosyası olarak da iner. Eksik yatan ödemeler ilk sayfanın altında, ayrı bir bölümdedir. Bankada karşılığı görünmeyen ödemelerin bölümü onun altındadır ve iki bölümde de her ödemenin kendi metni ile "Metni kopyala" düğmesi bulunur. Banka dökümü bir ödemenin gününden en çok üç gün sonra bitiyorsa ya da ödeme günü dökümün son gününden sonraysa para henüz yolda olabilir. Raporun o ödemeyle ilgili notu yakın tarihli bir banka satırı göstermiyorsa program böyle bir ödemeyi sorulacak tutara katmaz, bu bölüme de yazmaz. Not bir banka satırı gösteriyorsa ödeme bölümde kalır. Karşılığı görünmeyen her ödemenin altında raporun o ödemeyle ilgili notu da yazar. Metni göndermeden önce bu nota bakın, banka dökümünün ödeme gününü kapsadığından ve paranın başka bir banka hesabına yatmadığından emin olun. Tutarı eksi ya da sıfır olan bir ödeme emri bölümde adıyla geçer ama onun için metin hazırlanmaz. Bu kalemleri platforma sorarsınız. Hangisinde haklı olduğunuza platform karar verir.
- Stopaj çizelgesi: stopajı iki türlü toplar. Birincisi pazar yerinin stopajı kestiği aya, ikincisi ürünün satıldığı aya göredir. Satış ayına göre hesap için ürünlerin KDV oranları gerekir. KDV oranlarını müşteri ayarlarında vermediyseniz bu rakamlar tahminidir ve sayfa bunu belirtir.
- Beyan sağlaması (ön kontrol): program ekstredeki stopaj satırlarından matrahı (stopajın hesaplandığı tutarı) hesaplar ve mali müşavirin beyan ettiği satış rakamının yanına ay ay koyar. Bu rakamlar pazar yerinin bildirimi ya da Gelir İdaresi'nin kaydı değildir. Tablo yalnız ekstre tarafını gösterir, farkın açıklamasını mali müşavir yazar. Sayfanın üstünde karşılaştırmanın sonucu, altında beyan rakamlarını yazacağınız form bulunur. Form iki satırla başlar, "Satır ekle" yeni bir satır açar. Formda yazdığınız rakamlar yalnız o sayfada kullanılır. Çalışma klasörü kullanıyorsanız rakamları müşteri ayarları sayfasına kaydedin. Beyan sayfası onları forma kendiliğinden getirir.
- Mali müşavir paketi (zip): mutabakat raporunun tamamı, stopaj çizelgesi, beyan sağlaması, ekstrede görünen kesinti faturalarının listesi ve raporun CSV dökümleri tek bir zip dosyasında iner. Faturaların kendisi pakette yoktur, yalnız listeleri vardır. Müşterinin satış ve iade faturaları, ürün kârlılığı tablosu, itiraz metinleri ve müşteri paneli de pakete girmez. Paketin açıklama sayfası bunu da belirtir.

Kendi ajansınızı kurmak

Birden çok müşteriyle çalışıyorsanız her müşterinin dosyaları bir çalışma klasöründe durur. Klasörü ve içindeki düzeni program kurar. Siz müşterinin adını yazar, dosyalarını getirirsiniz.

1. Ana sayfadaki "Kendi ajansınız" bölümünde "Çalışma klasörünü oluştur" düğmesine basın. Program kullanıcı klasörünüzde ReconPilot Ajans adlı bir klasör oluşturur (C:\Users\<kullanıcı adınız>\ReconPilot Ajans) ve boş panoyu açar. Klasörün tam yolu düğmenin altında yazar. Klasör başka bir yerde dursun istiyorsanız "Başka bir klasör kullan"ı açın, yolu yazın, "Bu klasör yoksa oluştur" kutusunu işaretleyin ve "Bu klasörü aç"a basın. Program bu kutuyla henüz olmayan ya da boş bir klasörü çalışma klasörü yapar. İçinde başka dosyalar bulunan bir klasörü olduğu gibi bırakır ve yeni ya da boş bir klasörün yolunu ister. Klasör oluşturulduktan sonra ana sayfadaki bölümün adı "Ajans panosu", düğmesi "Panoyu aç" olur.
2. Boş panoda müşterinin adını yazıp "Ekle ve dosyalarını getir"e basın. Sonraki müşteriler için panonun sağ üstündeki "Yeni müşteri" düğmesini kullanın. Ad panoda, raporlarda ve indirilen dosyaların adında görünür. Ad en çok 80 harf olabilir ve şu işaretleri içeremez: < > : " / \ | ? *. Başka bir yerden kopyalanan bir adın içine bazen ekranda görünmeyen işaretler karışır. Program böyle bir adı kabul etmez ve adı klavyeden yeniden yazmanızı ister. Getirdiğiniz bir dosyanın adında böyle bir işaret varsa dosyanın adını elle yeniden yazın, sonra dosyayı yeniden getirin.
3. Açılan "Dosya ekle" sayfasında müşterinin dosyalarını seçin ya da kesik çizgili alana sürükleyip bırakın. Pazar yeri ekstrelerini, ödeme kuruluşu raporlarını ve banka hareketlerini birlikte verebilirsiniz. Birden çok ayın dosyalarını da tek seferde getirebilirsiniz (hepsi birlikte en çok 64 MB). Hangi dosyaların ve hangi tarihlerin alınacağı "Tek bir ayın raporu" bölümünde anlatılıyor. Dosyaları seçer ya da bırakır bırakmaz program onlara bakar ve bir sonraki sayfayı açar, ayrıca bir düğmeye basmanız gerekmez.
4. Program her dosyanın türünü ve ayını dosyanın kendisinden okur ve onu nereye koyacağını bir tabloda gösterir. Okuyamadığı yerde tahmin yürütmez, size sorar. O satırlar tabloda işaretlidir ve yanlarında nedeni yazar. Tabloyu kontrol edin, sorulanları seçin ve "Yerleştir ve ayları işle"ye basın. Bu düğmeye basana kadar klasöre hiçbir şey yazılmaz. Seçim yapmadığınız bir dosya yerleştirilmez. Programın yerini bulduğu bir dosyayı bu sefer koymak istemiyorsanız tür listesinden "Bu dosyayı atla"yı seçin.
5. Program dosyaları ayın klasörüne koyar, o ayları işler ve sonucu gösterir. Tek bir ay işlendiyse o ayın satırındaki "Raporu aç" sizi doğrudan rapora götürür. "Panoya dön" panoyu açar.
6. Yeni bir müşterinin ilk ayında programın sütunları nasıl okuduğuna bir kez bakın. Ayın raporunu açın ve üstündeki "Sütunları düzenle" düğmesine basın. Yanlış okunan bir sütun varsa düzeltin, sayfanın altındaki "Müşteri profili" kutusu işaretli kalsın ve "Mutabakatı çalıştır"a basın. Program tahminden farklı seçtiğiniz sütunları müşterinin profiline kaydeder ve sonraki aylarda kendiliğinden uygular.
7. Sonraki aylarda müşterinin adının yazdığı satırdaki "Dosya ekle"ye basıp yeni ayın dosyalarını getirmeniz yeter.
8. İsterseniz çalışma klasörüne marka.json adlı bir dosya koyun (aşağıda). Program müşteri raporuna, müşteri paneline ve aday müşteriler için hazırladığı ön inceleme sayfasına ajansın adını ve logosunu bu dosyadan alır. Dosya yoksa bu sayfalar ajans adı ve logo olmadan çıkar.

Program dosyanın yerini nasıl bulur

Program bir dosyanın hangi müşteriye ait olduğunu dosyanın içinden okumaz. Dosyayı hangi müşterinin "Dosya ekle" sayfasına getirdiyseniz o müşteriye koyar. Yalnız şunu yakalar: getirdiğiniz dosyanın aynısı başka bir müşterinin işlenmiş bir ayında da duruyorsa onay tablosu bunu o dosyanın satırında ve sayfanın başında söyler. Dosyayı yanlış müşteriye getirdiyseniz bunu orada görürsünüz. Karar yine sizindir, program dosyayı engellemez.

Türü dosyanın sütun başlıklarından okur. Başlıklar tek bir türü gösteriyorsa dosyayı o türe koyar: yalnız Trendyol'un ya da yalnız Hepsiburada'nın kullandığı bir başlık, yalnız iyzico'nun ya da yalnız PayTR'nin kullandığı bir başlık, ya da bir banka dökümünün tarih, açıklama ve tutar sütunları. Başlıklar iki türe de uyuyorsa ya da hiçbirine uymuyorsa türü size sorar.

Ayı satırlardaki tarihlerden okur:
- Pazar yeri ekstresi, satış ve iade satırlarının bulunduğu aya konur. Ödeme ve kesinti satırları sonraki ayın ilk 10 gününe taşabilir.
- Banka dökümü başladığı aya konur. O ayın içinde ya da sonraki ayın ilk 10 günü içinde bitmelidir. Bütün hareketleri bir ayın ilk 10 gününde olan bir döküm o ayın başı da olabilir, önceki ayın devamı da. Program o zaman ayı size sorar.
- Ödeme kuruluşu raporunun bütün satırları tek bir ayda olmalıdır.
Tarihler bu kurallara uymuyorsa ayı size sorar. Program bir dosyayı bölmez: iki ayı kapsayan bir dosyayı bütün olarak sizin seçtiğiniz aya koyar.

Aynı dosyayı ikinci kez getirirseniz klasördeki dosya olduğu gibi kalır. Getirdiğiniz dosyaların hepsi klasörde zaten varsa program bunu tablonun üstünde söyler. Yazılacak bir şey kalmadığı için tabloda seçim kutusu çıkmaz ve sayfada yalnız "Panoya dön" ve "Başka dosya seç" bulunur. Ayın klasöründe aynı adda başka bir dosya varsa program size sorar ve isterseniz yenisini numaralı bir adla ("ekstre (2).xlsx" gibi) eskisinin yanına koyar. Bunu onay tablosunda, dosyanın satırındaki kutuyla sorar. Tabloda o kutu çıkmadıysa dosyayı yazmaz ve aynı soruyu sonuç sayfasında sorar. Program ayı size sorduğunda ya da siz ayı değiştirdiğinizde böyle olabilir. Hiçbir dosyanın üstüne yazmaz. Yazdığı her dosyayı sonra geri okur ve getirdiğinizle karşılaştırır.

Klasörleri kendiniz açmak

Dosyaları Dosya Gezgini'nden de koyabilirsiniz. Bunun iki yolu var. Birincisi müşterinin klasöründeki gelen klasörüdür. Oraya bıraktığınız dosyalar panoda "yerleştirilmeyi bekliyor" diye görünür. Yanındaki "Dosyaları yerleştir" müşterinin "Dosya ekle" sayfasını açar. Oradaki "Bekleyen ... dosyaya bak" düğmesi aynı onay tablosunu getirir. Program yerine koyduğu dosyayı gelen klasöründen kaldırır. Ayın klasöründe aynı içerikte bir dosya zaten duruyorsa gelen klasöründeki kopyayı ayın klasörüne ikinci kez yazmaz, yalnız gelen klasöründen kaldırır. İkinci yol dosyayı doğrudan yerine koymaktır. O zaman klasörleri aşağıdaki adlarla siz açarsınız:

  ReconPilot Ajans\       çalışma klasörü
    marka.json            ajansın adı, logo dosyasının adı ve not (isteğe bağlı)
    logo.png              ajansın logosu (isteğe bağlı)
    musteriler\
      <müşterinin adı>\
        gelen\            yerini programın bulacağı dosyalar (isteğe bağlı)
        2026-10\          bir ay
          pazaryeri\      pazar yeri ekstreleri (isterseniz trendyol\ ve hepsiburada\ alt klasörleriyle)
          odeme\          ödeme kuruluşu raporları (isterseniz iyzico\ ve paytr\ alt klasörleriyle)
          banka\          banka hesap hareketleri
    adaylar\              görüştüğünüz satıcılar (isteğe bağlı, aşağıda "Aday müşteriler")

Ay klasörünün adı yıl, tire ve iki haneli aydır: Ekim 2026 için 2026-10. İçindeki üç klasörün adı küçük harfle ve Türkçe harf kullanılmadan yazılır: pazaryeri, odeme ve banka. Program .xlsx, .xls, .csv, .txt ve .json dosyalarını okur. Bir ayın işlenmesi için banka klasöründe en az bir dosya, pazaryeri ya da odeme klasöründe de en az bir dosya bulunmalıdır. Müşteri iki pazar yerinde satıyorsa dosyalar pazaryeri\trendyol ve pazaryeri\hepsiburada alt klasörlerine konur. Program o zaman dosyanın kimden geldiğini klasörün adından alır. odeme klasöründe iyzico ve paytr alt klasörleri aynı işi görür. "Dosya ekle" dosyaları bu alt klasörlere kendisi koyar. Program yalnız içinde musteriler klasörü bulunan bir klasörü çalışma klasörü olarak açar.

Program işledikçe bu klasörlere kendi dosyalarını da yazar (ozet.json, profil.json gibi). Bunların ne olduğu "Gizlilik" bölümünde anlatılıyor.

marka.json dosyasının içi tek bir satırdır:

  {"ad": "Ajansınızın adı", "logo": "logo.png", "not": "Sorularınız için bize yazın."}

En kolayı bu satırı buradan kopyalayıp Not Defteri'ne yapıştırmak ve yalnız tırnak içindeki adı ve notu değiştirmektir. Tırnak işaretlerini, iki noktaları ve virgülleri olduğu gibi bırakın. "Farklı kaydet" penceresinde dosya adı kutusuna tırnak içinde "marka.json" yazın. Böylece Not Defteri adın sonuna .txt eklemez. Kodlama kutusunda "UTF-8" seçili olsun. Adında BOM geçen seçeneği seçmeyin, program o dosyayı okuyamaz. Logo, marka.json ile aynı klasörde bulunan bir PNG ya da JPEG dosyasıdır (en çok 512 KB, kenarları en çok 4000 piksel). Logo istemiyorsanız "logo.png" yerine "" yazın, yani iki tırnağın arası boş kalsın. Ajansın adı en çok 120, not en çok 600 harf olabilir. marka.json isteğe bağlıdır, ama yazılmışsa doğru olmalıdır. Dosyada bir yanlış varsa (örneğin bir tırnak eksikse ya da ajansın adı boşsa) müşteri raporu, müşteri paneli ve ön inceleme hazırlanmaz. Program o zaman "Müşteri raporu hazırlanamadı: marka.json: ..." gibi bir iletiyle nedenini gösterir. Yazım bozuksa iletide doğru yazılmış bir örnek satır da bulunur. Mutabakat raporu ve pano bundan etkilenmez. Dosyayı düzeltin ya da silin: marka.json yoksa bu sayfalar ajans adı ve logo olmadan hazırlanır.

Ajans panosu

Pano her müşteriyi kendi adının altında, son üç ayıyla gösterir. Daha eski aylar için müşterinin altındaki "Önceki ... ayı göster" bağlantısına basın. Toplam satırı listede görünmeyen ayları da sayar. Müşterinin adının yazdığı satırın sağında "Dosya ekle", "Ayarlar" ve "Müşteri paneli" bulunur. Sekiz ya da daha çok müşteriniz varsa tablonun üstünde ada göre arama kutusu ve "Yalnız açık kalemi olanlar" seçeneği çıkar.

Her ayın satırında durumu yazar: Tamam, İşlendi, Dosya eksik, Durdu, İşlenmedi, "Ayarlar değişti: yeniden işleyin" ya da "Dosyalar değişti: yeniden işleyin". Tamam, ayın işlendiğini ve bakılacak bir kalem kalmadığını söyler. İşlendi durumundaki ay da işlenmiştir, ama bakmanız gereken bir şey vardır: yanında kaç açık ödeme ve kaç sorulacak kalem olduğu yazar. Durdu, programın o ayın bir dosyasını okuyamadığını ya da ayı işlemeyi bıraktığını söyler. Son iki durum, ayın en son işlendiği zamandan beri ayarların ya da dosyaların değiştiğini söyler (aşağıda). Henüz hiç dosyası olmayan bir müşteride ay satırı yerine "Henüz dosya yok" yazar.

Sizden bir şey bekleyen işler panonun başındaki "Sizden beklenenler" kutusunda toplanır: dosyası eksik aylar (hangi dosyanın eksik olduğuyla), duran aylar (nedeniyle) ve gelen klasöründe yerleştirilmeyi bekleyen dosyalar. Kendiliğinden işlemeyi kapattıysanız kutunun ilk satırı kaç ayın işlenmeyi beklediğini de söyler. Her satırın yanında o işin düğmesi bulunur. Programın okumadığı klasör ve dosyalar da aynı kutuda, ayrı bir satırın altında listelenir. Bekleyen bir iş yoksa kutu çıkmaz.

"Bu programla neler hazırlanır" kutusu programın çıkardığı belgeleri dört başlıkta toplar: platforma sorulacaklar, müşteriye gidenler, mali müşavire gidenler ve ajansın kendi işi. Örnek ajansta ve henüz hiçbir ay işlenmemişken açık gelir, sonra kapalı gelir ve yalnız dört başlığı gösterir. Başlığına tıklayınca açılır.

Program panoyu her açtığınızda klasöre bakar ve yeni ya da değişen ayları kendisi işler. Bir ayı şu durumlarda yeniden işler:
- klasörüne dosya eklendiyse, bir dosyası değiştiyse ya da silindiyse,
- müşterinin ayarları ya da kayıtlı sütun seçimleri değiştiyse,
- ay programın başka bir sürümüyle işlendiyse.
Pano açılırken bir dosyanın değişmiş olabileceğini boyutundan ve son değiştirilme zamanından anlar ve o ayı işlemeye alır. İşlerken dosyaların içeriğine bakar ve içerik aynıysa ayı yeniden hesaplamaz. "Bütün ayları işle" ise her ayın dosyalarının içeriğini karşılaştırır. Boyutu ve zamanı aynı kalmış bir değişikliği de o yakalar. Program ne yaptığını sayfanın başında bir satırla söyler. Tablonun altındaki "Programın bu oturumda kendiliğinden yaptıkları" satırı hangi ayları ne zaman işlediğini listeler. Bu liste yalnız program açıkken tutulur, bir dosyaya yazılmaz. Program ayları kendiliğinden yalnız sizin açtığınız çalışma klasöründe işler. İstemiyorsanız tablonun altındaki "Kendiliğinden işlemeyi kapat"a basın. O zaman aylar yalnız siz düğmeye bastığınızda işlenir ve pano kaç ayın değiştiğini yazar. Bu seçim o çalışma klasörü için geçerlidir ve klasördeki pano.json dosyasında durur. Çalışma klasöründe bu adı taşıyan ama programın yazmadığı bir dosya varsa program onu silmez, üstüne de yazmaz. O dosya orada durdukça ayları kendiliğinden işlemez ve seçimi değiştirmek istediğinizde dosyayı başka bir yere taşımanızı ister.

"Bütün ayları işle" düğmesi de yalnız değişen ayları yeniden hesaplar. Dosyaları ve ayarları değişmemiş bir ayın rakamları olduğu gibi kalır ve sayfa kaç ayın bu yüzden yeniden hesaplanmadığını söyler. Bir ayın satırındaki "Yeniden işle" düğmesi ise o ayı her zaman baştan hesaplar. İşlem uzun sürerse pano kaç ayın bittiğini yazar; son durumu "Durumu yenile" ile görürsünüz.

Tablonun sütunları:
- Açık kalan ödeme: raporun başındaki "Açık kalan ödemeler (geç gelenler dahil)" tablosunun dört satırındaki ödemelerin sayısı. Bu dört satır ve raporda her birine giren etiketler şunlardır:
  - "Bankada bulundu ama geç geldi": zamanlama farkı.
  - "Eksik yattı": kısmi ödeme, komisyon oranında eksik, tolerans içinde fark.
  - "Adayı var, kararınızı bekliyor": tek aday, birden çok aday, ekstre tarafında bir ödemeye bağlı çıkan nedeni belirlenemeyen fark ve mükerrer kayıt.
  - "Bu dönemin dosyalarında karşılığı görünmüyor": karşılığı yok.
  Banka tarafında bir banka hareketine bağlı çıkan nedeni belirlenemeyen fark, mükerrer kayıt ve iade ise raporda ayrı bir grupta, "Bankada karşılığı belirlenemeyen hareketler" altında yer alır. Bu grup açık kalana girmez.
- Açık kalan, geç gelenler dahil (TL): bu ödemelerin tutarı. Eksik yatan bir ödemenin yalnız yatmayan kısmı sayılır. Geç de olsa bankaya yatan ödemeler de buradadır.
- Sorulacak kesinti (kalem): kesinti denetiminin platforma sorulmak üzere ayırdığı kalemlerin sayısı.
- Sorulacak tutar (TL): platforma sorulacak tutar, neyin girdiği aşağıdaki listede. Banka dökümü bir ödemenin gününden en çok üç gün sonra bitiyorsa ya da ödeme günü dökümün son gününden sonraysa para henüz yolda olabilir. Raporun notu yakın tarihli bir banka satırı göstermiyorsa program karşılığı görünmeyen böyle bir ödemeyi sorulacak tutara katmaz, açık kalanda bırakır. Onu sonraki ayın banka dosyasında arayın.
Tablonun altındaki "Sütunlar ne anlatıyor?" satırına tıklayınca aynı açıklama açılır.

Üç rakam birbirine karışmasın:
- Açık kalan (pano): bakmanız gereken ödemeler. Geç yatan ödemeler, eksik yatanların yatmayan kısmı, eşleşmesi kararınızı bekleyen ödemeler ve karşılığı görünmeyen ödemeler bunun içindedir. Bu rakam "bu kadar para yatmadı" demek değildir.
- Henüz yatmayan (müşteri raporu ve panel): yatması gereken hakediş eksi bankaya yatan. Geç de olsa yatan para yatmış sayılır. Eşleşmesi kararınızı bekleyen bir ödeme, siz karar verene kadar burada sayılır. Müşteriye "bu kadar para henüz yatmadı" diye söyleyeceğiniz rakam budur.
- Sorulacak tutar (pano ve müşteri sayfaları): platforma sorulacak olan. Eksik yatanların yatmayan kısmı, karşılığı görünmeyen ödemeler ve kesinti denetiminin kalemleri buna girer. Geç gelen ve kararınızı bekleyen ödemeler girmez. Kesinleşmiş bir alacak da değildir.
Raporun özetindeki "aradaki fark" ise toplam beklenen ile raporun 2. bölümünde eşleşen banka hareketleri arasındaki farktır. O da kayıp para anlamına gelmez.

İşlenmiş bir ayın satırındaki "Raporu aç" düğmesi ayı klasördeki şimdiki dosyalarla ve bu müşteri için kaydettiğiniz sütun seçimleriyle yeniden işler ve raporunu açar. Henüz işlenmemiş bir ayda düğmenin adı "Aç"tır ve ay sütun sayfasında açılır. Sütunları değiştirmek için raporun üstündeki "Sütunları düzenle" düğmesini kullanın. Bir ayı bu yollardan biriyle işlediğinizde de o ayın özeti yazılır ve pano onu gösterir. Rakamlar panodakinden farklı çıkarsa rapor bunu en üstte belirtir. Bir istisna var: sütun sayfasında bir seçimi değiştirip "Müşteri profili" kutusunun işaretini kaldırırsanız seçiminiz kaydedilmez ve rapor yalnız o seferlik açılır. Sonuç kayıtlı seçimlerin verdiğinden herhangi bir rakamda ya da kalemde farklıysa panodaki özet değişmez ve rapor bunu en üstte söyler. Pano, karşılaştırma ve müşteri paneli kayıtlı seçimlerin rakamlarını göstermeye devam eder.

Program çoğu durumda ayı kendisi yeniden işler. Kendiliğinden işlemeyi kapattıysanız ya da bir ay işlenemediyse şunlar size kalır:
- Programın önceki bir sürümüyle işlenmiş bir ayın rakamları gösterilmez. Panoda o ay "İşlenmedi" görünür ve yanında "programın önceki bir sürümüyle işlendi; ayı yeniden işleyin" yazar.
- Bir müşterinin anlaşılan oranları, denetim eşikleri ya da kayıtlı sütun seçimleri bir ay işlendikten sonra değişirse panoda o ay "Ayarlar değişti: yeniden işleyin" diye görünür. Bu ayın rakamları gösterilmez ve toplamlara girmez, panonun toplam satırı da kaç ayın toplama girmediğini söyler. Satırdaki "Yeniden işle" düğmesi ayı yeni ayarlarla işler. Müşteri ayarları sayfası da bu ayların adını verir ve yalnız onları yeniden işleyen bir düğme gösterir ("Bu ayı yeniden işle" ya da "Bu ayları yeniden işle"). Ayarlar sayfasını hiçbir değeri değiştirmeden kaydederseniz aylar işaretlenmez. Maliyetler, KDV oranları, beyan rakamları ve itiraz süreleri ise onları kullanan sayfayı (ürün kârlılığı, stopaj çizelgesi, beyan sağlaması, itiraz dosyası) her açtığınızda yeniden okunur. Onlar için ayı yeniden işlemeniz gerekmez.
- Dosyası eksik görünen bir ayda da "Yeniden işle" düğmesi var. Eksik dosyayı "Dosya ekle" ile getirdiğinizde program ayı kendisi işler.
- Bir ayın klasörüne elle yeni bir dosya koyduysanız ya da bir dosyayı değiştirdiyseniz program bunu panoyu açtığınızda görür ve ayı yeniden işler. Kendiliğinden işleme kapalıysa o ay panoda "Dosyalar değişti: yeniden işleyin" diye görünür. Durmuş ya da dosyası eksik görünen bir ay için de böyledir. Bu ayın eski rakamları gösterilmez ve toplamlara girmez. Satırdaki "Yeniden işle"ye ya da "Bütün ayları işle"ye basın.
- Program bir ayı işlediği hâlde özetini klasöre yazamazsa (örneğin klasöre yazma izni yoksa ya da disk dolmuşsa) panonun başında "Şu ayların özeti yazılamadı" diye başlayan bir uyarı çıkar ve ayların adını nedeniyle birlikte verir. Program o ay için "raporu hazır" demez. Uyarı, o ayın özeti yazılana kadar panoda kalır. Özeti kimin yazdığı fark etmez: ayın kendi sayfası ya da komut satırı yazdıysa da uyarı bir sonraki bakışta kalkar. Klasörde kalan özet eski dosyalarla yazılmışsa ayın satırı "Dosyalar değişti: yeniden işleyin" diye görünür ve eski rakamları göstermez. Engeli kaldırın, sonra satırdaki "Yeniden işle"ye ya da "Bütün ayları işle"ye basın.

Rapor ve ondan açılan her sayfa en üstte "Ajans panosu" ile başlayan bir yol gösterir. O bağlantı sizi panoya döndürür. Aynı müşterinin önceki ya da sonraki ayının dosyaları tamsa sayfanın üstünde o ayın adını taşıyan bir bağlantı da çıkar. Çalışma klasöründen açılan bir aydan indirdiğiniz dosyaların adı müşterinin adı ve ayla başlar.

Panodaki "Bu programla neler hazırlanır" kutusunda, "Ajansın kendi işi" başlığı altındaki "Müşterileri karşılaştır" bağlantısı bir ayın müşterilerini yan yana koyar. Bir müşterinin komisyonunun satışa oranı geçen aya göre en az yarım puan değiştiyse (örneğin yüzde 18,0'dan yüzde 18,5'e) karşılaştırma bunu "arttı" ya da "azaldı" diye işaretler. Oran bu kadar arttıysa panodaki satırda o ayın karşılaştırmasına giden bir bağlantı da görünür.

Müşteri raporu

Çalışma klasöründen açılan bir ayın raporunda "Müşteri raporu" düğmesi de vardır. Bu düğme ajansın logosuyla bir müşteri raporu açar. Sayfa dört rakamla başlar: "Yatması gereken (hakediş)", "Bankaya yatan", "Henüz yatmayan" ve "Sorulacak tutar". Henüz yatmayan, yatması gereken tutardan bankaya yatanın çıkarılmasıyla bulunur. Bu rakamın panodaki açık kalandan farkı "Ajans panosu" bölümündeki "Üç rakam" listesinde anlatılıyor. Müşteri raporu ve panel, sorulacak tutarın kesinleşmiş bir alacak olmadığını müşteriye de söyler.

Müşteriye giden sayfalarda ekstrenin işlem türleri satıcının bildiği adlarla görünür, örneğin "Komisyon kesintisi". Ajansın kendi sayfalarında aynı ad önce gelir, yanında parantez içinde pazar yerinin resmî adı ve dosyadaki adı bulunur. Müşteri raporunu PDF olarak kaydetmek için tarayıcının Yazdır penceresini açın (Ctrl+P) ve yazıcı olarak (Chrome'da "Hedef" olarak) "PDF olarak kaydet"i seçin.

Komisyon notları

Trendyol bazen aynı komisyonu hem satış satırının içinde hem ayrı bir komisyon satırında gösterir. İki kayıt aynı tutardaysa program onları tek komisyon sayar, komisyonu bir kez düşer ve bunu raporun başındaki Dikkat notunda söyler. Örnek aydaki "kopya sayıldı" notu budur. Müşteri sayfalarına bundan bir uyarı gitmez.

Bazen de satış satırının komisyon sütununda bir tutar yazar, ama bu tutarın ödemeden ayrıca kesilip kesilmediği dosyalardan anlaşılmaz. Ödeme satırı yoksa ya da ödeme tutarı bunu açıkça göstermiyorsa böyle olur. Program o ödeme emirlerinde siparişin kendi komisyon satırı varsa o satırı, yoksa sütundaki tutarı komisyon sayar. Müşteri raporu, panel ve ön inceleme o zaman "Komisyon rakamı kesin değil" diye başlayan bir not gösterir ve müşteriye ayrıntıyı ajansa sorabileceğini söyler. Ödeme satırı dosyalarda yoksa not, yatması gereken tutarın da aynı varsayımla hesaplandığını ekler. "Müşterileri karşılaştır" sayfası da o ayın komisyon oranının altına "varsayıma dayanıyor" yazar.

Bu notu gördüğünüzde:
1. Ayın raporunu açın. Başındaki Dikkat notu bu durumdaki ödeme emirlerini numaralarıyla listeler.
2. Raporun "Sağlama" bölümüne bakın. Orada komisyon toplamı iki türlü hesaplanmış olarak yazılıdır: sütundaki tutar ödemeden ayrıca kesilmiş sayılırsa ve yalnız komisyon satırları sayılırsa (lisansla).
3. Pazar yerinin panelinde bu ödeme emirlerinden birini açın ve komisyonun ödemeden kaç kez düşüldüğüne bakın.
4. Panelden anlaşılmıyorsa ödemeden neyin kesildiğini pazar yerine sorun. Müşterinize de komisyon rakamının bu yanıta bağlı olduğunu söyleyin.

Müşteri paneli

Panoda her müşterinin adının yazdığı satırda, "Ayarlar" bağlantısının yanında "Müşteri paneli" bulunur. Basınca program o müşterinin son 12 ayını tek bir HTML dosyasına yazar: musteriler\<müşterinin adı>\panel\<müşterinin adı>-panel-<tarih>.html. Dosyanın adı küçük harfle ve Türkçe karakterler olmadan yazılır. Aynı dosyayı açılan sayfadaki "Dosyayı indir" ile de kaydedebilirsiniz. Dosyayı müşterinize siz gönderirsiniz, örneğin e-posta ekiyle. Müşteriniz dosyaya çift tıklar ve dosya tarayıcısında açılır. Müşterinizin bir şey kurmasına ya da anahtar almasına gerek yoktur, dosya internete de bağlanmaz. Örnek ajansta panel geçici klasöre yazılır ve örnek ajansın öbür dosyalarıyla birlikte silinir.

Dosyanın başında ajansın adı ve logosu ile "Aylar bir bakışta" tablosu bulunur. Tabloda her ay bir satırdır: yatması gereken hakediş, bankaya yatan, henüz yatmayan, sorulacak tutar, komisyonun satışa oranı ve iade oranı. Telefon gibi dar bir ekranda her ay alt alta ayrı bir blok olur. Sonra her ayın kendi bölümü gelir ve müşteri raporundaki gibi dört rakamla başlar: yatması gereken hakediş, bankaya yatan, henüz yatmayan ve sorulacak tutar. Altında sorulacak tutarın nasıl oluştuğu, henüz yatmayan ödemeler, eksik yatan ödemeler (beklenen günü, referansı ve yatmayan kısmıyla), geç yatıp hesaba geçen ödemeler, kesintilerde sorulacak kalemler, en çok satan on ürün, satış ayına göre stopaj ve faturaya bağlı tutarlar gelir. Her tablo bir toplam satırıyla biter. Müşterinin anlaştığı oranları verdiyseniz ürün tablosunda anlaşılan oran da görünür. En sonda ajansın notu yer alır. Dosyanın sağ üstünde, programdaki düğmeden ayrı olarak bir "Koyu tema" kutusu vardır. Müşteriniz onu işaretleyince panel koyu renge geçer. Bu seçim hatırlanmaz: dosya her açılışta açık renkte gelir ve yazdırınca açık renkte çıkar. Öbür müşterileriniz, eşikleriniz, Dikkat notları, durma nedenleri, itiraz metinleri ve beyan sağlaması dosyaya girmez. Mali müşavir paketi ayrıdır.

Program paneli hazırlarken ayları yeniden işlemez, her ayın en son işlendiği hâlini kullanır. Şu aylar dosyaya rakamsız girer: işlendikten sonra ayarları ya da dosyaları değişen aylar, durmuş aylar, dosyası eksik aylar ve henüz işlenmemiş aylar. Müşteriniz o ay için yalnız "Bu ayın rakamları henüz hazır değil." cümlesini görür. Nedenini açılan sayfa size bildirir ve "Bu ayları işle" (tek ayda "Bu ayı işle") düğmesini gösterir. İşlem bitince paneli yeniden hazırlayın. Dosyası eksik bir ay bu düğmeye girmez, önce eksik dosyayı panodan "Dosya ekle" ile getirin. Hiçbir ayın rakamı hazır değilse program dosyayı yazmaz ve sayfada "Panel hazırlanmadı" uyarısı çıkar. Panel yalnız lisansla hazırlanır.

Aday müşteriler

Panodaki "Bu programla neler hazırlanır" kutusunda "Ön inceleme (aday müşteriler)" bağlantısı görüştüğünüz satıcıların listesini açar. Yeni bir aday için adını yazıp "Ekle ve dosyalarını getir"e basın ve son bir ile üç ayın ekstresini müşterilerde olduğu gibi getirin. Sonraki dosyalar için adayın satırındaki "Dosya ekle"yi kullanın. Adayların dosyaları çalışma klasöründeki adaylar klasöründe, müşterilerinkiyle aynı düzende durur: adaylar\<satıcının adı>\2026-10\pazaryeri gibi. Dosyalar yerleşince listede adayın satırındaki "Ön inceleme" düğmesine basın. Program adayın klasöründeki en yeni üç ayın (ay klasörlerinin adına göre) dosyalarından, ajansın logosuyla bir ön inceleme sayfası hazırlar. Banka dosyası bu sayfa için isteğe bağlıdır.

Müşteri ayarları

Panoda her müşterinin adının yazdığı satırda bir "Ayarlar" bağlantısı var. Bu sayfada yazdıklarınızı ya da yüklediklerinizi program müşterinin klasöründe, her listeyi kendi dosyasında saklar ve o müşterinin aylarını işlerken kullanır. Hepsi isteğe bağlıdır.
- oranlar.json: müşterinin pazar yeriyle anlaştığı komisyon oranları. Oranları sayfadaki tabloya yazabilir ya da CSV veya Excel dosyası olarak yükleyebilirsiniz. Dosyanın ilk satırında Pazar yeri, Barkod, Oran ve Başlangıç başlıkları bulunur. Başlangıç, oranın geçerli olduğu ilk gündür. İsterseniz Bildirim Günü, Değişiklik Türü ve Süre (gün) sütunlarını da eklersiniz. Pazar yeri sütununa Trendyol ya da Hepsiburada, Oran sütununa yüzdeyi (12,5 gibi), tarih sütunlarına günü 01.10.2026 biçiminde yazın. Değişiklik Türü şu dört değerden biridir: artış, kampanya bitişi, düzenleyici kurum kararı ya da satıcı lehine. Her oran yalnız kendi satırında adı geçen pazar yerinin siparişlerine uygulanır. Bir oranın Değişiklik Türü artışsa ve Bildirim Günü yazılmışsa program, bildirimden sonraki süre dolmadan yeni oranla kesilmiş siparişleri "bildirim süresi sorulacak" diye listeler. Bildirim süresi kontrolü yalnız artış türündeki satırlara uygulanır. Süre sütunu boşsa program bu süreyi 30 gün sayar. Bu, programın başlangıç değeridir. Sözleşmeniz daha uzun bir süre tanıyorsa o süreyi Süre sütununa yazın. Sayfadaki tabloda Barkod kutusuna yazmaya başladığınızda program bu müşterinin işlenmiş aylarındaki barkodları önerir.
- denetim.json: kesinti denetiminin eşikleri ve pazar yeri başına itiraz süresi. İlk üç eşik denetimin hangi kalemleri listeleyeceğini belirler. Birincisi, programın bir ürünün olağan oranını hesaplaması için o ürünün en az kaç satırı olması gerektiğidir. İkincisi, bir oranın olağan sayılması için satırların en az yüzde kaçında görülmesi gerektiğidir. Üçüncüsü listelenecek en küçük farktır (TL). Bu değerleri düşürdükçe daha çok kalem çıkabilir. Dördüncü değer, dönem sonuna yakın iadeler için bir gün sayısıdır: ekstrenin son günlerinde, bu sayı kadar gün içinde yapılan bir iadenin komisyon iadesi sonraki döneme kalabilir. Program o kalemi yine listeler ama yanına bunu not eder. Sayfa başlangıç değerleriyle açılır ve her kutunun altında ne işe yaradığı anlatılır. İtiraz süresini yazarsanız itiraz dosyasında her kalemin yanında kalan gün görünür. İtiraz sayfası ayrıca Trendyol'un satıcı yardım sayfalarında yayımladığı iki süreyi (desi itirazı ve iade yanıtı için) anar. Bu süreler değişebilir, güvenmeden önce Trendyol'un güncel sayfasına bakın. Diğer süreleri sözleşmenize bakarak siz yazarsınız.
- maliyetler.json: ürün maliyetleri. Sütunlar Barkod ve Maliyet, isterseniz bir adedin kargo payı için Kargo.
- kdv.json: KDV oranları. Bütün ürünler için tek bir oran ya da KDV ve Barkod sütunlu bir dosya.
- beyan.json: mali müşavirin beyan ettiği satış rakamları. Beyan sağlaması ve mali müşavir paketi bunları kullanır.
Tutarları ve oranları Türkçe sayı biçimiyle yazın: 1.234,56 ve 12,5.

Çalışma klasöründen açılan bir ayın raporunda "Paketi müşterinin klasörüne yaz" düğmesi de vardır. Bu düğmeye bastığınızda program mali müşavir paketini o ayın klasöründeki musavir-paketi klasörüne yazar. Yeni paket öncekinin yerine geçer.

Kaç müşteriyle denendi

Program şimdiye kadar yalnız örnek ve yapay dosyalarla denendi. Lisans müşteri sayısını sınırlamaz. Programın denendiği en büyük klasörde 200 müşteri vardı. Her müşteride programla gelen örnek ayın dört dosyası bulunuyordu, müşteri ayarı (oran, maliyet ya da KDV listesi) yoktu. Bütün ayların işlenmesi bir dizüstü bilgisayarda 2 saniye kadar sürdü. Her müşteriye üç ay konduğunda (toplam 600 ay) işlem 6-7 saniye sürdü. Ama örnek ayın dosyaları küçüktür ve ölçüm yalnız bu ayla yapıldı. Bütün aylar işlendikten sonra pano ilk açılışta her zamankinden geç gelebilir, çünkü Windows'un virüs taraması yeni yazılan özet dosyalarını ilk okunuşta denetler. 30 müşterinin 12'şer ayıyla yapılan ölçümde bu ilk açılış bir saniyeye yakın sürdü, sonraki açılışlar saniyenin beşte birini geçmedi.

Bir dosya bozuksa ya da tek bir ayın verisi için fazla büyükse program o ayın işlenmesini durdurur ve nedenini yazar. Bu üç durumda olur:
- bir Excel hücresindeki metin 32.767 karakteri (Excel'in kendi sınırı) aşıyorsa,
- bir sayfanın hücrelerindeki metin toplamda 256 MB'ı geçiyorsa,
- ayın dosyalarındaki beklenen ödeme sayısı ile pazar yerinin ya da ödeme kuruluşunun adının geçtiği banka satırı sayısı çarpıldığında sonuç 100 milyonu aşıyorsa (örneğin ikisinden de on binden fazla varsa). Gönderen adı tanınmayan banka girişleri için bu sınır 5 milyardır.
Bir satıcının bir aylık dosyaları bu sınırların çok altında kalır. Öbür müşterilerin ayları işlenmeye devam eder.

Program bir sütunu tanırken başlığının ilk 200 karakterine bakar. Aradığı ad daha sonra geliyorsa sütunu tanımaz. Böyle bir sütunu sütun sayfasında elle seçersiniz.

Lisans ve deneme anahtarı

Lisans olmadan program kendi dosyalarınızda kaç ödemenin eşleştiğini ve kaç kalemin açıklama beklediğini, bir de ilk kalemi gösterir. Tutarlar, kalemlerin geri kalanı ve CSV dökümleri lisansla açılır. Örnek ay her zaman tamdır. Programı satın almadan önce kendi dosyalarınızla tam denemek isterseniz makine kodunuzu yazıp birkaç günlük bir deneme anahtarı isteyin. Deneme anahtarı da bir lisans anahtarıdır, yalnız son günü yakındır ve aynı kutuya yapıştırılır. Ana sayfanın "Lisans" bölümünde bu bilgisayarın makine kodu ve lisansın nereden alınacağı yazılıdır. Lisans alırken bu kodu bildirirsiniz ve anahtar yalnız bu bilgisayarda çalışır. Anahtarı aynı bölümdeki kutuya yapıştırıp "Anahtarı kaydet"e basın. Anahtarı kaydettiğinizde zip'teki LISANS-KOSULLARI.txt dosyasında yazan koşulları kabul etmiş olursunuz. Çalışma klasörü kullanıyorsanız panoyu açın: program, lisans yokken tutarsız işlediği ayları yeniden işler ve tutarlar görünür. Kendiliğinden işlemeyi kapattıysanız "Bütün ayları işle"ye basın. Anahtar bu bilgisayarda %AppData%\ReconPilotTR\lisans.txt dosyasında saklanır. Bilgisayar değişirse ya da Windows yeniden kurulursa makine kodu da değişir. Yeni kodu bildirdiğinizde aynı bitiş tarihiyle yeni anahtar ücretsiz gönderilir. Anahtarın son günü "Lisans" bölümünde görünür. Son 30 günde ana sayfa kalan günü gösterir. Son günden sonra program, lisans yokmuş gibi özet sayılarla ve ilk kalemle çalışır. Program lisanssız kullanımda ve deneme anahtarıyla olduğu gibi (bugünkü hâliyle) verilir. Rapor kontrolü kolaylaştırır, kayıt ve beyan kararı ise sizindir.

Yedek

Çalışma klasörünü düzenli olarak yedekleyin. İçinde yalnız indirdiğiniz dosyalar yok: müşteri ayarlarına elle yazdığınız anlaşılan oranlar, maliyetler ve beyan rakamları da orada durur ve klasör kaybolursa geri gelmez. Yedek için klasörü kopyalamanız yeter. Program kapalıyken, Dosya Gezgini'nde çalışma klasörünü harici bir diske ya da başka bir klasöre kopyalayın. Geri yüklerken kopyayı yerine koyup panoyu açın. Kopyalama sırasında dosyaların tarihi değişmiş olabilir. Program o zaman dosyaların içeriğini karşılaştırır ve içerik aynıysa rakamları olduğu gibi bırakır, ayları yeniden hesaplamaz. Kendiliğinden işleme kapalıysa aylar önce "Dosyalar değişti: yeniden işleyin" diye görünür. "Bütün ayları işle"ye bastığınızda aynı karşılaştırma yapılır ve rakamlar geri gelir. Yedeği bir bulut hizmetine koyarsanız müşterilerinizin dosyaları bilgisayarınızın dışına çıkar. Bu karar sizindir.

Güncelleme ve kaldırma

Yeni sürüm geldiğinde eski reconpilot-tr.exe dosyasının yerine yenisini koymanız yeter. Lisans anahtarı olduğu yerde kalır. Programı kaldırmak için exe dosyasını ve %AppData%\ReconPilotTR klasörünü silin. Bu klasörü bulmak için Dosya Gezgini'nin adres çubuğuna %AppData% yazıp Enter'a basın. Program Windows kayıt defterine bir şey yazmaz.

Gizlilik

Dosyalar yalnız bu bilgisayarda işlenir. Program internete bağlanmaz ve kendiliğinden kimseye bir şey göndermez. Ayları kendiliğinden işlemesi de bu bilgisayarda, çalışma klasörünün içinde olur.

Dosyaları ana sayfada seçip yüklediğinizde program onları yalnız bellekte işler ve diske yazmaz. Bu yolla eklediğiniz oran ve maliyet listeleri de hiçbir yere yazılmaz.

Bir çalışma klasörü kullandığınızda program müşteri dosyalarından ürettiklerini yalnız o klasöre yazar ve ajansın adını ve logosunu oradaki marka.json dosyasından okur. Klasöre yazdıkları şunlar:
- Klasörler: çalışma klasörünü siz istediğinizde program oluşturur. Bunu "Çalışma klasörünü oluştur" ile kullanıcı klasörünüzde ReconPilot Ajans adıyla ya da sizin yazdığınız yolda yapar. Müşteri eklediğinizde müşterinin klasörünü ve içindeki gelen klasörünü, dosya yerleştirdiğinizde ayın ve dosya türünün klasörlerini açar. İlk aday müşteriyi eklediğinizde adaylar klasörünü, her aday için de kendi klasörünü ve içindeki gelen klasörünü açar.
- "Dosya ekle" ile getirdiğiniz dosyalar: onay tablosunun altındaki düğmeye bastığınızda program onları müşterinin ay klasörüne, getirdiğiniz hâliyle yazar. O zamana kadar dosyalar yalnız bellekte durur. Vazgeçerseniz ya da programı kapatırsanız hiçbir yere yazılmaz. gelen klasörüne koyduğunuz bir dosyayı yerine yazdıktan sonra o klasörden kaldırır. Ayın klasöründe aynı içerikte bir dosya zaten varsa gelen klasöründeki kopyayı ikinci kez yazmaz, yalnız gelen klasöründen kaldırır.
- pano.json: kendiliğinden işlemeyi kapattığınızda çalışma klasörüne yazılır ve yalnız bu seçimi taşır. Kendiliğinden işlemeyi yeniden açtığınızda program dosyayı siler. Bu adı taşıyan ama programın yazmadığı bir dosyayı silmez ve değiştirmez.
- ozet.json: her müşterinin her ayı için bir özet. Özette raporun rakamları ve açık kalan kalemlerin listesi bulunur, dosyalarınızın kendisi bulunmaz. Ama notlar dosyalardan alıntı taşıyabilir, örneğin bir banka açıklamasındaki gönderen adını. Özet, ay işlendiğinde yazılır: program panoyu açarken ya da dosya yerleştirirken ayı kendisi işlediğinde, panodaki "Bütün ayları işle" ile, komut satırında -klasor ile (aşağıda "Komut satırı") ya da ay kendi raporundan işlendiğinde. Ayrıntısı şöyle:
  - ayın durumu ve işlendiği zaman,
  - okunan her dosyanın türü, adı, bulunduğu alt klasör, kimden geldiği, çalışma sayfası, satır sayısı, boyutu, son değiştirilme zamanı ve SHA-256 değeri (dosyanın parmak izi),
  - raporun rakamları: toplamlar, açık kalan ödemelerin dört satırındaki ödemelerin sayısı ve tutarı, ekstrenin tür başına satır sayıları ve tutarları, banka dosyası biterken beklenen ödemelerin sayısı ve tutarı ve komisyon toplamı,
  - açık kalemler (referans, karşı taraf, tarih, tutar, fark ve notla),
  - kesinti denetiminin kalemleri (sipariş numarası, ürün kodu, tutar, karşılaştırma ölçüsü, dosya ve satırla). Karşılaştırma ölçüsü, kalemin karşılaştırıldığı oran ya da tutardır.
  - ayın ürün barkodları, ayarlar sayfası barkod önerebilsin diye,
  - raporun Dikkat notları ve kapsam uyarısı (banka dosyası kısa kaldığında raporun eklediği not), müşterinin kayıtlı seçimleriyle ilgili notlar ve ay durduysa durma nedeni,
  - müşteri ayarlarının parmak izi. Bu iz, ay işlendikten sonra ayarların değişip değişmediğini anlamak içindir ve rakam ya da dosya içeriği taşımaz.
  - özeti yazan program dosyasının parmak izi. Program güncellenince hangi ayları yeniden işleyeceğini bundan anlar.
  Lisans yoksa özet tutarları içermez, yalnız sayıları ve ilk kalemi tutar.
- profil.json: müşterinin profili. Bir ayı sütun sayfasından çalıştırdığınızda, sayfanın altındaki "Müşteri profili" bölümünde kutu işaretliyse yazılır. İçinde sütun başlıkları, programın tahmininden farklı yaptığınız seçimler, bazı dosya ve çalışma sayfası adları ve banka açıklamasında aranacak kelimeler bulunur. Bankanın verdiği dosya adında hesap numarası varsa profile yazılan dosya adında da o numara bulunur.
- Müşteri ayarları sayfasında yazdığınız ya da yüklediğiniz listeler: müşterinin anlaştığı komisyon oranları ve bildirim günleri (oranlar.json), denetim eşikleri ve itiraz süreleri (denetim.json), ürün maliyetleri (maliyetler.json), KDV oranları (kdv.json) ve beyan sağlaması için yazdığınız beyan rakamları (beyan.json).
- musavir-paketi: bir ayın raporunda "Paketi müşterinin klasörüne yaz" düğmesine bastığınızda program mali müşavir paketini o ayın klasöründeki musavir-paketi klasörüne yazar. Yeni paket öncekinin yerine geçer, sayfada da bu belirtilir. Program yazdığı dosyaların listesini aynı klasörde .paket-dosyalari.json adlı bir dosyada tutar. Yeni paketi yazarken yalnız bu listedeki dosyaları değiştirir ya da siler. Klasöre sizin koyduğunuz dosyalar yerinde kalır. Pakette mutabakat raporunun tamamı, stopaj çizelgesi, beyan sağlaması, ekstrede görünen kesinti faturalarının listesi ve ekstre ile banka satırlarından alınmış CSV dökümleri bulunur. Bu dökümlerde sipariş ve ödeme emri numaraları, tutarlar ve banka açıklamaları (bankanın yazdığı gönderen adları dahil) yer alır. Raporda, programın okuduğu dosyaların adları da geçer. Bankanın verdiği dosya adında hesap numarası varsa o numara da pakete girer. Raporun başında lisans sahibinin adı yazar.
- panel: müşteri panelini hazırladığınızda müşterinin klasöründeki panel klasörüne tek bir HTML dosyası yazılır. Dosyada o müşterinin aylarına ait rakamlar, sipariş ve ürün kodları, ajansın adı, logosu ve notu bulunur. Altında lisans sahibinin adı yazar. Bu dosyayı müşterinize siz gönderirsiniz.

Lisans sahibinin adı mutabakat raporunun başında, müşteri raporunun ve ön incelemenin de altında yazar. Bu sayfaları yazdırdığınızda ya da dosya olarak birine gönderdiğinizde ad da onlarla birlikte gider.

Örnek ajansı açtığınızda program örnek dosyaları bilgisayarın geçici klasöründe yeni bir klasöre yazar ve örnekle yapılan işlerin özetlerini, paketlerini ve panellerini de oraya koyar. Bu klasörü "Programı kapat" düğmesiyle çıkınca siler, pencere kapatılarak çıkıldıysa bir sonraki açılışta siler.

Çalışma klasörünün dışında program bilgisayara yalnız şunları yazar. Kaydettiğiniz lisans anahtarını (içinde lisans sahibinin adı vardır) %AppData%\ReconPilotTR\lisans.txt dosyasına yazar. Komut satırında tek bir ayın raporunu aldığınızda program istediğiniz rapor dosyasını da yazar. Sayfalardan indirdiğiniz rapor ve CSV dosyaları tarayıcının kaydettiği yere iner. Seçtiğiniz temayı (açık ya da koyu) tarayıcınız tema adlı bir çerezde tutar.

Programın her sayfasının altındaki "Program bu bilgisayara neleri yazar?" satırına tıklayınca bu bölümün kısa bir özeti açılır.

Programda kullanılan açık kaynak bileşenlerin (Go standart kütüphanesi, MIT lisanslı eşleştirme motoru) lisans metinleri zip'teki LISANSLAR.txt dosyasındadır. Programın lisans koşulları LISANS-KOSULLARI.txt dosyasında, lisans ve deneme anahtarı için verdiğiniz bilgilerle ilgili aydınlatma metni AYDINLATMA.txt dosyasındadır.

Komut satırı

Programı komut satırından da kullanabilirsiniz. Panodaki "Bütün ayları işle" düğmesinin işini reconpilot-tr.exe -klasor "C:\Users\...\ReconPilot Ajans" yapar. Tırnakların arasına çalışma klasörünün yolunu yazın. Yol panonun başında, "Çalışma klasörü" sözünden sonra yazar. Komut da dosyaları ve ayarları değişmemiş ayları yeniden hesaplamaz. Bir müşterinin panelini reconpilot-tr.exe -klasor "C:\Users\...\ReconPilot Ajans" -musteri-paneli "Müşteri Adı" hazırlar. Hiçbir ayın rakamı hazır değilse komut satırı da dosya yazmaz ve ayları nedenleriyle birlikte listeler.

Kısa sözlük

- Ödeme emri: pazar yerinin tek seferde bankaya gönderdiği ödeme ve onu oluşturan satış, iade ve kesinti satırları. Bankaya yatan para bu ödemenin karşılığıdır.
- Kesinti denetimi: programın ekstredeki komisyon ve kargo kesintilerini kontrol ettiği kısım. Bulduklarını itiraz dosyasına koyar.
- Stopaj: pazar yerinin satıcıya ödeme yaparken kestiği vergi (e-ticaret stopajı). Ekstrede ayrı satırlarda görünür. Program matrahı hesaplarken kendi oran tablosunu kullanır. Tabloda, 9284 sayılı Cumhurbaşkanı Kararı ile 1 Ocak 2025'ten beri geçerli olan %1 oranı vardır. Stopaj çizelgesi, kullandığı oranı dayanağıyla birlikte gösterir. Oran yeni bir kararla değişirse programın yeni sürümü gerekir.
- Matrah: stopajın hesaplandığı tutar. Program onu ekstredeki stopaj satırlarından hesaplar.
- Beyan sağlaması: ekstreden hesaplanan matrahın mali müşavirin beyan ettiği rakamla yan yana konduğu ön kontrol.
- Mahsup: kesilen stopajın beyannamede ödenecek vergiden düşülen kısmı. Beyan sağlaması sayfasında "Son beyannamede mahsup edilen stopaj" kutusunda geçer.
- Mutabakat: pazar yerinin ve ödeme kuruluşunun ödediğini bildirdiği tutarların bankaya yatanlarla karşılaştırılması.
- Eşik: kesinti denetiminin bir farkı listelemesi için gereken en küçük değerler. Müşteri ayarları sayfasında bulunur.
- Puan: yüzde puanı. Yüzde 18,0'dan yüzde 18,5'e çıkan bir oran yarım puan artmıştır.
- Tolerans: banka açıklamasında referansı geçen bir ödemede tutar binde 5'e kadar (50.000 TL'lik bir ödemede 250 TL'ye kadar) farklı olsa da program ödemeyi eşleştirir. Ama farkı açıklama isteyen kalemler arasına "tolerans içinde fark" diye ayrıca yazar. Etiketin adı farkın önemsiz olduğunu söylemez: örnek ayda 9002 numaralı ödeme bu etiketle 150,00 TL eksik yatmıştır, raporda "Eksik yattı" satırındadır ve yatmayan kısım sorulacak tutara girer.
- Faturaya bağlı alacaklar (panelde "Faturaya bağlı tutarlar"): platformun üstlendiği indirim ve kupon bedelleri ile iade ve tazmin tutarları. Platform bunları ancak satıcı ona fatura kesince öder. Satıcının bu faturaları kesip kesmediğine bakın. Rapor onları "Kesinti denetimi: sorulacak kalemler" bölümünde ayrı bir tabloda gösterir.
- JSON: pazar yerlerinin ve ödeme kuruluşlarının API ile verdiği bir dosya biçimi. Program onu okur, sizin açıp düzenlemeniz gerekmez.
- API: pazar yerinin ya da ödeme kuruluşunun, verileri bir yazılımın otomatik olarak çekebileceği biçimde verdiği bağlantı.

Bir dosya okunmazsa

Bir dosya okunmazsa ya da sonuç tuhaf görünürse atilgandev@gmail.com adresine yazın. Dosyanın kendisini ya da bir parçasını göndermeyin. Program okuyamadığı bir dosya için ana sayfada ya da sütun sayfasında, hata mesajının altında bir "Destek için tanılama notu" gösterir. Not dosyanın hangi kutudan yüklendiğini, kaynağını, türünü ve tarihini, sütun sayfasında da bulunamayan alanların adını taşır. Dosyanın adı ve içeriği notta yoktur. Notu seçip kopyalayın ve e-postanıza yapıştırın. Sonuç tuhafsa ödemenin numarasını ve neyi tuhaf bulduğunuzu kendi sözlerinizle yazın.
