Geliştiriciler ve iş ortakları için

Etibas verinizi
kendi yazılımınıza bağlayın

Bayi siteniz kataloğunuzu çekip sipariş açar; muhasebe ya da ERP programınız ürün, stok ve fiyat gönderir, siparişleri toplayıp durumunu yazar. Etibas API, panelinizdeki ürün, stok, fiyat, kategori, marka ve sipariş verisini REST/JSON olarak dışarı açar; değişiklikleri webhook ile anında bildirir. Pazaryeri geliştirici merkezlerinden alıştığınız her şey burada: belge, deneme konsolu, sandbox, OpenAPI ve Postman.

Geliştirici Merkezi'ni Aç 7 Gün Ücretsiz Dene

🔑 Bearer token 📦 Ürün · Stok · Fiyat 🧾 Sipariş akışı 🔔 Webhook 🧪 Sandbox 📄 OpenAPI · Postman

api.etibas.com/v2

# stok ve fiyatı dakikada bir eşitle curl https://api.etibas.com/v2/stoklar?size=5000 \ -H "Authorization: Bearer ****" { "veri": [ { "id": "URN001", "barkod": "4549526241383", "stok": 12, "psf": 4299.00, "alis": 3009.30 }, { "id": "URN002", "barkod": "8690000000002", "stok": 0, "psf": 1299.90, "alis": 909.93 } ], "sonraki_imlec": "Q2FzaW8…", "toplam": 18420 } ✓ 200 · 48 ms · kalan istek 599/600

Üç Farklı İhtiyaç, Tek API

Aynı uçlar; kim bağlandığına göre yetki ve kapsam değişir. Her bağlantı için ayrı API hesabı açarsınız, biri sorun çıkarırsa yalnız onu kapatırsınız.

🛒

Bayi sitesi / dropship

Bayiniz kataloğunuzu kendi sitesinde satar, siparişi size iletir. Size özel alış fiyatını tanımlarsanız her üründe hazır gelir.

Ürünleri çeker: ad, barkod, görseller, özellikler, açıklama
Dakikada bir hafif stok/fiyat listesi ya da webhook
Satış olunca POST /siparisler — panelinize Onay Bekliyor düşer
Kargo ve durum değişimini webhook'la müşterisine iletir

🏭

ERP / muhasebe programı

Ürün ve stok yönetimi sizde; Etibas pazaryerlerine ve web sitenize dağıtır, siparişleri toplar. Token'da yazma yetkileri açılır.

Ürün kartı: POST /urunler, marka ve kategori adla, yoksa açılır
Stok ve fiyat: 500'lük partiler, barkodla eşleşir
Siparişleri artımlı çeker (yalnız değişenler)
Faturayı kesince Faturalandı, depodan çıkınca Kargoda + takip no

🧑‍💻

Yazılım evi / e-ticaret altyapısı

Birden çok müşteriniz Etibas kullanıyor. Her müşteri kendi token'ını verir; hesap token'dan bulunur, adreste hesap adı yoktur.

OpenAPI'den istemci üretin, Postman'de deneyin
Müşteri başına webhook adresi
Hız sınırı token başına: müşteriler paralel işlenir
Hata mesajları Türkçe, kullanıcıya olduğu gibi gösterilir

Katalog Çekimi ve Dakikalık Stok Eşitleme

Ürün listesi barkod, kod, kategori, marka, görseller, özellikler ve açıklamayla gelir; imleçli sayfalama büyük kataloglarda da hızlı ve kararlıdır. Günlük tam tur yerine dakikada bir hafif stok/fiyat listesi çekersiniz: sayfada 5000 ürün, yalnız değişen alanlar.

Barkod, kod ya da serbest metinle süzebilir, yalnız stoğu olanları isteyebilirsiniz. Stok, API hesabının kuralına göre hesaplanır: satışa kapalı tedarikçiler ve kapalı firmalar sayılmaz, yalnız izin verdiğiniz depoların stoğu gider.

Liste fiyatı (psf) her zaman; alıcıya özel alış fiyatı (alis) tedarikçi açtıysa
Ürüne özel fiyat → marka iskontosu → genel iskonto önceliğiyle hesaplanır
Barkodla arama: ?barkod=…, serbest metin: ?ara=… (Türkçe harf duyarsız)
Kategori ağacı tam yoluyla ("Saat / Erkek Kol Saati"), marka ve özellik sözlüğü ayrı uçlarda
Pasif ürün listede yer almaz; kanallara stok 0 gider

Sipariş Açma, Takip ve Anında Bildirim

Bayi yazılımı kendi sipariş numarası, müşteri ve adres bilgisi, kargo ve ürün kimlikleriyle siparişi açar; sipariş panelinizde Onay Bekliyor olarak düşer, ürünler o anda rezerve edilir. Dropship'te fatura bayiye, teslimat son müşteriye kesilir; bayinin pazaryeri etiketi siparişle gelir.

Onay, kargo ve teslimat değişimleri webhook ile bayinin adresine imzalı JSON olarak gider; sorgulamak isteyen yalnız değişenleri artımlı çeker. Kargolanmamış sipariş API'den iptal edilir, rezerve stok geri döner.

Aynı sipariş kodu tekildir: ikinci istek 409 döner, mükerrer sipariş oluşmaz
Siparişin satıldığı kanal (N11, Trendyol…) etikette ve listede görünür
Kendi deponuzdan gönderen bayi kargo firması ve takip numarasını yazar
Not, fatura bilgisi ve teslimat adresi sonradan güncellenir (kargolanmadıysa)
Webhook 2xx almazsa 1 sn, 5 sn, 30 sn, 2 dk, 10 dk sonra yeniden dener; sonuç olay günlüğünde
Kargo firmaları, sipariş durumları ve satış kanalları referans uçlarından okunur

ERP'den Ürün, Stok ve Fiyat Gönderin

Ürün yönetimi kendi programınızdaysa API hesabında Ürün yazma yetkisini açarsınız. Programınız ürün açar ve günceller, 500'lük partilerle stok ve fiyat gönderir; Etibas kanal fiyatlarını fiyat stratejinize göre hesaplar, pazaryerlerine ve web sitenize dağıtır.

Ürün açma panelin Ürün Ekle penceresiyle aynı kurallarla çalışır: barkod tekildir, aynı kodlu ürünler varyant ailesi kurar, görseller o anda indirilir, ürün web sitesi ve B2B kataloğuna kendiliğinden eklenir. Marka ve kategori adla verilir; yoksa açılır.

Stok yazma hedef adet alır; fark kadar giriş/çıkış hareketi Stok Hareketleri'nde görünür
Fiyat değişimi Fiyat Geçmişi'ne "api" kaynağıyla düşer; sabit satış fiyatı da yazılabilir
Toplu uçlarda her satır bağımsız: hatalı satır ötekileri durdurmaz, yanıt satır satır sonuç verir
Özellikler ad çiftleriyle verilir ve var olan özellik sözlüğüne eşlenir
Sipariş yönetimi yetkisiyle durum (Onaylandı, Faturalandı, Kargoda…), not, fatura ve teslimat bilgisi yazılır
Siparişler artımlı çekilir: son turdan beri değişenler, iptaller dahil

Her Bağlantı Kendi Kapsamıyla

Token tek başına "her şeye erişim" değildir. API hesabında hangi markaların gideceğini, hangi ürün ve tedarikçilerin kapalı kalacağını, hangi depoların stoğunun sayılacağını, alıcıya özel alış fiyatını ve yazma yetkilerini siz belirlersiniz.

Bayinize verdiğiniz token okur ve sipariş açar; muhasebe programınıza verdiğiniz token ürün ve sipariş yazar. İsterseniz token'ı tek IP adresine bağlarsınız. Webhook iletileri gizli anahtarla imzalanır; dakikada 600 istek sınırı her token için ayrı işler.

Sipariş görünürlüğü: yalnız kendi açtığı siparişler (bayi) ya da tüm siparişler (muhasebe programı)
Yazma yetkileri varsayılan kapalı; açmak tek işaret, anında geçerli
Kapalı ürün hiç görünmez; kapalı firmanın stoğu sayılmaz, ürün görünür
Hesap pasife alınınca token geçersiz; silinen ürün ve marka listelerden kendiliğinden düşer
Her istek erişim günlüğüne, her olay ve webhook sonucu olay günlüğüne yazılır (30 gün)

Neler Yapılabilir?

Kaynak kaynak özet. Parametreler, örnek gövdeler ve hata kodları Geliştirici Merkezi'nde.

Kaynak	Okuma	Yazma	Yetki
Hesap	Token'ın hesabı, kapsamı, yetkileri, hız sınırı	—	Her token
Ürünler	Liste (imleç, barkod/kod/metin süzgeci), tek ürün, açıklama HTML'i	Ürün aç, kısmi güncelle, pasife al, görsel ekle/değiştir	Ürün yazma
Stok & Fiyat	Hafif liste: id, barkod, stok, psf, alış (5000/sayfa)	Tekil ve toplu (500) stok; tekil ve toplu fiyat, sabit satış fiyatı	Ürün yazma
Kategori · Marka · Özellik	Kategori ağacı (yol), markalar, özellik grupları ve değerleri	Kategori aç (yol zinciri), marka aç — varsa olanı döner	Ürün yazma
Siparişler	Liste (durum, kanal, tarih, artımlı değişenler, sipariş kodu), tek sipariş	Sipariş aç, iptal, kargo bildir, not · durum, fatura bilgisi, teslimat adresi	Her token Sipariş yönetimi
Referans	Kargo firmaları, sipariş durumları, satış kanalları ve mağazalar, depolar	—	Her token
Webhook	Ayar, olay günlüğü (gönderim sonuçları)	Adres kaydet/kaldır, gizli anahtar yenile, deneme olayı	Her token

Sipariş açma her token'da açıktır; yazma yetkileri API hesabında ayrıca işaretlenir. Tedarikçiniz de Etibas kullanıyorsa API gerekmez: Etibas Ağı bağlantısıyla stok ve fiyat saniyeler içinde yansır, siparişiniz tedarikçinin paneline kendiliğinden düşer.

Geliştiriciniz İçin Hazır Araçlar

Entegrasyon bir öğleden sonra başlayıp aynı gün ilk siparişi açabilir.

📘Geliştirici Merkezi

Her uç için parametreler, örnek istek ve yanıt, curl · PHP · Python · Node.js · C# kod örnekleri, hata sözlüğü, senaryolar.

api.etibas.com → ▶Deneme konsolu

Tarayıcıdan gerçek istek atın: yöntem, yol, gövde, token. Her uç kartındaki "Dene" örneği konsola taşır.

Konsolu aç → 🧪Sandbox

Herkese açık tanıtım hesabı token'ı: okuma, yazma ve sipariş dahil her uç denenir; yazılanlar 24 saatte silinir.

Token'ı gör → 📄OpenAPI & Postman

OpenAPI 3.0 sözleşmesinden istemci üretin; klasörlenmiş Postman koleksiyonunu indirip hemen deneyin.

openapi · postman →

API hesabı açma ve ayarları için yazılı rehber: yardim.etibas.com › API Hesapları →

Sıkça Sorulan Sorular

Hayır. API Etibas aboneliğine dahildir; ayrı lisans ya da istek başına ücret yoktur. Token'ı panelde Ayarlar › API Hesapları ekranından siz üretirsiniz; dilediğiniz kadar API hesabı açabilirsiniz. Tek sınır hız sınırıdır: her token dakikada en çok 600 istek atabilir.

Ona bir API hesabı açar, hangi markaları göreceğini ve isterseniz size özel alış fiyatını belirlersiniz. Bayinizin yazılımı ürün listesini ve hafif stok/fiyat ucunu çeker, satış olunca siparişi API ile size açar; sipariş panelinize 'Onay Bekliyor' olarak düşer. Stok değişince webhook ile anında haber verilir. Bayiniz de Etibas kullanıyorsa API'ye bile gerek kalmaz: Etibas Ağı bağlantısı panel içinden akar.

Evet. API hesabında 'Ürün yazma' yetkisini açarsanız programınız ürün açar ve günceller, 500'lük partilerle stok ve fiyat gönderir (barkodla eşleşir), kategori ve markayı yoksa kendisi açar. 'Sipariş yönetimi' yetkisiyle siparişleri çekip faturayı kesince durumunu 'Faturalandı', depodan çıkınca 'Kargoda' yapabilir ve takip numarasını yazabilir.

Evet, webhook ile. Bir https adresi tanımlarsınız; ürün stoğu/fiyatı değişince, hesabınız adına sipariş açılınca ya da siparişin durumu/kargosu değişince adresinize imzalı JSON gönderilir. Adresiniz yanıt vermezse 1 saniye, 5 saniye, 30 saniye, 2 dakika ve 10 dakika sonra yeniden denenir; sonucu panelden ve API'den izlersiniz.

Evet. Belge sayfasında herkese açık bir sandbox (tanıtım hesabı) token'ı vardır: okuma, sipariş açma, ürün/stok/fiyat yazma ve sipariş yönetimi dahil her uç denenebilir. Sandbox'ta yazılanlar tanıtım verisine karışmaz ve 24 saat içinde kendiliğinden silinir. Tarayıcıdaki deneme konsoluyla kod yazmadan da istek atılabilir.

Her API hesabının kendi token'ı vardır; token hangi markaları göreceğini, hangi ürün ve tedarikçilerin kapalı kalacağını, hangi depoların stoğunun gideceğini, size özel alış fiyatını, sipariş görünürlüğünü ve yazma yetkilerini taşır. İsterseniz token'ı tek bir IP adresine bağlarsınız. Bayi token'ında yazma yetkileri kapalı tutulur; webhook iletileri HMAC imzasıyla doğrulanır; hesabı pasife aldığınız anda token geçersiz olur.

Evet. v1 adresleri değişmeden çalışır; yeni özellikler (yazma uçları, webhook, referans listeleri, sandbox) v2'de. Geriye uyumluluk ilkesi: v2'de alan eklenir, var olan alanın adı ya da anlamı değişmez; kırıcı bir değişiklik gerekirse yeni sürüm yolu açılır ve eski sürüm en az 12 ay sürer.

Bayileriniz ve Programlarınız Etibas'a Bağlansın

Token'ı 1 dakikada açın, geliştiriciniz belgeyle aynı gün başlasın.

Geliştirici Merkezi 7 Gün Ücretsiz Dene

Etibas verinizikendi yazılımınıza bağlayın