Kurye firması · Ayarlar

Entegrasyon durumu

Mağaza bağlantılarınızın, İYS, e-Fatura, webhook ve bildirim kanallarınızın çalışıp çalışmadığını tek ekranda görme; renklerin anlamı ve her sorunda ne yapmanız gerektiği.

Entegrasyon durumu ekranı, firmanızın dış sistemlerle olan bütün bağlantılarını tek yerde gösterir: e-ticaret ve pazaryeri mağazalarınız, İYS, e-Fatura, webhook'larınız, Slack, Microsoft Teams, SMS, WhatsApp ve e-posta kanallarınız. Bir bağlantı koparsa siparişler gelmeyebilir ya da bildirimler gitmeyebilir; bu ekran bunu siz fark etmeden önce gösterir. Bağlantı hataya düştüğünde size e-posta gelir (ayrıntı), destek ekibimiz de anında haberdar olur.

Ekran Yönetim › Ayarlar › Entegrasyon durumu sekmesindedir ve yalnız Firma sahibi (ayar yönetme yetkisi olan) kişiler açabilir.

Adım adım: ekranı açma

1. Sol menüde Yönetim › Ayarlar'a basın.
2. Üstteki sekmelerden Entegrasyon durumu'nu seçin.
3. Her bağlantı için bir kart görürsünüz. Sorunlu kartlar en başta durur.
4. Bilgiyi tazelemek için sağ üstteki Yenile'ye basın. Kartın altındaki Son kontrol satırı, durumun ne zaman hesaplandığını yazar.

Hiç bağlantınız yoksa "Henüz bağlı bir entegrasyonunuz yok" yazar; mağaza bağlamak için Mağaza bağla'ya basabilirsiniz.

Renkler ne anlama gelir?

• Yeşil — Çalışıyor: Bağlantı sorunsuz. Bir şey yapmanız gerekmez.
• Turuncu — Dikkat: Bağlantı çalışıyor ama bakmanız gereken bir şey var (ör. eşleşme bekleyen sipariş, kısa süreli bir hata). İşler büyük ölçüde yürür.
• Kırmızı — Çalışmıyor: Bağlantı koptu ya da art arda hata veriyor. Siparişler gelmiyor ya da iletiler gitmiyor olabilir; hemen bakın.
• Gri — Kapalı: Bağlantı kayıtlı ama kapalı. Kontrol edilmez.

Kartta neler yazar?

• Başlık: E-ticarette bağlantının adı, altında altyapı (Trendyol, Shopify…) ve şube; diğerlerinde kanalın adı (İYS, e-Fatura, SMS…).
• Sorunlar: Her sorunun altında kısa bir ne yapmalıyım önerisi ve ilgili ayar sayfasına giden bağlantı vardır.
• Son başarı / Son deneme / Son hata: "5 dakika önce" gibi yazar; tam saati görmek için üzerine gelin.
• Son 24 saat: SMS, e-posta, Slack, Teams ve webhook kartlarında son 24 saatte kaç iletinin gittiği ve kaçının gidemediği.
• Son hatayı göster: Sağlayıcının verdiği son hata metnini açar. Destek talebi açarken bu metni kopyalayabilirsiniz.

Gösterge panelindeki uyarı

• En az bir bağlantı kırmızı ise gösterge panelinin üstünde kırmızı bir şerit çıkar: "N entegrasyon çalışmıyor". Şeritteki Entegrasyon durumu düğmesi bu ekranı açar.
• Yalnız turuncu varsa daha sade bir not çıkar.
• Her şey yolundaysa hiçbir şey görünmez. Şeridi yalnız ayar yetkisi olan kişiler görür.

E-posta bildirimi

Bir bağlantı kırmızıya düştüğünde size e-posta da göndeririz; ekranı açık tutmanız gerekmez.

1. Bağlantılar her 15 dakikada bir kontrol edilir.
2. Bir bağlantı kırmızıya düşerse "Entegrasyon hatası: …" konulu bir e-posta gelir. İçinde bağlantının adı, şubesi, sorunun ne olduğu ve sağlayıcının verdiği son hata yazar.
3. Aynı turda birden çok bağlantı bozulduysa hepsi tek e-postada gelir.
4. Hata sürerse e-postayı tekrarlamayız; gösterge panelindeki kırmızı şerit kalır.
5. Bağlantı yeniden çalışınca "Entegrasyon düzeldi: …" e-postası gelir; hatanın ne kadar sürdüğü yazar.

Kimler alır?

• Firma sahibi (ayar yönetme yetkisi olan): bütün bağlantılar için.
• Yönetici: yalnız e-ticaret mağaza bağlantıları için. Belirli şubelere bağlı yönetici yalnız kendi şubesinin mağazası için alır; firma geneli mağaza bağlantısını tüm şubeleri gören yönetici alır.
• Operatör ve muhasebeci almaz.

İpuçları:

• E-posta, hesabınızdaki e-posta adresine gider. Adres yoksa ya da yanlışsa firma sahibi Yönetim › Kullanıcılar'dan düzeltir; bkz. Kullanıcılar ve yetkiler.
• E-posta, sizin e-posta hesabınız bozulmuş olsa bile ulaşsın diye Courino'nun kendi hesabından gönderilir.
• Turuncu (Dikkat) durumlar için e-posta gönderilmez; onları bu ekranda görürsünüz.
• E-posta hesabınızın dilinde (Türkçe ya da İngilizce) gelir.

Sorunlar ve ne yapmalısınız

E-ticaret bağlantıları

• Mağazada yeniden yetki vermeniz gerekiyor (kırmızı): Mağaza onayı (ör. IdeaSoft) geri alınmış ya da süresi dolmuş. Ayarlar › E-ticaret sekmesinde bağlantının Mağazada yetki ver düğmesine basın ve açılan mağaza panelinde onay verin.
• Siparişler art arda alınamadı (kırmızı): Sipariş kontrolü üst üste en az 3 kez başarısız oldu. Çoğu zaman API anahtarı silinmiş, değişmiş ya da süresi dolmuştur. Aşağıdaki "E-ticaret: anahtarı yenileme" adımlarını uygulayın.
• Bağlantı henüz hiç başarılı olmadı (kırmızı): Bağlantı kurulduğundan beri bir kez bile sipariş alınamadı. "E-ticaret: anahtarı yenileme" adımlarını uygulayın; mağaza adresini de kontrol edin.
• Son sipariş kontrolü başarısız oldu (turuncu): Tek seferlik bir hata. Mağaza kısa bir kesinti yaşamış olabilir. Birkaç dakika sonra Yenile'ye basın; düzelmezse anahtarları kontrol edin.
• 2 saattir başarılı sipariş kontrolü yok (turuncu): Bağlantı bir süredir yanıt vermiyor. Mağaza tarafında kesinti olabilir; sürerse anahtarları kontrol edin.
• Siparişin durumu mağazaya yazılamadı (turuncu): Siparişler kuryeye düşüyor, yalnız "teslim edildi" bilgisi mağazaya geri yazılamıyor. Anahtarın yazma izni olduğunu kontrol edin.
• Sipariş eşleşme ya da düzeltme bekliyor (turuncu): Semti ya da adresi anlaşılamayan siparişler var. Ayarlar › E-ticaret'te Eşleşme bekleyenler listesini açın; semti ya da adresi düzeltip siparişi içe alın ya da atlayın.
• Sipariş içe alınamadı (turuncu): Bağlantının sipariş listesinde hata nedenini okuyun, düzeltip yeniden deneyin.

E-ticaret: anahtarı yenileme

1. Mağaza ya da pazaryeri panelinizde API anahtarının hâlâ geçerli olduğuna bakın; gerekirse yeni anahtar oluşturun.
2. Ayarlar › E-ticaret'te bağlantıyı düzenleyip anahtarı yeniden girin.
3. Bağlantıyı dene'ye basın.
4. Entegrasyon durumu sekmesine dönüp Yenile'ye basın.

Ayrıntılar için E-ticaret entegrasyonu yazısına bakın.

İYS

• İYS'ye yapılan son çağrı başarısız oldu (kırmızı): İYS kullanıcı adı ya da şifresi değişmiş olabilir. Ayarlar › İYS'de bilgileri kontrol edip Bağlantıyı dene'ye basın.
• Onay İYS'ye gönderilemedi (son 7 gün): Ayarlar › İYS › Bildirim kuyruğu'nda hatalı kayıtların nedenini görün. Bağlantı düzelince kayıtlar yeniden denenir.
• Onay 1 saatten uzun süredir gönderilmeyi bekliyor: Kuyruk ilerlemiyor. Genelde İYS bağlantısı sorunludur; önce bağlantıyı deneyin.

Ayrıntılar için İYS entegrasyonu yazısına bakın.

e-Fatura

• e-Fatura kesilemedi (son 7 gün): Faturalar sayfasında hatalı faturanın nedenini okuyun; Ayarlar › e-Fatura sekmesinde bağlantı bilgilerini kontrol edin. Bkz. Faturalar.

Webhook, Slack, Teams, SMS, WhatsApp, e-posta

• Son 24 saatte ileti gönderilemedi (turuncu): Bazı iletiler gitmedi.
• SMS ve e-posta: Bildirim günlüğü'nde başarısız iletinin nedenini okuyun. Kendi SMS ya da e-posta hesabınızı kullanıyorsanız bakiyeyi ve anahtarı kontrol edin.
• Webhook: Adresin açık olduğunu ve 2xx yanıt verdiğini kontrol edin (Ayarlar › Webhook).
• Slack ve Teams: Ayarlar › Bildirimler'deki kanal bağlantısının silinmediğini kontrol edin.
• WhatsApp: Bildirim günlüğü'nde hatayı okuyun; şablonunuzun onaylı, erişim anahtarınızın geçerli ve Twilio/Meta hesap bakiyenizin yeterli olduğunu kontrol edin. Bkz. WhatsApp bildirimleri.
• Son 24 saatte hiçbir ileti gidemedi (kırmızı): Kanal tamamen çalışmıyor. Yukarıdaki kontrolleri hemen yapın.

Ayrıntılar için Bildirim ayarları ve Bildirim günlüğü yazılarına bakın.

Sorun mu var?

• Sorunu düzelttim ama kart hâlâ kırmızı: Kart bir sonraki başarılı denemede yeşile döner; bu birkaç dakika sürebilir. Biraz bekleyip Yenile'ye basın.
• Sekmeyi göremiyorum: Bu sekmeyi yalnız ayar yönetme yetkisi olan kişiler görür. Firma sahibinden yetki isteyin.
• Ne yapacağımı bilemedim: Kartta Son hatayı göster'e basın, metni kopyalayın ve destek talebi açın.