Trouvez les paires clé/valeur d'une requête de landed cost.
Bien que Zonos Landed Cost puisse fournir un landed cost précis à partir de la seule description d'un article, plus vous fournissez d'informations, plus la soumission de landed cost sera précise. Vous trouverez ci-dessous les entrées REQUIRED et OPTIONAL, mais nous vous recommandons de remplir le plus grand nombre possible de champs OPTIONAL.
Un code HS est fortement recommandé. Contrairement au landed cost de base, le landed cost complet inclut le détail, au niveau de l'article, des taux de droits par code HS.
Les renseignements relatifs aux rabais, y compris l'identifiant, le montant et tout détail.
discounts.id OPTIONAL
L'identifiant unique du rabais pour le marchand ou l'exportateur.
discounts.amount OPTIONAL
Un nombre décimal indiquant le montant du rabais, en dollars et en cents.
discounts.detail OPTIONAL
Caractéristiques, attributs ou descriptions supplémentaires du rabais.
items REQUIRED
La liste des articles exportés. hash
items.id REQUIRED
L'identifiant unique de l'article pour le marchand ou l'exportateur.
items.amount REQUIRED
Un nombre décimal indiquant le total d'un seul article, en dollars et en cents.
items.amount_discount OPTIONAL
Le montant du rabais qui s'applique à l'article.
items.brand OPTIONAL
La marque de l'article, par exemple Leatherman.
items.category OPTIONAL
La description de la catégorie de l'article, par exemple Vêtements.
items.color OPTIONAL
La couleur de l'article.
items.country_of_origin OPTIONAL
Le pays de fabrication ou de production, représenté par un code ISO à deux lettres. Ce champ est recommandé pour obtenir les soumissions les plus précises. Si aucun pays d'origine n'est reçu, le taux de la nation la plus favorisée (NPF) est appliqué.
items.description_customs OPTIONAL
La description suggérée des marchandises pour la facture commerciale. Cette description diffère habituellement de la description de vente au détail et comprend généralement une description générale de l'article, de sa composition et de son usage.
items.description_retail OPTIONAL
La description de vente au détail de l'article.
items.detail OPTIONAL
Caractéristiques, attributs ou descriptions supplémentaires de l'article.
items.dimensions OPTIONAL
La taille de l'envoi. Ce champ est recommandé pour obtenir les soumissions les plus précises vers les pays où les tarifs douaniers dépendent des dimensions de l'article. hash
items.dimensions.height OPTIONAL
Un nombre décimal pour la hauteur de l'article.
items.dimensions.length OPTIONAL
Un nombre décimal pour la longueur de l'article.
items.dimensions.unit OPTIONAL
L'unité de mesure des dimensions de l'article. Les valeurs possibles sont inch, centimeter, millimeter et null. Si la valeur est null, inch est utilisé.
items.dimensions.width OPTIONAL
Un nombre décimal pour la largeur de l'article.
items.duty_tax_fee_free OPTIONAL
Une chaîne qui indique si l'article doit être exclu du calcul du landed cost. Lorsque exclude est envoyé dans la requête, l'article apparaît dans removed_items dans la réponse de l'API.
items.hs_code OPTIONAL
Le code HS de l'article, de 2 à 10 chiffres.
items.image_url OPTIONAL
L'URL de l'image.
items.quantity REQUIRED
Un entier indiquant la quantité de l'article.
items.upc_code OPTIONAL
La chaîne du code UPC de l'article.
items.weight OPTIONAL
Un nombre décimal pour le poids de l'article.
items.weight_unit OPTIONAL
La chaîne de l'unité de mesure du poids. Les valeurs possibles sont pound, ounce, kilogram et null. Si la valeur est null, pound est utilisé.
landed_cost OPTIONAL
Le type de requête de landed cost. Les valeurs possibles comprennent delivery_duty_paid et delivery_duty_unpaid. Les frais d'un landed cost peuvent différer selon que l'envoi est DDP ou DDU. Si la valeur est null, une requête DDP est présumée. Si une requête DDP est faite et que le DDP n'est pas offert, une erreur 400 est renvoyée avec un message indiquant que le DDP n'est pas offert pour le niveau de service fourni. Le DDP et le DDU sont généralement tous deux offerts pour chaque niveau de service; assurez-vous donc que ce réglage peut être configuré par niveau de service plutôt qu'au niveau du compte.
sale_type OPTIONAL
Un indicateur du type de vente. Les valeurs possibles comprennent not_for_resale et for_resale. Si la valeur est null, une requête not_for_resale est présumée.
Une chaîne pour la ville, le village, le district, la banlieue ou la localité de l'adresse du client. Selon le pays d'importation, ce champ peut être REQUIRED.
ship_to.country REQUIRED
Une chaîne pour le pays de destination dans lequel se trouve le compte bancaire, représenté par un code ISO à deux lettres.
ship_to.postal_code OPTIONAL*
Une chaîne pour le code postal de destination. Ce champ peut être requis lorsque l'envoi se fait entre l'Irlande du Nord et l'Union européenne.
ship_to.state OPTIONAL*
Une chaîne pour le code de l'État ou de la province de destination, lorsqu'il est disponible. Si le pays d'importation est le Brésil ou le Canada, ce champ est requis.
shipping REQUIRED
Les détails de l'expédition, comme le montant, le montant du rabais et le niveau de service du transporteur. hash
shipping.amount REQUIRED
Un nombre décimal pour la somme totale des frais d'expédition, en dollars et en cents.
shipping.amount_discount OPTIONAL
Un nombre décimal pour le montant du rabais qui s'applique à l'expédition.
shipping.service_level REQUIRED
Le service_level du transporteur. Consultez la documentation des transporteurs pour obtenir la liste complète des niveaux de service offerts par transporteur.
*Ce champ est facultatif selon les exigences relatives aux champs d'adresse du pays d'importation.
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",
Demander un landed cost
Demander un landed cost
Trouvez les paires clé/valeur d'une requête de landed cost.Bien que Zonos Landed Cost puisse fournir un landed cost précis à partir de la seule description d'un article, plus vous fournissez d'informations, plus la soumission de landed cost sera précise. Vous trouverez ci-dessous les entrées REQUIRED et OPTIONAL, mais nous vous recommandons de remplir le plus grand nombre possible de champs OPTIONAL.
Attributs
Paires clé/valeur JSON dans le corps de la requête
POST |
https://api.zonos.com/v1/landed_costEN-TÊTE
zonos-version: 2019-11-21currencyREQUIREDdiscountsOPTIONALdiscounts.idOPTIONALdiscounts.amountOPTIONALdiscounts.detailOPTIONALitemsREQUIREDhashitems.idREQUIREDitems.amountREQUIREDitems.amount_discountOPTIONALitems.brandOPTIONALitems.categoryOPTIONALitems.colorOPTIONALitems.country_of_originOPTIONALitems.description_customsOPTIONALitems.description_retailOPTIONALitems.detailOPTIONALitems.dimensionsOPTIONALhashitems.dimensions.heightOPTIONALitems.dimensions.lengthOPTIONALitems.dimensions.unitOPTIONALinch,centimeter,millimeteretnull. Si la valeur estnull,inchest utilisé.items.dimensions.widthOPTIONALitems.duty_tax_fee_freeOPTIONALexcludeest envoyé dans la requête, l'article apparaît dansremoved_itemsdans la réponse de l'API.items.hs_codeOPTIONALitems.image_urlOPTIONALitems.quantityREQUIREDitems.upc_codeOPTIONALitems.weightOPTIONALitems.weight_unitOPTIONALpound,ounce,kilogrametnull. Si la valeur estnull,poundest utilisé.landed_costOPTIONALdelivery_duty_paidetdelivery_duty_unpaid. Les frais d'un landed cost peuvent différer selon que l'envoi est DDP ou DDU. Si la valeur estnull, une requête DDP est présumée. Si une requête DDP est faite et que le DDP n'est pas offert, une erreur 400 est renvoyée avec un message indiquant que le DDP n'est pas offert pour le niveau de service fourni. Le DDP et le DDU sont généralement tous deux offerts pour chaque niveau de service; assurez-vous donc que ce réglage peut être configuré par niveau de service plutôt qu'au niveau du compte.sale_typeOPTIONALnot_for_resaleetfor_resale. Si la valeur estnull, une requêtenot_for_resaleest présumée.ship_from_countryREQUIREDship_toREQUIREDhashship_to.cityOPTIONAL*ship_to.countryREQUIREDship_to.postal_codeOPTIONAL*ship_to.stateOPTIONAL*shippingREQUIREDhashshipping.amountREQUIREDshipping.amount_discountOPTIONALshipping.service_levelREQUIRED{"currency": "USD","discounts": [{"id": "sale124","amount": 43,"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.webp","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"}Cette page vous a-t-elle été utile?