Ticimax

Ticimax mağazalarında ürünler Gelişmiş XML ile veri akışından gelir; siparişleri entegratörünüz Ticimax web servisinden okuyup Veri API ile gönderir.

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: Gelişmiş XML ile ürünler; 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ı panel menü yolları
✓ Belgede doğrulandı sipariş durumları
! Belgeden doğrulanmadı akış adresi
! Belgeden doğrulanmadı dosya biçimi
! Belgeden doğrulanmadı kayıt yolu
! Belgeden doğrulanmadı alan adları
! Belgeden doğrulanmadı webhook'lar

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

Ticimax panelinde Entegrasyonlar → Gelişmiş Xml Ayarları'ndan bir ürün XML'i oluşturun.
Oluşan XML adresini kopyalayıp sihirbazdaki alana yapıştırın; önizlemede alan eşlemesini kontrol edin.
Siparişler XML ile gelmez: 'API ile gönderim' yolunu da kurun.

API ile gönderim (Veri API)

Ticimax panelinde Ayarlar → WS Yetki Kodu Yönetimi → Yeni Ekle ile Sipariş Listele ve Üye Listele yetkili bir yetki kodu oluşturun.
Entegratörünüz sipariş servisinden (SiparisServis, SelectSiparis) siparişleri — SiparisDurumu, kargo takip numarası 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.
Ticimax 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ışı (Gelişmiş XML)

Biçim

xml ! Belgeden doğrulanmadı

Adres kalıbı

Belgede yok — adresi panelden kopyalayın.

Bilinen alan adları

item_ref ← UrunKartiID, ID
urun_adi ← UrunAdi
urun_kodu ← StokKodu, Barkod
fiyat ← IndirimliFiyati, IndirimliFiyat
normal_fiyat ← SatisFiyati
stok ← StokAdedi
marka ← Marka, MarkaAdi
kategori ← AnaKategori, Kategori, KategoriAdi
url ← UrunSayfaAdresi, UrunUrl
gorsel ← Resim, Resimler, ResimUrl
kisa_aciklama ← OnYazi, Aciklama

! Belgeden doğrulanmadı

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
`0`	`pending`
`1`	`on-hold`
`2`	`processing`
`3`	`pending`
`4`	`processing`
`5`	`processing`
`6`	`shipped`
`7`	`delivered`
`8`	`cancelled`
`9`	`refunded`
`10`	`cancelled`
`13`	`refunded`
`14`	`cancelled`
`Ön sipariş`	`pending`
`Onay bekliyor`	`on-hold`
`Onaylandı`	`processing`
`Ödeme bekliyor`	`pending`
`Paketleniyor`	`processing`
`Tedarik ediliyor`	`processing`
`Kargoya verildi`	`shipped`
`Teslim edildi`	`delivered`
`Iptal`	`cancelled`
`İptal`	`cancelled`
`Iade`	`refunded`
`İade`	`refunded`
`Silinmis`	`cancelled`
`IadeOdemeYapildi`	`refunded`
`TeslimOncesiIptal`	`cancelled`

Notlar

Ticimax web servisi SOAP'tur ve tek bir yetki koduyla çalışır; doğrudan Ticimax bağlayıcısı mümkün ama henüz yok. XML adres kalıbı ve etiket adları belgede yok.

Altyapı belgeleri

Ana site Destek [email protected]