Kurye firması · Ayarlar

E-ticaret entegrasyonu (WooCommerce, Shopify, ikas, Ticimax, Trendyol, Hepsiburada, n11, Çiçeksepeti, Sentos, Entegra, IdeaSoft)

Müşterinizin WooCommerce, Shopify, ikas, Ticimax mağazasını, Trendyol, Hepsiburada, n11, Çiçeksepeti satıcı hesabını Sentos, Entegra entegratör hesabını ya da IdeaSoft mağazasını bağlama, anahtarları alma, eşleme ayarları, kapıda ödeme ve eşleşme bekleyen siparişler.

Müşterinizin internet mağazasına gelen siparişler, o müşteri adına kendiliğinden kurye siparişi olur. Siz ya da müşteriniz siparişi elle girmezsiniz. Kurye siparişi alıp teslim edince bu bilgi mağazaya da yazılır.

Desteklenen mağazalar: WooCommerce (WordPress), Shopify, ikas (bkz. ikas), Ticimax (bkz. Ticimax), IdeaSoft (bkz. IdeaSoft), pazaryerleri Trendyol, Hepsiburada, n11, Çiçeksepeti (bkz. Trendyol, Hepsiburada, n11 ve Çiçeksepeti) ve çok kanallı entegratörler Sentos (bkz. Sentos), Entegra (bkz. Entegra).

Ayarlar Ayarlar › E-ticaret sekmesindedir. Bu sekmeyi firma sahibi ve yönetici rolündeki personel görür. Yalnız bazı şubeleri gören yönetici (şube yöneticisi) yalnız kendi şubesinin bağlantılarını görür ve yönetir (aşağıda şube bölümüne bakın). Müşteriniz kendi mağazasını müşteri portalından da bağlayabilir (E-ticaret mağazam sayfası); o bağlantılar da bu listede görünür.

Nasıl çalışır

• Mağazada yeni sipariş olunca mağaza bize hemen haber verir (webhook). Haber gelmese bile sistem 10 dakikada bir mağazayı yoklar; sipariş kaçmaz.
• Aynı mağaza siparişi iki kez gelse de tek kurye siparişi açılır.
• Sipariş, gönderen müşterinin fiyat listesiyle ve panelden açılan siparişle aynı hesapla fiyatlanır.
• Teslim adresi firmanızın semtlerinden biriyle eşleşmezse sipariş açılmaz, Eşleşme bekleyenler listesine düşer (aşağıya bakın).
• İlk bağlantıda mağazadaki son 24 saatin siparişleri alınır; daha eskileri alınmaz.

Mağaza bağlama (adım adım)

1. Ayarlar › E-ticaret sekmesini açın.
2. Mağaza bağla düğmesine basın.
3. Mağaza türünü seçin: WooCommerce, Shopify, ikas, Ticimax, Trendyol, Hepsiburada, n11, Çiçeksepeti, Sentos, Entegra ya da IdeaSoft. İleri'ye basın.
4. Ekrandaki yönergeye göre mağazadan anahtarları alın (aşağıdaki bölümler her adımı anlatır).
5. Gönderen müşteri alanında siparişlerin kimin adına açılacağını seçin (müşteri adıyla arayabilirsiniz).
6. Mağaza adresi ile anahtarları yapıştırın (Trendyol, Hepsiburada, n11, Çiçeksepeti ve Entegra'da mağaza adresi sorulmaz).
7. Bağlantıyı dene düğmesine basın. Yeşil "Bağlantı başarılı" yazısını görünce İleri'ye basın. (IdeaSoft'ta bu düğme yoktur; mağaza onayı kayıttan sonra alınır, bkz. IdeaSoft.)
8. Eşleme ayarlarını kontrol edin (en az Gönderi tipi seçili olmalı) ve Bağla ve kaydet'e basın.
9. Ekranda webhook adresi (WooCommerce'te ayrıca imza sırrı) bir kez gösterilir. Genelde bir şey yapmanız gerekmez: webhook mağazada kendiliğinden açılır. Sarı uyarı görürseniz webhook açılamamıştır; siparişler yine yoklamayla gelir.

WooCommerce anahtarı alma

1. WordPress yönetim panelinize girin.
2. WooCommerce › Ayarlar › Gelişmiş › REST API sayfasını açın.
3. Anahtar ekle düğmesine basın.
4. Açıklama olarak "Kurye" yazın.
5. Kullanıcı olarak bir yönetici hesabı seçin.
6. İzinler alanında Okuma/Yazma seçin (yalnız okuma seçerseniz teslim bilgisi mağazaya yazılamaz).
7. API anahtarı oluştur düğmesine basın.
8. Tüketici anahtarı (ck_… ile başlar) ve Tüketici sırrı (cs_… ile başlar) çıkar. Sır yalnız bu ekranda gösterilir; ikisini de kopyalayıp sihirbaza yapıştırın.
9. Mağaza adresi olarak sitenizin adresini yazın (ör. https://www.magazaniz.com). Adres https olmalıdır.

Shopify anahtarı alma

1. Shopify yönetim panelinde Ayarlar › Uygulamalar ve satış kanalları sayfasını açın.
2. Uygulama geliştir düğmesine basın. İlk kez yapıyorsanız Özel uygulama geliştirmeye izin ver deyin.
3. Uygulama oluştur ile yeni bir uygulama açın; adını "Kurye" koyun.
4. Admin API kapsamlarını yapılandır bölümünde şu izinleri işaretleyin: read_orders, write_merchant_managed_fulfillment_orders, write_assigned_fulfillment_orders. Kaydedin.
5. Uygulamayı yükle düğmesine basın.
6. Admin API erişim jetonu (shpat_…) yalnız bir kez gösterilir; kopyalayın.
7. Aynı sayfadaki API gizli anahtarı değerini de kopyalayın. Bu değer, mağazadan gelen haberlerin gerçekten mağazanızdan geldiğini doğrulamak için gerekir.
8. Mağaza adresi olarak magaza-adi.myshopify.com adresini yazın (kendi alan adınızı değil).

ikas anahtarı alma

1. ikas yönetim panelinde Ayarlar › Uygulamalar › Özel Uygulamalar sayfasını açın.
2. Özel uygulama oluştur deyin; adını "Kurye" koyun.
3. İzinlerde siparişler için okuma ve yazma seçin (yalnız okuma seçerseniz teslim bilgisi ikas'a yazılamaz). Kaydedin.
4. Client ID ve Client Secret değerlerini kopyalayıp sihirbaza yapıştırın. Client Secret, ikas'tan gelen haberlerin imzasını da doğrular.
5. Mağaza adresi olarak magaza-adi.myikas.com adresini yazın (kendi alan adınızı değil).
6. Yeni siparişler ikas'tan anında gelir (webhook kendiliğinden açılır); ayrıca 10 dakikada bir yoklanır.
7. Varsayılan olarak UNFULFILLED (hazırlanacak) ve READY_FOR_SHIPMENT (gönderime hazır) siparişler alınır. Mağazadan teslim alınacak siparişler kurye siparişi olmaz; isterseniz durumlara CLICK_AND_COLLECT ekleyin. Havale gibi ödemesi beklenen siparişler ödeme gelene kadar alınmaz. Kapıda nakit ya da kartla ödemeli siparişlerin tutarı kurye siparişine yazılır.
8. Kurye paketi alınca ikas'ta sipariş kargoya verildi olur (takip numarası = kurye sipariş numarası, takip bağlantısı eklenir); teslimde paket teslim edildi yapılır. Kurye siparişinin referansı IKAS-sipariş no biçimindedir.

Ticimax anahtarı alma

1. Ticimax yönetim panelinde Ayarlar › WS Yetki Kodu Yönetimi sayfasını açın.
2. Yeni bir yetki kodu oluşturun. Sipariş servisinde en az SelectSiparis (sipariş okuma) ve SetSiparisDurum (durum yazma) izinlerini açın.
3. Yetki kodunu kopyalayıp sihirbaza yapıştırın.
4. Mağaza adresi olarak mağazanızın alan adını yazın (ör. https://www.magazaniz.com).
5. Ticimax'ta anlık bildirim yoktur: siparişler 10 dakikada bir yoklanarak gelir ("yalnız yoklama" rozeti normaldir). Hemen almak için Şimdi senkronize et'e basın.
6. Varsayılan olarak Onaylandi ve Paketleniyor durumundaki siparişler alınır. Kapıda nakit (KapidaOdemeNakit) ve kapıda kart (KapidaOdemeKrediKarti) ödemeli siparişlerin tutarı kurye siparişine yazılır.
7. Kargo firması süzgeci: Ticimax'ta bazı siparişler bir kargo firmasıyla gidiyorsa, eşleme ayarlarındaki Yalnız bu kargo firmasına atanan paketler alanına sizin kuryeniz için tanımlı kargo firmasının adını yazın (ör. Kurye). Boş bırakırsanız tüm siparişler alınır.
8. Kurye paketi alınca Ticimax'ta sipariş KargoyaVerildi olur (takip numarası = kurye sipariş numarası, takip bağlantısı eklenir); teslimde TeslimEdildi yazılır. Kurye siparişinin referansı TCX-sipariş no biçimindedir.

Trendyol, Hepsiburada, n11 ve Çiçeksepeti (pazaryerleri)

Pazaryerinde mağaza adresi girilmez; satıcı hesabının anahtarlarıyla bağlanılır. Her paket ayrı kurye siparişi olur (bir sipariş birkaç pakete bölünmüşse her biri ayrı). Kurye siparişinin referansı TY-sipariş no/paket no, HB-sipariş no/paket no ya da N11-sipariş no/paket no biçimindedir. Çiçeksepeti'nde ise ana sipariş (alt siparişleriyle birlikte) tek kurye siparişi olur; referansı CS-sipariş no biçimindedir.

Kim ne yapar?

• Kuryelerinizin Trendyol'a, Hepsiburada'ya, n11'e ya da Çiçeksepeti'ne üye olması gerekmez. Pazaryerinden gelen paket, panelden açılan her sipariş gibi kurye uygulamasına düşer; kurye her zamanki gibi alır ve teslim eder.
• Mağaza (pazaryerinde satış yapan müşteriniz) zaten bir satıcı hesabına sahiptir. Pazaryerinden kendi kuryesiyle gönderim yetkisini o ister ve API anahtarlarını o alır (aşağıda adım adım).
• Anahtarları mağaza müşteri portalındaki E-ticaret mağazam sayfasından kendisi girebilir ya da siz burada, mağaza adına girebilirsiniz. Müşterinin portalda bu sayfayı görmesi için hesabında entegrasyon izni açık olmalıdır.
• Ücret ve kurye hakedişi, panelden açılan siparişle aynı hesaplanır.
• Trendyol Go ve HepsiJET gibi programlar, kuryenin doğrudan pazaryeri için çalıştığı ayrı sistemlerdir; bu entegrasyonla ilgileri yoktur.

Önce pazaryerinden yetki alın: Paketleri kendi kuryenizle göndermek için pazaryerinin izni gerekir.

• Trendyol: satıcı destekten Alternatif Teslimat (kendi kuryeyle gönderim) yetkisi isteyin.
• Hepsiburada: kendi kargonuzla gönderim yetkisi isteyin.
• n11: siparişin satıcı gönderimli olması yeterlidir; ayrı bir yetki gerekmez.
• Çiçeksepeti: durum yazmak için satıcının kendi aracıyla gönderim yetkisi gerekebilir.
• Yetki yoksa siparişler yine gelir ve kurye siparişi açılır; yalnız alındı/teslim bilgisi pazaryerine yazılamaz (Günlük'te hata görürsünüz).

Trendyol anahtarı alma

1. Trendyol satıcı panelinde Hesap Bilgilerim › Entegrasyon Bilgileri sayfasını açın.
2. Satıcı ID, API Key ve API Secret değerlerini kopyalayın.
3. Sihirbazda Trendyol'u seçin ve bu üç değeri yapıştırın.
4. Yeni paketler Trendyol'dan anında gelir (webhook kendiliğinden açılır); ayrıca 10 dakikada bir yoklanır.
5. Kurye paketi alınca Trendyol'da paket kargoya verildi olur ve takip bağlantısı eklenir; teslimde teslim edildi yazılır. Takip bağlantısı için firma takip sayfası açık olmalıdır.

Hepsiburada anahtarı alma

1. Hepsiburada satıcı panelinde Bilgilerim › Entegrasyon › Entegratör Bilgileri sayfasını açın.
2. Mağaza ID (Merchant ID) (tireli uzun kod) ve servis anahtarı değerlerini kopyalayın.
3. Sihirbazda Hepsiburada'yı seçin ve iki değeri yapıştırın. Hepsiburada size bir entegratör adı verdiyse onu da yazın; vermediyse boş bırakın.
4. Hepsiburada'da anlık bildirim yoktur: paketlediğiniz siparişler 10 dakikada bir yoklanarak gelir ("yalnız yoklama" rozeti normaldir). Hemen almak için Şimdi senkronize et'e basın.
5. Kurye paketi alınca Hepsiburada'da paket yolda, teslimde teslim edildi olur.

n11 anahtarı alma

1. n11 satıcı panelinde Hesabım › API Hesapları sayfasını açın.
2. API anahtarı (appKey) ve API şifresi (appSecret) değerlerini kopyalayın.
3. Sihirbazda n11'i seçin; Mağaza adı alanına n11 mağaza bağlantınızdaki adı yazın (ör. n11.com/magaza/deneme-magaza için deneme-magaza), ardından iki anahtarı yapıştırın.
4. n11'de anlık bildirim yoktur: siparişler 10 dakikada bir yoklanarak gelir ("yalnız yoklama" rozeti normaldir). Yalnız satıcı gönderimli paketler alınır. Hemen almak için Şimdi senkronize et'e basın.
5. Kurye paketi alınca sipariş n11'de onaylanır (Picking). n11'in API'si kargoya verildi ve teslim edildi bilgisinin dışarıdan yazılmasına izin vermez: bu adımları n11 mağaza panelinden siz güncellersiniz. Günlük'te bunu hatırlatan bir bilgi satırı görürsünüz; bu bir hata değildir.

Çiçeksepeti anahtarı alma

1. Çiçeksepeti satıcı panelinde Hesap Yönetimi › Entegrasyon Bilgilerim sayfasını açın.
2. Satıcı ID ve API anahtarı değerlerini kopyalayın. Test ve canlı anahtarlar farklıdır: canlı anahtarı kullanın.
3. Sihirbazda Çiçeksepeti'ni seçin; Satıcı ID ve API anahtarı alanlarına yapıştırın. Entegratör adı isteğe bağlıdır; Çiçeksepeti size bir ad vermediyse boş bırakın (önerilir). Satıcı ID kaydedildikten sonra değiştirilemez; yanlış girdiyseniz bağlantıyı silip yeniden kurun.
4. Çiçeksepeti'nde anlık bildirim yoktur: siparişler yaklaşık 10 dakikada bir yoklanarak gelir ("yalnız yoklama" rozeti normaldir). Çiçeksepeti'nin istek sınırı sıkı olduğundan siparişler birkaç dakika gecikmeli görünebilir. Hemen almak için Şimdi senkronize et'e basın.
5. Bir Çiçeksepeti siparişinin tüm alt siparişleri tek kurye siparişi olur.
6. Kurye paketi alınca Çiçeksepeti'nde alt siparişler Araca yüklendi (gerekirse önce Hazırlanıyor) olur; teslimde Teslim edildi ve teslim alan kişinin adı yazılır.
7. Bu bilgilerin yazılması için Çiçeksepeti'nde satıcının kendi aracıyla gönderim yetkisi gerekebilir. Yetki yoksa siparişler yine gelir; yalnız durum yazılamaz ve hata Günlük'te görünür. Böyle bir hata görürseniz Çiçeksepeti satıcı desteğinden bu yetkiyi isteyin.

Kargo firması süzgeci: Pazaryeri bazı paketleri kendi kargosuyla gönderir. Bunlara kurye siparişi açılmasın diye eşleme ayarlarındaki Yalnız bu kargo firmasına atanan paketler alanına pazaryerinde size atanan kargo firmasının adını yazın (ör. Kurye, Sendeo; büyük/küçük harf fark etmez, adın bir parçası yeterli). Boş bırakırsanız tüm paketler alınır.

Durumlar: Trendyol'da varsayılan olarak Created (yeni), Picking (hazırlanıyor) ve Invoiced (faturalandı) paketler alınır; Hepsiburada'da Packaged (paketlendi); n11'de Created (yeni) ve Picking (onaylandı); Çiçeksepeti'nde New (yeni) ve Preparing (hazırlanıyor). Çiçeksepeti'nin diğer durumları: ReadyForCargo (kargoya hazır), InVehicle (araca yüklendi), Shipped (kargoya verildi), Delivered (teslim edildi), Returned (iade); Çiçeksepeti'nde iptal edilen sipariş iptal sayılır. Trendyol'da kapıda ödemeli paketlerin tutarı siparişe yazılır; Hepsiburada, n11 ve Çiçeksepeti'nde ödeme pazaryerinde alındığı için kapıda ödeme kapalı gelir.

Sentos anahtarı alma

Sentos, mağazanın tüm satış kanallarındaki (pazaryerleri, web sitesi vb.) siparişleri tek panelde toplayan bir entegratördür. Kurye siparişinin referansı SNT-sipariş no biçimindedir.

1. Sentos panelinde Hesabım › API bilgileri sayfasını açın.
2. API Key ve API Secret değerlerini kopyalayın.
3. Sihirbazda Sentos'u seçin. Mağaza adresi alanına Sentos panel adresini yazın (ör. https://firma-adi.sentos.com.tr; yalnız sentos.com.tr adresleri kabul edilir), ardından iki anahtarı yapıştırın.
4. Kargo firması süzgecini mutlaka doldurun. Sentos tüm kanallardaki siparişleri getirir. Eşleme ayarlarındaki Yalnız bu kargo firmasına atanan paketler alanına Sentos'ta kurye için tanımlı kargo firması adını yazın (ör. Kurye). Boş bırakırsanız tüm kanallardan gelen bütün siparişler kurye siparişi olur.
5. Sentos'ta anlık bildirim yoktur: siparişler 10 dakikada bir yoklanarak gelir ("yalnız yoklama" rozeti normaldir). Hemen almak için Şimdi senkronize et'e basın.
6. Varsayılan olarak Approved (onaylandı) ve Preparing (hazırlanıyor) siparişler alınır. Diğer durumlar: AwaitingApproval (onay bekliyor), Supplying (tedarik sürecinde), Shipped (kargoya verildi), Delivered (teslim edildi), Cancelled (iptal). Ödeme yöntemi "Kapıda Ödeme", "Kapıda Nakit" ya da "Kapıda Kredi Kartı" olan siparişlerin tutarı kurye siparişine yazılır.
7. Kurye paketi alınca Sentos'a kargo firması, takip numarası (= kurye sipariş numarası) ve takip bağlantısı yazılır. Bu yalnız kaynağı Amazon, WooCommerce, OpenCart, ikas, Shopify ya da Farmazon olan siparişlerde çalışır. Diğer kanallardan gelen siparişlerde ve teslimde aşama Sentos API'si ile yazılamaz; Günlük'te bunu belirten bir bilgi satırı görürsünüz, bu bir hata değildir. Gerekirse durumu Sentos panelinden güncelleyin.

Entegra anahtarı alma

Entegra da tüm satış kanallarının siparişlerini toplayan bir entegratördür. Mağaza adresi sorulmaz; API kullanıcısıyla bağlanılır. Kurye siparişinin referansı ENT-sipariş no biçimindedir.

1. Entegra destek ekibinden hesabınız için bir API kullanıcısı açmasını isteyin.
2. Size verilen API kullanıcısı (e-posta) ve API şifresi bilgilerini not edin.
3. Sihirbazda Entegra'yı seçin ve iki bilgiyi yazın. API kullanıcısı kaydedildikten sonra değiştirilemez; yanlış girdiyseniz bağlantıyı silip yeniden kurun.
4. Kargo firması süzgecini doldurun (önerilir). Başka kargoyla gidecek siparişlere kurye siparişi açılmasın diye Yalnız bu kargo firmasına atanan paketler alanına Entegra'da kurye için tanımlı kargo firması adını yazın. Boş bırakırsanız tüm siparişler alınır.
5. Entegra'da anlık bildirim yoktur: siparişler birkaç dakikada bir yoklanarak gelir; her turda son 3 günün siparişleri taranır. Hemen almak için Şimdi senkronize et'e basın.
6. Varsayılan olarak New (yeni), Preparing (hazırlanıyor) ve ReadyToShip (kargoya verilecek) siparişler alınır. Diğer durumlar: Shipped (kargoya verildi), Delivered (teslim edildi), Invoiced (faturalı), OnHold (beklemede), AwaitingApproval (onay bekliyor). Kapıda nakit (kapida_nakit) ve kapıda kart (kapida_kredi_karti) ödemeli siparişlerin tutarı kurye siparişine yazılır.
7. Kurye paketi alınca Entegra'da sipariş Kargoya verildi olur; kargo firması, takip numarası (= kurye sipariş numarası) ve takip bağlantısı yazılır. Teslimde Teslim edildi olur.

IdeaSoft bağlama

IdeaSoft'ta anahtar kopyalamak yetmez: önce bir API istemcisi oluşturulur, sonra mağaza yöneticisi IdeaSoft'ta onay verir (izin ekranı). Kurye siparişinin referansı IDS-sipariş no biçimindedir.

1. Müşterinizin IdeaSoft yönetim paneline (gerekirse müşterinizle birlikte) yönetici olarak girin.
2. Entegrasyonlar › API sayfasını açın ve yeni bir API istemcisi oluşturun (adı ör. Kurye).
3. Sihirbazda IdeaSoft'u seçip İleri'ye basın. Ekranda bir Yönlendirme adresi görürsünüz; Kopyala düğmesine basın.
4. IdeaSoft'taki API istemcisinin Yönlendirme adresi (Redirect URI) alanına bu adresi yapıştırıp kaydedin.
5. IdeaSoft'un verdiği Client ID ve Client Secret değerlerini sihirbaza yapıştırın. Mağaza adresi alanına mağazanın alan adını yazın (ör. magaza-adi.myideasoft.com ya da kendi alan adınız).
6. İleri ile ayarlara geçin, Gönderi tipi seçin ve Kaydet ve mağazada onay ver'e basın.
7. IdeaSoft'un onay sayfası açılır. Mağaza yöneticisi hesabıyla girip izin verin. Onaydan sonra kendiliğinden Ayarlar › E-ticaret sayfasına dönersiniz; yeşil "Mağaza onayı alındı" yazısını görürsünüz.
8. IdeaSoft'ta anlık bildirim yoktur: siparişler 10 dakikada bir yoklanarak gelir ("yalnız yoklama" rozeti normaldir). Hemen almak için Şimdi senkronize et'e basın.
9. Varsayılan olarak approved (onaylandı) ve being_prepared (hazırlanıyor) siparişler alınır. Diğer durumlar: waiting_for_approval (onay bekliyor), waiting_for_payment (ödeme bekliyor), fulfilled (kargoya verildi), delivered (teslim edildi), cancelled (iptal). Kapıda Ödeme Nakit ve Kapıda Ödeme Kredi Kartı ödemeli siparişlerin tutarı kurye siparişine yazılır.
10. Kurye paketi alınca IdeaSoft'ta sipariş Kargoya verildi olur ve takip kodu (= kurye sipariş numarası) yazılır; teslimde Teslim edildi olur.

"Mağaza onayı gerekli" rozeti: Onay yarım kaldıysa, reddedildiyse ya da bağlantı uzun süre (yaklaşık 2 ay) hiç kullanılmadığı için IdeaSoft izni düştüyse bağlantıda kırmızı Mağaza onayı gerekli rozeti çıkar ve siparişler gelmez. Satırdaki Mağazada yetki ver düğmesine basıp 7. adımı tekrarlayın. Onay sayfasından dönüşte görebileceğiniz iletiler:

• Onay verilmedi: izin ekranında reddedildi; yeniden deneyin.
• Onay bağlantısının süresi doldu: onay sayfası 15 dakikadan uzun açık kaldı; Mağazada yetki ver ile yeniden başlayın.
• Onay tamamlanamadı: IdeaSoft izni verdi ama anahtar alınamadı. Günlük'teki satıra bakın; çoğunlukla Client Secret yanlıştır ya da yönlendirme adresi IdeaSoft'ta farklı yazılmıştır.

Eşleme ayarları

• İçe alınacak mağaza durumları: hangi durumdaki siparişler kurye siparişi olsun. WooCommerce'te genelde processing (hazırlanıyor). Shopify'da ödeme durumu: paid (ödendi), pending (kapıda ödeme gibi ödeme bekleyen), authorized.
• Gönderi tipi: açılan siparişlerin gönderi tipi (fiyat buna göre hesaplanır).
• Alım semti / Alım adresi: boş bırakırsanız müşterinin kayıtlı semti ve adresi kullanılır.
• Koli sayısı: her siparişe 1 koli, ürün adedi kadar koli ya da sabit sayı.
• Uygun siparişleri kendiliğinden aç: kapatırsanız her sipariş Eşleşme bekleyenler'de onayınızı bekler.
• Kurye ücretini alıcı öder: açılan siparişlerde ücret alıcıdan alınır.
• Alındı / teslim edildi bilgisini mağazaya geri yaz: WooCommerce'te siparişe not eklenir, teslimde durum Teslimde mağaza sipariş durumu alanındaki değere (varsayılan completed) çekilir. Shopify'da sipariş kargoya verildi olarak işaretlenir, takip bağlantısı eklenir ve teslimde "teslim edildi" olayı yazılır.

Kapıda ödeme

Mağaza siparişinin ödeme yöntemi Kapıda ödeme yöntemleri listesindekilerden biriyse (WooCommerce'te cod; Shopify'da "Cash on Delivery (COD)" ya da "Kapıda Ödeme"), siparişin toplam tutarı kurye siparişinin notuna "KAPIDA ÖDEME: tutar" olarak yazılır ve listede rozetle gösterilir. Kurye tutarı alıcıdan tahsil eder. Mağazanızda ödeme yönteminin adı farklıysa listeye o adı ekleyin.

Eşleşme bekleyenler

Mağaza siparişleri kartındaki Eşleşme bekleyenler sekmesi, kurye siparişi açılamayanları gösterir. Sık nedenler: mağaza adresindeki ilçe/semt firmanızın semtleriyle eşleşmedi, fiyat listesinde o bölge için fiyat yok, alıcı bilgisi eksik.

1. Satırdaki kırmızı açıklamayı okuyun.
2. Düzelt düğmesine basın.
3. Teslim semti'ni seçin; gerekirse alıcı adı, telefon ve adresi düzeltin.
4. Aynı yazım bir daha gelirse kendiliğinden eşleşsin istiyorsanız Bu il/ilçe yazımını hatırla kutusunu açık bırakın.
5. Kaydet ve sipariş aç'a basın. Kurye siparişi açılır, numarası satırda görünür.

Diğer düğmeler: Yeniden dene (ör. fiyat listesini düzelttikten sonra), Atla (bu mağaza siparişi için kurye siparişi açılmaz). Mağazada iptal edilen siparişler kendiliğinden atlanır; kurye siparişi açıldıktan sonra iptal edilenler için aşağıdaki "Mağazada iptal edilen sipariş" bölümüne bakın.

Mağazada iptal edilen sipariş

Mağazada (ya da pazaryerinde) iptal edilen bir sipariş için zaten kurye siparişi açılmışsa, KOS bunu kendiliğinden fark eder. Ne olacağı paketin nerede olduğuna bağlıdır:

• Kurye paketi henüz almadıysa (onay bekliyor, havuzda ya da kuryeye verilmiş): kurye siparişi kendiliğinden iptal edilir. Gerekçe "Mağazada iptal edildi (mağaza #no)" olarak yazılır; pul ödemesi iade edilir, kuryenin listesinden düşer.
• Kurye paketi aldıysa (yolda, depoda, iadede): kurye siparişi değiştirilmez. Satırda kırmızı "mağazada iptal · kurye almıştı, karar verin" rozeti çıkar.
• Teslim zaten yapıldıysa: hiçbir şey değişmez (mağazadaki iade teslimden sonradır); satırda bilgi rozeti görünür.

Karar bekleyenleri bulmak için:

1. Mağaza siparişleri kartında İptal kararı bekleyenler sekmesini açın. Bağlantı listesinde de "n iptal kararı bekliyor" rozeti görünür.
2. Satırdaki kurye siparişi numarasına basın.
3. Mağaza ve kuryeyle konuşup karar verin: paketi gönderene iade ettirin (teslim edilemedi › iade) ya da alıcı yine istiyorsa teslimi sürdürün; gerekirse siparişi iptal edin.

Bu davranışı istemiyorsanız bağlantının Düzenle penceresinde Mağazada iptal edilen siparişi kurye siparişinde de iptal et kutusunu kapatın. Kapalıyken iptaller yalnız günlüğe ve satıra ("senkron kapalı") yazılır; kurye siparişine dokunulmaz.

Hizmet bölgesi dışındaki alıcılar

Mağazanız Türkiye'nin her yerine satış yapar, ama siz yalnız şubelerinizin bulunduğu illerde dağıtım yaparsınız. Örneğin mağaza Trendyol'da sattı, alıcı Ankara'da, sizin şubeniz yalnız İstanbul'da. Bu sipariş kuryeye verilemez.

KOS bunu kendiliğinden yapar:

• Alıcının ilinin, dağıtım yaptığınız illerden biri olup olmadığına bakar.
• Değilse kurye siparişi açılmaz. Böylece sipariş havuza düşmez, kimse onu kuryeye atayamaz, otomatik dağıtıma da girmez.
• Satırda kırmızı "Hizmet bölgesi dışında · kuryeye verilemez" rozeti görünür. Açıklamada alıcının ili ve dağıttığınız iller yazar.
• Mağaza da (müşteriniz) aynı rozeti kendi portalında görür ve siparişi kargoyla göndermesi gerektiğini anlar.

Dağıttığınız iller nereden gelir?

• Her şubenin ili (Ayarlar › Şubeler).
• Resmî ilçeye bağlı semtlerinizin illeri.
• Mağaza bağlantısı bir şubeye bağlıysa yalnız o şubenin illeri sayılır. Firma geneli bağlantıda tüm etkin şubelerin illeri sayılır.
• Mağaza siparişleri kartının üstünde "Kuryeye verilebilecek alıcı illeri: …" satırı bu listeyi gösterir.
• Bir şubenizin il bilgisi hiç yoksa liste "bilinmiyor" görünür ve il denetimi yapılmaz. Denetimin çalışması için her şubeye il seçin.

Bölge dışındaki siparişleri görmek ve kapatmak için:

1. Mağaza siparişleri kartında Hizmet bölgesi dışında sekmesini açın.
2. Satırdaki açıklamayı okuyun: alıcının ili ve dağıttığınız iller.
3. Siparişi kapatmak için Atla'ya basın. Mağaza bu siparişi kendi kargosuyla göndermelidir.
4. O ilde yeni bir şube ya da semt açtıysanız Yeniden dene'ye basın; sipariş artık içe alınır.

Not: bu satırlarda Düzelt düğmesi yoktur. Başka bir ildeki semti elle seçmek de engellenir.

Şube seçimi

Firmanızın birden çok şubesi varsa her mağaza bağlantısının bir şubesi olur. Şube, siparişlerin hangi şubede açılacağını ve hangi semtlerle eşleşeceğini belirler.

1. Mağaza bağla sihirbazının son adımında (Eşleme ayarları) en üstte Şube alanını görürsünüz. Var olan bağlantıda Düzenle penceresinde aynı alan vardır.
2. Firma geneli (tüm şubeler) seçerseniz mağaza siparişi, teslim adresinin semtine göre ilgili şubeye düşer. Alım semti firmanızın herhangi bir semti olabilir.
3. Bir şube seçerseniz Alım semti listesinde yalnız o şubenin semtleri görünür. Başka şubenin semtini seçemezsiniz (kaydederken hata alırsınız). Teslim adresi de yalnız o şubenin semtleriyle eşleştirilir; Düzelt penceresindeki Teslim semti listesi o şubenin semtleriyle sınırlıdır.
4. Şubeyi sonradan değiştirmek için Düzenle'de başka şube seçin. Firma geneli'ni seçerseniz bağlantı tüm şubelere açılır. Şube değişince eski şubeye ait alım semti temizlenir; yenisini seçin.
5. Bağlantı listesinde her bağlantının yanında şube adı ya da Firma geneli rozeti görünür.
6. Mağaza siparişleri kartında Şube süzgeciyle yalnız bir şubenin kayıtlarını görebilirsiniz; her satırda siparişin şubesi yazar.

Yalnız bazı şubeleri gören yönetici (şube yöneticisi) için:

• Bağlantı listesinde yalnız kendi şubenizin bağlantılarını görürsünüz; firma geneli bağlantılar ve başka şubelerinkiler listede çıkmaz.
• Kendi şubenizin bağlantısını kurabilir, düzenleyebilir, deneyebilir, hemen eşitleyebilir ve silebilirsiniz.
• Şube listesinde yalnız yetkili olduğunuz şubeler çıkar; Firma geneli seçeneği yoktur. Yeni bağlantı mutlaka bir şubeye bağlanır.
• Firma geneli bağlantıları ve yetkiniz olmayan şubelerin bağlantılarını değiştiremezsiniz ("yetkiniz yok" uyarısı). Bunun için firma sahibine ya da tüm şubeleri gören bir kullanıcıya başvurun.

Müşteri portalından bağlanan mağazalarda şube seçilmez; gerekirse bu ekrandan Düzenle ile şube atayabilirsiniz.

Kişisel verilerin saklanması

Mağazadan gelen siparişte alıcının adı, telefonu ve adresi gibi kişisel veriler bulunur. Kişisel verileri gereğinden uzun tutmamak için (KVKK):

1. Mağaza siparişinin ham verisi 90 gün sonra kendiliğinden temizlenir.
2. Temizlenince satırda "Kişisel veri saklama süresi doldu, temizlendi" etiketi görünür; alıcı adı, adres ve tutar gibi mağaza bilgileri boş kalır.
3. Kurye siparişi silinmez. Açılmış kurye siparişi, teslim bilgisi ve faturası olduğu gibi kalır; satırdaki kurye sipariş numarasına basarak açabilirsiniz.
4. Temizlenmiş kayıtta Düzelt ve Yeniden dene düğmeleri görünmez (artık sipariş açmak için veri yoktur). İsterseniz Atla ile listeden kaldırabilirsiniz.
5. 90 gün içinde eşleşmeyen bir siparişi kaçırmamak için Eşleşme bekleyenler sekmesine düzenli bakın.

Bağlantı listesi

Her bağlantıda durum (etkin, duraklatıldı, hata sayısı), son senkron zamanı ve sipariş sayıları görünür.

• Şimdi senkronize et: mağazayı hemen yoklar.
• Dene: anahtarların hâlâ çalıştığını denetler.
• Düzenle: ad, şube, anahtarlar ve eşleme ayarları. Anahtar alanlarını boş bırakırsanız kayıtlı anahtarlar kalır.
• Günlük: son olaylar (gelen haberler, yoklamalar, hatalar).
• Duraklat / Sürdür: duraklatılan bağlantıdan sipariş alınmaz.
• Sil: bağlantıyı ve mağazadaki webhook'ları kaldırır. Açılmış kurye siparişleri silinmez.
• Mağazada yetki ver (yalnız IdeaSoft): mağaza onayını yeniden alır; "Mağaza onayı gerekli" rozetinde kullanın (bkz. IdeaSoft).

"Yalnız yoklama" rozeti, webhook'un mağazada açılamadığını gösterir; siparişler en geç 10 dakikada gelir.

Sorun mu var?

• "Bağlantıyı dene" hata veriyor: Mağaza adresinin https ile başladığını ve anahtarların eksiksiz yapıştırıldığını kontrol edin. WooCommerce'te anahtarın izni Okuma/Yazma olmalı; Shopify'da adres magaza-adi.myshopify.com, ikas'ta magaza-adi.myikas.com olmalı. Ticimax'ta yetki kodunda SelectSiparis izni açık olmalı.
• Siparişler gelmiyor: Bağlantı duraklatılmış olabilir (Sürdür'e basın). Mağaza durumunun İçe alınacak mağaza durumları listesinde olduğunu kontrol edin. Şimdi senkronize et ile hemen yoklayın.
• IdeaSoft siparişleri gelmiyor / "Mağaza onayı gerekli": Mağaza onayı alınmamış ya da (uzun süre kullanılmadığı için) düşmüştür. Satırdaki Mağazada yetki ver'e basıp IdeaSoft'ta izin verin (bkz. IdeaSoft).
• Siparişler hep Eşleşme bekleyenler'e düşüyor: Mağaza adresindeki ilçe yazımı semtlerinizle eşleşmiyor; bir kez Düzelt ile semt seçip Bu il/ilçe yazımını hatırla deyin. Fiyat hatası görüyorsanız müşterinin fiyat listesine o bölgeyi ekleyin, sonra Yeniden dene'ye basın.
• Mağazada teslim bilgisi görünmüyor: Alındı / teslim edildi bilgisini mağazaya geri yaz açık olmalı; WooCommerce anahtarı Okuma/Yazma izinli olmalı. Satırdaki "Mağazaya yazılamadı" açıklamasına bakın.

Güvenlik

Anahtarlar şifreli saklanır, ekranda bir daha gösterilmez. Mağaza adresi yalnız https olabilir; yerel ağ adresleri kabul edilmez. Mağazadan gelen her haber imzasıyla doğrulanır.