Veri akışları

Bir veri akışı, verinizi bir adresten (XML, CSV ya da JSON) belirli aralıklarla çeker, alanlarını Zitena’nın alanlarına eşler ve bilgi kaynaklarınıza yazar. Akışlar Bilgi Kaynakları → Veri akışları sekmesindedir ve paketinizde Veri akışları özelliğini ister. Okuma üyelere, oluşturma/düzenleme/çalıştırma yöneticilere açıktır; her değişiklik Değişiklik Geçmişi’ne düşer.

Akış oluşturma

Yeni akış: ad ve adres girin. Adres https:// ile başlamalıdır. Gerekiyorsa kimlik doğrulama seçin: Basic (kullanıcı adı/parola) ya da Başlık (ör. Authorization ve belirteç). Parola ve belirteç yalnız yazılır.
Hedef seçin: products (ürünler), orders (siparişler), categories (kategoriler), kb (bilgi içeriği) ya da customers (müşteriler).
Biçim: auto (varsayılan), google_merchant, xml, csv ya da json. XML ve JSON’da kayıtların bulunduğu yolu (kayıt yolu) boş bırakırsanız otomatik bulunur.
Önizleme: dosya indirilir, ilk 5 kayıt, alan listesi ve önerilen eşleme gösterilir. Eşlemeyi değiştirdikçe önizleme yeniden indirmeden güncellenir.
Zamanlama ve tam senkron seçip kaydedin; isterseniz hemen çalıştırın.

Alan eşleme

Kaynak alan adları, Zitena alanlarına ada göre önerilir: Türkçe harfler sadeleştirilir, g: öneki ve noktalama yok sayılır, bilinen dışa aktarım adları (Google Merchant, WooCommerce CSV, Shopify, Ticimax, ikas) tanınır. Aynı kaynak alanı yalnız bir hedefe gider. Altyapınız için bir ön ayar varsa, altyapının bilinen alan adları (dosyada gerçekten varsa) önceden seçilir. Aynı hedefe yazan başka bir akışın kayıtlı eşlemesi, kaynak alanlarının hepsi dosyada varsa önceliklidir.

Hedef alanlar (* zorunlu):

Hedef	Alanlar
`products`	`urun_adi`*, `item_ref`, `urun_kodu`, `fiyat`, `normal_fiyat`, `stok`, `stokta`, `kategori`, `marka`, `url`, `gorsel`, `kisa_aciklama`, `uyumluluk`, `renk`, `depolama`, `bellek`, `durum`, `kargo_suresi`
`orders`	`external_id`, `status`, `number`, `customer_name`, `phone`, `email`, `total`, `currency`, `items`, `carrier`, `tracking_number`, `tracking_url`, `shipping_method`, `shipping_city`, `payment_method`, `created_at`, `modified_at`, `customer_id`
`categories`	`kategori_id`, `kategori_adi`, `ust_kategori_id`, `yol`, `urun_sayisi`
`kb`	`id`, `baslik`, `icerik`*, `bolum`, `url`
`customers`	Veri API’deki müşteri alanları

Eşlenen her kayıt, Veri API’deki modelin aynısından geçer; API ile gelen veriyle aynı satıra dönüşür. Fiyatlarda indirimli fiyat yalnız sıfırdan büyük ve satış fiyatından düşükse kullanılır; indirimsiz üründe fiyat 0 TL olmaz. Tarihler Türkiye saatiyle yorumlanır; 24.09.2026 10:15 gibi biçimler tanınır. Satır hataları (en çok 50) çalıştırma kaydında gösterilir.

Sipariş durumu eşleme

Sipariş akışında kaynaktaki durum değerleri, firmanızın durum modelindeki kısa adlara eşlenir. Öneri anahtar kelimeyle gruba (ör. “kargo”, “ship” → yolda; “iptal”, “refund” → iptal), gruptan da firmanızın o gruptaki ilk durumuna gider. Standart kısa adlar:

Kısa ad	Grup
`pending`, `on-hold`	bekleyen
`processing`	onaylandı
`invoiced`	faturalandı
`shipped`	yolda
`delivered`, `completed`	tamamlandı
`cancelled`, `refunded`, `failed`	iptal

Tam senkron

Tam senkron açıksa, akışta olmayan kayıtlar pasiflenir (silinmez; tekrar gelince aktifleşir). Konsoldan elle eklenen bilgi girişleri (ek- önekli) korunur. Dosyanın her seferinde tam liste olduğundan emin değilseniz kapalı bırakın.

İndirme kuralları

Yalnız https; adres her yönlendirmede yeniden çözülür ve yerel/özel ağa çıkan adresler reddedilir.
En çok 5 yönlendirme (kimlik bilgisi yalnız aynı kökene gönderilir), 60 sn zaman aşımı, 50 MB dosya sınırı.
ETag / Last-Modified ile koşullu istek: dosya değişmediyse (304) yeniden işlenmez.
İstekte User-Agent: Zitena-Feed/1 kullanılır; sunucunuzda engelliyse izin verin.

Ana site Destek [email protected]