DOCS
Landed Cost•
StartpaginaAPI-referentie Landed Cost REST API Een Landed Cost aanvragen

Een Landed Cost aanvragen

Vind de sleutel/waarde-paren in een Landed Cost-aanvraag.

Hoewel Zonos Landed Cost een nauwkeurige Landed Cost kan bieden op basis van alleen de beschrijving van een item, wordt de Landed Cost-quote nauwkeuriger naarmate er meer informatie wordt verstrekt. Hieronder staan de REQUIRED en OPTIONAL invoervelden; het wordt aanbevolen om zoveel mogelijk OPTIONAL velden in te vullen.

Een HS-code wordt sterk aanbevolen. In tegenstelling tot de basic Landed Cost bevat de complete Landed Cost detailgegevens op itemniveau van de tariefpercentages per HS-code.

Attributen 

JSON-sleutel/waarde-paren in de body van de aanvraag

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

HEADER zonos-version: 2019-11-21

De bovenstaande header is een verplichte invoer om deze Landed Cost-aanvraag succesvol te kunnen voltooien.

Field↕Notes↕
currency REQUIREDDe tekenreeks voor de basisvaluta, weergegeven door een ISO-code van drie letters.
discounts OPTIONALDe informatie met betrekking tot eventuele kortingen, waaronder de id, het bedrag en eventuele details.
discounts.id OPTIONALDe unieke kortingsidentificatie voor de handelaar of exporteur.
discounts.amount OPTIONALEen decimaal getal met het kortingsbedrag, in dollars en centen.
discounts.detail OPTIONALExtra kenmerken, attributen of beschrijvingen van de korting.
items REQUIREDDe lijst met geëxporteerde items. hash
items.id REQUIREDDe unieke itemidentificatie voor de handelaar of exporteur.
items.amount REQUIREDEen decimaal getal met het totaal van één afzonderlijk item, in dollars en centen.
items.amount_discount OPTIONALHet kortingsbedrag dat op het item van toepassing is.
items.brand OPTIONALHet merk van het item, bijv. Leatherman.
items.category OPTIONALCategoriebeschrijving van het item, bijv. Clothing.
items.color OPTIONALKleur van het item.
items.country_of_origin OPTIONALHet land van fabricage of productie, weergegeven door een ISO-code van twee letters. Dit wordt aanbevolen voor de meest nauwkeurige quotes. Als er geen land van herkomst wordt ontvangen, wordt het Most Favored Nation (MFN)-tarief gebruikt.
items.description_customs OPTIONALDe voorgestelde omschrijving van de goederen voor de handelsfactuur. Deze omschrijving verschilt doorgaans van een retailomschrijving en bevat meestal een algemene beschrijving van wat het is, waaruit het is gemaakt en waarvoor het wordt gebruikt.
items.description_retail OPTIONALDe retailomschrijving van het item.
items.detail OPTIONALExtra kenmerken, attributen of beschrijvingen van het item.
items.dimensions OPTIONALDe afmetingen van de zending. Dit wordt aanbevolen om de meest nauwkeurige quotes te krijgen voor landen waar tarieven worden beïnvloed door de afmetingen van het item. hash
items.dimensions.height OPTIONALEen decimaal getal voor de hoogte van het item.
items.dimensions.length OPTIONALEen decimaal getal voor de lengte van het item.
items.dimensions.unit OPTIONALDe meeteenheid voor de afmetingen van het item. Mogelijke waarden zijn inch, centimeter, millimeter en null. Wanneer null, wordt inch gebruikt.
items.dimensions.width OPTIONALEen decimaal getal voor de breedte van het item.
items.duty_tax_fee_free OPTIONALEen tekenreeks om aan te geven of het item niet moet worden meegenomen in de Landed Cost-berekening. Wanneer exclude in de aanvraag wordt verzonden, verschijnt het item in removed_items in het API-antwoord.
items.hs_code OPTIONALHS-code van het item, 2 tot 10 cijfers.
items.image_url OPTIONALDe afbeelding-URL.
items.quantity REQUIREDEen geheel getal met de hoeveelheid van het item.
items.upc_code OPTIONALDe UPC-codetekenreeks voor het item.
items.weight OPTIONALEen decimaal getal voor het gewicht van het item.
items.weight_unit OPTIONALDe tekenreeks voor de meeteenheid van het gewicht. Mogelijke waarden zijn pound, ounce, kilogram en null. Wanneer null, wordt pound gebruikt.
landed_cost OPTIONALHet type aanvraag voor een Landed Cost. Mogelijke waarden zijn delivery_duty_paid en delivery_duty_unpaid. De kosten voor een Landed Cost kunnen verschillen naargelang deze als DDP of DDU wordt verzonden. Als null, wordt een DDP-aanvraag aangenomen. Als een DDP-aanvraag wordt gedaan en DDP niet beschikbaar is, wordt een 400-fout geretourneerd met een melding dat DDP niet beschikbaar is voor het opgegeven service level. DDP en DDU zijn doorgaans beide beschikbaar binnen elk service level, zorg er daarom voor dat dit per service level kan worden geconfigureerd in plaats van op accountniveau.
sale_type OPTIONALEen indicator van het type verkoop. Mogelijke waarden zijn not_for_resale for_resale. Als null, wordt een not_for_resale-aanvraag aangenomen.
ship_from_country REQUIREDDe tekenreeks voor het land van verzending, weergegeven door een ISO-code van twee letters.
ship_to REQUIREDHet bestemmingsadres. hash
ship_to.city OPTIONAL*Een tekenreeks voor de stad, plaats, wijk, buitenwijk of dorp van het adres van de klant. Afhankelijk van het land van invoer kan dit veld REQUIRED zijn.
ship_to.country REQUIREDEen tekenreeks voor het bestemmingsland waarin de bankrekening zich bevindt, weergegeven door een ISO-code van twee letters.
ship_to.postal_code OPTIONAL*Een tekenreeks voor de postcode van de bestemming. Dit veld kan vereist zijn wanneer de zending plaatsvindt tussen Noord-Ierland en de Europese Unie.
ship_to.state OPTIONAL*Een tekenreeks voor de deelstaatcode van de bestemming, indien beschikbaar. Als het land van invoer Brazilië of Canada is, is dit veld vereist.
shipping REQUIREDDe verzendgegevens, zoals het bedrag, het kortingsbedrag en het service level bij de vervoerder. hash
shipping.amount REQUIREDEen decimaal getal voor het totaalbedrag van de verzendkosten, in dollars en centen.
shipping.amount_discount OPTIONALEen decimaal getal voor het kortingsbedrag dat van toepassing is op de verzending.
shipping.service_level REQUIREDHet service_level bij de vervoerder. Raadpleeg de documentatie van de vervoerder voor de volledige lijst met beschikbare service levels per vervoerder.

*Dit veld is optioneel, afhankelijk van de adresveldvereisten voor het land van invoer.

1{
2 "currency": "USD",
3 "discounts": [
4 {
5 "id": "sale124",
6 "amount": 43,
7 "detail": null
8 }
9 ],
10 "items": [
11 {
12 "id": "294395",
13 "amount": 75,
14 "amount_discount": 0,
15 "brand": null,
16 "category": "Women's Clothing",
17 "color": null,
18 "country_of_origin": "FR",
19 "description_customs": null,
20 "description_retail": "Hoka One Running Shoe - Women's",
21 "detail": null,
22 "dimensions": {
23 "height": 4,
24 "length": 6,
25 "unit": "inch",
26 "width": 11
27 },
28 "duty_tax_fee_free": null,
29 "hs_code": "6116.10.00",
30 "image_url": "https://zonos.com/images/handbag.webp",
31 "quantity": 1,
32 "upc_code": null,
33 "weight": 10,
34 "weight_unit": "pound"
35 },
36 {
37 "id": "294396",
38 "amount": 15,
39 "country_of_origin": "CN",
40 "country_of_origin_source": "account_default",
41 "description_customs": "Men's t-shirt 100% polyester",
42 "description_retail": "Galaxy Quest Men's Tee Blue",
43 "detail": null,
44 "dimensions": {
45 "height": 4,
46 "lenght": 6,
47 "unit": "inch",
48 "width": 11
49 },
50 "duty_tax_fee_free": "exclude",
51 "hs_code": "6217.10",
52 "image_url": null,
53 "note": null,
54 "quantity": 1,
55 "upc_code": null,
56 "weight": 1,
57 "weight_unit": "pound"
58 }
59 ],
60 "landed_cost": "delivery_duty_paid",
61 "sale_type": "not_for_resale",
62 "ship_from_country": "US",
63 "ship_to": {
64 "city": "Campinas",
65 "country": "BR",
66 "postal_code": "75828-000",
67 "state": "SP"
68 },
69 "shipping": {
70 "amount": 14.23,
71 "amount_discount": 0,
72 "service_level": "ups_express_saver"
73 },
74 "tariff_rate": "zonos_preferred"
75}

Was deze pagina nuttig?

Krijg ondersteuning·Juridische documenten·© 2026 Zonos
Op deze pagina:
  • Een Landed Cost aanvragen
  • Attributen