Pazaryeri entegrasyonları rehberi: bağlantı yöntemleri, sipariş akışı ve kurulum
Pazaryeri entegrasyonları, Trendyol, Hepsiburada ya da Amazon gibi satış kanallarındaki mağazalarınızı, kargo firmanızı ve fatura programınızı aynı ürün kartına bağlayan yazılım köprüleridir. Doğru kurulduğunda bir sipariş geldiğinde stok bütün kanallarda düşer, kargo etiketi ve fatura aynı kayıttan üretilir, takip numarası pazaryerine geri gider. Bu bölümde bağlantı yöntemlerini, bir siparişin entegrasyonlar arasındaki yolunu, kargo ve e-fatura tarafında dikkat etmeniz gerekenleri ve kuruluma başlamadan önce neleri hazırlamanız gerektiğini adım adım anlatıyoruz.
Pazaryeri entegrasyonları ne işe yarar? Satış, stok, kargo ve fatura katmanları
Çok kanallı satışta işin büyük kısmı satış gerçekleştikten sonra başlar: stok düşülür, sipariş onaylanır, fatura kesilir, paket hazırlanır, takip numarası girilir, sonra da hakediş kontrol edilir. E-ticaret entegrasyonları bu işleri dört katmanda birbirine bağlar. Her katman ayrı bir programla, ayrı bir ekranda yönetildiğinde aynı bilgi birkaç kez yazılır ve hataların çoğu da bu geçişlerde çıkar.
| Katman | Neyi bağlar | Entegrasyon yoksa ne olur |
|---|---|---|
| Satış kanalı (pazaryeri, kendi siteniz, katalog) | İlan, stok, fiyat, sipariş, iade | Her panele ayrı giriş yapılır; bir kanalda biten ürün ötekinde satışta kalır |
| Ürün ve stok | Tek stok kartı, varyant, paket ve set stoğu | Aynı ürün için birden fazla sayı tutulur, aşırı satış riski doğar |
| Kargo ve lojistik | Barkod, etiket, takip numarası, kargo kesintisi | Takip numarası kopyala-yapıştır ile taşınır, geciken gönderi geç fark edilir |
| Muhasebe ve e-fatura | e-Arşiv ve e-Fatura, alış faturaları, KDV özeti | Fatura siparişten ayrı kesilir, pazaryerine tek tek yüklenir |
eticaretcim'de bu dört katman aynı ürün kartında buluşur: 80 satış kanalı, 57 kargo ve lojistik firması, 51 muhasebe, e-fatura ve ERP programı. Kanalların 48'i kullanıma hazırdır, kalanı yakında ya da beta durumundadır; kargo firmalarının da bir kısmı beta aşamasındadır. Pazaryeri entegrasyonlarının temeli stok ve fiyat bilgisidir; bu katmanın kanal başına fiyat farkı ve stok çakışmalarıyla nasıl işlediğini stok ve fiyat senkronizasyonu sayfasında ayrıntılı bulabilirsiniz.
API, XML ve Excel: entegrasyon yöntemleri arasındaki fark
Bir entegrasyonun ne kadar güvenilir olduğunu büyük ölçüde bağlantı yöntemi belirler. Satıcıların karşılaştığı üç yöntem vardır ve her biri farklı bir iş için uygundur.
Pazaryeri API entegrasyonu
Pazaryerleri, satıcıların mağazalarını kendi sistemlerine bağlayabilmesi için API (uygulama programlama arayüzü) sunar. Örneğin Trendyol'un geliştirici dokümanı, API'nin ürün aktarımı, stok ve fiyat güncellemesi, sipariş işleme ve fatura gönderimi için kullanıldığını belirtir. Bağlantı için satıcı panelinizin entegrasyon bölümünde size verilen API anahtarı ve satıcı numarası gibi bilgiler girilir. Mağaza şifrenizi paylaşmanız gerekmez. API bağlantısı iki yönlüdür: stok ve fiyat kanala gider, sipariş ve iade bilgisi kanaldan gelir. eticaretcim'de de kanal bağlantısı resmî API anahtarıyla kurulur.
XML entegrasyonu ve CSV beslemeleri
XML entegrasyonu çoğunlukla tek yönlüdür. Tedarikçinizin ürün listesini, stok ve fiyatını almak ya da Google Merchant, Meta Catalog gibi katalog kanallarına ürün göndermek için kullanılır. Sipariş geri gelmediği için tek başına pazaryeri satışını yönetmeye yetmez. Panelde tedarikçi XML ve CSV akışları kâr marjınızla fiyatlanır ve ortak ürün havuzuna alınabilir; havuzdan gelen sipariş tedarikçiye iletilir.
Excel ile toplu yükleme
Pazaryerlerinin çoğu toplu ürün yükleme için şablon dosya sunar. İlk ilan açılışında işe yarar, ama stok her satışta değiştiği için sürekli eşitleme için uygun değildir: dosyayı hazırlayıp yükleyene kadar geçen sürede satılan ürün öbür kanalda açık kalır.
Örnek: bir sipariş pazaryeri, kargo ve fatura entegrasyonlarından nasıl geçer?
Entegrasyonların değeri, bir siparişi baştan sona izlediğinizde en net biçimde görülür. Diyelim ki aynı tişört Trendyol, Hepsiburada ve Shopify sitenizde satışta ve depoda 3 adet var.
- Müşteri Hepsiburada'dan 1 adet alır; sipariş tek sipariş listesine Yeni durumuyla düşer.
- Stok, tek stok kartından 1 adet düşer ve kalan 2 adet Trendyol ile Shopify'a gönderilir.
- Otomatik onay açıksa sipariş Hazırlanıyor durumuna geçer; kapalıysa siz onaylarsınız.
- Bağlı fatura programınızda e-Arşiv ya da e-Fatura kesilir, sipariş Faturalandı olur; kanal destekliyorsa fatura PDF'i pazaryerine yüklenir.
- Birincil kargo firmanızdan barkod ve etiket alınır, takip numarası pazaryerine iletilir ve sipariş Kargolandı durumuna geçer.
- Teslimden sonra hakediş yattığında komisyon ve kargo kesintisi sipariş bazında kontrol edilir.
Bu adımların çoğu ayrı bir bağlantıya dayanır ve biri koptuğunda zincir aksar. Kargo bağlantısı yoksa takip numarası elle girilir; fatura bağlantısı yoksa Faturalandı aşaması ayrı bir programda takip edilir. Siparişlerin bu durumlar arasında nasıl ilerlediğini ve geciken sipariş uyarısının nasıl çalıştığını pazaryeri sipariş yönetimi sayfasında görebilirsiniz.
Aynı stokla birden fazla kanalda satarken ilk risk, son adedin iki kanalda birden satılmasıdır. Çok kanallı stokta aşırı satışı önleme rehberi bu konuyu örneklerle anlatıyor. Altıncı adım ise çoğu satıcının en az kontrol ettiği yerdir: sipariş bazında net kâr, fazla kesilen komisyon, fazla kargo kesintisi ve ödenmeyen hakedişler hakediş mutabakatı ekranında listelenir.
Kargo entegrasyonu: etiket, takip numarası ve kesinti kontrolü
Kargo entegrasyonu, siparişteki alıcı ve paket bilgisini kargo firmasının sistemine aktarıp barkodlu etiket ve takip numarası üreten bağlantıdır. Pazaryeri satıcıları genellikle iki modelden birini, bazen ikisini birlikte kullanır.
Pazaryerinin anlaşmalı kargosu
Bazı pazaryerleri kendi anlaşmalı kargo seçeneğini sunar; gönderi bilgisi pazaryerinden gelir, kargo ücreti hakedişinizden kesilir. Bu modelde kargo entegrasyonunun asıl işi, kesilen tutarı siparişle eşleştirmek ve beklenenden yüksek kesintiyi görünür kılmaktır. Koşullar ve ücretler kanala, desiye ve döneme göre değişir; güncel tarifeyi satıcı panelinizden kontrol edin.
Kendi kargo sözleşmenizle gönderim
Bir kargo firmasıyla kendi anlaşmanız varsa panele o firmanın entegrasyon bilgileriyle bağlanırsınız. Birincil kargo firmanızı seçer, etiketleri toplu basar, takip numarasını pazaryerine otomatik gönderirsiniz. Kendi sitenizden gelen siparişler de aynı sipariş listesine düştüğü için depo tek bir etiket düzeniyle çalışabilir.
- Kargo firmanızın şubesinden ya da müşteri temsilcinizden entegrasyon kullanıcı bilgilerini isteyin.
- Hangi kanalda anlaşmalı kargo, hangisinde kendi sözleşmenizi kullandığınızı tek bir tabloda yazın.
- Ürünlerin desi bilgisini güncel tutun; fazla kargo kesintisini fark edebilmek için doğru desiyi bilmeniz gerekir.
- İade gönderileri için kimin etiket oluşturacağını önceden belirleyin.
Firma seçimi, birincil kargo ayarı ve toplu etiket akışının ayrıntıları kargo entegrasyonu sayfasında yer alıyor.
e-Fatura entegrasyonu: internet satışında mevzuatın istedikleri
Fatura entegrasyonu, siparişteki alıcı, ürün, tutar ve KDV bilgisini e-fatura sağlayıcınıza ya da muhasebe programınıza aktarır ve oluşan belgeyi siparişe bağlar. Pazaryeri satıcısı için bunun iki gerekçesi vardır: sipariş hacmi arttığında faturayı elle kesmek yetişmez, ayrıca internet satışında faturada bulunması gereken ek bilgiler vardır.
e-Arşiv faturada bulunması gereken bilgiler
Gelir İdaresi Başkanlığı'nın 509 Sıra No'lu Vergi Usul Kanunu Genel Tebliği'ne göre elektronik ticaret kapsamındaki satışlar için düzenlenen e-Arşiv faturalarda aşağıdaki bilgiler zorunludur ve faturada "Bu satış internet üzerinden yapılmıştır." ifadesi yer almalıdır:
- Satış işleminin yapıldığı web adresi
- Ödeme şekli ve ödeme tarihi
- Mal satışlarında gönderiyi taşıyanın adı soyadı ya da unvanı ile VKN/TCKN bilgisi
- Malın gönderildiği ya da hizmetin ifa edildiği tarih
- İade bölümünde malı iade edenin adı soyadı, adresi, imzası ile iade edilen malın cinsi, miktarı, birim fiyatı ve tutarı
Aynı tebliğe göre kendi sitesinde ya da aracı hizmet sağlayıcılarına ait sitelerde, yani pazaryerlerinde mal veya hizmet satan mükelleflerden 2022 ve sonraki hesap dönemlerinde brüt satış hasılatı 500 bin TL ve üzeri olanlar e-Fatura ve e-Arşiv Fatura uygulamasına geçmek zorundadır. Geçiş, sınırın aşıldığı hesap dönemini izleyen yedinci ayın başına kadar tamamlanır. Bu alanların çoğu siparişte ve kargo kaydında zaten bulunur; faturayı siparişten üretmek bu bilgileri ikinci kez yazma ihtiyacını azaltır.
Muhasebe entegrasyonu: otomatik e-Arşiv, alış faturası ve KDV özeti
Bağlı programınızla siparişe otomatik e-Arşiv ya da e-Fatura kesilir, kanal destekliyorsa PDF pazaryerine yüklenir. Alış faturalarınızı PDF'ten yapay zekâ ile okutabilir, aylık KDV özetini görebilirsiniz. Akışın tamamı e-Fatura ve e-Arşiv entegrasyonu sayfasında anlatılıyor.
Hangi satış kanalını önce bağlamalı? Kanal türleri ve öncelik sırası
Bütün kanalları aynı gün açmak gerekmez; çoğu satıcı için doğru yol, kanalları türüne göre ayırıp sırayla bağlamaktır. Kullanıma hazır 48 kanalı beş grupta toplayabiliriz:
- Yurt içi pazaryerleri: Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, idefix, PttAVM, Koçtaş Pazaryeri, Teknosa Pazaryeri, Modanisa, Decathlon.
- Yurt dışı pazaryerleri: Amazon, eBay, Etsy, Ozon, Joom, Walmart Marketplace, Fruugo, OnBuy, bol.com, Allegro, Zalando, AliExpress, TikTok Shop.
- E-ticaret altyapıları: Shopify, WooCommerce, Ticimax, ikas, İdeaSoft, T-Soft, OpenCart, Magento, PrestaShop, Wix Stores, BigCommerce.
- Katalog kanalları: Google Merchant, Meta Catalog, Facebook Shop, Instagram Shop, Microsoft Merchant Center, Pinterest Catalog, YouTube Shopping, TikTok Catalog, Snapchat Catalog, Google Free Listings.
- Fiyat karşılaştırma siteleri: Akakçe, Cimri, Epey.
Pratik bir sıralama şöyle olabilir: önce en çok sipariş aldığınız pazaryerini bağlayın ve barkod eşleşmesini orada doğrulayın. İkinci adımda kendi sitenizi ekleyin, çünkü site ile pazaryeri aynı stoğu paylaştığında aşırı satış riski en çok orada görülür. Ardından ürün kategorinize uyan diğer yurt içi pazaryerlerine geçin. Yurt dışı kanallarda ayrıca teslim süresi, iade adresi ve döviz fiyatlaması planlanmalıdır. Katalog ve fiyat karşılaştırma kanalları ise ürünlerinizi alışveriş aramalarında ve karşılaştırma listelerinde gösterir; bunları stok ve fiyatınız düzenli hale geldikten sonra açmak daha sağlıklıdır.
Komisyon oranları kanaldan kanala ve kategoriden kategoriye değiştiği için her kanala aynı fiyatı göndermek kârı eritebilir. Panelde kanal başına yüzde ya da tutar olarak fiyat farkı tanımlanır; güncel komisyon oranını her kanalın satıcı panelinden kontrol edin.
Entegrasyon kurulumuna nasıl hazırlanılır?
Entegrasyonun sorunsuz başlaması büyük ölçüde ürün verinizin düzenine bağlıdır. Mevcut ilanlarınız panele okunur, barkod ya da stok koduyla eşleşir ve siz onaylamadan hiçbir ilan değişmez. Yine de aşağıdaki hazırlık eşleşme aşamasını kısaltır.
Başlamadan önce hazırlanacak bilgiler
- Her kanal için satıcı panelindeki entegrasyon bilgileri (API anahtarı, satıcı numarası).
- Barkod ve stok kodu listesi: aynı ürünün bütün kanallarda aynı barkodla açık olması eşleşmeyi kolaylaştırır.
- Varyant yapısı: beden ve renk kombinasyonlarının her kanalda aynı kurgulandığından emin olun.
- Paket ve set ürünleri: 5'li ya da 10'lu paketlerin hangi tekil ürünün stoğundan düşeceği.
- Kanal bazında fiyat farkı, kargo firması ve fatura programı bilgileri.
Kurulumda sık yapılan hatalar
- Aynı ürünü farklı kanallarda farklı barkodla açmak: ürün eşleşmez ve stok iki ayrı sayı olarak kalır. Paneldeki stok çakışmaları listesi bu tür uyuşmazlıkları bulmanıza yardım eder.
- Paket ürüne ayrı stok tutmak: tekil ürün biterken paket satışta kalır. Paket stoğu tek stok biriminden, set stoğu bileşenlerinden düşmelidir.
- Reddedilen ilanları takip etmemek: kanal ilanı reddettiğinde stok güncellenmez. Senkron sağlığı ekranı reddedilen ilanın sebebini gösterir.
- Kritik stok seviyesini tanımlamamak: son adetler bittiğinde fark etmek için uyarı eşiği belirleyin.
İsterseniz kurulum birlikte yapılır. Ekranları kurulumdan önce görmek isterseniz panel turu sayfasına göz atabilirsiniz.
Hangi pakette kaç kanal, kargo ve e-Fatura entegrasyonu var?
Kaç satış kanalı, kaç kargo firması ve kaç fatura programı bağlayabileceğiniz paketinize göre belirlenir. Aşağıdaki tablo yalnız entegrasyon kapsamını özetler; fiyatlar aylıktır ve yıllık ödemede %20 indirim uygulanır.
| Paket | Aylık | Satış kanalı | Kargo entegrasyonu | Tedarikçi XML | e-Fatura programı |
|---|---|---|---|---|---|
| Başlangıç | ₺499 | 1 (Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM, idefix'ten biri) | Yok, takip numarası elle | Yok | Yok |
| Büyüme | ₺999 | 3 (80 kanaldan herhangi üçü) | 1 firma | Sınırsız | Yok |
| Profesyonel | ₺1.999 | 5 (28 kanaldan) | 2 firma | 3 akış | 1 program |
| Kurumsal | ₺3.999 | Sınırsız | 5 firma | 10 akış | 3 program |
| Enterprise | ₺7.999 | Sınırsız | Sınırsız | Sınırsız | Sınırsız |
Bütün paketlerde stok ve fiyat senkronu, merkezi sipariş listesi ve stok sağlığı raporu bulunur. Büyüme paketinden itibaren toplu işlemler ve kural motoru, Profesyonel paketten itibaren ürün ve kanal bazında kâr ile kesinti raporları eklenir. Limitlerin tamamını ve paket karşılaştırmasını pazaryeri entegrasyonu fiyatları sayfasında bulabilirsiniz; 3 günlük ücretsiz deneme süresinde bağlantıları kendi ürünlerinizle test edebilirsiniz.
Pazaryeri entegrasyonları hakkında sık sorulan sorular
Pazaryeri entegrasyonu için mağaza şifremi vermem gerekir mi?
Hayır. Pazaryerlerinde bağlantı, satıcı panelinde size verilen resmî API bilgileriyle ya da kanalın kendi yetki ekranında verdiğiniz izinle kurulur; fiyat karşılaştırma siteleri XML beslemesiyle bağlanır. Panel şifreniz sizde kalır ve entegrasyon için paylaşılmaz.
Entegrasyonu bağladığımda mevcut ilanlarım değişir mi?
Bağlantı kurulduğunda mevcut ilanlarınız panele okunur ve barkod ya da stok koduyla eşleştirilir. Siz onaylamadan hiçbir ilanın stoğu, fiyatı ya da içeriği değişmez.
Kargo entegrasyonu için kargo firmasıyla ayrıca sözleşme yapmam gerekir mi?
Kendi sözleşmenizle gönderim yapacaksanız evet, panele o sözleşmenin entegrasyon bilgileriyle bağlanırsınız. Pazaryerinin anlaşmalı kargosunu kullanıyorsanız etiket pazaryeri tarafından sağlanır. Başlangıç paketinde kargo entegrasyonu yoktur, takip numarası elle girilir.
e-Fatura entegrasyonu hangi pakette var?
Muhasebe ve e-fatura programı bağlantısı Profesyonel pakette 1, Kurumsal pakette 3 program ile sunulur; Enterprise pakette sınırsızdır. Başlangıç ve Büyüme paketlerinde fatura entegrasyonu bulunmaz.
Pazaryeri entegrasyonu kurulumu ne kadar sürer?
Süre ürün sayınıza, barkod düzeninize ve bağlayacağınız kanal sayısına göre değişir. Barkodları kanallar arasında tutarlı olan bir katalogda eşleşme aşaması kısalır. Sorularınız için 15 dakikalık demo görüşmesi isteyebilir, kurulumu ekibimizle birlikte yapabilirsiniz.
Listede olmayan bir satış kanalı ya da program bağlanabilir mi?
Panelde tanımlı 80 satış kanalının 48'i kullanıma hazırdır, kalanı yakında ya da beta durumundadır. Kullandığınız kanal ya da program listede görünmüyorsa 0850 304 29 78 numarasından veya [email protected] adresinden durumunu sorabilirsiniz.
- Trendyol Developers - Marketplace API entegrasyon dokümanı
- GİB - 509 Sıra No'lu VUK Genel Tebliği (güncel metin, 2026)
- GİB e-Belge duyuruları
Son kontrol: · Bilgiler resmî kaynaklardan derlendi · Hazırlayan: eticaretcim ekibi


























































































































