Attribute
JSON-Schlüssel/Wert-Paare im Anfragekörper
POST | https://api.zonos.com/v1/landed_cost
HEADER zonos-version: 2019-11-21
Der obige Header ist eine erforderliche Eingabe für diesen landed cost-Antrag, um erfolgreich abgeschlossen zu werden.
Feld | Hinweise |
---|---|
Währung ERFORDERLICH | Der Basiswährungsstring, dargestellt durch einen dreistelligen ISO-Code. |
Rabatte OPTIONAL | Die Informationen zu etwaigen Rabatten, einschließlich der ID, des Betrags und eventueller Details. |
Rabatte.id OPTIONAL | Der eindeutige Rabatt-Identifier für den Händler oder Exporteur. |
Rabatte.betrag OPTIONAL | Eine Dezimalzahl mit dem Betrag des Rabatts, in Dollar und Cents. |
Rabatte.detail OPTIONAL | Zusätzliche Funktionen, Attribute oder Beschreibungen des Rabatts. |
Artikel ERFORDERLICH | Die Liste der exportierten Artikel. hash |
Artikel.id ERFORDERLICH | Der eindeutige Artikel-Identifier für den Händler oder Exporteur. |
Artikel.betrag ERFORDERLICH | Eine Dezimalzahl mit dem Gesamtbetrag eines einzelnen Artikels, in Dollar und Cents. |
Artikel.betrag_rabatt OPTIONAL | Der Betrag des Rabatts, der auf den Artikel angewendet wird. |
Artikel.marke OPTIONAL | Die Marke des Artikels, z.B. "Leatherman". |
Artikel.kategorie OPTIONAL | Kategorisierungsbeschreibung des Artikels, z.B. "Kleidung". |
Artikel.farbe OPTIONAL | Farbe des Artikels. |
Artikel.ursprungsland OPTIONAL | Das Herstellungs- oder Produktionsland, dargestellt durch einen zweistelligen ISO-Code. Dies wird für genaueste Angebote empfohlen. Wenn kein Ursprungsland angegeben wird, wird der Meistbegünstigungsstatus (MFN) rate verwendet. |
Artikel.beschreibung_zoll OPTIONAL | Die vorgeschlagene Warenbeschreibung für die Handelsrechnung. Diese Beschreibung wird in der Regel von der Einzelhandelsbeschreibung abweichen und enthält typischerweise eine allgemeine Beschreibung dessen, was es ist, woraus es besteht und wofür es verwendet wird. |
Artikel.beschreibung_einzelhandel OPTIONAL | Die Einzelhandelsbeschreibung des Artikels. |
Artikel.detail OPTIONAL | Zusätzliche Funktionen, Attribute oder Beschreibungen des Artikels. |
Artikel.abmessungen OPTIONAL | Die Größe der Sendung. Dies wird empfohlen, um genaueste Angebote in Ländern zu erhalten, in denen die Zölle von den Abmessungen des Artikels beeinflusst werden. hash |
Artikel.abmessungen.höhe OPTIONAL | Eine Dezimalzahl für die Höhe des Artikels. |
Artikel.abmessungen.länge OPTIONAL | Eine Dezimalzahl für die Länge des Artikels. |
Artikel.abmessungen.einheit OPTIONAL | Die Maßeinheit für die Artikelabmessungen. Mögliche Werte sind Zoll , Zentimeter , Millimeter und null . Bei null wird Zoll verwendet. |
Artikel.abmessungen.breite OPTIONAL | Eine Dezimalzahl für die Breite des Artikels. |
Artikel.zoll_steuer_gebührenfrei OPTIONAL | Ein String, um anzugeben, ob der Artikel nicht in die landed cost Berechnung einbezogen werden soll. Wenn exclude in der Anfrage gesendet wird, wird der Artikel in removed_items in der API-Antwort angezeigt. |
Artikel.hs_code OPTIONAL | Artikel HS-Code, 2 bis 10 Ziffern. |
Artikel.bild_url OPTIONAL | Die Bild-URL. |
Artikel.menge ERFORDERLICH | Eine Ganzzahl mit der Menge des Artikels. |
Artikel.upc_code OPTIONAL | Der UPC-Code-String für den Artikel. |
Artikel.gewicht OPTIONAL | Eine Dezimalzahl für das Gewicht des Artikels. |
Artikel.gewicht_einheit OPTIONAL | Der Maßeinheitsstring für das Gewicht. Mögliche Werte sind Pfund , Unze , Kilogramm und null . Bei null wird Pfund verwendet. |
landed_cost OPTIONAL | Der Typ der Anfrage für die landed cost. Mögliche Werte sind delivery_duty_paid und delivery_duty_unpaid . Die Gebühren für einen landed cost können je nachdem, ob er als DDP oder DDU versendet wird, unterschiedlich sein. Wenn null , wird eine DDP-Anfrage angenommen. Wenn eine DDP-Anfrage gestellt wird und DDP nicht verfügbar ist, wird ein 400-Fehler mit einer Meldung zurückgegeben, die besagt, dass DDP für den bereitgestellten Servicestandard nicht verfügbar ist.DDP und DDU sind in der Regel innerhalb jedes Servicestandards verfügbar, daher stellen Sie bitte sicher, dass dies auf Basis des Servicestandards und nicht auf Kontoebene konfiguriert werden kann. |
sale_type OPTIONAL | Ein Indikator für den Verkaufstyp. Mögliche Werte sind not_for_resale und for_resale . Wenn null , wird eine not_for_resale -Anfrage angenommen. |
ship_from_country ERFORDERLICH | Der Versandland-String, dargestellt durch einen Zwei-Buchstaben-ISO-Code. |
ship_to ERFORDERLICH | Die Zieladresse. hash |
ship_to.city OPTIONAL* | Ein String für die Adressstadt, Stadt, Bezirk, Vorort oder Dorf des Kunden. Je nach Einfuhrland kann dieses Feld ERFORDERLICH sein. |
ship_to.country ERFORDERLICH | Ein String für das Zielland, in dem sich das Bankkonto befindet, dargestellt durch einen Zwei-Buchstaben-ISO-Code. |
ship_to.postal_code OPTIONAL* | Ein String für die Ziel-Postleitzahl. Dieses Feld kann erforderlich sein, wenn die Sendung zwischen Nordirland und der Europäischen Union erfolgt. |
ship_to.state OPTIONAL* | Ein String für den Ziel-Bundeslandcode, wenn verfügbar. Wenn das Einfuhrland Brasilien oder Kanada ist, ist dieses Feld erforderlich. |
shipping ERFORDERLICH | Die Versanddetails wie Betrag, Rabattbetrag und Servicestufe beim Spediteur. hash |
shipping.amount ERFORDERLICH | Ein Dezimalwert für die Gesamtsumme der Versandkosten, in Dollar und Cent. |
shipping.amount_discount OPTIONAL | Ein Dezimalwert für den Rabattbetrag, der auf den Versand angewendet wird. |
shipping.service_level ERFORDERLICH | Der Servicestandard beim Spediteur. Siehe die Spediteur-Dokumentation für die vollständige Liste der verfügbaren Servicestufen nach Spediteur. |
*Dieses Feld ist optional, abhängig von den Adressfeldanforderungen für das Einfuhrland.
Beispielanfrage
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"
}
Beispielantwort
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"
}
]
}
Beantragen Sie einen landed cost
Finden Sie die Schlüssel/Wert-Paare in einem landed cost-Antrag.
Obwohl Zonos Landed Cost in der Lage ist, einen genauen landed cost allein auf der Beschreibung eines Artikels basierend bereitzustellen, wird das landed cost-Angebot genauer, je mehr Informationen bereitgestellt werden. Im Folgenden sind ERFORDERLICHE und OPTIONALE Eingaben aufgeführt, aber es wird empfohlen, so viele OPTIONALE Felder wie möglich auszufüllen.