Epin Yazılım Toplu Ürün İçe Aktarma: Bin Satırlık Dosyayı Panele Yüklemeden Önce Kimsenin Sana Söylemediği Hazırlık Adımlarını Anlatıyorum

Toplu ürün aktarma çoğu kişinin kafasında tek bir görüntüyle yaşar: dosyayı seç, yükle butonuna bas, bin ürün panelde. Gerçekte olan şey ise şu: dosyayı yükle, iki yüz ürün eksik alanla gelsin, üç yüzü çift kaydolsun, fiyatlar virgül yüzünden ondalık kaysın ve sen gece boyunca elle düzeltmeye çalış. Aktarma zor değildir; hazırlıksız aktarma yıkıcıdır.

Bu ayrımı bir kez yaşayan herkes aynı sonuca varır: işin yüzde doksanı dosyanın kendisinde biter, panelde sadece yüzde onu olur. Bu yazıda bir e-pin satış scripti üzerinde toplu aktarmanın gerçek sırasını, dosyayı hangi kurallara göre hazırlayacağını, güncelleme anahtarının neden her şeyden önemli olduğunu ve yanlış giderse nasıl geri döneceğini anlatıyorum.

Dosyayı Hazırlamadan Yüklemek Neden Her Zaman Pahalıya Gelir?

Toplu aktarma araçları itaatkârdır: ne verirsen onu yazar. Dosyada ürün adı iki farklı biçimde yazılmışsa iki ayrı ürün oluşturur. Fiyat sütununda binlik ayracı varsa sayıyı yanlış okur. Kategori adı tedarikçinin dilinde kalmışsa vitrinde tedarikçinin dili görünür. Araç hata yapmaz, senin dosyandaki tutarsızlığı büyütür.

Bu yüzden ilk iş dosyayı normalize etmektir. Ürün adlarını tek kalıba çek, fiyatları sade ondalık biçimine indir, kategori sütununu kendi vitrin adlandırmana çevir, boş hücreleri belirgin bir işaretle doldur ki hangisinin gerçekten boş olduğunu görebilsin. Bunları yapmadan aktaran her işletme, tasarruf ettiğini sandığı bir saati temizlik için iki gün olarak geri öder.

İkinci nokta kodlama ve ayraç. Türkçe karakterli bir dosyayı yanlış kodlamayla kaydettiğinde ürün adları bozuk görünür ve düzeltmek için bin satırı tek tek gezersin. Dosyayı kaydederken kodlamayı ve sütun ayracını bilinçli seçmek, aktarmanın en sıkıcı ama en kârlı adımıdır.

Sütunları Panelin Alanlarıyla Nasıl Eşleştirmelisin?

Her epin yazılım panelinin beklediği alan kümesi biraz farklıdır ama mantık aynıdır: aktarma dosyasının her sütunu panelde bir alana karşılık gelmeli, karşılığı olmayan sütun bilgi değil gürültüdür. Bu yüzden aktarma öncesi küçük bir eşleme tablosu çıkar: solda dosya sütunu, sağda panel alanı. Karşılığı bulunmayan sütunları ya sil ya da not alanına birleştir.

Eşlemede en çok atlanan üç alan şunlar: maliyet, teslimat tipi ve stok kaynağı. Tedarikçi dosyaları genelde ad, fiyat ve miktar verir; operasyonu ayakta tutan alanlar dosyada yoktur. Bunları dosyaya sen eklemelisin, aksi halde bin ürün panele girer ama hiçbiri satılabilir durumda olmaz.

Bir de sıralama ve görünürlük alanları var. Aktarmada tüm ürünleri doğrudan yayına almak yerine pasif durumda içe almak, sonra kontrol edip gruplar hâlinde açmak en güvenli yöntemdir. Vitrin yarım veriyle dolmaz, sen de düzeltmeleri sakin yaparsın.

Güncelleme Anahtarı Neden Tüm İşin Kalbi?

Toplu aktarmanın gerçek testi ikinci yüklemedir. İlk yükleme herkeste çalışır. İkinci yüklemede sistem şu soruyu sorar: bu satır yeni bir ürün mü, yoksa var olan bir ürünün güncellenmiş hâli mi? Bu soruyu cevaplayan şey tekil anahtardır.

Anahtarı ürün adı yapmak en yaygın ve en tehlikeli tercihtir, çünkü ürün adları değişir. Tedarikçi adlandırmayı değiştirir, sen başlığı iyileştirirsin ve bir sonraki aktarmada sistem aynı ürünü ikinci kez oluşturur. Doğru yaklaşım sabit bir kod sütunu kullanmaktır; bu kod bir kez atanır ve asla değişmez.

Anahtar doğru kurulduğunda toplu aktarma bambaşka bir araca dönüşür: artık sadece ürün eklemez, fiyat ve stok güncelleme motoru olur. Tedarikçi listesi geldiğinde dosyayı aynı anahtarla yüklersin, sistem mevcut satırları günceller, yeni olanları ekler. Toplu aktarmanın gerçek değeri ilk kurulumda değil, her hafta yaptığın rutin güncellemededir. Bu rutini destekleyen alan yapısını özellikler bölümünde inceleyebilirsin.

Deneme Yüklemesini Atlamak Neden Bu Kadar Riskli?

Bin satırlık dosyayı doğrudan yüklemek, test etmediğin bir kodu doğrudan yayına almak gibidir. Doğru yöntem şu: dosyadan yirmi satırlık temsili bir örnek ayır. Bu örneğe en basit ürünü, en karmaşık ürünü, Türkçe karakterli bir adı, ondalıklı bir fiyatı ve boş alan içeren bir satırı bilerek koy.

Bu yirmi satırı yükle, panelde tek tek kontrol et. Ad doğru mu, fiyat doğru mu, kategori doğru yere düştü mü, maliyet göründü mü? Sonra aynı yirmi satırı küçük bir değişiklikle tekrar yükle ve çift kayıt oluşup oluşmadığına bak. Bu ikinci yükleme anahtar testidir ve bir dijital ürün satış yazılımı değerlendirirken yapacağın en bilgilendirici denemedir.

Deneme başarılıysa tam dosyaya geçebilirsin. Ama tam dosyayı da tek parça yüklemek yerine ikiye üçe bölmeyi öneririm. Bir dilim hatalıysa sadece o dilimi geri alırsın; bin satırın tamamını temizlemek zorunda kalmazsın.

Yanlış Giderse Geri Dönüş Planın Ne?

Hazırlıklı bir aktarmanın ayırt edici özelliği geri dönüş planıdır. Üç noktada yedek al: aktarmadan hemen önce veritabanı yedeği, aktarma dosyasının kendisinin kopyası ve aktarma sonrası oluşan ürün listesinin dışa aktarımı. Bu üçü elinde varsa hiçbir hata kalıcı değildir.

Geri dönüşte iki yol var. Küçük hatalarda düzeltmeyi yine toplu aktarmayla yaparsın: aynı anahtarla düzeltilmiş dosyayı yükler, üstüne yazarsın. Büyük hatalarda ise parti etiketiyle ürünleri topluca pasife alıp silersin, ardından temizlenmiş dosyayla baştan başlarsın.

Bir uyarı: sipariş almış ürünleri silmek yerine pasife almak her zaman doğru tercihtir. Satış geçmişi olan kaydı silmek raporlarında boşluk bırakır ve o boşluğu sonradan doldurmanın yolu yoktur.

Aktarma Bittikten Sonra Hangi Beş Kontrolü Yapmalısın?

Aktarma bitince iş bitmez; doğrulama başlar. İlk kontrol sayımdır: dosyadaki satır sayısı ile paneldeki ürün sayısı örtüşüyor mu? Fark varsa hangi satırların düştüğünü bulmak, üç gün sonra bulmaktan çok daha kolaydır.

İkincisi fiyat aralığı kontrolü. Ürün listesini fiyata göre sırala, en yüksek ve en düşük beş kaydı gözden geçir. Ondalık kaymaları her zaman bu iki uçta yakalanır. Üçüncüsü maliyet boşluğu kontrolü, dördüncüsü kategori listesinde kopya ad taraması, beşincisi ise gerçek bir test satışı.

Bu beş kontrolü rutine bağladığında toplu aktarma korkulacak bir işlem olmaktan çıkar ve haftalık bakım işine dönüşür. Bir e-pin scripti ile yüzlerce ürünü sürdürülebilir biçimde yönetmenin sırrı sihirli bir düğme değil, tekrarlanabilir bu kısa listedir. Kaç ürün ve kaç aktarma hacmiyle çalışacağına göre uygun paketi fiyat sayfasında görebilir, kurulumu panel üzerinden başlatabilirsin.

Toplu aktarma, hazırlığını yapan işletme için bir gün kazandıran araç; yapmayan için bir hafta kaybettiren tuzaktır. Kendi dosya biçimini denemek ve eşleme ekranını görmek istersen canlı demo panelinde yirmi satırlık bir örnek dosyayla başla; anahtar mantığını ilk ikinci yüklemede net biçimde göreceksin.