← NotesEN
4 dk okuma

Shopify Line Item Properties: Kişiselleştirme Verisi Fulfillment'a Nasıl Ulaşır?

Gravür metni siparişte yok, logo dosyasına erişilemiyor, üretim ekibi WhatsApp'tan soruyor. Line item properties ile kişiselleştirme verisini siparişe doğru aktarma rehberi.

  • shopify
  • line-item-properties
  • fulfillment
  • kisisellestirme
  • siparis-yonetimi

Müşteri gravür yazısını girdi, sepete ekledi, ödedi. Fulfillment ekibi admin panelde siparişi açtı — gravür metni yok. Logo dosyası bir yerde kayboldu; üretim WhatsApp'tan müşteriye "dosyayı tekrar gönderir misiniz?" diye yazdı. Malzeme seçimi sepette görünüyor ama ERP'ye aktarılmadı; yanlış malzeme ile üretim başladı. Shopify line item properties, kişiselleştirme verisinin siparişe taşınması için standart mekanizmadır — doğru kurulmadığında operasyon kaosa döner.

Line item properties, sepete eklenen her ürün kaleminin altına eklenen anahtar-değer çiftleridir. Kişiselleştirme uygulamalarının ve tema formlarının temel entegrasyon noktasıdır. Sorun genellikle "properties var mı?" değil, "doğru alan adlarıyla, koşullu gizlenen alanlar hariç, fulfillment'ın okuyabileceği formatta mı?" sorusudur. Örnek property seti: Gravür Metni, Malzeme, Logo dosyası, Ek Ücret — her biri sipariş detayında ayrı satır olarak görünür.

Line Item Properties mi, Variant mı, Cart Attributes mı?

Veriyi doğru mekanizmaya koymak fulfillment netliği sağlar.

Variant kullanın:

  • Stok takipli standart seçenekler (beden, renk)
  • Fiyat kombinasyonu variant ile yönetilebiliyorsa

Line item properties kullanın:

  • Kişiselleştirme metni (gravür, hediye notu)
  • Malzeme, baskı tipi gibi variant limitini aşan seçenekler
  • Upload dosya referansı
  • Surcharge bilgisi
  • Üretim talimatı

Cart attributes kullanın:

  • Sepet düzeyinde bilgi (sipariş notu, referans numarası)
  • Tek bir ürün kalemiyle sınırlı olmayan genel bilgi

En temiz ayrım: variant standart seçenekler için, properties kişiselleştirme için.

Sorun Genel Olarak Nasıl Çözülür?

Veri akışı şöyle işler:

  1. Müşteri ürün sayfasında seçimleri yapar
  2. Tema formu veya uygulama, seçimleri properties olarak hazırlar
  3. "Sepete ekle" tıklandığında properties cart line item'a eklenir
  4. Checkout tamamlandığında properties order line item'a aktarılır
  5. Admin panel, fulfillment uygulaması ve webhook'lar bu veriyi okur

Fulfillment ekibi için properties şunları taşır: üretim talimatı (gravür metni, baskı rengi, boyut), dosya referansı (upload edilen logo), malzeme seçimi, ek hizmetler (hediye paketi, hızlı kargo). Property isimlerinin admin panelde net ve okunabilir olması operasyonel verimliliği doğrudan etkiler.

ERP ve üçüncü parti entegrasyonlarda dikkat edilmesi gerekenler: property isimlerinin tutarlı olması (Türkçe/İngilizce karışıklığından kaçının); özel karakter ve emoji desteği; upload property'lerinde dosyaya erişim URL'si; surcharge bilgisinin ayrı property olarak mı yoksa fiyata dahil mi aktarıldığı.

Karmaşık option set'lerde alan adı değişikliği yeni siparişlerde tutarsızlık oluşturabilir; mevcut siparişler etkilenmez (sipariş anındaki değerler korunur). Büyük değişiklikler öncesi JSON backup almak iyi bir pratiktir.

Test kontrol listesi: her alan tipini doldurup sepete ekleyin → sepette properties görünüyor mu → checkout sonrası sipariş detayında var mı → koşullu gizlenen alanın property'si gitmiyor mu → upload dosyasına admin panelden erişilebiliyor mu → webhook payload'ında doğru mu?

ERP, Webhook ve Operasyon Entegrasyonu

Shopify siparişlerini ERP, MRP veya özel üretim sistemine aktaran mağazalarda line item properties webhook payload'ının (orders/create) doğru okunması kritiktir. Property isimlerini entegrasyon geliştirmeden önce dondurun; "Gravür Metni" ile "gravur_metni" arasındaki tutarsızlık otomasyonu kırar. Upload property'lerinde dosya URL'sinin erişilebilir olduğundan emin olun; fulfillment uygulaması veya baskı makinesi bu URL'ye ihtiyaç duyar. Çok dilli mağazalarda property isimlerinin dil bağımsız ve tutarlı kalması, ERP tarafında eşleme tablosu oluşturmayı kolaylaştırır. Müşteri hizmetleri ekibi sipariş detayından properties okuyabilmeli; belirsiz alan adları destek talebi sayısını artırır. Büyük option set değişikliklerinden önce JSON backup almak, property yapısının geri dönüşünü kolaylaştırır. WhatsApp veya sipariş notu ile toplanan kişiselleştirme verisini properties akışına taşımak, manuel hata riskini sistematik olarak azaltır.

Ring Product Options ve Line Item Properties

Kişiselleştirme alanlarını otomatik olarak line item properties'e yazan uygulamalardan biri Ring Product Optionsdır. Görsel builder'da tanımladığınız her alan, sipariş detayında okunabilir bir property olarak görünür. Koşullu görünürlükle gizlenen alanların değeri siparişe aktarılmaz. JSON backup ile option set yapılandırması yedeklenebilir; çoklu dil desteği ile alan etiketleri dile göre çevrilir, property isimleri tutarlı kalır. 7 günlük deneme ile test siparişi vererek akışı doğrulayabilirsiniz. Fulfillment ekibinizle property isimlerini kurulum öncesi birlikte belirlemek, sonradan yaşanacak karışıklığı önler.

Properties müşteriye e-posta faturasında görünür mü?

Evet. Shopify sipariş onay e-postasında line item properties müşteriye gösterilir. Property isimlerinin müşteri dostu olması önemlidir.

Properties ile stok takibi yapılabilir mi?

Hayır. Stok takibi variant sistemi üzerinden yapılır. Properties kişiselleştirme bilgisi taşır; stok etkilemez.

Eski siparişlerdeki properties uygulama kaldırılınca kaybolur mu?

Hayır. Sipariş anında kaydedilen properties Shopify'da kalıcıdır. Uygulama kaldırılsa bile mevcut sipariş verisi korunur.

Properties API üzerinden toplu okunabilir mi?

Evet. Shopify Admin API ve webhook'lar üzerinden line item properties okunabilir. ERP entegrasyonları genellikle orders/create webhook'unu kullanır.

Sonraki Adım

Line item properties, kişiselleştirme verisinin siparişe aktarılmasının standart yoludur. Property isimlerini fulfillment ekibiyle birlikte tanımlayın, koşullu gizlenen alanları test edin ve ERP/webhook akışını doğrulayın. Upload alanı kullanıyorsanız dosyaya admin panelden erişimi ayrıca kontrol edin. Properties akışını doğrulamadan canlıya almak, WhatsApp ile manuel toplama döngüsünü sürdürmeniz anlamına gelir.

Ring Product Options ile option set kurup test siparişi vererek properties akışını 7 günlük deneme süresinde uçtan uca test edebilirsiniz.