Pazaryeri–ERP Entegrasyonu: Hazır Paket mi, Özel Geliştirme mi?

Pazaryeri entegrasyonu hangi işleri kapsar?

Pazaryeri entegrasyonu, pazaryeri ile ERP ya da muhasebe programı arasında yedi iş akışını otomatikleştirmektir: ürün ve katalog, stok ve fiyat, sipariş, kargo, fatura, iade ve mutabakat. Bir entegrasyon programını değerlendirirken önce bu akışların hangisine ihtiyacınız olduğunu yazmak gerekir; çünkü paketler ve özel çözümler bu akışların farklı bir alt kümesinde güçlüdür.

• Ürün ve katalog: Ürün açma, kategori ve özellik eşleştirme, görsel.
• Stok ve fiyat: Satılabilir stok ve satış fiyatının pazaryerine gönderilmesi.
• Sipariş: Siparişin okunması ve ERP'ye sipariş ya da fatura olarak yazılması.
• Kargo: Kargo etiketi ve takip numarasının iki yöne taşınması.
• Fatura: e-Arşiv ya da e-Fatura belgesinin düzenlenmesi ve pazaryerine iletilmesi.
• İade: İptal ve iade durumunun yakalanması, depo girişi ve belge.
• Mutabakat: Komisyon, indirim ve hakediş tutarlarının ERP kayıtlarıyla karşılaştırılması.

Pazaryerlerinin satıcı API'leri bu akışları belgelenmiş servislerle sunar. Örneğin Trendyol'un geliştirici belgesinde stok ve fiyat güncellemesi, sipariş paketleri ve iade edilen siparişler için ayrı servisler tanımlıdır. Asıl farkı yaratan, bu servislerin ERP tarafına nasıl bağlandığıdır.

Hazır paket ne zaman yeter, özel geliştirme ne zaman gerekir?

Hazır paket standart akışta yeterlidir; özel geliştirme, iş kuralınız paketin ayarla karşılayamadığı bir mantık gerektirdiğinde gerekir. İki tarafı ayrı ayrı ele alalım.

Hazır entegrasyon paketlerinin güçlü olduğu durumlar

Hazır paketler, çok sayıda satıcının ortak ihtiyacını tek bir ürünle karşıladıkları için standart akışta güçlüdür. Satış kanalınız çoksa, ürünleriniz tekilse ve muhasebe kaydınız alışılmış biçimdeyse, hazır paket genellikle daha hızlı devreye girer ve bakımı sizin yerinize yürür.

Hazır paketin öne çıktığı durumlar şunlardır:

• Çok pazaryeri: Beş ya da altı farklı kanalda satış yapılıyorsa her kanalın API değişikliğini tek tek izlemek ağır bir iştir. Paket bu işi kendi ürününün parçası olarak üstlenir.
• Katalog yönetimi: Kategori ve özellik eşleştirmesi, ürün açma ekranları gibi işler paketlerin olgun olduğu alanlardır.
• Standart sipariş ve fatura akışı: Sipariş gelir, tek depodan sevk edilir, fatura standart biçimde kesilir.
• Hızlı başlangıç: Yeni bir pazaryerine kısa sürede açılmak gerekiyorsa paket, geliştirme beklemeden çalışmaya başlar.
• Desteklenen ERP: Paketin sizin ERP ürününüz ve sürümünüz için hazır bir bağlantısı varsa iş büyük ölçüde ayardır.

Bu durumların çoğu sizi tarif ediyorsa özel geliştirme önermeyiz. Hazır paket yetiyorsa, onu kullanmak hem daha düşük riskli hem daha dürüst bir öneridir.

Özel geliştirmenin gerektiği durumlar

Özel geliştirme, iş kuralınız paketin ayar ekranında karşılığı olmayan bir mantık gerektirdiğinde anlam kazanır. Burada ölçü, kuralın "özel" olması değil, kuralın kod gerektirip gerektirmemesidir. Pek çok paket esnek ayarlar sunar; önce ayarla çözülüp çözülmediği denenir.

Özel geliştirmenin genellikle gerektiği durumlar şunlardır:

• Özel fiyat kuralı: Pazaryeri fiyatının maliyet, döviz kuru, kampanya takvimi ve kanal komisyonuna göre formülle hesaplanması.
• Siparişe göre üretim: Sipariş ERP'ye düşmeden önce üretim kapasitesi ya da hammadde kontrolünden geçmesi; sipariş bir iş emrine dönüşüyorsa sipariş takip programı ile aynı akışta yönetilmesi.
• Çok depo ve depo seçme kuralı: Siparişin, alıcının iline ya da depo stoğuna göre hangi depodan sevk edileceğinin kuralla seçilmesi.
• Set, koli ve paket ürün: Pazaryerinde tek satır olarak satılan setin ERP'de birden fazla stok kalemine ya da çarpanla açılması.
• Özel muhasebe kaydı: Komisyon, pazaryeri indirimi ya da kargo bedeli için mali müşavirin istediği kayıt düzeninin her siparişte aynı şekilde uygulanması.
• Paketin desteklemediği ERP ya da sürüm: Kullandığınız programın, paketin hazır bağlantı listesinde olmaması.
• ERP'ye yazma yöntemi: Paketin ERP'ye üreticinin resmî arayüzü yerine başka bir yoldan yazması ve bunun sizin için kabul edilebilir olmaması.

Son madde sık gözden kaçar. ERP'ye kayıt yazmanın güvenli yolu üreticinin belgelediği arayüzdür. Örneğin Mikro, API içindeki serbest SQL ucunu yalnızca SELECT için belgeliyor ve kayıt oluşturmayı tipli uç noktalara bağlıyor. Paketin ya da özel çözümün ERP'ye hangi yoldan yazdığını sormak, her iki seçenekte de ilk sorudur.

Karar tablosu

Karar tablosu, en çok karşılaşılan durumlar için hangi yolun genellikle daha uygun olduğunu gösterir. Tablo bir öneri değil, keşif görüşmesinde sorulacak soruların sırasıdır; kendi durumunuzu her satırda işaretleyin.

Tabloda "ayara bağlı" yazan satırlar için paketin deneme ortamında sizin gerçek örneklerinizi çalıştırmak en sağlıklı testtir. Üç zor siparişi seçin: bir set ürün, iki depodan biri, iptal edilip yeniden verilmiş bir sipariş. Paket bu üçünü doğru işliyorsa büyük ihtimalle yeterlidir.

Toplam sahip olma maliyeti kalemleri

Toplam sahip olma maliyeti, ilk kurulum bedelinin yanında entegrasyonun yıllar boyunca yaşamasının gerektirdiği tüm kalemlerin toplamıdır. Bu yazıda rakam vermiyoruz, çünkü rakam kapsamınıza göre değişir; ama hangi kalemlerin hesaba katılacağını listeliyoruz.

Bu kalemlerin en çok küçümseneni API değişikliğidir. Pazaryerleri servislerini düzenli olarak günceller. Örneğin Trendyol, geliştirici belgesinde eski sipariş servisinin 15 Ekim 2026 tarihinden itibaren kullanımdan kalkacağını ve yerine v2 sipariş servisinin zorunlu olacağını önceden duyurdu. Hazır pakette bu değişikliği sağlayıcı karşılar; özel geliştirmede ise sözleşmenin bakım maddesinde açıkça yazılı olmalıdır.

İkinci küçümsenen kalem iç emektir. Hangi yolu seçerseniz seçin, eşleşmeyen ürünleri düzeltmek, reddedilen siparişleri incelemek ve ay sonu mutabakatını yapmak için ekibinizden zaman gider. Bu zamanı azaltan şey, hataların görünür ve sebebiyle listelenmesidir.

İkisini birlikte kullanma seçeneği

Hazır paket ve özel geliştirme birbirini dışlamaz; birçok durumda en dengeli yapı ikisinin birlikte kullanılmasıdır. Paket, kanal sayısının çok olduğu pazaryeri tarafını yönetir; özel bir katman, ERP'ye yazma kurallarını ve sizin işinize özgü mantığı uygular.

İki tipik karma yapı vardır:

1. Paket pazaryeri tarafında, özel katman ERP tarafında. Paket siparişleri tüm kanallardan toplar ve stok ile fiyatı kanallara dağıtır. Özel katman siparişi paketten alır, depo seçme ve set açma kurallarını uygular, ERP'nin resmî arayüzüyle kayıt yazar.
2. Paket uçtan uca, özel katman yalnız bir istisna için. Standart siparişleri paket ERP'ye yazar. Siparişe göre üretilen ürünler gibi tek bir grup, özel katmana yönlendirilir ve orada iş emrine dönüştürülür.

Karma yapının tek ve kesin bir şartı vardır: aynı veriyi iki sistem aynı anda yazmamalıdır. Örneğin bir pazaryerine stok hem paket hem özel katman tarafından gönderilirse, iki sistem birbirinin değerini ezer ve stok sürekli dalgalanır. Her veri akışı için tek bir yazıcı belirlenir ve bu, sözleşmede ya da teknik belgede yazılı olur.

Karma yapıda kimlik bilgilerinin yönetimi de önemlidir. Trendyol'un belgesine göre API anahtarı ve şifresi satıcı panelinde yalnızca ana kullanıcının görebildiği bir sayfada yer alır ve her istekte kimin adına çalışıldığını belirten bir başlık gönderilmesi gerekir; satıcının kendi entegrasyonu ile aracı bir firmanın entegrasyonu bu başlıkta ayrı biçimde belirtilir. Aynı anahtarı iki sisteme vermeden önce hangi sistemin hangi servisi çağıracağını netleştirin.

Karar vermeden önce sorulacak sorular

Pazaryeri entegrasyon programı ya da özel geliştirme teklifi değerlendirirken aşağıdaki soruların her biri için yazılı cevap isteyin:

• ERP'ye hangi yoldan yazıyorsunuz: üreticinin resmî arayüzü mü, başka bir yöntem mi?
• Bizim ERP ürünümüz ve sürümümüz için hazır bağlantınız var mı, yoksa geliştirme mi gerekiyor?
• Eşleşmeyen ürün ya da reddedilen sipariş nerede ve nasıl görünüyor, kime bildirim gidiyor?
• Pazaryeri API'si değiştiğinde güncellemeyi kim, hangi takvimle yapıyor?
• ERP sürüm yükseltmesinden önce test yapılıyor mu?
• Set ürün, çok depo ve özel fiyat kurallarımızı ayarla mı, kodla mı karşılıyorsunuz?
• Ayrılmak istersek verilerimizi ve eşleştirme tablolarımızı hangi biçimde alırız?

Bu soruların cevabı belirsiz kalıyorsa, seçenekler arasındaki fark fiyat değil, gelecekte yaşanacak belirsizliktir.

Sıkça Sorulan Sorular

Pazaryeri entegrasyon programı her işletmeye yeter mi?

Standart akışta çalışan, tekil ürün satan ve tek depodan sevk eden işletmeler için çoğu zaman yeter. Siparişe göre üretim, kurala bağlı depo seçimi, set ürün ya da özel muhasebe kaydı varsa paketin bu kuralları ayarla karşılayıp karşılamadığı gerçek siparişlerle test edilmelidir. Karşılamıyorsa özel katman eklenir.

Trendyol ERP entegrasyonu için özel yazılım şart mı?

Şart değil. ERP ürününüz paketin hazır bağlantı listesindeyse ve kurallarınız standartsa hazır paket yeterli olabilir. Özel yazılım, paketin ERP'nize bağlanmadığı ya da iş kuralınızı uygulayamadığı durumlarda gerekir.

Hazır paketle özel geliştirmeyi birlikte kullanmak riskli mi?

Doğru kurulursa değil. Risk, aynı veriyi iki sistemin yazmasından doğar. Stok, fiyat ve sipariş için tek bir yazıcı belirlenir ve her akışın sahibi yazılı olur.

Özel geliştirmede pazaryeri API değişikliklerini kim takip eder?

Bu, sözleşmenin bakım maddesinde yazılı olmalıdır. Teslim sonrası 15 gün ücretsiz hata düzeltme standardımızdır; pazaryeri ve ERP değişikliklerinin izlenmesi ise sürekli bir iş olduğu için ayrı bir bakım anlaşmasıyla tanımlanır. Bu madde yazılı değilse, API değiştiği gün kimin sorumlu olduğu belirsiz kalır.

Kararı vermeden önce neyi hazırlamalıyız?

Satış yaptığınız kanalları, ERP ürününüzü ve sürümünüzü, depo sayınızı ve en zor üç siparişinizi yazın. Bunlara set ürün, iki depodan sevk ve iptal edilip yeniden verilen sipariş örnekleri dahil olsun. Bu liste hem paket denemesinde hem özel geliştirme keşfinde aynı ölçütle kullanılır.

Sonraki adım: kurallarınızı birlikte okuyalım

Hazır paketle mi başlayacağınızı, yanına özel bir katman mı gerektiğini anlamak için en kısa yol kurallarınızı yazılı hâle getirmektir. Hiçbir pazaryeri ya da ERP üreticisinin bayisi değiliz ve paket satmıyoruz; paketin yettiği yerde bunu açıkça söyleriz, yetmediği yerde ERP entegrasyonu katmanını resmî arayüzler üzerinden yazarız. İlk keşif görüşmesi online ve ücretsizdir; iletişime geçin ya da isterseniz WhatsApp'tan yazın.