ikas
ikas mağazalarında ürünler Google Merchant katalog bağlantısından veri akışıyla gelir; siparişler ve müşteriler için entegratörünüz Veri API ile gönderim kurar. Doğrudan ikas bağlayıcısı henüz yok.
Aşağıdaki adımlar ve doğrulama işaretleri, ürünün kurulum sihirbazında gösterdiği ön ayardan birebir alınır. Belgeden doğrulanmadı işaretli bir adım ya da bilgi, altyapının herkese açık belgesinde görülemedi; panelinizde kontrol edin.
- Özet
- Ürünler Google Merchant XML'inden; siparişler Veri API ile.
- Önerilen yol
- XML-CSV bağlantısı (veri akışı)
- Kullanılabilir yollar
- XML-CSV bağlantısı (veri akışı) · API ile gönderim (Veri API) · Elle yükleme
- Araştırma tarihi
2026-09-26
Neler doğrulandı
Aşağıdaki her bilgi ya altyapının herkese açık belgesinde görülüp doğrulandı ya da doğrulanamadı. Doğrulanmayanlar yine kullanılabilir; ancak güvenmeden önce önizlemede kontrol edin.
- ✓ Belgede doğrulandı API
- ✓ Belgede doğrulandı kimlik doğrulama
- ✓ Belgede doğrulandı dosya biçimi
- ✓ Belgede doğrulandı panel menü yolları
- ✓ Belgede doğrulandı sipariş durumları
- ✓ Belgede doğrulandı webhook'lar
- ! Belgeden doğrulanmadı akış adresi
- ! Belgeden doğrulanmadı kayıt yolu
- ! Belgeden doğrulanmadı alan adları
XML-CSV bağlantısı (veri akışı)önerilen
- ikas panelinde Satış Kanalı → Eklentiler → Google Merchant Center'ı açın.
- 'Google Merchant Center katalog bağlantısı' alanındaki .xml adresini kopyalayıp sihirbazdaki alana yapıştırın; biçim Google Merchant olarak seçili gelir.
- Siparişler ve müşteriler XML ile gelmez: 'API ile gönderim' yolunu da kurun.
API ile gönderim (Veri API)
- ikas panelinde Uygulamalar → Uygulamalarım → Daha fazla → Özel Uygulama Oluştur ile read_orders ve read_customers izinli bir özel uygulama açın (client secret bir kez gösterilir).
- Yazılımcınız/entegratörünüz ikas Admin API'sinden (GraphQL, listOrder) siparişleri — durum (orderPackageStatus), kargo takip bilgisi (orderPackages.trackingInfo) ve müşteri telefonuyla — okuyup Zitena Veri API'sine gönderir.
- Sihirbazda (ya da Ayarlar → API anahtarları’nda) gizli API anahtarını oluşturun ve yazılımcınıza/entegratörünüze güvenli bir kanaldan iletin.
- ikas tarafındaki entegrasyon ürünleri PUT /api/v1/catalog/products, siparişleri PUT /api/v1/orders, müşterileri PUT /api/v1/musteriler uçlarına gönderir (örnekler Veri API sayfasında).
- Siparişte durum, kargo firması, takip numarası ve müşteri telefonu gönderilirse asistan arayanı telefonundan tanır ve kargo sorusunu yanıtlar.
Elle yükleme
- Altyapınızın panelinden ürün listesini CSV ya da XML olarak dışa aktarın.
- Dosyayı sihirbaza yükleyin; sütunlar otomatik eşlenir, gerekirse düzeltin.
- Elle yükleme tek seferliktir: fiyat ve stok değiştikçe yeniden yükleyin ya da XML bağlantısına geçin.
Akış şablonu
Ürün akışı (Google Merchant katalog bağlantısı)
- Biçim
google_merchant✓ Belgede doğrulandı- Adres kalıbı
- Belgede yok — adresi panelden kopyalayın.
- Bilinen alan adları
item_ref←g:id,id,g:item_group_idurun_kodu←g:mpn,g:gtin,sku
Bilinen alan adları yalnız dosyanızda gerçekten varsa uygulanır; eşleşmeyen ad hiçbir şey yapmaz. Eşleme, içe aktarmadan önce her zaman önizlemede gösterilir.
Sipariş durumu eşlemesi
Altyapıdan gelen durum değerleri standart kısa adlara, firmanızın aynı gruptaki kendi durumu varsa ona eşlenir. Bilinmeyen değerler eşlenmez ve size gösterilir.
| Altyapı değeri | Standart kısa ad |
|---|---|
CREATED | processing |
DRAFT | pending |
WAITING_UPSELL_ACTION | pending |
UNFULFILLED | processing |
READY_FOR_SHIPMENT | processing |
PARTIALLY_READY_FOR_SHIPMENT | processing |
PARTIALLY_FULFILLED | shipped |
FULFILLED | shipped |
READY_FOR_PICK_UP | shipped |
PARTIALLY_DELIVERED | shipped |
UNABLE_TO_DELIVER | shipped |
DELIVERED | delivered |
CANCELLED | cancelled |
REFUNDED | refunded |
WAITING | pending |
PAID | processing |
FAILED | failed |
Notlar
ikas'ın Admin API'si açık belgeli ve istemci kimliğiyle (4 saatlik belirteç) çalışıyor; doğrudan ikas bağlayıcısı sıradaki adım. Katalog bağlantısının adres kalıbı belgede yok: adresi panelden kopyalayın.
Altyapı belgeleri
© 2026 Erusoft