İzinlerin tam listesi
| Scope | İzin |
|---|---|
| read_products | Ürün, varyant, kategori, marka ve etiketleri görme; v2'de stok lokasyonlarını ve stokları görme |
| write_products | Ürün, varyant ve bağlı bilgileri düzenleme; v2'de varyant stoklarını güncelleme |
| read_inventories | v1'de stok lokasyonlarını, stokları ve tedarikçileri görme |
| write_inventories | Stokları güncelleme; v1'de tedarikçileri yönetme |
| read_orders | Tüm satış kanallarındaki siparişleri görme |
| write_orders | Siparişleri düzenleme ve durumlarını değiştirme |
| read_customers, write_customers | Müşterileri görme ve düzenleme |
| read_campaigns, write_campaigns | İndirim ve kuponları görme ve düzenleme |
| write_storefronts | Mağaza script'leri ve politikaları; v2'de kargo ayarlarını listeleme |
Kaynak: ikas: Yetkilendirme.
Stok izinlerinde v1 ve v2 farkı
Stok entegrasyonunda en sık karışıklık buradadır. v1 uç noktasında stok okumak için read_inventories, yazmak için write_inventories gerekir; yazma işlemi saveProductStockLocations'tır. v2'de stok okumak read_products ile yapılır; yazma işlemi saveVariantStocks'tur ve hem write_inventories hem write_products buna izin verir.
ikas'a göre stok lokasyonları API ile yalnız okunabilir. Depo eklemek ya da silmek yönetim panelinden yapılır.
İşleme göre gereken izin
| İşlem | Kullanılan işlem adı | İzin |
|---|---|---|
| Ürünleri listeleme | listProduct | read_products |
| Ürün açma | saveProduct (v1), createProduct (v2) | write_products |
| Depoları listeleme | listStockLocation | v1 read_inventories, v2 read_products |
| Stok yazma | saveProductStockLocations (v1), saveVariantStocks (v2) | write_inventories |
| Siparişleri listeleme | listOrder | read_orders |
| Siparişi kargoya hazırlama | fulfillOrder | write_orders |
Sınırlamalar ve sık hatalar
- ikas'a göre mağaza START paketindeyse kargoya hazırlama, paket durumu, kargo iptali, satır iptali ve iade gibi sipariş işlemleri yalnız uygulamanın kendi satış kanalındaki siparişlerde yapılabilir.
- Admin uygulamasına yeni izin gerektiğinde mağazanın yeni scope listesiyle yeniden yetkilendirilmesi gerekir.
- Yetkisi olmayan bir token ile çağrılan işlem yetki hatası döner. Hata mesajındaki işlem adına bakıp tablodaki izni ekleyin.
- Gereğinden geniş izin istemeyin. Okuma yapan bir rapor aracının yazma iznine ihtiyacı yoktur.
Sık sorulanlar
ikas stok güncellemek için hangi izin gerekir?
write_inventories. v1'de saveProductStockLocations, v2'de saveVariantStocks bu izinle çalışır; v2'de write_products da varyant stoğunu güncelleyebilir.
ikas'ta depoları API ile oluşturabilir miyim?
Hayır. ikas'a göre stok lokasyonları API ile yalnız okunabilir. Depo tanımı yönetim panelinden yapılır.
Siparişleri okumak için hangi izin gerekir?
read_orders. Bu izin tüm satış kanallarındaki siparişleri, bağlı ürün ve müşteri bilgileriyle birlikte görmeyi sağlar.
write_orders hangi işlemler için gerekir?
Siparişi düzenlemek ve durumunu değiştirmek için: kargoya hazırlama, paket durumu güncelleme, satır iptali ve iade gibi. START paketindeki mağazalarda bu işlemlerin bir kısmı yalnız uygulamanın kendi satış kanalındaki siparişlerde yapılabilir.
Yetki hatası alıyorum, ne yapmalıyım?
Çağırdığınız işlemin gerektirdiği izni bulun ve özel uygulamanın ayarlarından ekleyin. Ardından yeni bir token alıp isteği tekrarlayın.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı