Entegrasyonlar

Entegrasyonlar ekranı üç sekmeden oluşur. Her sekmenin yanında o sekmede bağlı olan kayıt sayısı görünür.

“Pazaryerleri”

Trendyol, Hepsiburada, n11 gibi pazaryerleri ile ikas, Shopier, Ideasoft gibi e-ticaret sitelerinizin bağlantıları.

“Fatura”

e-Arşiv / e-Fatura sağlayıcınızın bağlantısı, otomatik fatura ayarları ve son kesilen faturalar.

“İletişim”

Bildirimlerin gideceği WhatsApp ve Telegram kanalları.

“Pazaryerleri” sekmesinde iki liste görürsünüz: “Pazaryerleri” ve “E-ticaret siteniz”. Her kartta pazaryerinin adı ve durumu (“Bağlı değil”, “2 mağaza bağlı” gibi) yazar.

1. 1Bağlamak istediğiniz pazaryerinin kartındaki “Bağla” düğmesine basın. Aynı pazaryerinde zaten bir mağazanız bağlıysa düğmenin adı “Ekle” olur; böylece ikinci bir mağaza ekleyebilirsiniz.
2. 2Açılan pencerenin üstünde, bilgileri pazaryerinin panelinde nerede bulacağınız yazar. Bu bilgileri pazaryeri panelinizden kopyalayın.
3. 3İstenen alanları doldurun. İsterseniz “Mağaza adı (isteğe bağlı)” alanına mağazanızı panelde tanıyacağınız bir ad verin (ör. “Ana mağaza”). Boş bırakırsanız pazaryeri adı ve satıcı numaranız kullanılır.
4. 4“Bağla” düğmesine basın. DevEntegre bilgileri kaydetmeden önce pazaryerine gerçek bir deneme isteği gönderir; bilgiler hatalıysa pencerede hata mesajı görürsünüz.
5. 5Bağlantı kurulunca “Bağlandı” mesajı çıkar. Siparişler ve ürünler birkaç dakika içinde panelde görünmeye başlar.

“Hazırlanıyor” / “Yakında”

Bu pazaryerinin bağlantısı henüz hazırlanıyor, şimdilik bağlanamaz.

“Onay bekliyor” / “Uygulama onayı bekleniyor”

Bu pazaryeri için DevEntegre uygulamasının pazaryerindeki onayı sürüyor; onaylanınca bağlantı açılır.

Bilgileri Trendyol Satıcı Paneli › Hesap Bilgilerim › Entegrasyon Bilgileri sayfasında bulursunuz. Bu sayfaya ana hesapla giriş yapmanız gerekir.

“Satıcı ID”

Yalnızca rakamlardan oluşan satıcı numaranız.

“API Key” ve “API Secret”

Entegrasyon Bilgileri sayfasındaki anahtarlar. “Göster” kutusunu işaretleyerek yazdığınız API Secret’ı kontrol edebilirsiniz.

“Ürün sayısı (Trendyol’daki listeleme limitiniz)”

Trendyol’daki listeleme limitinize uyan kademeyi seçin: “50.000 ürüne kadar”, “75.000 ürüne kadar”, “150.000 ürüne kadar”, “500.000 ürüne kadar” veya “Limitsiz”.

“Gelişmiş” bölümünü açarak mağazaya bir ad verebilir ve “Trendyol test ortamı (stagepartner)” kutusunu işaretleyerek test hesabınızı bağlayabilirsiniz. Test ortamındaki mağazalarda “Test ortamı” etiketi görünür.

Trendyol bağlantısında DevEntegre, Trendyol’a anlık sipariş bildirimi (webhook) kaydını kendisi yapar; yeni siparişler beklemeden gelir. Anlık bildirim kurulamazsa siparişler yine 3 dakikada bir çekilir.

1. 1Hepsiburada Satıcı Paneli › Bilgilerim › Entegrasyon › Entegratör Bilgileri sayfasına gidin.
2. 2“Entegratör ekle” ile DevEntegre’yi ekleyin. Yetki yaklaşık 2 saatte açılır.
3. 3Ardından Mağaza ID’nizi ve Servis Anahtarı’nı DevEntegre’deki pencereye girin.

“Mağaza ID (Merchant ID)”

Harf, rakam ve tirelerden oluşan uzun kimlik (GUID biçiminde).

“Servis Anahtarı”

12 karakterli anahtar.

“Hepsiburada mağaza adı (isteğe bağlı)”

Hepsiburada’da müşterinin gördüğü mağaza adınız; BuyBox sıranızı bulmak için kullanılır.

İsterseniz “Hepsiburada test ortamı” kutusunu işaretleyerek test hesabınızı bağlayabilirsiniz.

Bilgileri n11 Mağazam › Hesabım › API Hesapları sayfasında bulursunuz.

“API Anahtarı (appKey)”

API Hesapları sayfasındaki anahtar.

“API Şifresi (appSecret)”

Aynı sayfadaki şifre.

n11 bağlantısında siparişler, sipariş onayı, ürün ve stok/fiyat güncellemesi çalışır. İadeler ve müşteri soruları n11 panelinden yönetilir.

Amazon bağlantısında anahtar girmezsiniz; Amazon’un kendi onay ekranını kullanırsınız.

1. 1Amazon Türkiye kartındaki “Bağla” düğmesine basın.
2. 2İsterseniz mağazaya bir ad verin, ardından “Amazon Türkiye’de onayla” düğmesine basın.
3. 3Seller Central’a yönlendirilirsiniz. DevEntegre’ye yetki verdiğinizde Entegrasyonlar ekranına geri dönersiniz ve bağlantı kendiliğinden kurulur.

Siparişler, kargo bildirimi ve SKU bazında stok/fiyat güncellemesi çalışır. Müşteri kişisel bilgileri (ad, adres) Amazon’un kısıtlı veri kuralları nedeniyle gösterilmez.

Bilgileri Çiçeksepeti Satıcı Paneli › Hesap Yönetimi › Entegrasyon Bilgilerim sayfasında bulursunuz. Anahtarınız yoksa Destek › “API Entegrasyon Süreçleri” talebiyle istenir.

“Satıcı ID”

Yalnızca rakamlardan oluşan satıcı numaranız.

“API Anahtarı (x-api-key)”

Entegrasyon Bilgilerim sayfasındaki anahtar.

Bilgileri Pazarama İş Ortağım Paneli › Hesap Bilgileri › Entegrasyon Bilgileri sayfasında bulursunuz.

“API Key (Client ID)”

Entegrasyon Bilgileri sayfasındaki anahtar.

“API Secret (Client Secret)”

Yalnızca üretildiğinde bir kez gösterilir; o anda kopyalayıp saklayın.

PttAVM Satıcı Paneli › Hesap Yönetimi › Entegrasyon Bilgileri sayfasında entegratör olarak DevEntegre’yi ekleyip yetkilendirin. API Key ve DevEntegre’ye özel Token bu sayfada görünür.

“API Key”

Entegrasyon Bilgileri sayfasındaki anahtar.

“Token (access-token)”

Entegratöre özel, mağaza bazlı token.

Sipariş durumu, iadeler ve müşteri soruları PttAVM panelinden yönetilir.

idefix Satıcı Paneli › Hesap Bilgilerim › Entegrasyon Bilgileri sayfasında “Yeni API Oluştur”a basın. API Key ve Secret kayıtlı e-posta adresinize gönderilir; Satıcı ID aynı sayfada yazar.

“Satıcı ID”

Entegrasyon Bilgileri sayfasındaki satıcı numaranız.

“API Key” ve “API Secret”

E-postanıza gelen anahtarlar.

1. 1ikas Yönetim Paneli › Uygulamalar › Uygulamalarım › Özel Uygulamalar bölümünde yeni bir uygulama oluşturun ve “Standart Uygulama”yı seçin.
2. 2Yetkilerde read_orders, write_orders, read_products ve write_products seçeneklerini işaretleyin.
3. 3Oluşan Client ID ve Client Secret’ı DevEntegre’deki pencereye girin. Client Secret yalnızca uygulama oluşturulurken bir kez gösterilir.

ikas bağlantısında siparişler, kargoya hazırlama, ürün ve stok/fiyat güncellemesi çalışır.

Shopier bağlantısında anahtar girmezsiniz. Shopier kartındaki “Bağla”ya basıp pencerede “Shopier’de onayla” düğmesine bastığınızda Shopier giriş ekranına gidersiniz; DevEntegre’ye izin verdiğinizde bağlantı kendiliğinden kurulur ve Entegrasyonlar ekranına geri dönersiniz.

1. 1DevEntegre’de Ideasoft kartındaki “Bağla”ya basın. Pencerede bir “Yönlendirme adresi” görürsünüz; yanındaki kopyala simgesiyle bu adresi kopyalayın.
2. 2Ideasoft yönetim paneli › Entegrasyonlar › API bölümünde “API Ekle”ye basın. Uygulama adına DevEntegre yazın, Yönlendirme Adresi alanına kopyaladığınız adresi aynen yapıştırın ve İzin Yönetimi’nden “Okuma/Yazma” verin.
3. 3Oluşan Client ID ve Client Secret’ı DevEntegre’deki pencereye girin. “Mağaza adresi” alanına mağazanızın Ideasoft adresini yazın (ör. magazam.myideasoft.com).
4. 4“Ideasoft’ta onayla” düğmesine basın; Ideasoft onay ekranına yönlendirilirsiniz. Onay verdiğinizde bağlantı kurulur ve DevEntegre’ye geri dönersiniz.

Amazon Türkiye, Shopier ve Ideasoft bağlantıları pazaryerinin kendi onay ekranı üzerinden kurulur. Düğmeye bastığınızda “… onay ekranına yönlendiriliyorsunuz…” mesajını görür ve pazaryerinin sitesine geçersiniz.

Onayı verdikten sonra Entegrasyonlar ekranına döndüğünüzde ekranın üstünde bağlantının başarılı olup olmadığını anlatan bir bilgi kutusu çıkar. Kutuyu sağdaki kapat simgesiyle kapatabilirsiniz.

Bağladığınız her mağaza, “Pazaryerleri” sekmesinin en üstünde ayrı bir kart olarak görünür. Kartta mağaza adı, satıcı numarası, o mağazadan gelen sipariş sayısı ve siparişlerin en son ne zaman çekildiği (“son çekim”) yazar.

“Bağlı”

Bağlantı çalışıyor.

“Hata”

Pazaryerine son istekte sorun çıktı. Kartın altında hata mesajı yazar.

“Bekliyor”

Bağlantı henüz doğrulanmadı.

“Test ortamı”

Bu bağlantı pazaryerinin test hesabına bağlı; gerçek siparişler gelmez.

“Anlık bildirim açık”

Pazaryeri yeni siparişleri anında DevEntegre’ye bildiriyor (şimdilik Trendyol’da).

“3 dk’da bir çekiliyor”

Siparişler 3 dakikada bir pazaryerinden kontrol edilerek çekiliyor.

“Anlık bildirim durdu” / “Anlık bildirim bulunamadı”

Pazaryeri anlık bildirimi durdurmuş. Siparişler yine 3 dakikada bir gelir; kartın altındaki “Yeniden aç” ile bildirimi tekrar kurabilirsiniz.

Mağaza kartının sağındaki üç nokta menüsünde şu işlemler bulunur:

“Bağlantıyı test et”

Kayıtlı bilgilerle pazaryerine deneme isteği gönderir. Başarılıysa “Bağlantı çalışıyor.” mesajı çıkar ve durum “Bağlı” olur; başarısızsa durum “Hata” olur ve neden kartın altında yazar.

“Şimdi senkronize et”

Sipariş ve ürünlerin pazaryerinden hemen çekilmesini başlatır; otomatik çekimi beklemek istemediğinizde kullanın.

“Anlık bildirimi yeniden kur”

Yalnızca anlık bildirimi destekleyen pazaryerlerinde (şimdilik Trendyol) görünür; bildirimi pazaryerine yeniden kaydeder.

“Ayarlar”

“Mağaza ayarları” penceresini açar. Buradan mağaza adını değiştirebilirsiniz; Trendyol mağazalarında ürün sayısı (listeleme limiti) kademesini de güncelleyebilirsiniz. “Kaydet” ile onaylayın.

“API bilgilerini güncelle”

Pazaryerinde anahtarınızı yenilediyseniz yeni bilgileri buradan girersiniz. Satıcı numarası sabit kalır, aynı bağlantı güncellenir ve mağaza sınırınızdan yer harcamaz. Kaydetmeden önce yeni bilgiler pazaryerinde denenir. Onay ekranıyla bağlanan Amazon, Shopier ve Ideasoft mağazalarında bu seçenek yoktur.

“Bağlantıyı kaldır”

Mağazanın bağlantısını keser (ayrıntısı aşağıda).

1. 1Mağaza kartındaki üç nokta menüsünden “Bağlantıyı kaldır”ı seçin.
2. 2“Bağlantı kaldırılsın mı?” penceresinde “Kaldır”a basın.

Bağlantı kaldırıldığında o mağazadan yeni veri çekilmez ve otomatik işlemler durur. Geçmiş siparişler ve raporlar silinmez.

“Fatura” sekmesinde “Sağlayıcılar” başlığı altında desteklenen e-Arşiv / e-Fatura sağlayıcıları listelenir. Fatura sağlayıcısı bağlamazsanız faturayı kendiniz kesip linkini siparişe ekleyebilirsiniz.

1. 1Kullandığınız sağlayıcının kartında “Bağla”ya basın.
2. 2Pencerede istenen bilgileri girin (her sağlayıcının alanları aşağıda).
3. 3Sağlayıcı test ortamı sunuyorsa ve önce denemek istiyorsanız “Test ortamı (gerçek fatura kesilmez)” kutusunu işaretleyin.
4. 4“Test et” ile bilgilerin doğru olduğunu kontrol edin. Başarılıysa “Bağlantı başarılı” ve hesap adınız görünür.
5. 5“Kaydet ve kullan”a basın. Bu sağlayıcı kaydedilir ve faturalar artık bununla kesilir.

Trendyol E-Faturam

Trendyol’un e-Arşiv hizmeti. “Portal e-posta adresi” ve “Portal şifresi” ile bağlanır. “Firma ID” ve “Kullanıcı ID” alanlarını boş bırakın; girişte otomatik bulunur. Firma bulunamazsa portaldaki firma numarasını yazın.

Nilvera

e-Arşiv ve e-Fatura. “API anahtarı” ile bağlanır: Nilvera portalı › Ayarlar › API anahtarı oluştur. Anahtar yalnızca bir kez gösterilir.

Paraşüt

Ön muhasebe + e-Arşiv. “Firma numarası” (Paraşüt adres çubuğundaki numara), “Paraşüt e-posta adresi”, “Paraşüt şifresi”, “Client ID” ve “Client secret” istenir. Client ID ve secret için [email protected] adresinden API erişimi isteyin. Test ortamı yoktur.

Bien Connect

e-Arşiv. Bien e-dönüşüm portalı “Kullanıcı adı” ve “Şifre” ile bağlanır. e-Fatura mükellefi alıcılarda fatura Bien panelinden kesilir.

“Kullanılıyor”

Faturalar şu anda bu sağlayıcıyla kesiliyor.

“Bağlı”

Bilgileri kayıtlı ama şu an kullanılmıyor.

“Test”

Test ortamına bağlı; gerçek fatura kesilmez.

Bağlı bir sağlayıcının kartındaki üç nokta menüsünde şunlar bulunur:

• “Bunu kullan”: Bağlı ama kullanılmayan sağlayıcıyı etkin yapar; faturalar artık bununla kesilir.
• “Bilgileri düzenle”: Kayıtlı bilgileri günceller. Şifre ve anahtar alanlarını yalnızca değiştirmek istiyorsanız doldurun; boş bırakırsanız mevcut değer korunur.
• “Kaldır”: Kayıtlı bilgileri siler. Daha önce kesilmiş faturalar etkilenmez.

Sekmenin en üstündeki bilgi kutusu faturaların hangi sağlayıcıyla kesildiğini gösterir.

En az bir fatura sağlayıcısı bağladıktan sonra “Fatura” sekmesinde “Ayarlar” kartı görünür.

“Yeni siparişlerde faturayı otomatik kes”

Açıksa yeni siparişlerin faturası kendiliğinden kesilir. Kapalıyken siparişler ekranında siparişleri seçip “Fatura kes”e basarak kesersiniz.

“Seri ön eki (isteğe bağlı)”

3 harf veya rakamdan oluşan fatura serisi (ör. EAR). Boş bırakırsanız sağlayıcınızdaki varsayılan seri kullanılır.

“Kargo firması VKN’leri”

e-Arşiv internet satışı faturasında taşıyıcı kargo firmasının vergi numarası zorunludur. Kullandığınız her kargo firmasının VKN’sini ilgili alana yazın; bu numara kargo faturalarınızda yazar. Eksik firma sayısı başlığın altında gösterilir.

Değişikliklerden sonra kartın altındaki “Kaydet” düğmesine basın.

“Fatura” sekmesinin altındaki “Son faturalar” tablosunda en son kesilen 20 fatura görünür: sipariş numarası, fatura numarası, tutar, durum ve zaman. Sipariş numarasına tıklayarak siparişin ayrıntısına gidebilirsiniz.

“Sırada”

Fatura kesilmek üzere sıraya alındı.

“Onay bekleniyor”

Sağlayıcıya iletildi, onayı bekleniyor.

“Kesildi”

Fatura kesildi.

“Pazaryerine gönderildi”

Fatura kesildi ve pazaryerine yüklendi.

“Hata”

Fatura kesilemedi; nedeni durumun yanında yazar. Satırdaki yenile simgesiyle (“Tekrar dene”) yeniden deneyebilirsiniz.

“Elle kesilmeli”

Bu fatura otomatik kesilemez; sağlayıcınızın panelinden kendiniz kesmelisiniz. Nedeni durumun yanında yazar.

“İletişim” sekmesinde bildirimlerin gideceği kanalları eklersiniz. “Kanal ekle” başlığı altında üç seçenek vardır:

“WhatsApp · Kare kod” (Hızlı kurulum)

Telefonunuzla kare kodu okutarak hemen başlarsınız.

“WhatsApp · Business API” (Önerilen)

Meta’nın resmî altyapısıdır; numara engellenme riski yoktur.

“Telegram”

Bir grup açar, botunuzu gruba eklersiniz.

Kurulum adımlarının ayrıntısı “Bildirimler” bölümünde anlatılıyor. “Bağlı kanallar” listesinde her kanalın adı, türü, alıcısı ve kaç olay için açık olduğu görünür.

“Bağlı”

Kanal çalışıyor.

“Bağlantı yok”

Kanal mesaj gönderemiyor (ör. kare kodla bağlı WhatsApp oturumu kopmuş).

“Duraklatıldı”

Kanal geçici olarak durduruldu.

• “Test” düğmesi kanala bir deneme mesajı gönderir.
• Çöp kutusu simgesi kanalı kaldırır; onay penceresinde “Kaldır”a basmanız gerekir.
• “Hangi olaylar gitsin?” bağlantısı sizi “Bildirimler” sayfasına götürür; orada her kanal için olayları seçersiniz.

Kare kodla bağlanmış telefonlar “Kare kodla bağlı WhatsApp hesapları” listesinde görünür (“Bağlı”, “Koptu” veya “Bekliyor”). Üç nokta menüsünden “Kare kodu yeniden okut” ile bağlantıyı tazeleyebilir, “Bağlantıyı kes” ile oturumu kapatabilirsiniz.