Ön koşullar
Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:
- Zonos ile etkin bir kapsayıcı fiyatlandırma aboneliği.
- Zonos Dashboard'unuzdan bir Secret GraphQL API anahtarı. API anahtarlarınızı bulmak için Ayarlar -> Entegrasyonlar seçeneğine gidin. Anahtar
credential_liveönekine sahip olmalı ve süresi dolmamış olmalıdır.
İlk kez kurulum
Kapsayıcı fiyatlandırma raporu şablonunu ilk kez kurmak için bu adımları izleyin.
Google Sheet şablonunu kopyalayın
Kapsayıcı fiyatlandırma raporu şablonunu açın ve Dosya -> Bir kopyasını yap seçeneğine giderek kendi kopyanızı oluşturun. Orijinal sayfaya editör erişimi talebinde bulunmayın.
API anahtarınızı bağlayın
Kopyaladığınız sayfada, menü çubuğundan (Yardım'ın yanında) Zonos -> GraphQL API Anahtarını Güncelleyin seçeneğini tıklayın. Bu menü seçeneği, sayfayı açtıktan sonra görünmesi bir dakika sürebilir.
Betiği yetkilendirin
İlk kez kullanıcılar için bir yetkilendirme iletişim kutusu görünecektir. Tamam'ı tıklayın ve ardından betiği Google hesabınızla yetkilendirmek için istemleri izleyin:
- Gerekli izinleri vermek için Tümünü seç seçeneğini tıklayın.
- Yetkilendirmeyi tamamlamak için Devam Et seçeneğini tıklayın.
Secret API anahtarınızı girin
Yetkilendirmeden sonra, Zonos Secret GraphQL API anahtarını girmenizi isteyen bir iletişim kutusu görünecektir. Bunu Zonos Dashboard'unuzda Ayarlar -> Entegrasyonlar altında bulabilirsiniz.
credential_live önekine sahip geçerli bir Secret anahtarını kopyaladığınızdan emin olun. Süresi dolan anahtarlar veya Public anahtarlar hataya neden olacaktır.
Siparişleri getirin
Menü çubuğundan Zonos -> Siparişleri Getir seçeneğini tıklayın.
Bir tarih aralığı seçin
İletişim kutusunda başlangıç ve bitiş tarihi girin veya ön ayarlanmış seçeneklerden birini kullanın (Son 30 gün, Bu ay, Geçen ay, Bu yıl), sonra Siparişleri Getir seçeneğini tıklayın.
Tamamlandığında, siparişleriniz sayfanın Siparişler sekmesinde görünecektir.
Not: Gelecekte başvurmak üzere bir raporu kaydetmek için Siparişler sekmesine sağ tıklayın ve Çoğalt seçeneğini belirleyin, ardından gerektiği gibi yeniden adlandırın. Ayrıca tüm elektronik tablonun bir kopyasını dışarı aktarabilir veya yapabilirsiniz.
Günlük kullanım
İlk kurulumu tamamladıktan sonra, yeni raporlar oluşturmak basittir:
- Adımları 1-3'ü atlayın - Bunlar tek seferlik bir işlemdir.
- Adım 4'ü atlayın API anahtarınızın süresi dolmadıkça veya farklı bir Zonos mağazasından veri çekmesi gerekmedikçe.
- Adımları 5 ve 6'yı tekrarlayın yeni bir tarih aralığı için siparişleri almak üzere.
401 Yetkisiz hata
HTTP fetch failed from 'order': 401: Unauthorized içeren bir hata görebilirsiniz.
Çözüm: Zonos Dashboard'unuzdan geçerli bir Secret GraphQL API anahtarı kullandığınızdan emin olun. Bu hata, anahtar eksik, geçersiz veya Secret anahtar türü olmadığında oluşur.
Güvenlik gereksinimi başarısız hatası
Security requirement failed içeren bir hata görebilirsiniz.
Çözüm: Secret GraphQL API anahtarını (Public anahtar değil) kullandığınızdan ve Süresi Dolan statüsüne sahip olmadığından emin olun. Anahtar durumunuzu doğrulamak için Zonos Dashboard'unuzda Ayarlar -> Entegrasyonlar seçeneğine gidin.
Sipariş yok görünüyor
Geçerli bir Secret GraphQL API anahtarı sağlamasına rağmen siparişler görünmüyor.
Çözüm: Bu rapor yalnızca kapsayıcı fiyatlandırma öznitelikleri olan siparişler için veri oluşturur. Maddeleriniz reverseAmountDetail alanları içermiyorsa dahil edilmeyecektir. Seçtiğiniz tarih aralığında işlenen kapsayıcı fiyatlandırma siparişleriniz olduğunu doğrulayın.
Kapsayıcı fiyatlandırma raporunu dışarı aktar
Google Sheet kullanarak madde düzeyinde kapsayıcı fiyatlandırma dökümü oluşturun.
Kapsayıcı fiyatlandırma raporu şablonu, Zonos GraphQL API'nizi sorgulayan ve siparişlerinizde madde düzeyinde temel ve kapsayıcı tutarların dökümünü gösteren bir rapor oluşturan yerleşik bir komut dosyası içeren Google Sheet'tir. Bu, kapsayıcı fiyatlandırma siparişlerindeki maddelere dağıtılan vergilerin, harçların ve ücretlerin nasıl dağıtıldığı hakkında görünürlük isteyen herhangi bir satıcı için faydalıdır.