Sipariş Oluşturma Modları ve Google E-Tablolar Aktarımı — RUTHH COD Form & Upsells

RUTHH COD Form & Upsells uygulamasının Shopify’da tekil (idempotent) Standart Sipariş (orderCreate) veya Taslak Sipariş (draftOrderCreate) oluşturma sürecini anlamak ve Integrations → Google Sheets (/app/integrations/google-sheets) ekranını yapılandırarak siparişleri gerçek zamanlı olarak Google E-Tablolar’a aktarmak.

• Settings → General (/app/settings/general) altında tercih ettiğiniz Sipariş Oluşturma Modunu belirlemiş olmanız.
• Google E-Tablolar aktarımı için Google Drive / E-Tablolar erişimi olan bir Google hesabınızın bulunması.

1. Settings → General (/app/settings/general) sayfasını açın.
2. Order Creation bölümünde şu iki moddan birini seçin:
   • Standard COD Order (STANDARD): Tekil (idempotent) bir işlem içinde Shopify orderCreate çağrısı yapar; yapılandırdığınız sipariş etiketlerini (COD, RUTHH_COD), kargo satırını, ek COD ücretini ve UTM customAttributes verilerini siparişe yazar.
   • Save as Draft Order (DRAFT): Shopify draftOrderCreate çağrısıyla Shopify Yönetim Paneli → Siparişler → Taslaklar altında bir Taslak Sipariş oluşturur. Çağrı merkezi onayı sonrasında siparişi kesinleştirmek isteyen mağazalar için uygundur.
3. Save butonuna tıklayın. Taslak Sipariş modu seçildiğinde Ana Sayfa ve Analitik ekranlarındaki metrik başlıkları otomatik olarak Orders / Draft Orders biçiminde gösterilir.

1. Integrations → Google Sheets (/app/integrations/google-sheets) sayfasına gidin.
2. Connect Google Account butonuna tıklayın.
3. Google OAuth izin ekranını onaylayın. Uygulama yalnızca dar kapsamlı https://www.googleapis.com/auth/drive.file iznini (ve temel hesap e-posta bilgisini) talep eder; yani Google Drive’ınızdaki diğer dosyalara erişemez, yalnızca uygulama içinden oluşturduğunuz veya Google Picker ile seçtiğiniz e-tabloya erişebilir.

1. Bağlantı tamamlandıktan sonra e-tablo seçiminizi yapın:
   • Create New Spreadsheet: Tek tıkla Google Drive’ınızda yeni bir e-tablo oluşturur ve otomatik olarak bağlar.
   • Select Existing Spreadsheet (Google Picker): Resmi Google Picker penceresini açarak mevcut bir e-tabloya drive.file erişimi vermenizi sağlar.
2. Hedef Worksheet (Çalışma Sayfası / Sekme) seçimini yapın. Uygulama, sekme adını önbelleğe almanın yanı sıra değişmez sayısal sheetId değerine bağlanır; böylece Google E-Tablolar içinde sekme adını değiştirseniz bile aktarım bozulmaz.

1. Column Preset (Sütun Şablonu) altından aktarılacak veri kapsamını seçin:
   • MINIMAL: Temel sipariş numarası, tarih, müşteri iletişim bilgileri, teslimat adresi, ürün özeti ve toplam tutar.
   • MARKETING: Temel alanlara ek olarak UTM parametreleri (utm_source, utm_medium, utm_campaign, utm_term, utm_content), indirim detayları ve huni bilgileri.
   • FULL: Satır bazlı SKU, varyant kimlikleri, kargo kuralı, ek COD ücreti, sipariş oluşturma modu (STANDARD / DRAFT) ve sahte sipariş/doğrulama durumunu içeren tam operasyonel şablon.
2. Row Mode (Satır Modu) altından seçim yapın:
   • ORDER (Sipariş başına tek satır): Bir siparişteki tüm ürünleri tek bir satırda birleştirir.
   • PRODUCT (Ürün kalemi başına bir satır): Siparişteki her ürün satırı için ayrı bir satır yazar.
3. Enable Export anahtarını açıp Save butonuna tıklayın (veya bağlantıyı hemen test etmek için Send Test Row butonunu kullanın).

• Google E-Tablolar’da sekme adı değiştirildi: Aktarıcı hedef sekmeyi sayısal sheetId üzerinden bulduğu için isim değişikliği aktarımı durdurmaz; yönetim panelinde güncel sekme adını görmek için Refresh Worksheets butonuna tıklayabilirsiniz.
• Taslak Siparişler yalnızca kesinleşmiş siparişleri dinleyen ERP’lerde görünmüyor: Taslak siparişler Shopify’da onaylanana kadar Siparişler → Taslaklar altında tutulur. Google E-Tablolar aktarımı ise hem Standart hem Taslak COD siparişlerini otomatik olarak dışa aktarır.

• Teşekkür Sayfası ve Genel Ayarlar
• Sahte Sipariş Koruması ve Doğrulama
• Sorun Giderme Rehberi