DOCS

landed cost Hesaplayın - GraphQL

Landed Cost•
AnasayfaLojistik sağlayıcıları için Landed Cost landed cost Hesaplayın - GraphQL

landed cost Hesaplayın

GraphQL ile gümrük vergilerini, vergileri ve ücretleri hesaplayın.

GraphQL

Zonos uluslararası gönderimler için toplam landed cost hesaplar; gümrük vergileri, vergiler ve gümrük, broker veya taşıyıcılar tarafından alınan ek ücretler dahil. Çoğu durumda, bu hesaplamaları son faturayı kendimiz ödeyerek garanti ediyoruz ve size tam olarak hesapladığımız tutarı yansıtıyoruz. Bazı durumlarda, garantisiz olarak landed cost'umuzu kullanabilirsiniz; bu, hesaplamamız ile gerçek ücretler arasındaki farktan sorumlu olduğunuz anlamına gelir.

Talebi Hazırlayın 

Bir landed cost API'si hesaplamak için birkaç girdi gereklidir; bunları iş akışlarına organize ettik. Tamamlandığında, gönderim yeri, sepet içindeki ürünler ve gönderim detaylarına dayalı olarak bir landed cost döndürmek için tek bir istek yapabileceksiniz.

Her iş akışının kendi gerekli girdileri vardır. GraphQL, gerekli olandan daha fazla veri geçirmenize izin verir, ancak yalnızca belirli alanlar bir landed cost döndürmek için gereklidir. Bunlar, tüm olası alanları görmek için API referansımızda açıkça işaretlenmiştir.

Hesaplamanızın garanti edilmesini istiyorsanız, bazı alanların koşullu olarak gerekli olduğunu unutmayın.

Aşağıda, garantili bir landed cost hesaplamak için gereken tüm alanları özetledik. Talebinizi yapmadan önce bu bilgilerin dahil olduğundan emin olun.

Garantili hesaplamalar için gerekli girdiler

partyCreateWorkflowInput

partyCreateWorkflowInput, ilgili tarafları ve konumlarını tanımlar. Tam şemayı GraphQL API'mizde referans bölümünde görüntüleyin. Gerekli alanlar:

  • location
    • administrativeAreaCode: Eyalet veya il kodu, iki harfli. Sadece CA ve BR için gereklidir.
    • countryCode: Ülkenin iki harfli ISO kodu.
    • line1: Adresin ilk satırı.
    • postalCode: Adresin posta kodu veya zip kodu.
  • person
    • email: Kişinin e-posta adresi.
    • firstName: Kişinin adı.
    • lastName: Kişinin soyadı.
    • phone: Kişinin telefon numarası.
  • type
    • DESTINATION: Gönderim yeri için location & person bilgisi.
    • ORIGIN: Gönderim kaynağı için location bilgisi. Gönderim kaynağı ile ilişkili person gerekli değildir.
itemCreateWorkflowInput

itemCreateWorkflowInput, sepet içindeki ürünleri listeler. Birçok isteğe bağlı alan vardır (tüm olasılıkları API referansımızda görebilirsiniz), ancak aşağıdaki alanlar gereklidir.

  • amount: Ürünün fiyatı.
  • currencyCode: Ürün tutarı için para birimi kodu.
  • quantity: Ürünün miktarı.
  • Aşağıdakilerden biri (seçtiğiniz ürün anahtar tercihiniz olarak ayarlanan). Ürün anahtarınız, Katalogda saklanan bilgileri sepet içindeki ürünle bağlar ve etiket oluşturma sırasında kullanılır.)
    • productId: Ürünün ürün kimliği.
    • sku: Ürünün SKU'su.

measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) yalnızca gönderim derecelendirmesi alırken ürünlerinizi kartonlaştırmak istiyorsanız gereklidir.

cartonsCreateWorkflowInput

cartonsCreateWorkflowInput yalnızca girdiyi gerektirir. Tüm değerleri görmek için GraphQL API'mizde referans bölümünde tam şemayı görüntüleyin. Zonos'un gönderim maliyetini hesaplaması durumunda, kartonun boyutlarını ve ağırlığını geçmek önemlidir.

shipmentRatingCreateWorkflowInput

Bu iş akışı, gönderim hizmeti ve maliyetini zaten biliyorsanız kullanılır; Zonos'un etkinleştirdiğiniz hizmetler için bu maliyetleri hesaplamasını istiyorsanız, bu iş akışını değiştirin ve shipmentRatingCalculateWorkflow kullanın.

shipmentRatingCreateWorkflowInput, gönderim maliyetini iletir. Tam şemayı GraphQL API'mizde referans bölümünde görüntüleyin. Gerekli alanlar:

  • amount: Gönderim maliyeti.
  • currencyCode: Gönderim maliyetinin para birimi kodu.
  • serviceLevelCode: Gönderim derecelendirmesinde kullanılan gönderim hizmeti seviyesini belirten kod.
landedCostWorkflowInput

landedCostWorkflowInput, landed cost hesaplaması için tercihleri belirler. Tam şemayı GraphQL API'mizde referans bölümünde görüntüleyin. Gerekli alanlar:

  • calculationMethod: Gönderim planladığınız yöntemi belirtir: DDP (ön ödenmiş gümrük vergileri ve vergiler) veya DAP (ya gümrük vergileri ve vergiler teslimatta ödenir ya da bir remittance planı uygulanıyorsa, vergi kimliği aracılığıyla ödenir).
    • landed cost garantimizi kullanıyorsanız, bu değer her zaman DDP_PREFERRED olmalıdır; bu, mümkün olduğunda DDP teklifi sağlayacak ve DDP teklifi yasaksa DAP teklifi verecektir. Bunun yerine DAP kullanmak, genellikle teslimatta ödenen gümrük vergileri ve vergilerle sonuçlanacağından, hesaplanan landed cost'un garanti edilmemesiyle sonuçlanabilir.
  • endUse: Malların başka bir işletmeye (FOR_RESALE) veya bir tüketici ile son kullanım için (NOT_FOR_RESALE) satılıp satılmadığını belirtir.
  • tariffRate: Bu teklif için uygulanabilecek bir dizi gümrük tarifesi varsa, Zonos'un bu gümrük tarifelerini hesaplamak için kullanması gereken yöntemi belirtir. * landed cost garantimizi kullanırken, bu her zaman ZONOS_PREFERRED olmalıdır.

Hesaplanan gönderim ekleyin: Zonos'un sizin için gönderim maliyetini hesaplamasını istiyorsanız, shipmentRatingCreateWorkflow'u shipmentRatingCalculateWorkflow ile değiştirin. Zonos'un gönderim maliyetini bulmadan önce ürünlerinizi kartonlara ayırmasını istiyorsanız cartonizeWorkflow'u ekleyin (bu, boyutsal ağırlık için kullanılır).

HS kodu ve nakliye seçenekleri

GraphQL, isteği tercihlerinize göre özelleştirme esnekliği sunar. İsteğe HS kodları ve nakliye maliyetlerini dahil etmenin birkaç seçeneği vardır.

HS kodları

HS kodları, gümrük vergisi oranlarını etkiler ve bu nedenle gereklidir. Her bir ürün için HS kodunu geçebilir veya Classify'nin bunları oluşturmasına izin verebilirsiniz.

Her bir ürün için HS kodlarını geçin

Zonos ürün spesifik HS kodları kullanmanızı şiddetle önerir, çünkü bu daha doğru bir landed cost teklifi sağlar. HS kodlarınızı biliyorsanız, itemCreateWorkflow sırasında her item için hsCode'u geçin.

Eğer bir HS kodu geçerseniz, Zonos bunu landed cost teklifi alırken anında doğrulayacaktır. Geçtiğiniz HS kodu geçersizse (yani mevcut değilse), Zonos ürününüzü anında yeniden-classify sınıflandıracak ve sağladığınız kod yerine yeni, geçerli HS kodunu kullanacaktır.

Ürünleriniz için HS kodları oluşturma konusunda yardıma ihtiyacınız varsa, Zonos Classify hakkında bilgi edinin ve nasıl sınıflandırma talep edeceğinizi öğrenin.

Classify ile HS kodları oluşturun

Eğer Zonos'a bir hsCode geçmezseniz, önce Zonos Kataloğu kontrol edilecek ve ürününüz için bir HS kodu saklanıp saklanmadığına bakılacaktır. Eğer yoksa, Classify çağrısı yaparak landed cost hesaplamanızı desteklemek için bir sınıflandırma oluşturacağız. Bu, itemCreateWorkflow ürün detay alanları olan: description, category ve material temelinde yapılacaktır. Eğer ürün detay alanlarınız, Classify's'nin güven skoru temelinde bir sınıflandırma oluşturmak için yeterince detaylı değilse, mağazanıza atanan varsayılan HS kodu kullanılacaktır.

Nakliye maliyeti

Nakliye hizmet seviyesi ve maliyeti, gümrük vergileri, vergiler ve ücretleri etkiler ve bu nedenle gereklidir. Zonos nakliye maliyetlerini hesaplayabilir veya bunu bize geçebilirsiniz.

Nakliye maliyetini hesaplayın

Zonos'un nakliye maliyetlerini hesaplaması için shipmentRatingCalculateWorkflow kullanın. Hesaplanan nakliye yanıtında dönen nakliye seçenekleri, Dashboard üzerindeki nakliye profillerine atadığınız serviceLevels ile ilişkilendirilecektir.

Sorun Giderme: Eğer yanıt içinde bir serviceLevel bekliyorsanız ancak görünmüyorsa, lütfen serviceLevel'ın etkin olduğundan ve seçtiğiniz method tarafından desteklendiğinden emin olun.

Nakliye maliyetini bulmadan önce Zonos'un ürünlerinizi kutulara ayırmasını istiyorsanız, cartonizeWorkflow'u (girdi gerektirmeyen) ekleyin (bu, boyutsal ağırlık için kullanılır).

Nakliye maliyetlerini geçin

Eğer bir gönderi için serviceLevel ve amount'ı biliyorsanız, bunları isteğin shipmentRatingCreateWorkflow kısmında geçebilirsiniz. Bu değerleri kullanarak ilgili taşıyıcı ücretlerini hesaplayacak ve yanıt olarak döndüreceğiz.

API üzerinden bir landed cost talep edin 

Gerekli giriş verilerine sahip olduğunuzda, GraphQL mutasyonunu seçtiğiniz istemci kütüphanesi veya aracı kullanarak API uç noktasına gönderin. İşte mutasyonu nasıl yapılandırabileceğinize dair bazı örnekler.

Zonos'un Landed Cost talebi kapsamında nakliye maliyetini hesapladığı bu isteği kullanın. Daha sonra, varış ülkesinin değerlendirmesi durumunda nakliye üzerinden gümrük vergileri ve vergileri hesaplayacağız.

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
mutation CalculateLandedCostWithShipping(
  $parties: [PartyCreateWorkflowInput!]!
  $items: [ItemCreateWorkflowInput!]!
  $landedCostConfig: LandedCostWorkflowInput!
) {
  partyCreateWorkflow(input: $parties) {
    type
    id
    organization
  }

  itemCreateWorkflow(input: $items) {
    id
    amount
  }

  cartonizeWorkflow {
    id
    type
    items {
      item {
        id
      }
    }
  }

  shipmentRatingCalculateWorkflow {
    id
    amount
  }

  landedCostCalculateWorkflow(input: $landedCostConfig) {
    id
    duties {
      amount
      currency
    }
    taxes {
      amount
      currency
    }
    fees {
      amount
      currency
    }
  }
}

Değişkenler

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
{
  "parties": [
    {
      "location": {
        "administrativeArea": "Utah",
        "administrativeAreaCode": "UT",
        "countryCode": "US",
        "line1": "345 N 2450 E",
        "line2": "#151",
        "locality": "St George",
        "postalCode": "84790"
      },
      "type": "ORIGIN"
    },
    {
      "location": {
        "administrativeArea": "BC",
        "administrativeAreaCode": "BC",
        "countryCode": "CA",
        "line1": "27 Sussex Dr.",
        "locality": "Victoria",
        "postalCode": "V8T 2V9"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      },
      "type": "DESTINATION"
    },
    {
      "type": "PAYOR",
      "location": {
        "administrativeArea": "ON",
        "administrativeAreaCode": "ON",
        "countryCode": "CA",
        "latitude": 1.2,
        "line1": "asdf",
        "line2": "asdf",
        "locality": "locality",
        "longitude": 3423.2,
        "postalCode": "M4C 1A1"
      },
      "person": {
        "email": "test@gmail.com",
        "firstName": "firstName",
        "lastName": "lastName",
        "phone": "5022303021",
        "companyName": "goProTest",
        "metadata": { "key": "key", "value": "value" }
      }
    }
  ],
  "items": [
    {
      "amount": 69,
      "currencyCode": "USD",
      "countryOfOrigin": "US",
      "quantity": 1,
      "productId": "productId",
      "hsCode": "1006.30",
      "description": "description",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    },
    {
      "amount": 62,
      "currencyCode": "CAD",
      "countryOfOrigin": "US",
      "hsCode": "1006.30",
      "quantity": 1,
      "productId": "productId2",
      "description": "description2",
      "measurements": [
        { "type": "WIDTH", "value": 2, "unitOfMeasure": "CENTIMETER" },
        { "type": "WEIGHT", "value": 2, "unitOfMeasure": "POUND" }
      ]
    }
  ],
  "landedCostConfig": {
    "endUse": "FOR_RESALE",
    "method": "DAP",
    "tariffRate": "ZONOS_PREFERRED"
  }
}

Yanıt

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
{
  "data": {
    "partyCreateWorkflow": [
      {
        "type": "ORIGIN",
        "id": "party_749959ae-b9ff-4de4-b4ac-59cc990c53ba",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "DESTINATION",
        "id": "party_cd7ff245-76b6-464f-a7bf-151ebe1f8833",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      },
      {
        "type": "PAYOR",
        "id": "party_00e63a9e-9735-44d9-b129-3b3e76c5df25",
        "organization": "organization_dbb64939-12d7-4f12-98ea-7ae5b21acfd0"
      }
    ],
    "itemCreateWorkflow": [
      {
        "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e",
        "amount": 69
      },
      {
        "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115",
        "amount": 62
      }
    ],
    "cartonizeWorkflow": [
      {
        "id": "carton_b34b29c1-ce27-464b-b91b-df8e4a696312",
        "type": "PACKAGE",
        "items": [
          {
            "item": {
              "id": "item_eb27f071-de8b-4578-9db9-ae69aaf9be3e"
            }
          },
          {
            "item": {
              "id": "item_fffa8ba8-cc8d-4e13-bed6-55044a71c115"
            }
          }
        ]
      }
    ],
    "shipmentRatingCalculateWorkflow": [
      {
        "id": "shipment_rating_96787309-9510-43cc-b4fa-c341ff80f4cc",
        "amount": 173.2
      },
      {
        "id": "shipment_rating_b0ccb109-7794-4c7c-b5cc-e2cfbbc5c8ac",
        "amount": 190.1
      }
    ],
    "landedCostCalculateWorkflow": [
      {
        "id": "landed_cost_74d3ce11-bff2-4326-9e6f-368e03ac88b4",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      },
      {
        "id": "landed_cost_7bbfd354-028c-457f-8c8e-c81bb8fa09a0",
        "duties": [
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "taxes": [
          {
            "amount": 3.45,
            "currency": "USD"
          },
          {
            "amount": 3.1,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          },
          {
            "amount": 0.0,
            "currency": "USD"
          }
        ],
        "fees": [
          {
            "amount": 0.13,
            "currency": "USD"
          },
          {
            "amount": 1.44,
            "currency": "USD"
          }
        ]
      }
    ]
  }
}

Dashboard'da bir landed cost talep et 

Ayrıca, API kullanmadan doğrudan Zonos Dashboard üzerinden landed cost hesaplayabilirsiniz. Bu, hesaplamaları test etmek, ekibinizi eğitmek veya müşteri talepleri 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 alacağınız 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 landed cost hesaplayıcısı ile hesaplanan nakliye ücretleriyle teklifler alabilir, bilinen nakliye maliyetleriyle teklifler oluşturabilir veya birden fazla teklifi toplu olarak işleyebilirsiniz.

Gönderiminiz için nakliye hizmet seviyesi ve maliyetini bildiğinizde bu akışı kullanın.

  1. Dashboard → Siparişler → Teklifler sayfasına gidin
  2. Yeni teklif butonuna tıklayın
  3. İsteğe bağlı — Gönderim adresinizin konumunu değiştirin
  4. Aşağı açılır menüden bir Hedef ülke seçin
  5. Nakliye tutarını girin
    • Hizmet seviyesi isteğe bağlıdır; eklemek, geçerli taşıyıcı ücretlerini hesaplamamıza olanak tanır
  6. Gönderim için ürün detaylarını ekleyin
    • Bir açıklama girdiğinizde, ürünü otomatik olarak classify ederiz ve bir HS kodu oluştururuz
    • Gerekirse oluşturulan HS kodunu geçersiz kılabilirsiniz
    • Birden fazla ürün için Kaydet ve başka birini ekle butonuna tıklayın. Aksi takdirde, Kaydet butonuna tıklayın
  7. İsteğe bağlı — Değiştirmek için Daha fazla seçenek butonuna tıklayın:
    • Satış türünü Yeniden satış için olarak değiştirin
    • Teslimat modunu Teslimat vergileri ödenmemiş olarak değiştirin
  8. Teklif al butonuna tıklayın
    • Değişiklik yapmak için Formu düzenle butonuna tıklayın ve herhangi bir detayı değiştirin
    • Güncellemek için tekrar Teklif al butonuna tıklayın

Sağda bir landed cost teklifi görünecektir; bu teklif ürün, nakliye ve ithalat maliyetlerini içerecektir. Teklifi genişleterek ürünlerin, nakliye, gümrük vergileri, vergiler ve ücretlerin ayrıntılı dökümünü görebilirsiniz. Tüm teklifler, gelecekteki referans için teklif sayfasında kaydedilir.

Mevcut teklifleri düzenleme: Sıfırdan başlamak yerine mevcut bir teklifi değiştirmek için sağ üstteki Teklifi tekrar oluştur butonuna tıklayın.

Dashboard kullanmanın avantajları

  • Kodlama gerektirmez — Kullanıcı dostu bir arayüz aracılığıyla teklifler oluşturun
  • Ekip eğitimi — Teknik olmayan ekip üyelerinin landed cost bileşenlerini anlamalarına yardımcı olun
  • API doğrulama — API entegrasyonunuzun beklenen sonuçları ürettiğini doğrulayın
  • Müşteri desteği — Müşteri talepleri için hızlı bir şekilde teklifler oluşturun
  • Toplu işleme — Birden fazla hesaplamayı verimli bir şekilde yönetin (yakında geliyor)

Dashboard teklifleri, API aracılığıyla mevcut olan aynı ayrıntılı dökümleri içerir, bu da onu otomatik entegrasyonunuza mükemmel bir tamamlayıcı yapar.

Bu sayfa yardımcı oldu mu?

Bir demo rezervasyonu yap

Sorular?

Destek al
© 2025 Zonoszonos.com
Bu sayfada:
  • landed cost Hesaplayın
  • Talebi Hazırlayın
  • API üzerinden bir landed cost talep edin
  • Dashboard'da bir landed cost talep et