DOCS

Request a landed cost

/

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.

Ein HS-Code wird dringend empfohlen. Im Gegensatz zum grundlegenden landed cost enthält der vollständige landed cost detaillierte Informationen zu den Zollsätzen pro HS-Code.

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.

FeldHinweise
Währung ERFORDERLICHDer Basiswährungsstring, dargestellt durch einen dreistelligen ISO-Code.
Rabatte OPTIONALDie Informationen zu etwaigen Rabatten, einschließlich der ID, des Betrags und eventueller Details.
Rabatte.id OPTIONALDer eindeutige Rabatt-Identifier für den Händler oder Exporteur.
Rabatte.betrag OPTIONALEine Dezimalzahl mit dem Betrag des Rabatts, in Dollar und Cents.
Rabatte.detail OPTIONALZusätzliche Funktionen, Attribute oder Beschreibungen des Rabatts.
Artikel ERFORDERLICHDie Liste der exportierten Artikel. hash
Artikel.id ERFORDERLICHDer eindeutige Artikel-Identifier für den Händler oder Exporteur.
Artikel.betrag ERFORDERLICHEine Dezimalzahl mit dem Gesamtbetrag eines einzelnen Artikels, in Dollar und Cents.
Artikel.betrag_rabatt OPTIONALDer Betrag des Rabatts, der auf den Artikel angewendet wird.
Artikel.marke OPTIONALDie Marke des Artikels, z.B. "Leatherman".
Artikel.kategorie OPTIONALKategorisierungsbeschreibung des Artikels, z.B. "Kleidung".
Artikel.farbe OPTIONALFarbe des Artikels.
Artikel.ursprungsland OPTIONALDas 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 OPTIONALDie 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 OPTIONALDie Einzelhandelsbeschreibung des Artikels.
Artikel.detail OPTIONALZusätzliche Funktionen, Attribute oder Beschreibungen des Artikels.
Artikel.abmessungen OPTIONALDie 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 OPTIONALEine Dezimalzahl für die Höhe des Artikels.
Artikel.abmessungen.länge OPTIONALEine Dezimalzahl für die Länge des Artikels.
Artikel.abmessungen.einheit OPTIONALDie Maßeinheit für die Artikelabmessungen. Mögliche Werte sind Zoll, Zentimeter, Millimeter und null. Bei null wird Zoll verwendet.
Artikel.abmessungen.breite OPTIONALEine Dezimalzahl für die Breite des Artikels.
Artikel.zoll_steuer_gebührenfrei OPTIONALEin 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 OPTIONALArtikel HS-Code, 2 bis 10 Ziffern.
Artikel.bild_url OPTIONALDie Bild-URL.
Artikel.menge ERFORDERLICHEine Ganzzahl mit der Menge des Artikels.
Artikel.upc_code OPTIONALDer UPC-Code-String für den Artikel.
Artikel.gewicht OPTIONALEine Dezimalzahl für das Gewicht des Artikels.
Artikel.gewicht_einheit OPTIONALDer Maßeinheitsstring für das Gewicht. Mögliche Werte sind Pfund, Unze, Kilogramm und null. Bei null wird Pfund verwendet.
landed_cost OPTIONALDer 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 OPTIONALEin 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 ERFORDERLICHDer Versandland-String, dargestellt durch einen Zwei-Buchstaben-ISO-Code.
ship_to ERFORDERLICHDie 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 ERFORDERLICHEin 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 ERFORDERLICHDie Versanddetails wie Betrag, Rabattbetrag und Servicestufe beim Spediteur. hash
shipping.amount ERFORDERLICHEin Dezimalwert für die Gesamtsumme der Versandkosten, in Dollar und Cent.
shipping.amount_discount OPTIONALEin Dezimalwert für den Rabattbetrag, der auf den Versand angewendet wird.
shipping.service_level ERFORDERLICHDer 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"
    }
  ]
}

War diese Seite hilfreich?