Geliver entegrasyonu: hesap onayından pazaryeri siparişinin etiketine kadar
Geliver entegrasyonu, Geliver kargo platformundaki hesabınızı API token ile Yox İş Ortağım'a bağlayarak satış kanallarınızdan gelen siparişlerin gönderisini Geliver üzerinden açmanızı sağlayan bağlantıdır. Geliver bir kargo firması değil, birden çok kargo firmasının fiyat teklifini tek hesapta toplayan bir aracıdır; bu yüzden kurulumda hem Geliver hesabınızın kurallarını hem de her pazaryerinin kargo modelini bilmeniz gerekir. Bu rehberi Ekim 2026 itibarıyla Geliver'in kendi sayfalarında, geliştirici dokümanında ve pazaryerlerinin resmî kaynaklarında yazanlardan derledik. Hesap belgelerini, bakiye mantığını, gönderi durumlarını, Trendyol ve Çiçeksepeti siparişlerindeki farkı ve hangi pakette kullanılabildiğini tablolarla anlatıyoruz.
Geliver entegrasyonu nedir, hangi satıcının işine yarar?
Geliver entegrasyonu, siparişlerinizi tek tek Geliver paneline yazmadan, siparişin bilgileriyle Geliver'de gönderi açıp etiket ve takip numarasını siparişe geri getiren bağlantıdır. Platformun sahibi, Wix uygulama mağazasındaki kaydına göre Geliver Bilişim Yazılım Lojistik Ticaret Pazarlama Danışmanlık Arge A.Ş.'dir; şirketin Hakkımızda sayfası, girişimin 2021 yılının Ekim ayında Manisa Teknokent bünyesinde başladığını yazar. Geliver kendini anlaşma gerektirmeyen, herkese açık bir kargo platformu olarak tanıtır. Koliyi taşıyan her zaman seçtiğiniz kargo firmasıdır; Kargo API sayfasında adı geçen firmalar Aras Kargo, Yurtiçi Kargo, Sürat Kargo, PTT Kargo, HepsiJet, MNG Kargo ve Kolay Gelsin'dir.
Bir Geliver gönderisinin yaşam döngüsü: teklif, kabul, etiket
Geliver'in resmî JavaScript SDK dokümanına göre bir gönderi açıldığında kargo firmalarının fiyat teklifleri eşzamansız olarak hazırlanır; tekliflerden biri kabul edildiğinde etiket satın alınmış olur ve barkod, etiket bağlantısı ile takip bağlantısı gönderiye işlenir. Aynı doküman önemli bir istisnayı da not eder: bazı kargo firmalarında takip numarası, koli şubeye teslim edilene ya da firma tarafından alınana kadar oluşmayabilir. Entegrasyonu kullanırken “etiket elimde ama takip numarası boş” görüntüsünün en olağan sebebi budur; hata değil, firmanın işleyişidir.
Geliver kimin için anlamlı, kimin için gereksiz?
- Hiçbir kargo firmasıyla kurumsal sözleşmesi olmayan satıcılar: Geliver üyeliği ücretsizdir, anlaşma ve gönderi taahhüdü istemez.
- Kendi sitesinden ya da kendi kargonuzla çıkış yapılabilen pazaryerlerinden sipariş alan satıcılar; Çiçeksepeti bu kanalların en belirgin örneğidir.
- Gönderi başına farklı firmaların fiyatını ve tahmini teslim süresini karşılaştırmak isteyenler.
- Siparişlerinin büyük bölümü Trendyol'un anlaşmalı kargosuyla çıkan satıcılar için ise Geliver'in katkısı sınırlıdır, çünkü o siparişlerin kargo kodu pazaryerinden gelir.
Geliver hesabı açarken bilmeniz gerekenler: belgeler, bakiye ve kurallar
Geliver hesabı ücretsiz açılır ve kayıt sırasında kredi kartı istenmez; ancak gönderi oluşturabilmek için hesabın belgelerle onaylanması gerekir. Entegrasyonu kurmadan önce aşağıdaki kuralları bilmek, ilk siparişte takılmanızı önler. Tablodaki bilgiler Geliver'in ana sayfasından ve Geliver A.Ş.'nin yayımladığı WooCommerce eklentisinin resmî sayfasından alınmıştır.
| Konu | Geliver'in açıklaması (Ekim 2026) |
|---|---|
| Üyelik | Ücretsiz; kargo firmasıyla anlaşma ve gönderi taahhüdü istenmez |
| Şirket hesabı | Vergi mükellefleri için önerilir; vergi levhası ve imzalı üyelik sözleşmesi istenir |
| Bireysel hesap | Bireysel girişimciler için önerilir; e-Devlet'ten alınan ikametgâh belgesi ve imzalı üyelik sözleşmesi istenir |
| Belgelerin iletilmesi | [email protected] adresine e-postayla ya da WhatsApp üzerinden |
| Kapıda ödeme | Yalnız şirket hesaplarında; PTT Kargo ile kapıda ödeme için PTT posta çeki hesabı gerekir |
| Etiket bedeli | Hesaba yüklenen bakiyeden ödenir (WooCommerce eklentisinin gereksinimleri) |
| Birden çok koli | Birden fazla paket tek etiketle gönderilemez; bir paketin içine birden fazla ürün konabilir |
| Fiyat | Kargo firmasına, desiye ve ağırlığa göre değişir; güncel liste Geliver panelinde |
Şirket mi bireysel mi: kapıda ödeme kararı burada verilir
Hesap türünü seçerken yalnız vergi durumunuza değil, satış modelinize de bakın. Kapıda ödemeli satış yapıyorsanız ya da yapmayı düşünüyorsanız Geliver bu seçeneği yalnız şirket hesaplarına açar. PTT Kargo ile kapıda ödeme için ayrıca bir PTT Kargo şubesinden açtıracağınız posta çeki hesabı gerekir; bu hesap bilgisi Geliver'deki hesap bilgileri bölümüne girilir.
Bakiye: etiketin satın alındığı an
Geliver'de bir teklifi kabul etmek, o gönderinin etiketini satın almak demektir ve Geliver'in eklenti sayfası etiket alabilmek için hesapta yüklü bakiye bulunmasını şart koşar. Entegrasyon kurulduktan sonra siparişler panelden Geliver'e aktarılsa bile bakiye yetersizse etiket adımı tamamlanmaz. Kampanya ya da yoğun sipariş günlerinden önce bakiyenizi Geliver hesabınızdan kontrol etmeyi rutininize ekleyin.
Geliver API token nasıl oluşturulur ve panele nasıl girilir?
Geliver API token, Geliver hesabınızda sizin adınıza gönderi açma yetkisi veren erişim anahtarıdır ve Yox İş Ortağım'daki bağlantı için zorunlu tek bilgidir. Geliver'in Kargo API sayfasına göre token ücretsiz kayıttan sonra oluşturulur ve her organizasyon için ayrı API anahtarı tanımlanabilir. Kurulum sırası şöyledir:
- app.geliver.io adresinde kayıt olun ve hesap türünüzü (Şirket ya da Bireysel) seçin.
- İstenen belgeleri Geliver'e iletin ve hesabınızın onaylanmasını bekleyin.
- Gönderilerin çıkacağı gönderici adresini Geliver'de tanımlayın; Geliver'in SDK dokümanına göre gönderici adresinde telefon ve posta kodu zorunludur.
- app.geliver.io/apitokens sayfasında yeni bir API token oluşturun ve yalnız sizin erişebildiğiniz bir yerde saklayın.
- Yox İş Ortağım'da Kargo bölümünü açın, Geliver alanına token'ı yapıştırın, gerekiyorsa gönderici adresi ID'sini ekleyin ve “Bağlantıyı test et” ile doğrulayın.
- Siparişlerin hangi kargo hesabıyla gideceğini belirlemek için Geliver'i birincil kargo olarak seçin ya da ikinci hesap olarak bırakın.
Gönderici adresi ID'sini ne zaman girmelisiniz?
Gönderici adresi ID'si panelde isteğe bağlı bir alandır. Geliver'de tek bir gönderici adresiniz varsa boş bırakmanız çoğu durumda yeterlidir. Depo ve mağaza gibi birden çok çıkış adresiniz varsa ya da gönderilerin her zaman belirli bir adresten çıkmasını istiyorsanız bu alanı doldurun. Geliver'de adresi silip yeniden oluşturursanız yeni adresin kimliği değişir; paneldeki ID'yi de güncellemeniz gerekir.
Token güvenliği ve yenileme
Geliver entegrasyonu Yox İş Ortağım'da sipariş akışını nasıl değiştirir?
Geliver entegrasyonu kurulduğunda kargo işi siparişin kendisinden başlar: sipariş hazır olduğunda Geliver'de gönderi kaydı oluşturulur, takip numarası siparişe yazılır ve Geliver etiketi döndürdüğünde etiket panelden basılır. Yox İş Ortağım bağlantıyı Geliver'in satıcılarına sunduğu entegrasyon servisi üzerinden kurar; mağaza şifrenizi istemez, pazaryerlerine de resmî API anahtarıyla bağlanır.
Siparişten koliye: günlük iş nasıl ilerler?
- Pazaryerinden ya da sitenizden gelen siparişler tek sipariş listesinde toplanır.
- Geliver ile gidecek siparişte gönderi kaydı açılır; alıcı adı, adresi ve telefonu elle kopyalanmaz.
- Etiketi basıp koliye yapıştırırsınız; Geliver'in ana sayfasına göre şubede gönderi kodunu söyleyerek teslim edebilirsiniz.
- Kargo durumu Geliver üzerinden sorgulanır ve siparişe yansır: kargoya verildi, yolda, teslim edildi.
- Takip numarası ve kargo firması siparişin geldiği pazaryerine ya da sitenize iletilir; pazaryerinin kendi kargo kuralları geçerlidir.
Geliver gönderi durumları ne anlama gelir?
Geliver'in geliştirici dokümanı gönderileri belirli durum kodlarıyla listeler. Bu kodları bilmek, bir siparişin neden beklediğini anlamanızı kolaylaştırır:
| Geliver durumu | Anlamı | Sizin için anlamı |
|---|---|---|
| CREATED, GOT_OFFERS | Gönderi açıldı, kargo firmalarının teklifleri geldi | Teklif kabul edilmeden etiket oluşmaz |
| OFFER_ACCEPTED | Teklif kabul edildi, etiket satın alındı | Bedel bakiyeden düşer, etiket basılabilir |
| TRACKING_CODE_CREATED | Takip kodu oluştu | Numara siparişe ve kanala gidebilir |
| LABEL_PRINTED | Etiket basıldı | Koli teslime hazır |
| SHIPPED | Koli kargo firmasında | Siparişte kargoya verildi, yolda |
| DELIVERED | Alıcıya teslim edildi | Siparişte teslim edildi |
| CANCELED, RETURNED, FAILED | İptal, iade ya da hata | Siparişi ve Geliver hesabını birlikte kontrol edin |
Tablodaki TRACKING_CODE_CREATED adımı bazı firmalarda koli şubeye ulaştıktan sonra gerçekleşir. Bu yüzden pazaryerinin kargoya verme süresini takip ederken etiketin basıldığı saate değil, kolinin şubeye teslim edildiği saate göre plan yapın.
Pazaryeri siparişlerinde Geliver: hangi kanalda nasıl kullanılır?
Pazaryeri siparişlerinde Geliver'i kullanıp kullanamayacağınızı Geliver değil, siparişin geldiği kanalın kargo modeli belirler. Satıcıların çoğu pazaryerinin anlaşmalı kargosuyla çalışır ve bu siparişlerde kargo kodu pazaryerinden gelir. Geliver'in entegrasyon sayfasında listelenen mağaza bağlantıları arasında pazaryeri olarak Trendyol ve Çiçeksepeti yer alır; iki kanalın kuralları birbirinden belirgin biçimde farklıdır.
| Kanal | Kanalın resmî kargo kuralı | Geliver ile gönderim |
|---|---|---|
| Trendyol | Kargo firmaları listesinde yalnız Marketplace kodları var (ARASMP, YKMP, SURATMP, PTTMP, SENDEOMP gibi); üründeki kargo firması Trendyol sözleşmenizde onaylanan firmayla aynı olmalı | Kod Trendyol'dan gelir; ayrı Geliver gönderisi açmadan önce mağazanızın kargo modelini doğrulayın |
| Çiçeksepeti | Anlaşmalı kargo seçenekleri Yurtiçi, Sürat ve MNG; kendi anlaşmanız ve fiyatlarınızla çıkış için entegrasyon yazılımıyla API üzerinden çalışmanız gerekir; kargo ücreti satıcıya aittir | Geliver'in en doğal kullanım alanlarından biri |
| Hepsiburada, n11 ve diğerleri | Kendi kargonuzla gönderim izni mağaza ve kategori ayarına göre değişir | Satıcı panelinizin kargo ayarından teyit edin |
| Kendi siteniz | Kargo kuralını siz belirlersiniz | Doğrudan kullanılır |
Trendyol siparişinde Geliver etiketi basmadan önce
Trendyol'un geliştirici dokümanındaki takip kodu tablosunda, kendi kargo fiyatıyla çalışan satıcılar için de Trendyol'un anlaşmalı fiyatını kullananlar için de listelenen firmaların tamamında Trendyol kargo kodu kullanılır; aynı sayfada takip numarası güncelleme servisi kullanımdan kaldırılmış olarak işaretlenmiştir. Pratik sonuç: Trendyol'dan gelen bir siparişte etiketi Trendyol'un verdiği kodla basın, Geliver'de aynı sipariş için ikinci bir gönderi açmayın. Kanalın diğer kurallarını Trendyol entegrasyonu sayfasında topladık.
Çiçeksepeti ve kendi sitenizin siparişleri
Çiçeksepeti Akademi'nin sık sorulan sorularına göre kargo ücretleri satıcı tarafından karşılanır ve kendi kargo anlaşmanızla çıkış yapmak istiyorsanız bir entegrasyon firmasıyla API üzerinden çalışmanız gerekir. Bu model, Geliver gibi bir platformun teklifleriyle gönderim yapmak için uygun zemindir; kanal ayrıntıları Çiçeksepeti entegrasyonu sayfasında. Kendi sitenizde ise kural tamamen sizdedir: WooCommerce mağazanızın siparişleri Geliver ile gönderilir, takip numarası siteye iletilir ve müşteri kargosunu sipariş sayfasından izler.
Geliver mi, doğrudan kargo sözleşmesi mi, pazaryerinin anlaşmalı kargosu mu?
Üç gönderim modelinin farkı, kargo bedelini kimin belirlediği ve takip numarasının nereden geldiğidir. Aynı mağazada üçünü birlikte kullanmak mümkündür; önemli olan, her siparişin tek bir modelle çıkmasıdır. Aşağıdaki karşılaştırma Geliver'in, Trendyol'un ve Çiçeksepeti'nin resmî açıklamalarına dayanır.
| Ölçüt | Geliver hesabı | Kargo firmasıyla doğrudan sözleşme | Pazaryerinin anlaşmalı kargosu |
|---|---|---|---|
| Sözleşme | Geliver üyelik sözleşmesi; kargo firmasıyla ayrıca gerekmez | Firmayla kurumsal sözleşme | Pazaryeri ile kargo firması arasında |
| Fiyatı ne belirler? | Kabul ettiğiniz teklif ya da Geliver'e eklediğiniz kendi anlaşmanız | Sözleşmenizdeki tarife | Pazaryerinin tarifesi |
| Firma seçimi | Gönderi başına tekliflerden | Sözleşme yaptığınız firma | Pazaryeri sözleşmenizde onaylı firma |
| Ödeme | Geliver bakiyesinden | Kargo firmasının faturası | Pazaryerinin kuralına göre |
| Yox İş Ortağım'da gereken bağlantı | Geliver API token | Firmanın entegrasyon bilgileri | Pazaryeri mağaza bağlantısı |
Kendi anlaşmanızı Geliver'e eklemek
Geliver, Kargo API ve Hakkımızda sayfalarında mevcut kargo anlaşmanızı hesabınıza bağlayabileceğinizi belirtir; bu durumda gönderi sizin sözleşme koşullarınızla açılır. Elinizde güçlü bir sözleşme varsa iki yol vardır: sözleşmeyi Geliver'e ekleyip panele yalnız Geliver'i bağlamak ya da firmayı doğrudan bağlamak, örneğin Yurtiçi Kargo entegrasyonu ile. Aynı sözleşmeyi hem Geliver üzerinden hem doğrudan bağlamak, hangi siparişin hangi hesaptan çıktığını izlemeyi zorlaştırır. Hangi yolu seçerseniz seçin, kolinin desisini desi hesaplama aracıyla önceden bulmak fiyat tekliflerini karşılaştırmanızı kolaylaştırır.
Geliver entegrasyonu hangi Yox İş Ortağım paketinde kullanılır?
Geliver entegrasyonu, kargo bağlantısı içeren paketlerde kullanılır ve paketinizdeki kargo firması hakkından birini kullanır. Başlangıç paketinde kargo bağlantısı yoktur; orada takip numarası siparişe elle girilir. Panelde tanımlı 57 kargo ve lojistik firması, 80 satış kanalı ve 51 muhasebe, e-Fatura ve ERP programının tamamı entegrasyon sayfamızda listelenir.
| Paket | Aylık fiyat | Kargo firması bağlantısı | Satış kanalı | Aylık sipariş | Geliver için anlamı |
|---|---|---|---|---|---|
| Başlangıç | ₺499 | Yok (takip numarası elle) | 1 | 100 | Geliver bağlanmaz |
| Büyüme | ₺999 | 1 firma | 3 | 500 | Geliver tek kargo hesabınız olur |
| Profesyonel | ₺1.999 | 2 firma | 5 | 2.000 | Geliver ve bir firma daha |
| Kurumsal | ₺3.999 | 5 firma | Sınırsız | 5.000 | Geliver ve dört firma daha |
| Enterprise | ₺7.999 | Sınırsız | Sınırsız | Sınırsız | Sınır yok |
Yıllık ödemede %20 indirim uygulanır. Geliver'i tek kargo hesabı olarak kullanacaksanız Büyüme paketi yeterlidir; Geliver'in yanında bir firmayı doğrudan bağlamak isterseniz Profesyonel paketten itibaren iki hesap bağlanır. Bütün limitleri paket karşılaştırmasında görebilirsiniz. Yox İş Ortağım'ı 3 gün ücretsiz deneyebilir, kısa bir ön görüşmeyle kurulumu birlikte yapabilirsiniz; bunun için Yox İş Ortağım'a başvurun.
Geliver entegrasyonunu canlıya almadan önce kontrol listesi ve sık hatalar
Geliver entegrasyonunda sorunların çoğu bağlantıdan değil, hesap ayarlarından ve kanal kurallarından çıkar. İlk gerçek siparişi göndermeden önce aşağıdaki maddeleri tek tek işaretleyin.
İlk siparişten önce kontrol listesi
- Geliver hesabınız onaylandı mı, hesap türü kapıda ödeme ihtiyacınıza uygun mu?
- Gönderici adresinde telefon ve posta kodu eksiksiz mi; panelde adres ID'si girdiyseniz bu adres Geliver'de hâlâ duruyor mu?
- Hesapta ilk günün etiketlerini karşılayacak bakiye var mı?
- Token doğru organizasyonun hesabında mı oluşturuldu ve “Bağlantıyı test et” başarılı mı?
- Her kanal için hangi siparişin pazaryerinin anlaşmalı kargosuyla, hangisinin Geliver ile çıkacağı netleşti mi?
- Etiket yazıcınız Geliver'in döndürdüğü dosyayı doğru boyutta basıyor mu; deneme etiketi aldınız mı?
En sık yapılan dört hata
- Aynı mağazayı hem Geliver'in kendi eklentisine ya da mağaza bağlantısına hem de Yox İş Ortağım'a bağlamak: aynı sipariş için iki etiket satın alınabilir. Siparişi Geliver'e tek bir yerden aktarın.
- Trendyol'un anlaşmalı kargosuyla çıkması gereken siparişe Geliver etiketi basmak.
- Tek etikete birden çok koli bağlamaya çalışmak; Geliver'de her koli ayrı gönderidir.
- Takip numarası gelmedi diye ikinci bir gönderi açmak; bazı firmalarda numara koli şubeye teslim edildikten sonra oluşur.
Kurulum sırasında bir adımda takılırsanız ya da hangi kanalın siparişini hangi modelle göndereceğinize karar veremiyorsanız bize ulaşın; bağlantıyı ve ilk gönderiyi sizinle birlikte kontrol ederiz.
Son kontrol: 13 Ekim 2026
