Mikro Trendyol Entegrasyonu: Pazaryeri Siparişini Mikro'ya Aktarmak

Mikro Trendyol entegrasyonu hangi verileri hangi yönde taşır?

Mikro Trendyol entegrasyonu üç ayrı veri akışından oluşur: sipariş pazaryerinden Mikro'ya, stok ve fiyat Mikro'dan pazaryerine, sipariş durumu ve iade bilgisi pazaryerinden Mikro'ya. Bu üç akışın her biri farklı bir sıklıkla çalışır ve farklı bir hata davranışına ihtiyaç duyar.

Bu ayrım önemlidir, çünkü dördüncü satır çoğu projede unutulur. Komisyon ve pazaryeri indirimleri Mikro'ya kayıt olarak yazılmak zorunda değildir; ama ay sonunda hakediş raporuyla karşılaştırılabilmesi için bir yerde saklanmaları gerekir.

Pazaryeri siparişinden ne veri gelir?

Trendyol'un satıcı API'si siparişi "sipariş paketi" olarak verir ve paket, sipariş numarasından ayrı bir kimlik taşır. Trendyol'un geliştirici belgesine göre bölünen ya da kısmen iptal edilen bir sipariş aynı sipariş numarasını korur, ama paketi yeni bir paket kimliği ve yeni bir kargo barkodu alır. Mükerrer kayıt kontrolünü yalnızca sipariş numarasına bağlarsanız bölünmüş paketlerde ya kayıt kaçırırsınız ya da çift kayıt üretirsiniz.

Sipariş paketinde entegrasyon için önemli alanlar şunlardır:

• Sipariş satırları: Her satırda stok kodu ve barkod, miktar, birim fiyat, brüt tutar, satıcı indirimi ile pazaryeri indirimi ayrı alanlarda, KDV oranı ve komisyon bulunur.
• Fatura adresi: Alıcının adı, adresi ve kurumsal alıcıysa vergi dairesi ile vergi numarası.
• Kurumsal fatura işareti: Trendyol bir alanla alıcının kurumsal fatura isteyip istemediğini belirtir; bu alan kapalıysa vergi bilgileri gelmez.
• Durum: Oluşturuldu, hazırlanıyor, faturalandı, kargoda, teslim edildi, iptal, tedarik edilemedi, iade gibi durumlar.
• Kargo: Kargo firması ve takip numarası.

Belgeye göre sipariş sorgusunda tarih aralığı en fazla iki haftadır ve geriye dönük sorgu sınırlıdır. Trendyol ayrıca geliştirici belgesinde eski sipariş servisi için 15 Ekim 2026'yı kullanımdan kaldırma tarihi olarak duyurdu; bu tarihten itibaren v2 sipariş servisi zorunlu. Pazaryeri API'lerinin bu şekilde değişmesi olağandır; entegrasyonun bakım kalemi olarak sözleşmede yer almasının sebebi budur.

Erişim için gereken satıcı kimliği, API anahtarı ve API şifresi Trendyol satıcı panelinde Hesap Bilgilerim altındaki Entegrasyon Bilgileri sayfasında yer alır; belgeye göre bu sayfayı yalnızca panelin ana kullanıcısı görebilir. Hepsiburada tarafında da erişim mağaza hesabına bağlı bir Merchant ID ve panelin entegrasyon bölümünde tanımlanan bir servis anahtarıyla açılır. Menü yolu ve onay adımı Hepsiburada'nın güncel satıcı belgelerinde ya da satıcı destek hattında teyit edilir.

Mikro'ya yazmanın resmî yolu: Desktop API

Mikro'ya dışarıdan kayıt yazmanın üretici tarafından belgelenen yolu Mikro Desktop API'dir. JSON ile çalışan bu REST arayüzü makinede bir Windows servisi olarak koşar; varsayılan port V16 kurulumlarında 8084, V17 kurulumlarında 8094'tür. API kullanımı bir API Key gerektirir ve üreticinin belgesine göre firmaya özel yazılımlar için bu anahtar manuel lisansla verilir.

Mikro entegrasyonu açısından en önemli ayrıntı şudur: üretici API içindeki serbest SQL ucunu (SqlVeriOkuV2) yalnızca SELECT için belgeliyor. Yazma ise tipli uç noktalara bağlı. Cari için CariKaydetV2 gibi çağrılar, satış belgeleri için AlimSatimEvragiKaydetV2 gibi evrak uçları kullanılır. Mikro'nun değişiklik kaydına göre 17.05e sürümünde (14 Ocak 2026) bu uca hizmet, stok ve masraf kalemlerini tek JSON yapısında gönderme imkânı eklendi. Pazaryeri siparişinde ürün satırlarının yanında kargo gibi hizmet satırı da olduğu için bu ayrıntı işe yarar.

Kullanılacak uç noktanın adı ve sürümü, kurulumunuzdaki API sürümüne göre teyit edilir. Mikro uç noktaları V1, V2, V3 sonekiyle sürümler ve değişiklik kayıtlarında kırıcı değişiklik ayrıca etiketlenmez. Bu yüzden port, uç nokta sürümü ve kimlik bilgileri koda gömülmez, yapılandırmada tutulur.

Sipariş olarak mı, fatura olarak mı yazılmalı?

Pazaryeri siparişini Mikro'ya sipariş evrakı olarak mı yoksa doğrudan satış faturası olarak mı yazacağınız, deponuzun nasıl çalıştığına bağlıdır. Sipariş evrakı, hazırlık ve sevk sürecini Mikro içinde izliyorsanız doğru seçimdir; fatura ise sipariş anında sevk edilen ve hazırlık takibi Mikro dışında yapılan işlerde tercih edilir.

• Sipariş evrakı: Depo, siparişi Mikro'dan görüp hazırlar; faturalama sevk anında yapılır. İptal, faturalamadan önce gelirse yalnızca sipariş kapatılır.
• Doğrudan fatura: Daha az adım vardır, ama faturalandıktan sonra gelen her iptal bir iade ya da iptal işlemi doğurur.

e-Arşiv ve e-Fatura belgesinin hangi sistemden ve hangi anda düzenleneceği ayrı bir karardır. Belge Mikro'dan mı, pazaryerinin önerdiği bir e-belge hizmetinden mi kesilecek, bunu mali müşavirinizle birlikte belirleyin. Entegrasyon bu karara göre kurulur, kararı entegrasyon vermez.

Mikro'nun iki veri kuralı

Mikro'ya yazan her entegrasyon iki kurala uymalıdır. Birincisi, tarih alanlarına saat bilgisi yazılmaz; saat taşıyan kayıt hata vermez ama gün bazlı raporlarda yanlış toplam üretir. Pazaryeri sipariş tarihini milisaniyeli zaman damgası olarak verir, Mikro'ya yazılmadan önce gün hassasiyetine indirgenir. İkincisi, kod tutan kolonlar ürünün kendi çözümleme fonksiyonlarıyla okunur, tahminle eşleştirilmez.

Bireysel müşteri carisi: üç model

Pazaryerinden gelen alıcı için Mikro'da cari açma kararı, entegrasyonun en çok tartışılan konusudur. Üç yaygın model vardır ve hangisinin uygun olduğu muhasebe yönteminize bağlıdır.

Karma model çoğu mağaza için dengeli bir başlangıçtır. Kurumsal alıcı için cari açılırken önce vergi numarasıyla mevcut cari aranır; varsa yeni cari açılmaz. Bireysel alıcı bilgisi tek cariye yazılan evrakın adres ve açıklama alanlarında taşınır.

Kişisel veri tarafında KVKK'nın genel ilkelerinden biri, verinin işlendiği amaçla bağlantılı, sınırlı ve ölçülü olmasıdır. Siparişi teslim etmek ve belgeyi düzenlemek için gerekmeyen alıcı bilgisini Mikro'ya taşımamak bu ilkeyle uyumludur. Hangi bilginin gerekli olduğunu belge türüne göre mali müşavirinizle belirleyin.

Stok kodu ve kalem eşleştirme

Stok kodu eşleştirme tablosu

Stok kodu eşleştirmesi, pazaryerindeki ürün tanımlayıcısını Mikro'daki stok koduna ve birime bağlayan, kodun dışında yönetilen bir tablodur. Trendyol satırında barkod ve satıcının kendi stok kodu birlikte gelir; Mikro'da ise STOKLAR tablosundaki stok kodu esastır. İkisi her zaman aynı değildir.

Tablodaki barkod ve kodlar örnektir. Tabloyu işletirken uyulması gereken kurallar şunlardır:

1. Eşleşmeyen satır kayda gitmez. Siparişin bir satırı bile eşleşmiyorsa sipariş Mikro'ya yazılmaz, bekleme listesine düşer ve sorumluya bildirim gider. Tahminle stok kodu seçen entegrasyon, stok farkını sessizce büyütür.
2. Set ürün çarpanla açılır. Üç adetlik set tek satır olarak satılır ama Mikro'da üç adet stok düşmelidir. Çarpan tablo satırında tutulur, kodda değil.
3. Varyant ayrı satırdır. Renk ve beden kombinasyonlarının her biri ayrı barkod ve ayrı Mikro stok koduyla eşleşir.
4. Tabloyu işletme sahibi yönetir. Yeni ürün açıldığında eşleştirme, geliştirici çağırmadan bir yönetim ekranından yapılır.
5. Ters yön de aynı tabloyu kullanır. Mikro'dan pazaryerine stok gönderilirken çarpan tersine uygulanır: 36 adet stok, koli barkodu için 3 koli olarak gönderilir.

Komisyon, kargo ve indirim kalemleri

Komisyon, müşteriye düzenlenen satış belgesinde yer almaz. Trendyol komisyon kesintisi için satıcıya ayrı bir fatura düzenler; faturanın güncel düzenleme ve görüntüleme biçimi satıcı panelinden teyit edilir. Sipariş satırındaki komisyon alanı ise Mikro'ya kayıt olarak değil, mutabakat raporu için saklanır.

Pazaryerinin kendi bütçesinden yaptığı indirimin satış belgesine ve kayıtlara nasıl yansıyacağı vergi kuralı açısından ayrıca değerlendirilmesi gereken bir konudur. Bu yazı kayıt yöntemi önermez; entegrasyon, mali müşavirinizin belirlediği kuralı her siparişte aynı biçimde uygular.

Mutabakat tablosunda her paket için sipariş numarası, paket kimliği, brüt tutar, iki indirim türü, komisyon ve kargo bilgisi saklanır. Ay sonunda bu tablo, pazaryerinin hakediş raporuyla satır satır karşılaştırılır. Fark çıkan paket listelenir; böylece "fark nereden geldi" sorusu tahmine bırakılmaz.

İade ve iptal akışı

İade ve iptal, siparişin hangi aşamada olduğuna göre farklı kayıt gerektirir ve entegrasyonun ayrı bir akışı olarak tasarlanmalıdır. Trendyol sipariş servisinde iptal ve tedarik edilemedi durumları ayrı bir filtreyle sorgulanır; iade edilen siparişler ise ayrı bir iade servisinden okunur.

1. Faturalamadan önce iptal: Sipariş Mikro'ya henüz yazılmadıysa hiç yazılmaz. Sipariş evrakı olarak yazıldıysa evrak kapatılır ya da iptal edilir; stok rezervi serbest kalır.
2. Faturalandıktan sonra iptal: Belgenin iptal mi edileceği yoksa iade belgesiyle mi karşılanacağı, belge türüne ve e-belge kurallarına bağlıdır. Bu karar mali müşavirle verilir; entegrasyon yalnızca durumu yakalar ve ilgili kişiye iş olarak düşürür ya da tanımlı kurala göre işlemi başlatır.
3. Müşteri iadesi kargoya verildiğinde: Mikro'da henüz kayıt açılmaz; iade bekleyenler listesine düşer.
4. İade depoya ulaştığında: Ürün kontrol edilir. Satılabilir durumdaysa satılabilir depoya, kusurluysa ayrı bir depoya giriş yapılır. Kontrol edilmeden satılabilir stoğa dönen iade, bir sonraki siparişte yanlış ürün gönderilmesine yol açabilir.
5. İade kabul ya da red: Pazaryeri panelindeki karar Mikro'daki iade evrakıyla eşleştirilir; reddedilen iade için evrak açılmaz.

Bu akışta en sık atlanan adım dördüncüsüdür. İade kaydının depo girişiyle aynı anda yapılması, barkod okutmayla kolaylaşır; depoda barkodlu stok takip programı kullanılıyorsa iade kabulü aynı el terminalinden yapılabilir.

Başlamadan önce: hazır paket mi, özel katman mı?

Pazaryeri ile Mikro arasındaki hazır entegrasyon paketleri standart akışta iyi çalışır. Tek depo, tekil ürünler ve standart belge biçimi varsa hazır paket genellikle yeterlidir; bu durumda özel geliştirme önermeyiz.

Özel katman; set ve koli çarpanı, birden fazla depo, mali müşavirin istediği özel kayıt düzeni ya da siparişin Mikro'ya düşmeden önce üretim veya tedarik kontrolünden geçmesi gerektiğinde anlam kazanır. İki seçenek birbirini dışlamaz: pazaryeri tarafını paketin, Mikro'ya yazma kurallarını özel katmanın yönettiği karma yapı da kurulabilir.

Kontrol listesi

Mikro entegrasyonu için geliştirmeye başlamadan önce şu maddeler yazılı olarak netleşmelidir:

• Mikro ürünü ve sürümü (V16 mı V17 mi), masaüstü mü Jump Bulut mu, kaç firma ve çalışma yılı aktif
• Mikro Desktop API anahtarının durumu ve başvuru adımları
• Siparişin Mikro'ya sipariş evrakı mı fatura mı olarak yazılacağı
• e-Arşiv ve e-Fatura belgesinin hangi sistemden kesileceği
• Cari modeli (ayrı, tek, karma) ve kurumsal alıcı kuralı
• Stok kodu eşleştirme tablosunun ilk hâli ve sorumlusu
• Kargo, satıcı indirimi ve pazaryeri indiriminin kayıt yöntemi
• İptal ve iade için durum bazlı kurallar
• Hata bildirimlerinin kime gideceği

Sıkça Sorulan Sorular

Trendyol siparişleri Mikro'ya otomatik düşebilir mi?

Evet. Sipariş Trendyol'un satıcı API'sinden okunur ve Mikro Desktop API'nin tipli uç noktalarıyla Mikro'ya sipariş ya da satış evrakı olarak yazılır. Bunun için Mikro tarafında API anahtarı, Trendyol tarafında satıcı panelindeki entegrasyon bilgileri gerekir. Hangi belge türünün yazılacağı deponuzun çalışma biçimine göre belirlenir.

Pazaryeri siparişleri için her müşteriye ayrı cari açmak zorunlu mu?

Entegrasyon açısından zorunlu değildir; her alıcıya ayrı cari, pazaryeri başına tek cari ya da karma model kurulabilir. Hangisinin uygun olduğu muhasebe yönteminize ve belge düzenleme kurallarına bağlıdır. Karar mali müşavirinizle verilir, entegrasyon bu kararı her siparişte aynı şekilde uygular.

Trendyol komisyonu Mikro'ya nasıl yansıtılır?

Komisyon, müşteriye kesilen satış belgesinde yer almaz. Trendyol komisyon için satıcıya ayrı bir fatura düzenler; bu faturanın kaydı muhasebe ekibinizin olağan alış belgesi akışında yapılır. Entegrasyon, sipariş satırındaki komisyon bilgisini mutabakat raporu için saklar.

Hepsiburada için de aynı yapı kullanılabilir mi?

Mikro tarafı, cari modeli, eşleştirme tablosu ve iade akışı aynı kalır. Değişen kısım pazaryeri bağlantısıdır: Hepsiburada'nın kendi kimlik bilgileri, durum adları ve servisleri vardır. Eşleştirme tablosunda pazaryeri sütunu bu yüzden bulunur; aynı Mikro stok kodu iki kanalın farklı kodlarına bağlanır.

Mikro sürümü yükselince entegrasyon bozulur mu?

Doğru kurulmuşsa bozulmaz, ama kendiliğinden de korunmaz. V16'dan V17'ye geçişte servisin dinlediği port değişir ve uç noktalar sürümlenir. Port ve uç nokta sürümü yapılandırmada tutulur, yükseltme öncesinde test ortamında bir kontrol turu yapılır.

Mikro ve pazaryeri bağlantınızı birlikte planlayalım

Mikro kullanıyorsanız ve Trendyol ya da Hepsiburada siparişlerini elle giriyorsanız, ilk adım yukarıdaki kontrol listesini sizin kurulumunuz üzerinde doldurmaktır. Hiçbir ERP üreticisinin bayisi değiliz; Mikro'nuz yerinde kalır, yanına resmî API üzerinden çalışan bir katman yazarız. Kapsam ve fiyat sözleşmede yazılıdır, teslim sonrası 15 gün ücretsiz hata düzeltme standardımızdır. İlk keşif görüşmesi online ve ücretsizdir; iletişime geçin ya da isterseniz WhatsApp'tan yazın.