Satıcı API Entegrasyon Örneği Nasıl Kurulur?

Bir fren balatası siparişi stokta görünürken depoda yoksa, sorun yalnızca iptal edilen tek bir satış değildir. Tamirhanenin araç teslim planı aksar, sürücünün güveni zedelenir ve satıcının puanı etkilenir. İyi kurgulanmış bir satıcı API entegrasyon örneği, stoktan siparişe kadar bu kopuklukları azaltır; doğru ürün bilgisini doğru anda pazaryerine taşır.

Otomotiv yedek parçada entegrasyonun değeri, ürün sayısını artırmaktan fazlasıdır. Aynı ürün kodunun farklı marka, araç ve motor seçeneğiyle ilişkilendiği bu alanda fiyat, stok ve uyumluluk bilgisinin birlikte yönetilmesi gerekir. Satıcının kendi ERP'si, muhasebe programı veya e-ticaret altyapısı ile pazaryeri arasındaki veri akışı doğru kurulursa operasyon hızlanır, yanlış parça riski düşer.

Satıcı API entegrasyon örneği hangi sorunu çözer?

API, iki yazılımın belirlenmiş kurallarla veri alışverişi yapmasını sağlar. Satıcı tarafında bu bağlantı genellikle ürün kartları, stok miktarı, fiyatlar, siparişler, faturalar ve kargo durumları arasında çalışır. Böylece ekiplerin her değişikliği ayrı ayrı panele girmesi gerekmez.

Örneğin bir yedek parça satıcısının deposunda 12 adet ön fren diski bulunsun. Mağaza içi satışla iki adet ürün çıktığında ERP stok bilgisini 10'a indirir. API bu değişikliği pazaryerine iletir. Aynı anda fiyat güncellemesi varsa, yeni fiyat da ürün koduyla eşleşerek aktarılır. Alıcı, artık eski stok veya eski fiyatla karşılaşmaz.

Burada kritik detay ürün kodudur. OEM numarası, üretici kodu, barkod ve satıcının kendi stok kodu farklı alanlarda tutulabilir. Entegrasyon tasarımı bu kodların hangisini birincil eşleştirme anahtarı olarak kullanacağını açıkça belirlemelidir. Aksi halde doğru stok, yanlış ürün kartına bağlanabilir.

Örnek akış: Stok, fiyat, sipariş ve kargo

Pratik bir entegrasyon dört temel akış üzerinden anlatılabilir. Her işletmenin altyapısı farklı olsa da başlangıç noktası aynıdır: Tek bir doğru veri kaynağı seçmek.

1. Ürün kartının pazaryerine gönderilmesi

Satıcı, ERP veya ürün yönetim sisteminde bir ürün kartı oluşturur. Kartta marka, ürün adı, OEM numarası, kategori, KDV oranı, görseller, açıklama ve teknik özellikler yer alır. Otomotiv parçasında bunlara araç marka-model-yıl, motor tipi veya uyumluluk notu da eklenmelidir.

Örnek veri yapısı şu mantıkla düşünülebilir:

```json { "satici_stok_kodu": "FD-ON-320", "oem_no": "1K0615301", "urun_adi": "Ön Fren Diski", "marka": "OEM", "stok": 12, "satis_fiyati": 1850, "kdv_orani": 20, "uyumluluk": "2015-2019 1.6 dizel modeller" } ```

Pazaryeri bu veriyi alırken zorunlu alanları kontrol eder. Eksik ürün adı, geçersiz fiyat, hatalı kategori veya tanımsız ürün kodu varsa kayıt doğrudan satışa açılmamalıdır. Bunun yerine hata mesajı satıcı sistemine dönmelidir. Bu yaklaşım ilk bakışta işlemi yavaşlatır gibi görünür; ancak uyumsuz ürün iadesi ve müşteri kaybı daha maliyetlidir.

2. Stok ve fiyatın düzenli güncellenmesi

Stok güncellemeleri iki biçimde çalışabilir. İlkinde satıcı, değişiklik olduğunda API'ye anlık bildirim gönderir. İkincisinde pazaryeri belirli aralıklarla satıcının stok bilgisini çeker. Yoğun sipariş alan, aynı ürünü mağazada ve birden çok kanalda satan işletmeler için anlık bildirim daha güvenlidir.

Bununla birlikte her ürün için saniye saniye sorgu yapmak gereksiz sistem yükü oluşturabilir. Düşük hareketli ürünlerde 15 veya 30 dakikalık periyot yeterli olabilir. Çok satan yağ, filtre, balata ve ampul gruplarında ise daha kısa aralıklar tercih edilmelidir. Doğru yöntem, satış hızı ve stok devir oranına bağlıdır.

Fiyat aktarımında indirimli fiyatın başlangıç ve bitiş zamanı ayrıca gönderilmelidir. Sadece fiyat tutarını değiştirmek, kampanya bittiğinde ürünün yanlış fiyatta kalmasına yol açabilir. Satıcı maliyet artışlarını yönetirken minimum kâr marjı kontrolü de kurmalıdır. En düşük fiyat her zaman en iyi ticari sonuç değildir; kargo, komisyon, paketleme ve iade payı da hesaba katılmalıdır.

3. Siparişin satıcı sistemine düşmesi

Alıcı siparişi tamamladığında pazaryeri satıcıya sipariş numarası, ürün kodu, adet, teslimat bilgisi ve ödeme durumunu iletir. Satıcının sistemi bu siparişi otomatik olarak "hazırlanıyor" durumuna alabilir. Depo ekibi ürün kodunu kontrol eder, ürünü toplar ve paketler.

Sipariş kabulü için bir zaman sınırı tanımlamak gerekir. Stokta görünmesine rağmen ürün bulunamazsa satıcı neden koduyla birlikte siparişi reddedebilmelidir. "Stok sayım farkı", "hasarlı ürün" veya "ürün tedarik dışı" gibi nedenler, sistemsel problemleri izlemede işe yarar. Sürekli aynı nedenle iptal oluşuyorsa mesele personel hatası değil, stok senkronizasyon kuralı olabilir.

Ayrıca sipariş verisinde araç uyumluluğu için gereken bilgiler korunmalıdır. Şasi numarasıyla doğrulama yapılan siparişlerde bu bilgi yalnızca yetkili süreçlerde kullanılmalı, gereksiz sistemlere aktarılmamalıdır. API entegrasyonu hız sağlar, fakat müşteri verisi için yetki ve güvenlik kuralları da gerektirir.

4. Kargo ve teslimat durumunun geri bildirilmesi

Paket hazırlandığında kargo firması, takip numarası üretir. Satıcı sistemi bu numarayı ve kargo durumunu pazaryerine gönderir. Alıcı, siparişinin hazırlanıp hazırlanmadığını veya dağıtımda olup olmadığını tek ekrandan görür.

Kargo durumlarını sade tutmak gerekir: hazırlanıyor, kargoya verildi, teslim edildi, iade sürecinde. Her firmanın kullandığı ayrıntılı durum kodlarını olduğu gibi göstermek kafa karıştırabilir. Buna karşılık teslimat gecikmesi, adres sorunu veya hasar bildirimi gibi istisnalar açıkça işaretlenmelidir.

Entegrasyonda uyumluluk verisini ayrı düşünmeyin

Yedek parçada ürün görseli ve fiyatı satışa yaklaştırır, uyumluluk bilgisi ise satın alma kararını güvenli hale getirir. Bir marş motoru veya süspansiyon parçası, dış görünüşte benzer olsa bile motor koduna göre değişebilir. Bu nedenle ürün kartı yalnızca "uyumlu araçlar" metninden ibaret olmamalıdır.

Mümkünse araç marka, model, üretim yılı, motor hacmi, yakıt türü ve OEM numarası yapılandırılmış alanlar halinde gönderilmelidir. Serbest açıklama alanı ek bilgi için yararlıdır, ancak tek başına filtreleme ve doğrulama sağlamaz. Şasi numarasıyla sorgulama sunan yapılarda, ürün eşleşmesinin hangi veriyle doğrulandığı da kayıt altına alınmalıdır.

Krikogo gibi onaylı satıcı ağını ve geniş katalogyu bir araya getiren pazaryerlerinde bu disiplin, sadece görünürlüğü değil satıcının hizmet kalitesini de güçlendirir. Doğru eşleşen ürün, daha az iade, daha kısa servis bekleme süresi ve daha memnun müşteri anlamına gelir.

Hata yönetimi ve güvenlik nasıl kurulmalı?

Başarılı entegrasyon, hiç hata vermeyen entegrasyon değildir. Hata oluştuğunda hatayı fark eden, kaydeden ve güvenli biçimde tekrar deneyen entegrasyondur. Örneğin internet kesintisi nedeniyle stok güncellemesi gönderilemediyse sistem aynı kaydı kontrolsüz biçimde onlarca kez oluşturmamalıdır. Her isteğe benzersiz bir işlem kimliği verilmesi, tekrar eden kayıtları önlemeye yardımcı olur.

API erişimi için anahtar veya token kullanılmalı; bu bilgiler e-posta, ekran görüntüsü ya da açık dosyalarla paylaşılmamalıdır. Yetkiler rol bazlı tanımlanmalıdır. Depo uygulaması stok güncelleyebilirken, muhasebe verisini görmesi gerekmeyebilir. Test ortamında denenen bir geliştirme, gerçek siparişleri veya canlı stokları etkilememelidir.

İzleme ekranında başarısız istekler, bekleyen siparişler ve son stok güncelleme zamanı görünmelidir. "Entegrasyon çalışıyor" ifadesi tek başına yeterli değildir. Hangi ürünün, hangi saatte ve hangi nedenle aktarılmadığını görebilen satıcı, müdahaleyi zamanında yapar.

Canlıya geçmeden önce kontrol edin

Canlı kullanım öncesinde küçük bir ürün grubu seçin ve uçtan uca test yapın. Ürün kartı oluşuyor mu, stok değişikliği doğru yansıyor mu, kampanyalı fiyat süresi bitince eski fiyat geri geliyor mu, sipariş depoya düşüyor mu ve kargo takip numarası alıcıya görünüyor mu? Bu kontrollerin her biri gerçek işlem senaryosuyla doğrulanmalıdır.

İade senaryosunu atlamayın. İade edilen ürün tekrar satılabilir durumdaysa stok ne zaman artacak, hasarlı üründe hangi depo alanı kullanılacak, para iadesi hangi aşamada işlenecek? Özellikle fren, elektrik ve motor parçalarında ambalajı açılmış veya montaj izi bulunan ürünler için operasyon kuralı net olmalıdır.

Entegrasyonu bir kez kurup bırakmak yerine, haftalık olarak iptal oranı, stok uyuşmazlığı, kargoya verme süresi ve iade nedenlerini izleyin. En çok hata veren ürün kodları veya kategoriler, ürün verisini iyileştirmek için en net başlangıç noktasıdır. Doğru kurulan her veri akışı, müşterinin aradığı parçayı daha hızlı bulmasına ve satıcının satışını daha güvenle büyütmesine yardımcı olur.