Fruugo entegrasyonu:
ürün, stok ve sipariş tek panelde.

Fruugo entegrasyonu: ürün beslemesi, stok ve yurt dışı siparişleri tek panelden yönetmek

Fruugo entegrasyonu, Türkiye'deki stokunuzu kırkı aşkın ülkedeki müşterilere açarken aynı ürünü iki kanalda birden satma riskini azaltmanın yoludur. Döviz ve ödeme işleme tarafını Fruugo yürütür; size düşen iş doğru bir ürün beslemesi, tutarlı stok ve zamanında kargodur. Bu bölümde başvurudan ödeme takvimine kadar Fruugo'nun güncel kurallarını ve bunları eticaretcim panelinde nasıl karşılayacağınızı adım adım anlatıyoruz.

Fruugo'da satış yapmak için başvuru ve hazırlık

Fruugo, satıcı sayfasında kendi gönderim araçlarıyla kırkı aşkın müşteri ülkesine ulaşılabildiğini belirtir. Pazaryerine katılmadan önce işletmenizin doğrulanması gerekir. Bazı ürün kategorileri ve müşteri bölgeleri için satış açılmadan önce ek doğrulama istenir; bu yüzden ilk günden bütün kataloğu açmayı değil, belgeleri hazır kategorilerle başlamayı planlayın.

1. Fruugo'nun satıcılar için temel şartlarını (Seller Key Requirements) ve başvuru sürecini okuyun.
2. Hazır olduğunuzda kayıt formunu doldurun.
3. Fruugo ekibi sizinle iletişime geçer, kalan sorularınızı yanıtlar ve başvurunuzu tamamlamanıza yardım eder.
4. İşletme doğrulaması tamamlanınca, gerekiyorsa belirli kategoriler ve bölgeler için ek doğrulama yapılır.
5. Entegrasyon yöntemini seçer, ürün beslemenizi ve sipariş akışınızı bağlarsınız.

Fruugo ürün beslemesi nasıl hazırlanır? Zorunlu alanlar

Fruugo'da ürün başlığı, açıklama, fiyat ve kategori ürün beslemesiyle (product feed) taşınır. Beslemedeki küçük bir hata, ürünün yayına hiç çıkmamasına ya da yanlış seçenekle eşleşmesine yol açabilir. eticaretcim'de ürün bilgisi tek stok kartında durduğu için Fruugo'ya gidecek bilgiyi de bu karttan yönetirsiniz. Kurulumda aşağıdaki üç noktayı mutlaka kontrol edin.

ProductId ve SkuId alanları nasıl doldurulur?

ProductId, sipariş bilgisinde tanıyacağınız kendi ürün kodunuzdur; renk, beden gibi seçenekleri olan ürünlerde bütün seçenekler aynı ProductId altında toplanır. SkuId ise her seçeneği ayrı ayrı tanımlar ve zorunludur. Fruugo, her ProductId ve SkuId ikilisinin yalnız tek bir ürüne ait olmasını, başka bir üründe tekrar kullanılmamasını ister. Paneldeki varyantlı stok kartları bu yapıya karşılık gelir; stok kodlarınızı tutarlı tutmak eşleşme hatalarını önler.

EAN/GTIN zorunluluğu ve üretici istisnası

EAN alanı Fruugo'nun zorunlu alanlarındandır ve 8, 12, 13 ya da 14 haneli GTIN kabul eder; kitaplar bu kuralın dışındadır. Ürünün üreticisi sizseniz alana EXCEP yazarak istisna bildirebilirsiniz. Barkodu eksik ürünleri gönderimden önce tamamlamak, reddedilen ilanlarla sonradan uğraşmaktan daha az zaman alır.

LeadTime ve RestockDate ne zaman kullanılır?

Fruugo'da ürünlerin varsayılan gönderim süresi 1 gündür. Stokta olan bir ürünü 24 saatte gönderemiyorsanız LeadTime alanına siparişten çıkışa kadar geçecek yaklaşık gün sayısını yazarsınız. Stokta olmayan (OUTOFSTOCK) bir ürün için ise RestockDate alanıyla ürünün yeniden ne zaman satışa hazır olacağını bildirirsiniz.

Fruugo stok entegrasyonu ve fiyat güncellemesi

Fruugo stok entegrasyonu, Türkiye'de satılan son ürünün yurt dışında da satışta kalmasını önleyen katmandır. Fruugo'nun Stock Status API'si yalnız stok durumunu ve stok adedini günceller; başlık ya da fiyat bu yolla değişmez, ürün beslemesinden yönetilir. Yani stok ve fiyat Fruugo'ya iki ayrı yoldan ulaşır. İkisini panelde aynı karttan yönettiğinizde birini güncelleyip diğerini unutma ihtimali azalır.

• Trendyol'dan ya da Hepsiburada'dan gelen sipariş ortak stoku düşürür; Fruugo'ya giden stok bilgisi de aynı karttan güncellenir.
• Kritik stok uyarısı, stoku azalan ürünü fark etmenizi ve gerekirse Fruugo'da satışı zamanında kapatmanızı kolaylaştırır.
• Stok çakışmaları listesi, kanallar arasında farklı görünen adetleri yan yana gösterir.
• Senkron sağlığı ekranı reddedilen ilanın sebebini gösterir; EAN ya da kategori hatasını buradan yakalarsınız.

Stok mantığının ayrıntısı için stok ve fiyat senkronizasyonu sayfasına, birden fazla kanalda satarken eksi stoka düşmemek için hazırladığımız aşırı satışı önleme rehberine bakabilirsiniz.

Fruugo komisyon oranı 2026 ve fiyatlama

Fruugo 1 Ocak 2026'dan itibaren tek ve sabit bir ücret modeline geçti: ürün beslemesinde belirlediğiniz fiyatın, kargo dahil, %20'si kesilir ve listelediğiniz fiyatın %80'i size kalır. Bu ücret komisyonu, ödeme işleme maliyetini, trafik ve pazarlama yatırımını kapsar. Fruugo aylık ücret ve listeleme ücreti almadığını belirtir, ancak ücretsiz listelemede limitler uygulanabileceğini de not eder. Aşağıdaki tablo beslemedeki fiyat üzerinden basit bir hesap örneğidir.

Yurt dışı kargo ve paketleme maliyetiniz Türkiye'deki kanallardan farklı olduğu için Fruugo'ya yurt içindeki fiyatın aynısını göndermek çoğu zaman zarar demektir. Panelde kanal başına yüzde ya da tutar olarak fiyat farkı tanımlayıp Fruugo fiyatını ana fiyattan otomatik türetebilirsiniz. Gerçekleşen kesintileri sipariş bazında izlemek için hakediş mutabakatı özelliğini kullanabilirsiniz.

Fruugo sipariş entegrasyonu ve yurt dışı kargo

Fruugo'nun Order API'si siparişleri indirmeyi, onaylamayı, kargoya verildi olarak işaretlemeyi, iptal ve iade adımlarını ve paketleme fişinin (packing slip) PDF olarak alınmasını kapsar. Fruugo'nun önerdiği akış şöyledir: siparişi indirin, onaylayın, ürün hazır olunca kargolandı olarak işaretleyin, paketleme fişini yazdırıp pakete koyun. Gönderiyi varsayılan 1 gün ya da ürüne tanımladığınız LeadTime içinde çıkarmanız beklenir; müşteriler sipariş durumunu ve takip bilgisini Fruugo üzerinden izler.

• Fruugo siparişleri diğer kanallarla aynı listeye düşer ve Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim aşamalarından geçer.
• Geciken sipariş uyarısı, gönderim süresini kaçırmak üzere olduğunuz siparişleri öne çıkarır.
• Kendi kargo sözleşmenizle bağladığınız firmadan etiket alır, takip numarasını pazaryerine iletirsiniz.
• Toplu etiket ve fatura, yoğun günlerde yurt dışı paketlerini tek seferde hazırlamanızı sağlar.

Kargo firması bağlantılarının nasıl kurulduğunu kargo entegrasyonu sayfasında anlattık. Yurt dışı satışta fatura düzenleme, gümrük beyanı ve alıcı ülkedeki vergiler ürününüze ve gönderim şeklinize göre değişir; bu kararları mali müşavirinizle birlikte verin.

Fruugo ödeme takvimi ve hakediş kontrolü

Fruugo ödemeleri haftalık yapar. Bir siparişin ödemeye girmesi için teslimattan itibaren işleyen 14 günlük cayma süresinin dolması gerekir. Ödeme, Fruugo ücreti düşülmüş olarak yerel para biriminizde yapılır ve her ödemeyle birlikte ayrıntılı bir fatura gelir.

Bu takvim, bugün kargoladığınız bir siparişin parasının birkaç hafta sonra hesabınıza geçeceği anlamına gelir. Nakit akışını planlarken şu kontrolleri haftalık rutine dönüştürün:

• Ödemedeki sipariş listesini paneldeki teslim edilen siparişlerle karşılaştırın.
• Beklenen %20 ücret dışında bir kesinti varsa sipariş bazında işaretleyin.
• Cayma süresi dolduğu halde ödemeye girmeyen siparişleri ayrıca takip edin.
• Zarar eden siparişleri ve kanal karşılaştırmasını inceleyip Fruugo fiyat farkınızı güncelleyin.

Fruugo entegrasyon programı: kurulum ve paket seçimi

Fruugo, entegrasyon ortakları ve e-ticaret platformları aracılığıyla ürün verisinin gönderilmesine ve siparişlerin satıcının kendi sistemine alınmasına imkân tanır. eticaretcim'de bağlantı resmî API erişim bilgileriyle kurulur; mağaza şifrenizi paylaşmazsınız. Mevcut ürünleriniz barkod ya da stok koduyla eşleştirilir ve siz onaylamadan hiçbir ilan değişmez. İsterseniz kurulumu birlikte yaparız.

1. Fruugo hesabınızdan API erişim bilgilerini alın.
2. Panelde Fruugo kanalını ekleyip bu bilgileri girin.
3. Ürünlerin barkod ve stok kodu eşleşmesini kontrol edin, eksik EAN'ları tamamlayın.
4. Fruugo için kanal fiyat farkını tanımlayın.
5. Değişiklikleri gözden geçirip onaylayın, ilk siparişleri ortak sipariş listesinden takip edin.

Başlangıç paketi yalnız yurt içindeki yedi kanaldan birini kapsadığı için Fruugo'yu Büyüme paketi (₺999, 80 kanaldan herhangi üçü) ve üzerindeki paketlerde kullanabilirsiniz; bütün seçenekler paket fiyatları sayfasında. Yurt dışına açılmak için bakabileceğiniz bir başka kanal OnBuy entegrasyonu; bağlanabileceğiniz bütün pazaryerlerini entegrasyonlar listesinde bulabilirsiniz. Kurulumu kendi ürünlerinizle görmek isterseniz iletişim sayfasından 15 dakikalık bir demo görüşmesi isteyebilirsiniz.