İçeriğe atla
Bulutegra Geliştiriciler
Geliştiriciler

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.

Pazaryeri entegrasyonları: bağlantı türü, okunan ve yazılan veri, istenen bilgi, kurulum durumu
SistemBağlantıOkunanYazılanSizden istenenKurulum
TrendyolREST · apigw.trendyol.comSipariş, ürünStok, fiyat, ilan açma, içerikAPI anahtarı, API gizli anahtarı, satıcı numarasıBağlantı hazır
HepsiburadaREST · oms-external.hepsiburada.com · listing-external.hepsiburada.comSipariş, ürünStok, fiyat, ilan açma, içerikKullanıcı adı, satıcı (merchant) numarası, gizli anahtarBağlantı hazır
n11SOAP + REST · api.n11.comSipariş, ürünStok, fiyat, ilan açma, içerikUygulama anahtarı ve uygulama gizli anahtarıBağlantı hazır
PazaramaOAuth2 + REST · isortagimgiris.pazarama.com · isortagimapi.pazarama.comSipariş, ürünStok, fiyat, ilan açma, içerikİstemci kimliği ve gizli anahtarıBağlantı hazır
ePttAVMSOAP (WS-Security) · ws.pttavm.comSipariş, ürünStok, fiyat, ilan açma, içerikKullanıcı adı ve parolaBağlantı hazır
FLOREST · api.flo.com.trSiparişStok, fiyatAPI kimliğiBağlantı hazır
ÇiçeksepetiREST · apis.ciceksepeti.comSipariş, ürünStok, fiyat, ilan açma, içerikAPI anahtarıBağlantı hazır
idefixREST · merchantapi.idefix.comSipariş, ürünStok, fiyat, ilan açmaSatıcı numarası ve API anahtarıBağlantı hazır
ModanisaRESTSiparişStok, fiyatAPI kullanıcı adı ve parolaBağlantı hazır
AmazonAmazon Selling Partner API (SP-API)Sipariş, ürünStok, fiyat, içerikSP-API uygulama yetkisi ve satıcı kimliğiBağlantı hazır
eBayRESTSipariş, ürünStok, fiyat, ilan açma, içerikOAuth uygulama yetkisiBağlantı hazır
Walmart (ABD)OAuth2 + REST · Walmart Marketplace API v3Sipariş, ürünStok, fiyat, ilan açma, içerikİstemci kimliği ve gizli anahtarıBağlantı hazır
EtsyOAuth2 + REST · Etsy Open API v3Sipariş, ürünStok, fiyat, ilan açma, içerikUygulama anahtarı ve mağaza yetkilendirmesiBağlantı hazır
OzonREST · api-seller.ozon.ruSipariş, ürünStok, fiyat, ilan açma, içerikClient-Id · Api-KeyBağlantı hazır
TemuREST · Temu Open APISipariş, ürünStok, fiyat, ilan açmaUygulama anahtarı, gizli anahtar ve erişim belirteciBağlantı hazır
SHEINREST · SHEIN Open Platform APISatın alma siparişi, ürünStokMağaza ana hesabından uygulama yetkisiBağlantı hazır
JumiaRESTSiparişKurulumda belirlenirSatıcı API kimliğiBağlantı hazır
noonREST · noon Partner API (JWT)Ürünİlan açmaServis hesabı anahtarıBağlantı hazır
NamshiKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
AllegroKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
WildberriesRESTSiparişKurulumda belirlenirAPI anahtarıBağlantı hazır
TakealotREST · seller-api.takealot.comSiparişKurulumda belirlenirAPI anahtarıBağlantı hazır
AnanasKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
JustYolKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep ü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.

E-ticaret altyapıları: bağlantı türü, okunan ve yazılan veri, istenen bilgi, kurulum durumu
SistemBağlantıOkunanYazılanSizden istenenKurulum
ikasGraphQL · api.myikas.com · adminapi.myikas.comÜrün, varyant, stok, fiyatKurulumda belirlenirAdmin API anahtarıBağlantı hazır
ShopifyKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
WooCommerceKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
TicimaxKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
IdeaSoftKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
T-SoftKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep ü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.

ERP entegrasyonları: bağlantı türü, okunan ve yazılan veri, istenen bilgi, kurulum durumu
SistemBağlantıOkunanYazılanSizden istenenKurulum
Nebim V3Nebim V3 IntegratorSipariş, müşteri, stok (salt okuma prosedürleri)Ayrı ve denetimliServis adresi, servis kullanıcısı ve parolasıBağlantı hazır
LogoKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
MikroKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
SAPKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep ü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.

Tedarikçi beslemesi: okunan alanlar ve istenen bilgi
SistemBağlantıOkunanYazılanSizden istenenKurulum
Tedarikçi XML beslemesiXMLÜrün kodu, barkod, ad, fiyat, stok, görselYazılmazBesleme adresi ve kolon düzeniBağ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.

Kargo firmaları: kurulum durumu
SistemBağlantıOkunanYazılanSizden istenenKurulum
Aras KargoKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
Yurtiçi KargoKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
MNG KargoKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
PTT KargoKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
Sürat KargoKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
HepsijetKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
Trendyol ExpressKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
DHLKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
FedExKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
UPSKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep ü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.

Sosyal medya ve reklam kanalları: kurulum durumu
SistemBağlantıOkunanYazılanSizden istenenKurulum
WhatsApp BusinessKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
MetaKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep üzerine kurulur
Google AdsKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirKurulumda belirlenirTalep ü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.

Bağlantı nasıl kuruluyor
  1. Kapsam: hangi sistemler, hangi yön (okuma, yazma) ve hangi veri konuşulur.
  2. Kimlik bilgisi: sistemlerin kendi panelinden üretilen bilgiler, kurulumda belirlenen yolla iletilir.
  3. Gölge mod: sistem yalnız okur, ne yapacağını gösterir, hiçbir kanala yazmaz.
  4. 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.

Entegrasyon talebi

Formu göndererek, talebinizi değerlendirebilmemiz için iletişim bilgilerinizin işlenmesine izin vermiş olursunuz.