DOCS

Request a landed cost

/
Landed Cost•
AnasayfaAPI referansı Landed Cost REST API Bir landed cost talep edin

Bir landed cost talep edin

Bir landed cost talebindeki anahtar/değer çiftlerini bulun.

Zonos Landed Cost yalnızca bir ürünün tanımına dayanarak doğru bir landed cost sağlayabilse de, sağlanan bilgi ne kadar fazla olursa, landed cost teklifi o kadar doğru olacaktır. Aşağıda ZORUNLU ve İSTEĞE BAĞLI girdiler bulunmaktadır, ancak mümkün olduğunca çok İSTEĞE BAĞLI alanın doldurulması önerilir.

Bir HS kodu kullanılması şiddetle tavsiye edilir. Temel landed cost'dan farklı olarak, tam landed cost HS kodu başına gümrük tarifelerinin ürün düzeyindeki detaylarını içerecektir.

Özellikler 

İstek gövdesindeki JSON anahtar/değer çiftleri

POST | https://api.zonos.com/v1/landed_cost

HEADER zonos-version: 2019-11-21

Yukarıdaki başlık, bu landed cost talebinin başarılı bir şekilde tamamlanması için zorunlu bir girdi olarak gereklidir.

AlanNotlar
currency GEREKENTemel para birimi dizesi, üç harfli ISO kodu ile temsil edilir.
discounts İSTEĞE BAĞLIHerhangi bir indirimle ilgili bilgiler, kimlik, miktar ve diğer detaylar dahil.
discounts.id İSTEĞE BAĞLITüccar veya ihracatçı için benzersiz indirim tanımlayıcısı.
discounts.amount İSTEĞE BAĞLIİndirim miktarını, dolar ve sent olarak gösteren bir ondalık.
discounts.detail İSTEĞE BAĞLIİndirimle ilgili ek özellikler, nitelikler veya açıklamalar.
items GEREKENİhracatı yapılan ürünlerin listesi. hash
items.id GEREKENTüccar veya ihracatçı için benzersiz ürün tanımlayıcısı.
items.amount GEREKENTek bir ürünün toplamını, dolar ve sent olarak gösteren bir ondalık.
items.amount_discount İSTEĞE BAĞLIÜrüne uygulanan indirim miktarı.
items.brand İSTEĞE BAĞLIÜrünün markası, örneğin "Leatherman."
items.category İSTEĞE BAĞLIÜrünün kategori açıklaması, örneğin "Giyim."
items.color İSTEĞE BAĞLIÜrünün rengi.
items.country_of_origin İSTEĞE BAĞLIÜretim veya imalat ülkesi, iki harfli ISO kodu ile temsil edilir. Bu, en doğru tekliflerin alınması için önerilir. Eğer bir menşei ülkesi alınmazsa, En Çok Kayrılan Ülke (MFN) rate kullanılır.
items.description_customs İSTEĞE BAĞLITicari fatura için önerilen mal tanımı. Bu tanım genellikle perakende tanımından farklıdır ve genellikle ne olduğunu, ne ile yapıldığını ve ne için kullanıldığını içeren genel bir tanım içerir.
items.description_retail İSTEĞE BAĞLIÜrünün perakende tanımı.
items.detail İSTEĞE BAĞLIÜrünle ilgili ek özellikler, nitelikler veya açıklamalar.
items.dimensions İSTEĞE BAĞLIGönderinin boyutu. Bu, tarife oranlarının ürün boyutlarından etkilendiği ülkelere en doğru tekliflerin alınması için önerilir. hash
items.dimensions.height İSTEĞE BAĞLIÜrünün yüksekliği için bir ondalık.
items.dimensions.length İSTEĞE BAĞLIÜrünün uzunluğu için bir ondalık.
items.dimensions.unit İSTEĞE BAĞLIÜrün boyutları için ölçü birimi. Olası değerler inch, centimeter, millimeter ve null'dır. null olduğunda, inch kullanılacaktır.
items.dimensions.width İSTEĞE BAĞLIÜrünün genişliği için bir ondalık.
items.duty_tax_fee_free İSTEĞE BAĞLIÜrünün landed cost hesaplamasına dahil edilmemesi gerektiğini belirtmek için bir dize. exclude isteği gönderildiğinde, ürün API yanıtında removed_items içinde görünecektir.
items.hs_code İSTEĞE BAĞLIÜrün HS kodu, 2 ila 10 haneli.
items.image_url İSTEĞE BAĞLIResim URL'si.
items.quantity GEREKENÜrünün miktarını gösteren bir tam sayı.
items.upc_code İSTEĞE BAĞLIÜrün için UPC kodu dizesi.
items.weight İSTEĞE BAĞLIÜrünün ağırlığı için bir ondalık.
items.weight_unit İSTEĞE BAĞLIAğırlık için ölçü birimi dizesi. Olası değerler pound, ounce, kilogram ve null'dır. null olduğunda, pound kullanılacaktır.
landed_cost İSTEĞE BAĞLIBir landed cost için istek türü. Olası değerler arasında delivery_duty_paid ve delivery_duty_unpaid bulunmaktadır. Bir landed cost için ücretler, DDP veya DDU olarak gönderilip gönderilmediğine bağlı olarak farklılık gösterebilir. Eğer null ise, bir DDP isteği varsayılacaktır. Eğer bir DDP isteği yapılır ve DDP mevcut değilse, sağlanan hizmet seviyesi için DDP'nin mevcut olmadığına dair bir mesajla birlikte 400 hatası dönecektir. DDP ve DDU genellikle her hizmet seviyesinde mevcut olduğundan, bunun hesap düzeyinde değil, hizmet düzeyinde yapılandırılabildiğinden emin olun.
sale_type İSTEĞE BAĞLISatış türünün bir göstergesi. Olası değerler arasında not_for_resale ve for_resale bulunmaktadır. Eğer null ise, bir not_for_resale isteği varsayılacaktır.
ship_from_country GEREKENGönderim yapılan ülke dizesi, iki harfli ISO kodu ile temsil edilmektedir.
ship_to GEREKENHedef adres. hash
ship_to.city İSTEĞE BAĞLI*Müşterinin adres şehri, kasabası, ilçesi, banliyösü veya köyü için bir dize. İthalat ülkesine bağlı olarak, bu alan GEREKEN olabilir.
ship_to.country GEREKENBanka hesabının bulunduğu hedef ülke için bir dize, iki harfli ISO kodu ile temsil edilmektedir.
ship_to.postal_code İSTEĞE BAĞLI*Hedef posta kodu için bir dize. Bu alan, gönderim Kuzey İrlanda ile Avrupa Birliği arasında olduğunda gerekli olabilir.
ship_to.state İSTEĞE BAĞLI*Mevcut olduğunda hedef eyalet kodu için bir dize. İthalat ülkesi Brezilya veya Kanada ise, bu alan gereklidir.
shipping GEREKENTaşıyıcı ile birlikte miktar, indirim miktarı ve hizmet seviyesi gibi gönderim detayları. hash
shipping.amount GEREKENGönderim maliyetlerinin toplamı için bir ondalık, dolar ve sent cinsinden.
shipping.amount_discount İSTEĞE BAĞLIGönderime uygulanan indirim miktarı için bir ondalık.
shipping.service_level GEREKENTaşıyıcı ile birlikte hizmet seviyesi. Taşıyıcıya göre mevcut hizmet seviyelerinin tam listesi için taşıyıcı belgelerine bakın.

*Bu alan, ithalat ülkesinin adres alanı gereksinimlerine bağlı olarak isteğe bağlıdır.

Örnek istek

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
{
  "currency": "USD",
  "discounts": [
    {
      "id": "sale124",
      "amount": 43.0,
      "detail": null
    }
  ],
  "items": [
    {
      "id": "294395",
      "amount": 75,
      "amount_discount": 0,
      "brand": null,
      "category": "Women's Clothing",
      "color": null,
      "country_of_origin": "FR",
      "description_customs": null,
      "description_retail": "Hoka One Running Shoe - Women's",
      "detail": null,
      "dimensions": {
        "height": 4,
        "length": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": null,
      "hs_code": "6116.10.00",
      "image_url": "https://zonos.com/images/handbag.png",
      "quantity": 1,
      "upc_code": null,
      "weight": 10,
      "weight_unit": "pound"
    },
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "detail": null,
      "dimensions": {
        "height": 4,
        "lenght": 6,
        "unit": "inch",
        "width": 11
      },
      "duty_tax_fee_free": "exclude",
      "hs_code": "6217.10",
      "image_url": null,
      "note": null,
      "quantity": 1,
      "upc_code": null,
      "weight": 1,
      "weight_unit": "pound"
    }
  ],
  "landed_cost": "delivery_duty_paid",
  "sale_type": "not_for_resale",
  "ship_from_country": "US",
  "ship_to": {
    "city": "Campinas",
    "country": "BR",
    "postal_code": "75828-000",
    "state": "SP"
  },
  "shipping": {
    "amount": 14.23,
    "amount_discount": 0,
    "service_level": "ups_express_saver"
  },
  "tariff_rate": "zonos_preferred"
}

Örnek 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
{
  "id": "ldct_eab3008d-a8ca-4bd7-bf6d-cd178fe3cd77",
  "amount_subtotal": {
    "duties": 27.74,
    "fees": 15.33,
    "taxes": 16.23
  },
  "currency": {
    "id": "curr_8fb20952-d",
    "base": "USD",
    "date": "2019-11-04T20:42:40.999+0000",
    "rates": [
      {
        "currency": "BRL",
        "rate": 0.2274
      }
    ]
  },
  "customs": {
    "delivery_duty_paid": "available",
    "items": [
      {
        "id": "294395",
        "amount": 32.0,
        "country_of_origin": "FR",
        "country_of_origin_source": null,
        "description_customs": "Women's Tennis Shoe",
        "description_retail": "Hoka One Running Shoe - Women's",
        "detail": null,
        "dimensions": {
          "height": 4.0,
          "length": 6.0,
          "unit": "inch",
          "width": 11.0
        },
        "hs_code": "6116.10.00",
        "hs_code_source": "account_default",
        "image_url": "https://zonos.com/images/handbag.png",
        "note": null,
        "quantity": 1,
        "upc_code": null,
        "weight": 10.0,
        "weight_unit": "pound"
      }
    ],
    "ship_to_country": "BR",
    "shipping_amount": 14.23
  },
  "de_minimis": [
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "duty"
    },
    {
      "formula": "Less than 0 BRL",
      "method": "FOB",
      "note": null,
      "threshold": "above",
      "type": "tax"
    }
  ],
  "duties": [
    {
      "amount": 19.2,
      "description": "duty",
      "formula": "60%",
      "item_id": "294395",
      "note": "Duty is 60% of the items total.",
      "type": "item"
    },
    {
      "amount": 8.54,
      "description": "Duty",
      "formula": "60%",
      "item_id": null,
      "note": null,
      "type": "shipping"
    }
  ],
  "fees": [
    {
      "amount": 22.0,
      "description": "UPS United States Duty and Tax Forwarding Charge",
      "formula": "15 USD",
      "item_id": null,
      "note": null,
      "type": "ddp_service_fee"
    },
    {
      "amount": 0.33,
      "description": "UPS Currency Conversion Fee",
      "formula": ".75% of the amount converted",
      "item_id": null,
      "note": null,
      "type": "currency_conversion_fee"
    }
  ],
  "removed_items": [
    {
      "id": "294396",
      "amount": 15,
      "country_of_origin": "CN",
      "country_of_origin_source": "account_default",
      "description_customs": "Men's t-shirt 100% polyester",
      "description_retail": "Galaxy Quest Men's Tee Blue",
      "hs_code": "6217.10",
      "hs_code_source": "account_default",
      "note": null,
      "quantity": 1
    }
  ],
  "remittance": [],
  "taxes": [
    {
      "amount": 7.02,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": "294395",
      "note": null,
      "type": "item"
    },
    {
      "amount": 3.12,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "shipping"
    },
    {
      "amount": 6.09,
      "description": "ICMS",
      "formula": "18% applied to gross amount including tax. Calculate with fomula: value/(1-0.18)*0.18",
      "item_id": null,
      "note": null,
      "type": "duty"
    }
  ]
}

Bu sayfa yardımcı oldu mu?

© 2024 Zonoszonos.com
Bu sayfada:
  • Bir landed cost talep edin
  • Özellikler