PttAVM'ye XML'den Ürün Aktarma: Satışa Adım Adım Rehber

PttAVM'e ürünlerinizi gönderdiniz, işlem "tamamlandı" göründü, stoklar da girildi. Mağazanıza bakıyorsunuz, ürünlerin bir kısmı pasif. Bir kısmı görselsiz açılmış. Varyantlı bir üründe fiyat alış fiyatına inmiş.

Bunların hepsini kendi canlı mağazamızda yaşadık. Paneli yaklaşık 100.000 ürün ve beş pazaryeriyle sınadığımız o mağazada PttAVM'in nasıl davrandığını, resmi API dokümanıyla karşılaştırarak öğrendik. Bu yazıda PttAVM entegrasyonunu (birçok satıcının hâlâ ePttAVM diye aradığı pazaryeri) adım adım anlatıyoruz.

PttAVM entegrasyonu nasıl çalışır?

PttAVM'de bir ürünü satışa çıkarmak üç ayrı iştir. Önce ürün kataloğa kaydedilir. Sonra stoğu ve fiyatı güncellenir. En son ürün satışa açılır. PttAVM'in dokümanında bunlar ayrı servislerdir ve her biri kendi kuralıyla çalışır.

Ürün ekleme ve stok-fiyat güncellemesi anında sonuçlanmaz. İsteğiniz kabul edilince size bir takip numarası döner, sonucu bu numarayla ürün ürün sorgularsınız.

Bu adımlar atlanınca ne kaybedersiniz?

• Kaçan satış. Stoğu olduğu hâlde pasif bekleyen ürün vitrinde görünmez.
• Kaybolan beden. Yanlış güncellenen varyantlı üründe bedenler silinir ve yeniden kurulması gerekir.
• Zararına satış. Varyant fiyatı yanlış hesaplanırsa ürün alış fiyatına, hatta altına iner.
• Zayıf vitrin. Görseli yüklenmemiş ürün listede var görünür ama müşteriyi ikna etmez.

Bu yazının tek cümlelik özeti. PttAVM'de "tamamlandı" yazısı ürünün satışta olduğunu söylemez. Kayıtlı mı, stoklu mu, satışa açık mı diye üç soruyu ayrı ayrı sormanız gerekir.

Adım adım PttAVM entegrasyonu

1. Entegratörü satıcı panelinden yetkilendirin

PttAVM artık kullanıcı adı ve şifre yerine API anahtarı ve token ile çalışıyor. Eski yapı bir süre yeniyle birlikte çalıştı, PttAVM'in duyurusuna göre tamamen kaldırılacak.

Yetkiyi satıcı panelinde Hesap Yönetimi > Entegrasyon Bilgileri bölümünden verirsiniz. Her entegratör firma için mağazanıza özel ayrı bir token oluşur. O token yalnız o firmayla paylaşılır. Yetkiyi kaldırmak isterseniz aynı ekrandan kaldırırsınız.

Kontrol edin. Hâlâ kullanıcı adı ve şifreyle bağlanan bir programınız varsa, geçişi beklemeden token yapısına taşıyın.

2. Barkodu ürünün kimliği sayın

PttAVM ürünü barkodundan tanır. Daha önce sisteme kaydedilmemiş bir barkod gönderirseniz, PttAVM onu yeni bir ürün olarak ekler. Aynı barkodla birden fazla kayıt gönderirseniz son gönderilen geçerli olur.

Bunun pratik sonucu şudur. Tedarikçiniz XML'de bir ürünün barkodunu değiştirirse PttAVM'de eskisinin yanına ikinci bir ürün açılabilir. Barkodun kaynağını baştan sabitleyin.

3. Yeni ürünün zorunlu alanlarını eksiksiz gönderin

Yeni bir ürün için PttAVM'in istedikleri bellidir. Geçerli bir kategori, en fazla 200 karakterlik bir ürün adı, geçerli adresli en az bir görsel, stok, fiyat ve KDV oranı. KDV için 0, 1, 10 ya da 20 değerlerinden biri kullanılır. Ürüne GTIN yazdıysanız geçerli bir numara olmalı. Desi normalde 0 ile 300 arasında olur, beyaz eşya ve mobilya gibi bazı kategoriler bundan muaftır.

4. Varyantlarda iki tuzağa dikkat edin

Bu adım PttAVM'de en çok para kaybettiren yerdir.

İlk tuzak ürün güncellemede. PttAVM'in dokümanı açık söylüyor. Ürünü güncellerken göndermediğiniz varyant silinir. Tek bir bedenin bilgisini değiştirmek isteseniz bile diğer bütün bedenleri de eski değerleriyle birlikte göndermeniz gerekir. Hiç varyant göndermezseniz ürünün bütün varyantları silinir.

İkinci tuzak varyant fiyatında. PttAVM varyantın fiyatını ayrı bir satış fiyatı olarak değil, ana ürünün fiyatına eklenen ya da çıkarılan bir fark olarak ister. Bu fark KDV dahil yazılır. Kendi mağazamızda farkın yerine maliyet gittiğinde varyantın PttAVM'deki fiyatı alış fiyatına indi. Doğru hesap, varyantın satış fiyatından ana ürünün satış fiyatını çıkarmaktır.

Kontrol edin. Varyantlı bir ürünün her bedenini PttAVM'de açıp son fiyatı kendi hesabınızla karşılaştırın.

5. Fiyat ve stoğu kendi servisinden güncelleyin

Günlük fiyat ve stok değişiklikleri için PttAVM'in ayrı bir fiyat-stok servisi var. Bu serviste yalnız değişen varyantı göndermeniz yeterli, göndermedikleriniz silinmez. Varyantlı ürünlerde fiyat ve stok onarımını bu yoldan yapmanızı öneriyoruz.

Bu serviste bilmeniz gereken birkaç kural var.

• Stok 0 ile 9999 arasında tutulur. Daha büyük bir sayı gönderirseniz 9999'a indirilir.
• Bir ürünün bütün varyantlarının stok toplamı 9999'u geçemez.
• İndirim oranı yüzde 70'i geçemez.
• Aynı istek 5 dakika içinde tekrar gönderilemez. PttAVM ikinci isteği değişiklik yok diye geri çevirir.
• Kilitli ürünler güncellenemez. Bu serviste kilit için uyarı döner.

Bir ince ayrıntı daha var. KDV dahil ve KDV hariç fiyatı birlikte gönderirseniz iki servis farklı davranır. Ürün ekleme servisinde KDV dahil fiyat, fiyat-stok servisinde KDV hariç fiyat öncelikli sayılır. Hangisinin esas alınacağını bilmeden ikisini birden göndermeyin. Fiyatı neye göre kuracağınızı komisyon ve otomatik fiyat hesaplama yazımızda anlattık.

6. Ürünü satışa açtığınızı ayrıca kontrol edin

PttAVM'de ürünü aktif ya da pasif yapmak için ayrı bir servis vardır. Fiyat-stok isteğinde de bir "aktif" alanı bulunur. Ama kendi mağazamızda stoğu giden ürünlerin bir kısmının pasif kaldığını gördük. Stok girildi, ürün satışta değildi, hiçbir yerde hata yazmıyordu. Ürünleri ayrı aktifleştirme adımıyla açtığımızda sorun çözüldü.

Kontrol edin. Stoğu sıfırdan büyük olup PttAVM'de pasif görünen ürününüz var mı, düzenli aralıklarla bakın. Bu liste satışını kaçırdığınız ürünlerin listesidir.

7. Görsellerin gerçekten yüklendiğine bakın

PttAVM görseli sizin verdiğiniz adresten kendisi indirir. Tedarikçinin görsel sunucusu yavaşsa PttAVM görseli alamayabilir ve ürün görselsiz kalır. Gönderim ise başarılı görünür. Bizim mağazamızda bu sorunun büyük kısmı tek bir tedarikçinin sunucusundan geliyordu. Ürünleri yeniden göndermek çoğunu çözmedi.

PttAVM'in bunun için bir servisi var. Hatalı ürün görselleri listesi, son güncellemede görseli işlenemeyen ürünleri ve hatanın sebebini gösterir.

8. Sonucu ürün ürün okuyun

Takip numarasıyla sorguladığınız işlem "tamamlandı" dese bile içinde reddedilmiş ürünler olabilir. Kendi mağazamızda "tamamlandı" dönen, reddedilen ürün sayısı sıfır görünen bir güncellemenin fiyatları hiç değiştirmediği de oldu. Genel duruma değil, her ürünün kendi sonucuna ve mağazadaki son hâline bakın.

Sık yapılan hatalar

• Varyantlı ürünü tek bedenle güncellemek. Ürün güncelleme servisinde diğer bedenler silinir.
• Varyant fiyatını tam fiyat sanmak. PttAVM ana fiyata eklenen farkı bekler.
• Aynı isteği arka arkaya göndermek. 5 dakika içindeki tekrar, değişiklik yok diye geri döner.
• Büyük partileri körlemesine göndermek. Resmi sınır istek başına 1.000 ürün. Biz kendi mağazamızda büyük partilerde varyantların sessizce reddedildiğini gördük ve daha küçük partilerle çalışıyoruz.
• "Tamamlandı"yı satışta sanmak. Kayıt, stok ve aktiflik ayrı ayrı kontrol edilir.
• Biten stoğu PttAVM'de açık bırakmak. Nasıl önleneceğini çok pazaryerinde stok senkronizasyonu rehberimizde ve stok düşmüyor yazımızda anlattık.

Hızlı teşhis

• Ürün stoklu ama pasifse satışa açma adımı uygulanmamıştır.
• Ürün görselsizse hatalı görseller listesine bakın, sorun büyük ihtimalle tedarikçinin görsel sunucusundadır.
• Bir beden kaybolduysa son ürün güncellemesinde o beden gönderilmemiştir.
• Varyant fiyatı çok düşükse fark yerine tam fiyat ya da maliyet gönderilmiştir.
• Güncelleme hiç işlememişse 5 dakika kuralına ya da ürünün kilitli olup olmadığına bakın.

Bunu Entegmar'da nasıl yapıyoruz

Entegmar'da tedarikçinizin XML kaynağını bir kez bağlar, kategori eşlemesini yaparsınız. Fiyatı maliyet, kargo, komisyon ve kâr kuralınıza göre panel hesaplar. Stok değiştikçe PttAVM'e de gider ve siparişler diğer pazaryerleriyle aynı listede görünür. Yukarıdaki tuzakların çoğunu kendi mağazamızda yaşayıp panele kural olarak koyduk. PttAVM entegrasyonu sayfamızda ayrıntıları görebilirsiniz.

Sık sorulan sorular

PttAVM ile ePttAVM aynı pazaryeri mi?

Evet. Birçok satıcı hâlâ ePttAVM diye arıyor. Biz metinlerimizde PttAVM yazıyoruz.

PttAVM entegrasyonu için yetkiyi nereden veririm?

Satıcı panelinde Hesap Yönetimi > Entegrasyon Bilgileri bölümünden. Her entegratör için mağazanıza özel ayrı bir token oluşur ve yetkiyi aynı yerden kaldırabilirsiniz.

PttAVM'de ürünü entegrasyonla silebilir miyim?

PttAVM'in entegrasyon dokümanında ürün silme servisi yer almıyor. Satmak istemediğiniz ürünü stoğunu sıfırlayıp pasife alarak kapatırsınız.

İlk gönderime kaç ürünle başlamalıyım?

Küçük bir grupla başlayın. İçinde en az bir varyantlı ürün olsun. Sonuçları ürün ürün okuyup mağazadaki hâlini kontrol ettikten sonra kataloğun geri kalanını gönderin.

Ürün "tamamlandı" göründü ama mağazada yok, neden?

Genel durum tamamlandı olsa da ürününüz tek tek reddedilmiş olabilir. Ürün kaydedilmiş ama satışa açılmamış da olabilir. Her ürünün kendi sonucuna ve mağazadaki hâline bakın.

Kendi XML'inizle birlikte bakalım

Ürünlerinizin PttAVM'de hangi adımda takıldığını kendi XML'iniz ve mağazanız üzerinden görmek en hızlı yoldur. Kısa bir demoda varyantlarınızı ve fiyat kurallarınızı birlikte inceleyelim.

Demo talebi bırakın →