Sözleşme CSV dosyalarını içe ve dışa aktarma
Sözleşmeleri üçüncü taraf abonelikler uygulamasından Shopify Subscriptions uygulamasına aktarmak veya sözleşmeleri Shopify Subscriptions uygulamasından dışa aktarmak için CSV (virgülle ayrılmış değerler) dosyası kullanabilirsiniz.
CSV dosyalarının kullanımı hakkında daha fazla bilgi edinmek için CSV dosyasını açma ve düzenleme sayfasına bakın.
Bu sayfada
Örnek bir CSV dosyası indirme
Şablon olarak kullanmak üzere örnek bir sözleşme CSV dosyası indirip görüntüleyebilirsiniz.
Sözleşme CSV dosyasıyla ilgili önemli hususlar
Sözleşmeleri içe aktarmak için sözleşme CSV dosyasını kullanmadan önce aşağıdaki hususları inceleyin.
CSV dosyasını biçimlendirme
Sözleşme CSV dosyanızın doğru bir şekilde içe aktarılması için dosyanın aşağıdaki ölçütleri karşıladığını doğrulayın:
- Sözleşme CSV dosyanızın ilk satırı, sözleşme CSV dosyası açıklama tablosunda belirtilen sütun üstbilgileri olmalıdır.
- Her sütunun virgülle ayrılması gerekir.
- CSV dosyasının büyüklüğü maksimum 10 MB olabilir.
Tanıtıcı sütununu anlama
Tanıtıcı her sözleşmeyi benzersiz şekilde tanımlamak için kullanılır. Tanıtıcılar, verileri aşağıdaki şekillerde yönetmek için kullanılır.
- Birden fazla satır öğesi içeren sözleşmeleri gruplandırma: Birden fazla satır öğesi içeren sözleşmeler, ortak bir tanıtıcıya göre gruplandırılır.
- Yinelenen sözleşmeleri önlenme: İçe aktarım sırasında yinelenen sözleşmeler dikkate alınmaz. Aynı tanıtıcıya sahip bir satır daha önce başarıyla içe aktarıldıysa yeni içe aktarma işleminde bu satır atlanır. Bu mekanizma, verilerin yinelenmesini önlemeye yardımcı olur.
Birden fazla satır öğesi içeren sözleşmeler
Birden fazla satır öğesi içeren sözleşmeler, her satır öğesi için ayrı bir satır gerektirir ve tanıtıcı sütunuyla birlikte gruplanır.
Örneğin, bir sözleşmede üç satır öğesi varsa her satır öğesi ayrı bir satır olarak eklenmelidir. İlk satır tüm sözleşme bilgilerini ve sonraki iki satır ise yalnızca aşağıdaki sütunlardaki değerleri içerir:
- handle
- line_variant_id
- line_quantity
- line_current_price
- İsteğe bağlı: line_selling_plan_id
- İsteğe bağlı: line_selling_plan_name
Tanıtıcı, üç sütunda da aynı olmalıdır. İkinci ve üçüncü satırlardaki diğer tüm sütunlar boş olmalıdır. Birden fazla satır öğesi içeren bir sözleşme örneğini incelemek için örnek CSV şablonunu indirebilirsiniz.
CSV dosyasının açıklaması
Sözleşmenin CSV dosyasında kullanılan bilgiler aşağıdaki kategorilere ayrılır: * Sözleşme adı * Müşteri ve fatura bilgileri * Teslimat yöntemi ve bilgileri * Aboneliğe dahil olan öğeler
Aktarma işleminin doğru şekilde yapılması için CSV dosyasına tüm sütunların eklenmesi gerekir ve aksi belirtilmediği sürece tüm alanlar gereklidir.
| Sütun | Açıklama |
|---|---|
| Handle | Tanıtıcılar, her bir sözleşmenin benzersiz tanımlayıcılarıdır. Örnek: Kırmızı gömlek. Tanıtıcılar, harf ve sayı içerebilir ve genellikle harf, sayı veya her ikisinin birleşiminden oluşan bir dizedir. Her sözleşme benzersiz bir tanıtıcıya sahip olmalıdır. |
| upcoming_billing_date | Sözleşme için yaklaşan fatura tarihi. Saat UTC (Eş Güdümlü Evrensel Zaman) saat diliminde verilir ve YYYY-AA-GGTSS:DD:SSZ biçimine sahip olmalıdır. Örneğin 7 Eylül 2019 günü saat 15:50, UTC (Eş Güdümlü Evrensel Zaman) saat diliminde 2019-09-07T15:50:00Z olarak gösterilir. Yaklaşan fatura tarihi değeri, CSV dosyasının içe aktarılmasından en az 24 saat sonraki bir tarih ve saat olarak ayarlanmış olmalıdır. |
| customer_id | Müşteri kimliği. Kimlik, Shopify yöneticinizdeki mevcut bir müşterinin kimliğiyle eşleşmeli ve bir sayı dizesi olmalıdır. Örnek: 6320530986896. |
| currency_code | Sözleşmenin para birimi kodu. Para birimi kodu, mağazanızda etkin olan bir para birimiyle eşleşmelidir. |
| status | Sözleşmenin durumu. Sözleşmenin durumu aşağıdakilerden biri olabilir:
|
| cadence_interval | Aboneliğin teslimat sıklığı. Bir sözleşme aşağıdaki sıklık aralıklarından birine sahip olabilir:
|
| cadence_interval_count | Aboneliğin genel zaman aralığı içindeki teslimat sıklığı. Örneğin, her aya ait kadans aralığı sayısı 1, her iki haftaya ait kadans aralığı ise 2'dir. |
| customer_payment_method_id | Müşterinin sözleşme için kullandığı ödeme yönteminin kimliği. Kimlik, benzersiz alfasayısal bir koddur. Örnek: 24e8c839c47ef47d30ad28346d130e74. |
| delivery_price | Teslimatın, doğru para birimi biçimindeki fiyatı. |
| delivery_method_type | Aboneliğin teslimat yöntemi. Teslimat yöntemi aşağıdaki türlerden biri olmalıdır.
|
| delivery_address_first_name | Teslimat adresindeki alıcının adı. Bu alan yalnızca Kargo ve Yerel Teslimat yöntemleri için gereklidir. |
| delivery_address_last_name | Teslimat adresindeki alıcının soyadı. Bu alan yalnızca Kargo ve Yerel Teslimat yöntemleri için gereklidir. |
| delivery_address_address1 | Teslimat adresinin ilk satırı. Bu alan yalnızca Kargo ve Yerel Teslimat yöntemleri için gereklidir. |
| delivery_address_address2 | Teslimat adresinin ikinci satırı. Bu alan yalnızca adresin ikinci bir alanı varsa ve teslimat yöntemi Kargo veya Yerel Teslimat ise gereklidir. |
| delivery_address_city | Teslimat adresinin bulunduğu şehir. Bu alan yalnızca Kargo ve Yerel Teslimat yöntemleri için gereklidir. |
| delivery_address_province_code | Teslimat adresinin bulunduğu il veya eyaletin ISO kodu. Bu alan yalnızca Kargo ve Yerel Teslimat yöntemleri için gereklidir. |
| delivery_address_country_code | Teslimat adresinin bulunduğu ülkenin ISO kodu. Bu alan yalnızca Kargo ve Yerel Teslimat yöntemleri için gereklidir. |
| delivery_address_company | Teslimat adresinin şirket adı. Bu alan yalnızca sipariş bir işletmeye aitse ve teslimat yöntemi Kargo veya Yerel Teslimat ise gereklidir. |
| delivery_address_zip | Teslimat adresinin posta kodu. Bu alan yalnızca Kargo ve Yerel Teslimat yöntemleri için gereklidir. |
| delivery_address_phone | Teslimat adresinin telefon numarası - örnek: +1 (613) 555-5555. Bu alan yalnızca Kargo ve Yerel Teslimat yöntemleri için gereklidir. |
| delivery_local_delivery_phone | Teslimat adresinin telefon numarası. Bu alan, Yerel Teslimat yöntemine sahip abonelikler için gereklidir. |
| delivery_local_delivery_instructions | Yerel teslimat talimatları. Bu alanın yalnızca Yerel Teslimat yöntemiyle abonelikler için talimatlar sağlandığında eklenmelidir. |
| delivery_pickup_method_location_id | Yerel teslim alım yönteminin konum kimliği. Bu alan, Mağazadan Teslim Alım yöntemine sahip abonelikler için gereklidir. |
| line_variant_id | Aboneliğe dahil edilen her satır öğesinin kimliği - örnek: 53154087005812. Abonelikte birden fazla satır öğesi varsa her satır öğesinin benzersiz varyasyon kimliğine sahip yeni bir satır olarak eklenmesi gerekir. |
| line_quantity | Aboneliğe dahil olan her satır öğesinin adedi. Abonelikte birden fazla satır öğesi varsa eklenen adet, söz konusu öğenin adedi olmalıdır. Dahil edilen tüm öğelerin toplam adedi kullanılmamalıdır. |
| line_current_price | Abonelik satır öğesinin doğru para birimi biçimindeki fiyatı. |
| line_selling_plan_id | Abonelik planının kimliği - örnek: 3607724288. Bu alan isteğe bağlıdır. |
| line_selling_plan_name | Abonelik planının adı. Bu alan isteğe bağlıdır. |
CSV dosyası kullanarak sözleşmeleri içe aktarma
Mevcut sözleşmeleri Shopify App Store'dan indirdiğiniz uygun bir üçüncü taraf abonelik uygulamasından veya başka bir mağazada Shopify Subscriptions uygulamasından içe aktarmak için bir CSV dosyası kullanabilirsiniz.
Mevcut sözleşmeleri düzenlemek veya sözleşmelerin üzerine yazmak için CSV dosyası kullanılamaz. Mevcut sözleşmelerin yinelenen kopyaları içe aktarma sırasında yok sayılır.
Sözleşmeleri üçüncü taraf bir abonelik uygulamasından içe aktarma
Sözleşmeleri üçüncü taraf bir abonelik uygulamasından içe aktarabilirsiniz. Üçüncü taraf bir uygulamadan verileri içe aktarırken aşağıdaki davranışları göz önünde bulundurun:
- Üçüncü taraf abonelik uygulamanız Shopify Checkout ile entegre değilse sözleşmelerinizi içe aktaramazsınız.
- Verileri doğrudan üçüncü taraf uygulamanızdan içe aktaramazsınız. İçe aktarmak için üçüncü taraf uygulamanızdaki sözleşme verilerini, Shopify Subscriptions uygulamasıyla uyumlu bir CSV dosyasına eklemeniz gerekir.
- Üçüncü taraf abonelik uygulamanızın dışa aktarma özelliği yoksa veya dışa aktarılan veriler, gerekli verilerin tümünü içermiyorsa destek almak için uygulamanın geliştiricisiyle iletişime geçin.
Adımlar:
- Shopify yöneticinizde Abonelikler > Sözleşmeler'e gidin.
- İçe aktar'a tıklayın.
- Dosya ekle'ye tıklayın ve ardından içe aktarmak istediğiniz CSV dosyasını seçin.
- Dosya yükle'ye tıklayın.
CSV dosyanız yüklendikten sonra, Shopify mağazanızı ayarlamak için kullandığınız e-posta hesabına Shopify'dan bir doğrulama e-postası alırsınız. İçe aktarma sorunlarının giderilmesine yardımcı olması için yaygın içe aktarma hatalarının çözümlerini okuyun.
CSV dosyası kullanarak sözleşmeleri dışa aktarma
Sözleşmelerinizi kayıtlarınız için dışa aktarabilir veya Shopify Subscriptions uygulamasının yüklü olduğu başka bir Shopify mağazasına aktarabilirsiniz.
Adımlar:
- Shopify yöneticinizde Abonelikler > Sözleşmeler'e gidin.
- Dışa aktar'a tıklayın.