Pinabi API Entegrasyonu Kurarken Kimsenin Anlatmadığı Ürün Eşleme Sırrı: Otomatik Fiyat Güncellemeyi Kâr Marjını Yakmadan Nasıl Kurarsın?

Çoğu satıcı tedarikçi API entegrasyonunu "anahtarı gir, ürünler dökülsün" işi sanır. Panelde bir alan var, oraya token yazılır, bir düğmeye basılır ve yüzlerce ürün listeye iner. Teknik olarak gerçekten böyle başlar. Ama entegrasyonun işe yaradığı yer bağlantının kurulduğu an değil, o ürünlerin senin katalogundaki karşılıklarıyla doğru eşleştiği ve fiyatların sen uyumadan güncellendiği andır. Aradaki fark, birkaç yüz liralık bir hata ile aylık binlerce liralık sessiz kayıp arasındaki farktır.

Pinabi gibi bir toptan e-pin sağlayıcısıyla çalışırken asıl mesele şu: onların ürün kodları, isimlendirmesi, para birimi ve fiyat mantığı senin vitrininle birebir örtüşmez. Bir tarafta "PUBG 60 UC (Global)" varken senin sitende "PUBG Mobile 60 UC" yazıyordur. Bir tarafta fiyat dolar bazlıdır, senin vitrininde lira. Bu yazıda bir e-pin satış scripti üzerinde ürün eşlemeyi nasıl disiplinli kuracağını, otomatik fiyat güncellemeyi hangi kurallarla sınırlayacağını ve canlıya geçmeden önce hangi provayı yapacağını anlatıyorum.

Entegrasyon "bağlandı" demek değildir, "eşleşti" demektir

Bir API entegrasyonunun üç ayrı katmanı var: kimlik doğrulama, veri eşleme ve iş kuralları. Birincisi en kolayı; anahtar, gizli anahtar ve uç nokta adresleri doğruysa bağlantı kurulur. İkincisi el emeği ister. Üçüncüsü ise senin işletme kararlarını koda çevirir: hangi üründe kaç puan kâr, hangi kategoride kaça kadar indirim, hangi durumda satışı kapat.

Bu üç katmanı birbirinden ayırmadığın zaman şu olur: tedarikçi bir ürünün adını değiştirir, senin sistemin onu yeni ürün sayar, vitrinde aynı ürün iki kez görünür ve biri yanlış fiyattan satılır. Bu yüzden iyi bir dijital ürün satış yazılımı eşlemeyi ürün adına değil, değişmeyen bir tedarikçi kimliğine bağlar. Pinova'da her vitrin ürününün altında ayrı bir tedarikçi eşleme kaydı tutulur; ad değişse bile bağ kopmaz.

Ürün eşleme neden manuel bir tabloyla başlamak zorunda?

Otomatik eşleme cazip görünür: isim benzerliğine bakan bir algoritma yazarsın, yüzde doksanını tutturur. Sorun kalan yüzde onda. "100 Elmas" ile "110 Elmas (Bonus)" arasındaki isim benzerliği çok yüksektir ama maliyet farkı gerçektir. Bir kez yanlış eşleşen ürün, düzeltilene kadar her satışta zarar yazar.

Doğru yöntem şu: ilk kurulumda otomatik öneri motorunu öneri olarak kullan, onayı insan versin. Eşleme tablona en az dört alan koy: tedarikçi ürün kimliği, tedarikçi ürün adı (referans için), kendi ürün kimliğin ve eşlemeyi kimin ne zaman onayladığı. Dördüncü alan gereksiz görünür; altı ay sonra bir fiyat tutarsızlığını araştırdığında en çok ona bakacaksın. Bir e-pin scripti üzerinde bu tabloyu düzgün kurmak bir günlük iştir ve yıllarca geri ödeme yapar.

Otomatik fiyat güncelleme: marjı koruyan kural motoru nasıl kurulur?

Ham mantık basit: maliyet gelir, üzerine marj eklenir, satış fiyatı yazılır. Gerçek hayatta bu formülün üç koruması olmalı. Birincisi alt sınır: hiçbir ürün belirlediğin taban fiyatın altına inmesin, tedarikçi hatalı fiyat gönderse bile. İkincisi üst sapma denetimi: yeni fiyat eski fiyattan yüzde belli bir oranın üzerinde saparsa otomatik yazma, onaya düşür. Üçüncüsü sıfır maliyet reddi: maliyet 0 veya boş geliyorsa fiyat güncellenmez, ürün satıştan çekilir.

Bu üç korumayı koymayan her otomasyon, tedarikçi tarafındaki tek bir veri hatasını doğrudan vitrinine taşır. Sektörde en çok anlatılan hikâyeler, API'den yanlışlıkla kuruş bazında gelen fiyatın lira olarak yazılmasıyla yaşanan gece boyu zararlardır. Sapma denetimi bu senaryoyu bir onay bildirimine dönüştürür. Kural motoru tarafını incelerken tam olarak bu üç eşiğin ayarlanabilir olup olmadığına bak.

Kur dalgalanması ve yuvarlama: üç kuruşun aylık kayba dönüşmesi

Maliyeti dövizle alıyorsan, satış fiyatın her gün değişen bir zemine oturuyor demektir. Burada iki karar vermen gerek. Birincisi kur kaynağı: merkez bankası, serbest piyasa ya da tedarikçinin kendi kuru. İkincisi tampon: kuru olduğu gibi mi kullanacaksın, yoksa üzerine yüzde bir iki ekleyip gün içi dalgalanmaya karşı kendini mi koruyacaksın? Tampon koymayan satıcılar, kurun sıçradığı günlerde eski fiyatla satmaya devam eder ve farkı kendi cebinden öder.

Yuvarlama ise psikolojiyle muhasebenin kesiştiği yer. 47,63 TL yerine 49,90 TL yazmak dönüşümü artırır ama yuvarlamayı her zaman yukarı yapman gerekir; aşağı yuvarlama küçük ürünlerde marjı doğrudan yer. Kuruş bazında çalışan ürünlerde binlerce işlemin toplamı ciddi bir kalem oluşturur. Bir epin yazılım tarafında yuvarlama stratejisini kategori bazında ayarlayabiliyor olman önemlidir: düşük fiyatlı elmas paketleriyle yüksek fiyatlı oyun anahtarları aynı kuralla yönetilmemeli.

Stok, sipariş kuyruğu ve başarısız çağrılar nasıl yönetilir?

Fiyat kadar önemli ikinci veri stoktur. Tedarikçi stok bilgisini gerçek zamanlı vermiyorsa, "stokta var" gösterdiğin bir ürünü satıp teslim edemeyebilirsin. Burada iki savunma hattı kurmalısın: birinci hat, satış anında tedarikçiye anlık doğrulama sorgusu; ikinci hat, teslimat başarısız olduğunda siparişi otomatik olarak bekleyen duruma alıp müşteriye bilgi veren bir akış.

Başarısız çağrılar için de net bir politika gerekir. Zaman aşımı kaç saniye? Kaç kez tekrar denenecek? Tekrar denemeler arasında artan bekleme var mı? En kritik soru şu: aynı sipariş iki kez gönderilirse ne olur? API tarafında tekrarsızlık anahtarı kullanmıyorsan, bir ağ kesintisi sonrası aynı e-pini iki kez satın alıp iki kez ödeyebilirsin. İyi kurulmuş bir e-pin satış yazılımı her sipariş için tek kullanımlık bir referans üretir ve tekrarlanan çağrıları aynı referansla eşleştirir.

Entegrasyonu canlıya almadan önceki 48 saatlik prova

Bağlantıyı kurdun, eşlemeyi yaptın, kuralları yazdın. Şimdi canlıya basmadan önce bir gölge dönemi geçirmelisin. Gölge dönemde senkronizasyon çalışır, hesaplamalar yapılır, ama sonuçlar vitrine yazılmaz; yalnızca kayda geçer. İki gün boyunca üretilen fiyatları mevcut fiyatlarınla karşılaştırır, sapma listesine bakarsın. Bu listede beklemediğin bir ürün varsa eşleme hatası yakalamış olursun.

Gölge dönemi geçtikten sonra kademeli aç: önce tek kategori, sonra en çok satan yirmi ürün, sonra tüm katalog. Her adımda sipariş başarısızlık oranını ve iade taleplerini izle. Bu disiplin sıkıcı gelebilir ama entegrasyon hatalarının en pahalı olanları hep "hepsini bir gecede açalım" kararından çıkar.

Entegrasyon, kurulduğu gün değil bakımı kolay olduğu gün başarılıdır. Eşleme tablonu kimlik üzerine kur, fiyat kurallarını üç korumayla çerçevele, kur tamponunu yaz, gölge dönemini atlama. Bu dördünü yaptığında tedarikçi tarafındaki değişiklikler senin için birer bildirime dönüşür, birer kriz olmaktan çıkar. Kural motorunun ekranlarını ve eşleme akışını gerçek veriyle görmek istersen canlı demo üzerinden dolaşabilir, paket kapsamını fiyat bölümünde karşılaştırabilirsin.