Atrybuty
Pary klucz/wartość JSON w ciele żądania
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
Powyższy nagłówek jest wymaganym wejściem dla tego żądania landed cost, aby zakończyło się pomyślnie.
| Pole | Uwagi |
|---|---|
currency WYMAGANE | Podstawowy ciąg walutowy, reprezentowany przez trzyznakowy kod ISO. |
discounts OPCJONALNE | Informacje dotyczące wszelkich rabatów, w tym identyfikator, kwotę i wszelkie szczegóły. |
discounts.id OPCJONALNE | Unikalny identyfikator rabatu dla sprzedawcy lub eksportera. |
discounts.amount OPCJONALNE | Liczba dziesiętna z kwotą rabatu, w dolarach i centach. |
discounts.detail OPCJONALNE | Dodatkowe cechy, atrybuty lub opisy rabatu. |
items WYMAGANE | Lista przedmiotów, które są eksportowane. hash |
items.id WYMAGANE | Unikalny identyfikator przedmiotu dla sprzedawcy lub eksportera. |
items.amount WYMAGANE | Liczba dziesiętna z całkowitą kwotą jednego przedmiotu, w dolarach i centach. |
items.amount_discount OPCJONALNE | Kwota rabatu, która dotyczy przedmiotu. |
items.brand OPCJONALNE | Marka przedmiotu, np. "Leatherman.” |
items.category OPCJONALNE | Opis kategorii przedmiotu, np. "Odzież." |
items.color OPCJONALNE | Kolor przedmiotu. |
items.country_of_origin OPCJONALNE | Kraj produkcji lub wytwarzania, reprezentowany przez dwuznakowy kod ISO. Jest to zalecane dla najdokładniejszych wycen. Jeśli nie otrzymano kraju pochodzenia, używana jest Najkorzystniejsza Narodowość (MFN) rate. |
items.description_customs OPCJONALNE | Sugerowany opis towarów na fakturze handlowej. Ten opis zazwyczaj różni się od opisu detalicznego i zazwyczaj zawiera ogólny opis tego, czym jest, z czego jest wykonany i do czego jest używany. |
items.description_retail OPCJONALNE | Opis detaliczny przedmiotu. |
items.detail OPCJONALNE | Dodatkowe cechy, atrybuty lub opisy przedmiotu. |
items.dimensions OPCJONALNE | Rozmiar przesyłki. Jest to zalecane, aby uzyskać najdokładniejsze wyceny do krajów, w których cła są uzależnione od wymiarów przedmiotu. hash |
items.dimensions.height OPCJONALNE | Liczba dziesiętna dla wysokości przedmiotu. |
items.dimensions.length OPCJONALNE | Liczba dziesiętna dla długości przedmiotu. |
items.dimensions.unit OPCJONALNE | Jednostka miary dla wymiarów przedmiotu. Możliwe wartości to inch, centimeter, millimeter i null. Gdy null, używana będzie jednostka inch. |
items.dimensions.width OPCJONALNE | Liczba dziesiętna dla szerokości przedmiotu. |
items.duty_tax_fee_free OPCJONALNE | Ciąg, aby określić, czy przedmiot nie powinien być uwzględniony w obliczeniach landed cost. Gdy exclude jest wysyłane w żądaniu, przedmiot pojawi się w removed_items w odpowiedzi API. |
items.hs_code OPCJONALNE | Kod HS przedmiotu, od 2 do 10 cyfr. |
items.image_url OPCJONALNE | URL obrazu. |
items.quantity WYMAGANE | Liczba całkowita z ilością przedmiotu. |
items.upc_code OPCJONALNE | Ciąg kodu UPC dla przedmiotu. |
items.weight OPCJONALNE | Liczba dziesiętna dla wagi przedmiotu. |
items.weight_unit OPCJONALNE | Ciąg jednostki miary dla wagi. Możliwe wartości to pound, ounce, kilogram i null. Gdy null, używana będzie jednostka pound. |
landed_cost OPCJONALNY | Typ żądania dla landed cost. Możliwe wartości to delivery_duty_paid i delivery_duty_unpaid. Opłaty za landed cost mogą się różnić, niezależnie od tego, czy jest wysyłany DDP czy DDU. Jeśli null, przyjmuje się, że żądanie DDP. Jeśli złożono żądanie DDP, a DDP nie jest dostępne, zwrócony zostanie błąd 400 z komunikatem informującym, że DDP nie jest dostępne dla podanego poziomu usługi. DDP i DDU są zazwyczaj dostępne w każdym poziomie usługi, więc proszę upewnić się, że można to skonfigurować na poziomie usługi, a nie na poziomie konta. |
sale_type OPCJONALNY | Wskaźnik typu sprzedaży. Możliwe wartości to not_for_resale for_resale. Jeśli null, przyjmuje się żądanie not_for_resale. |
ship_from_country WYMAGANY | Ciąg reprezentujący kraj wysyłki, oznaczony przez dwu-literowy kod ISO. |
ship_to WYMAGANY | Adres docelowy. hash |
ship_to.city OPCJONALNY* | Ciąg dla miasta, miasteczka, dzielnicy, przedmieścia lub wioski klienta. W zależności od kraju importu, to pole może być WYMAGANE. |
ship_to.country WYMAGANY | Ciąg dla kraju docelowego, w którym znajduje się konto bankowe, oznaczony przez dwu-literowy kod ISO. |
ship_to.postal_code OPCJONALNY* | Ciąg dla kodu pocztowego miejsca docelowego. To pole może być wymagane, gdy przesyłka jest między Irlandią Północną a Unią Europejską. |
ship_to.state OPCJONALNY* | Ciąg dla kodu stanu miejsca docelowego, gdy jest dostępny. Jeśli kraj importu to Brazylia lub Kanada, to pole jest wymagane. |
shipping WYMAGANY | Szczegóły wysyłki, takie jak kwota, kwota rabatu i poziom usługi u przewoźnika. hash |
shipping.amount WYMAGANY | Liczba dziesiętna dla całkowitych kosztów wysyłki, w dolarach i centach. |
shipping.amount_discount OPCJONALNY | Liczba dziesiętna dla kwoty rabatu, która ma zastosowanie do wysyłki. |
shipping.service_level WYMAGANY | Poziom usługi u przewoźnika. Zobacz dokumentację przewoźników dla pełnej listy dostępnych poziomów usług według przewoźnika. |
*To pole jest opcjonalne w zależności od wymagań dotyczących pól adresowych dla kraju importu.
Przykładowe żądanie
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"
}
Przykładowa odpowiedź
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"
}
]
}
Żądanie landed cost
Znajdź pary klucz/wartość w żądaniu landed cost.Chociaż Zonos Landed Cost jest w stanie dostarczyć dokładny landed cost wyłącznie na podstawie opisu przedmiotu, im więcej informacji zostanie podanych, tym dokładniejsza będzie wycena landed cost. Poniżej znajdują się WYMAGANE i OPCJONALNE dane wejściowe, ale zaleca się wypełnienie jak największej liczby OPCJONALNYCH pól.