IdeaSoft

IdeaSoft mağazaları ürün XML’iyle ya da Veri API ile gönderimle bağlanır. IdeaSoft Admin API’si OAuth yönlendirmesi gerektirdiği için doğrudan bağlayıcı 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ün XML'i ya da Veri API ile gönderim.

Ö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ı alan adları
• ✓ Belgede doğrulandı sipariş durumları
• ✓ Belgede doğrulandı webhook'lar
• ! Belgeden doğrulanmadı akış adresi
• ! Belgeden doğrulanmadı dosya biçimi
• ! Belgeden doğrulanmadı kayıt yolu
• ! Belgeden doğrulanmadı panel menü yolları

XML-CSV bağlantısı (veri akışı)önerilen

1. IdeaSoft panelinden ürün XML'inizi (ör. Google Alışveriş/pazaryeri XML'i) oluşturup adresini sihirbazdaki alana yapıştırın. ! Belgeden doğrulanmadı
2. XML menü yolu belgede doğrulanamadı: önizlemede eşlemeyi kontrol edin.

API ile gönderim (Veri API)

1. IdeaSoft Admin API'si yalnız OAuth yönlendirmesiyle (Entegrasyonlar → API → Ekle, yönlendirme adresi gerekli) çalışıyor; yapıştırılabilir bir belirteç yok.
2. Entegratörünüz siparişleri (GET /admin-api/orders: status, shippingTrackingCode, customerPhone) okuyup Zitena Veri API'sine gönderir.
3. 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.
4. IdeaSoft 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).
5. 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

1. Altyapınızın panelinden ürün listesini CSV ya da XML olarak dışa aktarın.
2. Dosyayı sihirbaza yükleyin; sütunlar otomatik eşlenir, gerekirse düzeltin.
3. 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ışı (XML/JSON)

Biçim

auto ! Belgeden doğrulanmadı

Adres kalıbı

Belgede yok — adresi panelden kopyalayın.

Bilinen alan adları

• item_ref ← id
• urun_adi ← name, fullName
• urun_kodu ← sku, barcode
• fiyat ← price1
• stok ← stockAmount
• url ← slug

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
waiting_for_approval	on-hold
approved	processing
being_prepared	processing
fulfilled	shipped
delivered	delivered
cancelled	cancelled
refunded	refunded
waiting_for_payment	pending
deleted	cancelled

Notlar

IdeaSoft bağlayıcısı OAuth yönlendirme akışı gerektirdiği için henüz yok.

Altyapı belgeleri

• IdeaSoft Admin API: kimlik doğrulama (İngilizce)