Entegrasyon referansı
Bulutegra'nın salt okuma bir REST API'si ve webhook'ları var; dokümanları developers.bulutegra.com adresinde. Bu sayfa başka bir şeyin dökümü: Bulutegra'nın her sistemin kendi resmi servisine kurduğu bağlantılar.
Bu sayfa neyi anlatıyor
Bulutegra bir entegrasyon katmanıdır: pazaryerleri, kendi siteniz ve ERP'niz arasında durur. Bağlantıyı biz kurarız, kanal tarafındaki farklılıkları biz üstleniriz. Siz kendi panelinizden bakarsınız, kanalların teknik ayrımıyla uğraşmazsınız.
Sitede listelenen 47 entegrasyonun 22 tanesinde bağlantı kurulu ve çalışır durumda; 25 tanesi talep üzerine kurulur. Bu, ürünün neyi desteklediğiyle ilgili bir bilgidir; kimin hangi kanalda satış yaptığıyla ilgisi yoktur.
Tablolardaki servis adresleri, ilgili sistemin kendi yayımladığı resmi satıcı servisleridir. Bulutegra bu servislere sizin hesabınızın yetkisiyle, sizin adınıza bağlanır. Arada Bulutegra'nın kendi uç noktası yoktur.
Tablolarda hiçbir anahtar, parola, satıcı numarası ya da örnek kimlik değeri yer almaz. "Sizden istenen" sütunu yalnız hangi bilginin gerektiğini söyler.
Pazaryerleri
Her pazaryeri bağlantısı o kanalın kendi satıcı servisi üzerinden kurulur. Sipariş kanaldan okunur; stok, fiyat ve ilan tarafı kanalın desteklediği ölçüde yazılır.
Tabloyu okumak için yana kaydırın.
| Sistem | Bağlantı | Okunan | Yazılan | Sizden istenen | Kurulum |
|---|---|---|---|---|---|
| Trendyol | REST · apigw.trendyol.com | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | API anahtarı, API gizli anahtarı, satıcı numarası | Bağlantı hazır |
| Hepsiburada | REST · oms-external.hepsiburada.com · listing-external.hepsiburada.com | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | Kullanıcı adı, satıcı (merchant) numarası, gizli anahtar | Bağlantı hazır |
| n11 | SOAP + REST · api.n11.com | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | Uygulama anahtarı ve uygulama gizli anahtarı | Bağlantı hazır |
| Pazarama | OAuth2 + REST · isortagimgiris.pazarama.com · isortagimapi.pazarama.com | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | İstemci kimliği ve gizli anahtarı | Bağlantı hazır |
| ePttAVM | SOAP (WS-Security) · ws.pttavm.com | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | Kullanıcı adı ve parola | Bağlantı hazır |
| FLO | REST · api.flo.com.tr | Sipariş | Stok, fiyat | API kimliği | Bağlantı hazır |
| Çiçeksepeti | REST · apis.ciceksepeti.com | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | API anahtarı | Bağlantı hazır |
| idefix | REST · merchantapi.idefix.com | Sipariş, ürün | Stok, fiyat, ilan açma | Satıcı numarası ve API anahtarı | Bağlantı hazır |
| Modanisa | REST | Sipariş | Stok, fiyat | API kullanıcı adı ve parola | Bağlantı hazır |
| Amazon | Amazon Selling Partner API (SP-API) | Sipariş, ürün | Stok, fiyat, içerik | SP-API uygulama yetkisi ve satıcı kimliği | Bağlantı hazır |
| eBay | REST | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | OAuth uygulama yetkisi | Bağlantı hazır |
| Walmart (ABD) | OAuth2 + REST · Walmart Marketplace API v3 | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | İstemci kimliği ve gizli anahtarı | Bağlantı hazır |
| Etsy | OAuth2 + REST · Etsy Open API v3 | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | Uygulama anahtarı ve mağaza yetkilendirmesi | Bağlantı hazır |
| Ozon | REST · api-seller.ozon.ru | Sipariş, ürün | Stok, fiyat, ilan açma, içerik | Client-Id · Api-Key | Bağlantı hazır |
| Temu | REST · Temu Open API | Sipariş, ürün | Stok, fiyat, ilan açma | Uygulama anahtarı, gizli anahtar ve erişim belirteci | Bağlantı hazır |
| SHEIN | REST · SHEIN Open Platform API | Satın alma siparişi, ürün | Stok | Mağaza ana hesabından uygulama yetkisi | Bağlantı hazır |
| Jumia | REST | Sipariş | Kurulumda belirlenir | Satıcı API kimliği | Bağlantı hazır |
| noon | REST · noon Partner API (JWT) | Ürün | İlan açma | Servis hesabı anahtarı | Bağlantı hazır |
| Namshi | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Allegro | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Wildberries | REST | Sipariş | Kurulumda belirlenir | API anahtarı | Bağlantı hazır |
| Takealot | REST · seller-api.takealot.com | Sipariş | Kurulumda belirlenir | API anahtarı | Bağlantı hazır |
| Ananas | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| JustYol | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
"Yazılan" sütununda "Kurulumda belirlenir" yazması, o kanalda yazma yönünün hesabınızdaki yetkilere ve gölge mod sonucuna göre açılacağı anlamına gelir. Yazma yetkisi hiçbir kanalda topluca açılmaz, kanal kanal açılır.
Stok bütün kanallarda tek havuzdan yönetilir: bir kanalda satış olunca diğerlerinde adet düşer. Kanal başına ayrı stok defteri tutulmaz.
E-ticaret altyapıları
Kendi siteniz bir e-ticaret altyapısı üzerindeyse ürün, stok ve fiyat tarafı aynı havuza bağlanır; site de kanallardan biri gibi çalışır.
Tabloyu okumak için yana kaydırın.
| Sistem | Bağlantı | Okunan | Yazılan | Sizden istenen | Kurulum |
|---|---|---|---|---|---|
| ikas | GraphQL · api.myikas.com · adminapi.myikas.com | Ürün, varyant, stok, fiyat | Kurulumda belirlenir | Admin API anahtarı | Bağlantı hazır |
| Shopify | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| WooCommerce | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Ticimax | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| IdeaSoft | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| T-Soft | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
Hazır bağlayıcısı olmayan altyapılarda yol iki tanedir: altyapının kendi resmi API'si ya da düzenli bir XML/CSV beslemesi. Hangisinin kullanılacağı, sizin sürümünüzde neyin açık olduğuna göre kurulumda belirlenir.
Sahiplik bayrağı burada da geçerlidir: bir ürünün belirli bir kanalını Bulutegra'nın mı yoksa dış bir sistemin mi yönettiği bellidir, iki taraf aynı alanı ters yönde güncellemez.
ERP
ERP bağlantısında sıra hep aynıdır: önce okuma, sonra karşılaştırma, en sonda yazma. Yazma tarafı ERP'de ayrı ve denetimli ilerler, çünkü yanlış bir kayıt muhasebeye kadar gider.
Tabloyu okumak için yana kaydırın.
| Sistem | Bağlantı | Okunan | Yazılan | Sizden istenen | Kurulum |
|---|---|---|---|---|---|
| Nebim V3 | Nebim V3 Integrator | Sipariş, müşteri, stok (salt okuma prosedürleri) | Ayrı ve denetimli | Servis adresi, servis kullanıcısı ve parolası | Bağlantı hazır |
| Logo | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Mikro | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| SAP | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
Logo, Mikro ve SAP tarafında bağlantı müşterinin sürümüne ve açık olan modüllere göre kurulur; bu yüzden hazır değil, talep üzerine kurulur diyoruz. Sürümünüzü ve modüllerinizi yazın, neyin mümkün olduğunu baştan söyleyelim.
Tedarikçi beslemesi
Ürünü kendiniz üretmiyor, tedarikçiden alıyorsanız katalog bir besleme dosyasından okunur.
Tabloyu okumak için yana kaydırın.
| Sistem | Bağlantı | Okunan | Yazılan | Sizden istenen | Kurulum |
|---|---|---|---|---|---|
| Tedarikçi XML beslemesi | XML | Ürün kodu, barkod, ad, fiyat, stok, görsel | Yazılmaz | Besleme adresi ve kolon düzeni | Bağlantı hazır |
Alanlar sabit kolonlardan okunur. Fiyat, tedarikçiye göre çarpanla hesaplanır; belirlenen eşiğin altındaki stok satışa açılmaz.
Toplu sıfırlama freni burada devreye girer: bir turda anormal sayıda ürün kodu sıfırlanacaksa gönderim durur ve uyarı düşer. Bozuk ya da yarım inen bir besleme bütün kanalları sıfırlayamaz.
Kargo
Pazaryeri siparişi, kargo firması ve teslim şekli bilgisiyle birlikte gelir. Bu bilgi kanal bazında tanımlanır ve siparişle beraber ERP'ye yazılır.
Tabloyu okumak için yana kaydırın.
| Sistem | Bağlantı | Okunan | Yazılan | Sizden istenen | Kurulum |
|---|---|---|---|---|---|
| Aras Kargo | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Yurtiçi Kargo | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| MNG Kargo | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| PTT Kargo | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Sürat Kargo | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Hepsijet | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Trendyol Express | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| DHL | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| FedEx | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| UPS | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
Kargo firmasının kendi servisine doğrudan bağlantı talep üzerine kurulur; kapsam kurulumda belirlenir. Bu satırların hepsinde "talep üzerine kurulur" yazmasının nedeni budur: sayfada kurulmamış bir bağlantıyı hazırmış gibi göstermiyoruz.
Sosyal medya ve reklam kanalları
Bu üç sistem sitedeki kanal evreninin parçası olarak listelenir.
Tabloyu okumak için yana kaydırın.
| Sistem | Bağlantı | Okunan | Yazılan | Sizden istenen | Kurulum |
|---|---|---|---|---|---|
| WhatsApp Business | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Meta | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
| Google Ads | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Kurulumda belirlenir | Talep üzerine kurulur |
Üçünde de bağlantı talep üzerine kurulur; kapsam ve istenen bilgi kurulumda belirlenir.
Bütün bağlantılarda geçerli dört kural
Gölge mod. Kurulum önce yalnız okur. İki taraftan veri çekilir, karşılaştırılır ve hiçbir yere yazılmaz. Ne olacağını önce görürsünüz, sonra devredersiniz.
Kanal kanal devir. Yazma yetkisi topluca açılmaz. Her kanal ayrı ayrı canlıya alınır; bir kanalda yazmaya geçmeden önce eşleştirmenin ve verinin doğruluğu görülür.
Tek stok havuzu. Stok tek yerden yönetilir. Bir kanalda satış olunca diğerlerinde adet düşer.
Toplu sıfırlama freni. Bir turda anormal sayıda ürün kodu sıfırlanacaksa gönderim durur ve uyarı düşer. Sessizce bütün kanalları boşaltan bir tur olmaz.
Bağlantı için sizden ne isteniyor
Tablolardaki "Sizden istenen" sütunu, o sistemin kendi panelinden ürettiğiniz kimlik bilgilerini gösterir. Bu bilgiler sizin hesabınıza aittir; Bulutegra onları yalnız sizin adınıza kullanır.
Kimlik bilgilerini iletişim formuna ya da e-postaya düz metin olarak yazmayın. Hangi bilginin nasıl iletileceğini kurulum sırasında birlikte belirleriz; hangi bilginin neden gerektiği tek tek yazılır.
Anahtarlar sunucuda, yalnız servisin çalıştığı kullanıcının okuyabildiği dosyalarda tutulur ve panelde okunabilir biçimde gösterilmez. Etsy ve eBay tarafında bağlantı tek tıkla yetkilendirmeyle kurulur; yetkiyi kendi hesabınızdan geri çekerseniz bağlantı o anda kesilir.
Saklama, yedekleme ve disk şifrelemesi konusunda ne yaptığımızı — ve ne yapmadığımızı — güvenlik sayfasında açıkça yazıyoruz: Güvenlik, erişim ve veri koruma.
Listede olmayan bir sistem
Tablolarda göremediğiniz bir pazaryeri, altyapı, ERP ya da kargo firması varsa bağlantı talep üzerine kurulur.
İlk bakılan şey şudur: o sistemin resmi bir satıcı servisi ya da düzenli bir XML/CSV beslemesi var mı, sizin hesabınızda açık mı. Varsa bağlantı aynı sırayla kurulur: önce okuma, sonra gölge mod, sonra kanal kanal yazma. Yoksa neyin mümkün olmadığını baştan söyleriz.
Bu sayfada süre vaadi vermiyoruz. Kapsam netleştikten sonra takvimi yazılı olarak paylaşırız.
Bu sayfa kimin işine yarar
Pazaryerinde satan işletme
Kanal hesapları sizde kalır. Bulutegra o hesaplara kanalın kendi resmi servisi üzerinden bağlanır; anahtarlar sizin adınıza üretilir.
ERP ekibi
Nebim V3 tarafında bağlantı kurulu. Diğer ERP'lerde kapsam sürüme ve açık modüllere göre kurulumda belirlenir.
Ajans ve çözüm ortağı
Birden fazla müşteri için kurulum yapan ekipler her müşteride aynı sırayı izler: okuma, gölge mod, kanal kanal yazma.
- Kapsam: hangi sistemler, hangi yön (okuma, yazma) ve hangi veri konuşulur.
- Kimlik bilgisi: sistemlerin kendi panelinden üretilen bilgiler, kurulumda belirlenen yolla iletilir.
- Gölge mod: sistem yalnız okur, ne yapacağını gösterir, hiçbir kanala yazmaz.
- Devir: sonucu gördükten sonra yazma yetkisi kanal kanal açılır.
Sık sorulan sorular
Bulutegra'nın kendi API'si var mı?
Evet. Salt okuma bir REST API'si ve webhook'ları var: kendi yazılımınız siparişleri, ürünleri, stoğu ve kanal durumunu okuyabilir; yeni sipariş, durum değişikliği ve ERP'ye aktarım webhook ile gelir. API hiçbir şeyi değiştiremez — kanallara ve ERP'nize yazma işini Bulutegra yapar. Anahtarı panelde Ayarlar › Bulutegra API ve webhook ekranından oluşturursunuz; dokümanlar developers.bulutegra.com adresinde.
Tabloda "bağlantı hazır" ne demek?
O sisteme bağlanan kod yazılmış ve çalışıyor demektir. Sizin hesabınızda açılması için yine kimlik bilgisi, eşleştirme ve gölge mod adımı gerekir. "Talep üzerine kurulur" ise bağlantının sizin ihtiyacınıza göre kurulacağı anlamına gelir; hazırmış gibi göstermiyoruz.
API erişimi ücretli mi?
Fiyat sayfasındaki paket tablosunda ayrı bir "API" kalemi yoktur. Entegrasyon bağlantıları ayrı satılan bir ürün değildir; hesabınızın planı ve talep ettiğiniz kapsamla birlikte değerlendirilir. Listede olmayan bir sistemin kurulumu bir bedel doğuruyorsa bunu yazılı teklifte kalem kalem görürsünüz. Paketler burada: Fiyatlar.
Kimlik bilgilerimi nasıl iletiyorum?
Formda ya da e-postada düz metin olarak göndermeyin. Hangi bilginin nasıl iletileceğini kurulum sırasında birlikte belirleriz. Bu bilgilerin sunucuda nasıl saklandığını — ve disk şifrelemesi gibi neyi yapmadığımızı — güvenlik sayfasında yazıyoruz: Güvenlik.
Ayrı bir test ortamı var mı?
Ayrı bir test ortamı sunmuyoruz. Denemeler kurulumdaki gölge mod üzerinden ve gerektiğinde demo hesabı üzerinden yürür: sistem önce yalnız okur, siz sonucu görürsünüz, yazma yetkisi ancak siz onay verince kanal kanal açılır.
Bağlanmak istediğiniz sistemi ve verinin hangi yönde akması gerektiğini yazın; kapsamı birlikte çıkaralım. Aşağıdaki formu doldurabilir ya da destek@bulutegra.com adresine yazabilirsiniz.