Attribut
JSON nyckel/värde-par i begärans kropp
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
Headern ovan är en obligatorisk indata för denna landed cost begäran för att slutföras framgångsrikt.
| Fält | Anteckningar |
|---|---|
currency KRÄVD | Basvaluta sträng, representerad av en tre-bokstavs ISO-kod. |
discounts VALFRI | Informationen relaterad till eventuella rabatter, inklusive id, belopp och eventuella detaljer. |
discounts.id VALFRI | Den unika rabattidentifieraren för handlaren eller exportören. |
discounts.amount VALFRI | Ett decimaltal med beloppet av rabatten, i dollar och cent. |
discounts.detail VALFRI | Ytterligare funktioner, attribut eller beskrivningar av rabatten. |
items KRÄVD | Listan över varor som exporteras. hash |
items.id KRÄVD | Den unika varuidentifieraren för handlaren eller exportören. |
items.amount KRÄVD | Ett decimaltal med totalen för en enskild vara, i dollar och cent. |
items.amount_discount VALFRI | Beloppet av rabatten som gäller för varan. |
items.brand VALFRI | Varumärket för varan, t.ex. "Leatherman.” |
items.category VALFRI | Kategoribeskrivning av varan, t.ex. "Kläder." |
items.color VALFRI | Färg på varan. |
items.country_of_origin VALFRI | Tillverknings- eller produktionsland, representerat av en två-bokstavs ISO-kod. Detta rekommenderas för de mest exakta offerterna. Om inget ursprungsland anges, används den mest gynnade nationen (MFN) rate. |
items.description_customs VALFRI | Den föreslagna beskrivningen av varor för den kommersiella fakturan. Denna beskrivning kommer vanligtvis att skilja sig från en detaljhandelsbeskrivning och kommer typiskt att inkludera en allmän beskrivning av vad det är, vad det är gjort av och vad det används för. |
items.description_retail VALFRI | Detaljhandelsbeskrivningen av varan. |
items.detail VALFRI | Ytterligare funktioner, attribut eller beskrivningar av varan. |
items.dimensions VALFRI | Storleken på försändelsen. Detta rekommenderas för att få de mest exakta offerterna till länder där tullar påverkas av varans dimensioner. hash |
items.dimensions.height VALFRI | Ett decimaltal för höjden på varan. |
items.dimensions.length VALFRI | Ett decimaltal för längden på varan. |
items.dimensions.unit VALFRI | Måttenhet för varans dimensioner. Möjliga värden är inch, centimeter, millimeter, och null. När null, kommer inch att användas. |
items.dimensions.width VALFRI | Ett decimaltal för bredden på varan. |
items.duty_tax_fee_free VALFRI | En sträng för att specificera om varan inte ska inkluderas i landed cost beräkningen. När exclude skickas i begäran, kommer varan att visas i removed_items i API-svaret. |
items.hs_code VALFRI | Varans HS-kod, 2 till 10 siffror. |
items.image_url VALFRI | Bildens URL. |
items.quantity KRÄVD | Ett heltal med kvantiteten av varan. |
items.upc_code VALFRI | UPC-kodsträngen för varan. |
items.weight VALFRI | Ett decimaltal för vikten av varan. |
items.weight_unit VALFRI | Måttenhet för vikten. Möjliga värden är pound, ounce, kilogram, och null. När null, kommer pound att användas. |
landed_cost VALFRI | Typen av begäran för en landed cost. Möjliga värden inkluderar delivery_duty_paid och delivery_duty_unpaid. Avgifterna för en landed cost kan skilja sig, oavsett om den skickas DDP eller DDU. Om null, kommer en DDP-begäran att antas. Om en DDP-begäran görs och DDP inte är tillgängligt, kommer ett 400-fel att returneras med ett meddelande som anger att DDP inte är tillgängligt för den angivna servicenivån. DDP och DDU är vanligtvis båda tillgängliga inom varje servicenivå, så vänligen säkerställ att detta kan konfigureras på en per-servicenivå basis istället för kontonivå. |
sale_type VALFRI | En indikator på typen av försäljning. Möjliga värden inkluderar not_for_resale for_resale. Om null kommer en not_for_resale begäran att antas. |
ship_from_country KRÄVD | Strängen för avsändningslandet, representerat av en tvåbokstavskod enligt ISO. |
ship_to KRÄVD | Leveransadressen. hash |
ship_to.city VALFRI* | En sträng för adressens stad, ort, distrikt, förort eller by för kunden. Beroende på importlandet kan detta fält vara KRÄVD. |
ship_to.country KRÄVD | En sträng för destinationslandet där bankkontot är beläget, representerat av en tvåbokstavskod enligt ISO. |
ship_to.postal_code VALFRI* | En sträng för destinationspostnumret. Detta fält kan vara nödvändigt när frakten sker mellan Nordirland och Europeiska unionen. |
ship_to.state VALFRI* | En sträng för destinationsstatens kod när den är tillgänglig. Om importlandet är Brasilien eller Kanada, är detta fält obligatoriskt. |
shipping KRÄVD | Fraktuppgifterna såsom belopp, rabattbelopp och servicenivå med transportören. hash |
shipping.amount KRÄVD | Ett decimaltal för den totala summan av fraktkostnaderna, i dollar och cent. |
shipping.amount_discount VALFRI | Ett decimaltal för det belopp av rabatten som gäller för frakten. |
shipping.service_level KRÄVD | Servicenivån med transportören. Se transportdokumentationen för hela listan över tillgängliga servicenivåer per transportör. |
*Detta fält är valfritt beroende på adressfältens krav för importlandet.
Exempelbegäran
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"
}
Exempel på svar
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"
}
]
}
Begär en landed cost
Hitta nyckel/värde-par i en landed cost begäran.Även om Zonos Landed Cost kan ge en exakt landed cost baserat enbart på beskrivningen av en artikel, desto mer information som tillhandahålls, desto mer exakt blir landed cost offerten. Nedan finns KRÄVDA och VALFRIA indata, men det rekommenderas att fylla i så många VALFRIA fält som möjligt.