İsteği hazırlayın
Varış maliyeti API'sini hesaplamak birkaç giriş gerektirir; bunları iş akışlarına organize ettik. Tamamlandıktan sonra, sevkiyat hedefine, sepetteki öğelere ve sevkiyat ayrıntılarına dayalı olarak varış maliyetini döndürmek için tek bir istek yapabileceksiniz.
Her iş akışının kendi gerekli girdileri vardır. GraphQL, gerekenden daha fazla veri geçirmenize izin verir, ancak varış maliyetini döndürmek için yalnızca belirli alanlar gereklidir. Bunlar API referansında tüm olası alanları görmek için açıkça işaretlenmiştir.
Bazı alanların, garantili hesaplamayı istiyorsanız koşullu olarak gerekli olduğunu unutmayın.
Aşağıda, garantili varış maliyetini hesaplamak için gerekli tüm alanları özetledik. İsteği yapmadan önce bu bilgilerin dahil olduğundan emin olun.
Garantili hesaplamalar için gerekli girdiler
partyCreateWorkflowInputpartyCreateWorkflowInput, ilgili tarafları ve bunların konumlarını tanımlar. GraphQL API referansında tam şemayı görün. Gerekli alanlar şunlardır:
locationadministrativeAreaCode: İl veya bölge kodu, iki harfle. Yalnızca CA ve BR için gerekli.countryCode: Ülkenin iki harfli ISO kodu.line1: Adresin ilk satırı.postalCode: Adresin posta veya zip kodu.
personemail: Kişinin e-posta adresi.firstName: Kişinin adı.lastName: Kişinin soyadı.phone: Kişinin telefon numarası.
typeDESTINATION: Sevkiyat hedefi içinlocation&personbilgileri.ORIGIN: Sevkiyat kaynağı içinlocationbilgileri. Sevkiyat kaynağı ile ilişkilipersongerekli değildir.
itemCreateWorkflowInputitemCreateWorkflowInput sepetteki öğeleri listeler. Birçok isteğe bağlı alan vardır (API referansında tüm olasılıkları görün), ancak aşağıdaki alanlar gereklidir.
amount: Sevkilen ürünün tek bir biriminin değeri, miktar ile çarpılmadan önce. Lütfen bunun posta tanımından farklı olduğunu unutmayın. Öğeninquantity1 ise, bu öğenin toplam maliyetidir. Öğeninquantity>1 ise, API öğeamountile öğequantityile çarpacak ve satır öğenin toplamını alacaktır. Tüm öğe birimlerinin toplam fiyatınıamountiçine koymayın.currencyCode: Öğe miktarının para birimi kodu.quantity: Öğenin miktarı. API, öğeamountöğesini öğequantityile çarparak satır öğesin toplamını alacaktır.countryOfOrigin: Öğenin üretildiği ülke.- Aşağıdakilerden biri (öğe anahtarı tercihine ayarlanmış olan hangisiyse. Öğe anahtarınız, Kataloğunda depolanan bilgileri sepetin öğesiyle bağlar ve etiket oluşturma sırasında kullanılır.)
productId: Öğenin ürün kimliği.sku: Öğenin SKU'su.
measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) yalnızca sevkiyat derecelendirmesi alırken kartona almak istiyorsanız gereklidir.
cartonsCreateWorkflowInputcartonsCreateWorkflowInput sadece girişin kendisini gerektirir. GraphQL API referansında geçirilebilen tüm değerleri görmek için tam şemayı görün. Zonos sevkiyat maliyetini hesaplıyorsa, kartonun boyutlarını ve ağırlığını geçirmek önemlidir.
shipmentRatingCreateWorkflowInputBu iş akışı, sevkiyat hizmetini ve maliyetini zaten bildiğinizde kullanılır; Zonos'un etkinleştirdiğiniz hizmetlerin maliyetlerini hesaplamasını istiyorsanız, bu iş akışını shipmentRatingCalculateWorkflow ile değiştirin.
shipmentRatingCreateWorkflowInput, sevkiyat maliyetini iletişim kurar. GraphQL API referansında tam şemayı görün. Gerekli alanlar şunlardır:
amount: Sevkiyat maliyeti.currencyCode: Sevkiyat maliyetinin para birimi kodu.serviceLevelCode: Sevkiyat derecelendirmesinde kullanılan sevkiyat hizmet seviyesini gösteren kod.
landedCostWorkFlowInputlandedCostWorkFlowInput, varış maliyeti hesaplaması tercihlerini belirler. GraphQL API referansında tam şemayı görün. Gerekli alanlar şunlardır:
calculationMethod: Nasıl sevk etmeyi planladığınıza ilişkin tercihini belirtir: DDP (ön ödemeli gümrük ve vergiler) veya DAP (gümrük ve vergiler teslimat sırasında ödenirse veya bir geri ödeme planı uygulanırsa vergi kimliği aracılığıyla geri ödenirse).- Varış maliyeti garantimizi kullanıyorsanız, bu değer her zaman
DDP_PREFERREDolmalıdır; mümkün olduğunda DDP teklifi sağlayacak ve DDP'ye izin verilmiyorsa DAP teklifi olacaktır. Bunun yerineDAPkullanmak, bu tipik olarak teslimat sırasında ödenecek gümrük ve vergiler ile sonuçlandığından, varış maliyetlerinin artık garantili olmaması ile sonuçlanabilir.
- Varış maliyeti garantimizi kullanıyorsanız, bu değer her zaman
endUse: Malların başka bir işletmeye (FOR_RESALE) satılıp satılmadığını veya tüketici (NOT_FOR_RESALE) ile son kullanım için satılıp satılmadığını belirtir.tariffRate: Bu teklif için tarife oranlarını hesaplamak için Zonos'un kullanması gereken yöntemi belirtir; uygulanabilecek bir dizi tarife oranı olması durumunda. *Varış maliyeti garantimizi kullanırken, bu her zamanZONOS_PREFERREDolmalıdır.
Hesaplanmış sevkiyat ekleyin: Zonos'un sevkiyat maliyetini sizin için hesaplamasını istiyorsanız,
shipmentRatingCreateWorkflowöğesinishipmentRatingCalculateWorkflowile değiştirin. Zonos'un sevkiyat maliyetini bulmadan önce öğelerinizi kartona ayırmasını istiyorsanızcartonizeWorkflowekleyin (boyutsal ağırlık için kullanılır).
HS kodu ve sevkiyat seçenekleri
GraphQL, isteği tercihine göre özelleştirme esnekliği sağlar. HS kodlarını ve sevkiyat maliyetlerini istekte nasıl dahil edeceğiniz için birkaç seçenek vardır.
HS kodları
HS kodları gümrük oranlarını etkiler ve bu nedenle gereklidir. Her öğe için HS kodunu geçirebilir veya Classify'nin onları oluşturmasına izin verebilirsiniz.
Zonos, daha doğru bir varış maliyeti teklifi elde ettiği için ürüne özel HS kodlarını kullanmasını şiddetle tavsiye eder. HS kodlarınızı biliyorsanız, itemCreateWorkflow sırasında her item için hsCode öğesini geçin.
Bir HS kodu geçirirseniz, Zonos, varış maliyeti teklifi alırken bunu uçuşta doğrulayacaktır. Sağladığınız HS kodu geçersizse (yani mevcut değilse), Zonos öğeyi uçuşta yeniden sınıflandıracak ve sağladığınız yerine yeni, geçerli HS kodunu kullanacaktır.
Ürünleriniz için HS kodları oluşturmaya yardımcı olması gerekiyorsa, Zonos Classify hakkında ve sınıflandırma isteme hakkında bilgi edinin.
Zonos'a bir hsCode geçirmezseniz, önce Zonos Kataloğunu kontrol edeceğiz ve öğeniz için depolanan bir HS kodu olup olmadığını göreceğiz. Yoksa, Classify çağıracağız ve aşağıdaki itemCreateWorkflow ürün detayı alanlarına dayalı olarak varış maliyeti hesaplamanızı güclendirecek bir sınıflandırma oluşturacağız: description, category ve material. Ürün detayı alanlarınız Classify'nin güven puanı üzerine dayalı bir sınıflandırma oluşturmak için yeterince ayrıntılı değilse, varsayılan HS kodu mağazanıza atanmış olacaktır.
Sevkiyat maliyeti
Hem sevkiyat hizmet seviyesi hem de maliyeti gümrük, vergiler ve ücretleri etkiler ve bu nedenle gereklidir. Zonos sevkiyatı hesaplayabilir veya bunu bize geçirebilirsiniz.
Zonos'un sevkiyat maliyetlerini hesaplamasını sağlamak için shipmentRatingCalculateWorkflow öğesini kullanın. Hesaplanan sevkiyat yanıtında döndürülen sevkiyat seçenekleri, Dashboard adresindeki sevkiyat profillerine atadığınız serviceLevels ile ilişkili olacaktır.
Sorun Giderme: Yanıtta bir
serviceLevelbekliyorsanız ancak görünmüyorsa, lütfenserviceLevelöğesinin etkinleştirildiğinden ve seçtiğinizmethodtarafından desteklendiğinden emin olun.
Zonos'un öğelerinizi kartona ayırmasını ve sevkiyat maliyetini bulmadan önce istiyorsanız cartonizeWorkflow (boyutsal ağırlık için kullanılır) ekleyin (girdileri yok).
Bir sevkiyat için serviceLevel ve amount öğesini biliyorsanız, bunları shipmentRatingCreateWorkflow kısmında geçirebilirsiniz. Bu değerleri, ilgili kargo ücretlerini hesaplamak için kullanacağız ve yanıtta döndüreceğiz.
API aracılığıyla varış maliyeti isteyin
Gerekli giriş verilerine sahip olduktan sonra, seçtiğiniz istemci kitaplığını veya aracını kullanarak GraphQL mutasyonunu API uç noktasına gönderin. İşte mutasyonu yapılandırabileceğiniz bazı örnekler.
Zonos'un sevkiyat maliyetini Varış Maliyeti isteğinin bir parçası olarak hesaplamasını sağlıyorsanız bu isteği kullanın. Daha sonra varış maliyeti hedefi ülkesinde değerlendirilirse sevkiyata gümrük ve vergiler hesaplayacağız.
mutation CalculateLandedCost($parties: [PartyCreateWorkflowInput!]!$items: [ItemCreateWorkflowInput!]!$landedCostConfig: LandedCostWorkFlowInput!) { partyCreateWorkflow(input: $parties) { type id organization } itemCreateWorkflow(input: $items) { id amount productId } cartonizeWorkflow { id type items { item { id } } } shipmentRatingCalculateWorkflow { id amount } landedCostCalculateWorkflow(input: $landedCostConfig) { id duties { amount currency note } taxes { amount currency note } fees { amount currency note } }}Sonraki adım: Bir sipariş oluşturun
Bir varış maliyetini hesapladıktan sonra ve API yanıtından landedCostId aldıktan sonra, Zonos sisteminde işlemi sonuçlandırmak için bir sipariş oluşturmalısınız. orderCreate mutasyonunu kullanın ve teklifinizden landedCostId öğesini geçin. Siparişler oluşturma hakkında daha fazla bilgi edinin.
Dashboard'da varış maliyeti isteyin
API'yi kullanmadan doğrudan Zonos Dashboard adresinde varış maliyetlerini hesaplayabilirsiniz. Bu, hesaplamaları test etmek, ekibinizi eğitmek veya müşteri sorgulamaları için hızlı teklifler almak için faydalıdır.
Dashboard, yukarıda açıklanan aynı API uç noktalarını kullanır, bu nedenle sonuçlar doğrudan API çağrılarından elde ettiğiniz sonuçlarla eşleşecektir. Bu, API entegrasyonunuzu doğrulamak veya farklı girdilerin hesaplamaları nasıl etkilediğini keşfetmek için harika bir yoldur.
Dashboard hesaplayıcısını kullanma
Dashboard'daki varış maliyeti hesaplayıcısı ile, hesaplanan sevkiyat oranlarıyla teklifler alabilir, bilinen sevkiyat maliyetleriyle teklifler oluşturabilir veya birden fazla teklifi toplu olarak işleyebilirsiniz.
Sevkiyatınızın sevkiyat hizmet seviyesini ve maliyetini bildiğinizde bu akışı kullanın.
- Dashboard → Orders → Quotes adresine gidin
- Yeni teklif öğesine tıklayın
- İsteğe bağlı — Gönderilen adresinizin konumunu değiştirin
- Açılır menüden Hedef ülkesi seçin
- Sevkiyat miktarını girin
- Hizmet seviyesi isteğe bağlıdır; eklemek bize uygulanabilir kargo ücretlerini hesaplamaya izin verir
- Sevkiyat için öğe ayrıntılarını ekleyin
- Bir açıklama girdiğinizde, otomatik olarak ürünü sınıflandırırız ve HS kodu oluştururuz
- Oluşturulan HS kodunu gerekirse yazabilirsiniz
- Birden fazla öğe için Kaydet ve başka ekle'ye tıklayın. Aksi takdirde Kaydet'e tıklayın
- İsteğe bağlı — Aşağıdakileri değiştirmek için Daha fazla seçenek öğesine tıklayın:
- Satış türü Yeniden satış için
- Teslimat modu Teslim edilecek gümrük ödemeleri
- Teklif al öğesine tıklayın
- Değişiklik yapmak için Formu düzenle'ye tıklayın ve ayrıntıları değiştirin
- Güncellemek için Teklif al'a tıklayın
Varış maliyeti teklifi, ürün, sevkiyat ve ithalatı maliyetleri dahil olmak üzere sağda görünecektir. Öğelerin, sevkiyatın, gümrük vergilerinin ve ücretlerin ayrıntılı dökümlerini görmek için teklifi genişletin. Tüm teklifler gelecekte başvurmak üzere teklif sayfasında kaydedilir.
Mevcut teklifleri düzenle: Sıfırdan başlamak yerine mevcut bir teklifi değiştirmek için sağ üst köşedeki Tekrar teklif et öğesine tıklayın.
Dashboard kullanmanın avantajları
- Kodlama gerekli değil — Kullanıcı dostu bir arayüz aracılığıyla teklifler oluşturun
- Ekip eğitimi — Teknik olmayan ekip üyelerinin varış maliyeti bileşenlerini anlamasına yardımcı olun
- API doğrulaması — API entegrasyonunuzun beklenen sonuçlar ürettiğini doğrulayın
- Müşteri desteği — Müşteri sorgulamaları için hızlı teklifler oluşturun
- Toplu işleme — Birden fazla hesaplamayı verimli bir şekilde işleyin (yakında)
Dashboard teklifleri, API aracılığıyla kullanılabilen aynı ayrıntılı dökümler içerir ve otomatik entegrasyonunuza mükemmel bir tamamlayıcıdır.
Varış maliyeti hesapla
GraphQL ile gümrük, vergi ve ücret hesaplayın.GraphQL
Zonos, uluslararası sevkiyatlar için varış maliyetini (gümrük, vergiler ve gümrük, broker veya kargo şirketleri tarafından talep edilen ek ücretler dahil) hesaplar. Çoğu durumda, bu hesaplamaları garanti ederiz—nihai faturayı kendimiz öderiz ve sizden hesapladığımız tam tutarı tahsil ederiz. Bazı durumlarda, varış maliyetimizi garanti olmaksızın kullanabilirsiniz, yani hesaplamamız ile gerçek ücretler arasındaki fark için siz sorumlu olursunuz.