Trouvez les paires clé/valeur dans une requête Landed Cost.
Bien que Zonos Landed Cost puisse fournir un Landed Cost précis basé uniquement sur la description d'un article, plus vous fournissez d'informations, plus le devis Landed Cost sera précis. Vous trouverez ci-dessous les entrées REQUIRED et OPTIONAL, mais nous recommandons de renseigner autant de champs OPTIONAL que possible.
Un code HS est fortement recommandé. Contrairement au Landed Cost de base, le Landed Cost complet inclura le détail au niveau de l'article des taux de droits par code HS.
Les informations relatives à toute remise, y compris l'identifiant, le montant et les détails.
discounts.id OPTIONAL
L'identifiant unique de remise pour le marchand ou l'exportateur.
discounts.amount OPTIONAL
Une valeur décimale indiquant le montant de la remise, en dollars et centimes.
discounts.detail OPTIONAL
Caractéristiques, attributs ou descriptions supplémentaires de la remise.
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
Une valeur décimale indiquant le total d'un seul article, en dollars et centimes.
items.amount_discount OPTIONAL
Le montant de la remise applicable à l'article.
items.brand OPTIONAL
La marque de l'article, par ex. Leatherman.
items.category OPTIONAL
Description de catégorie de l'article, par ex. Clothing.
items.color OPTIONAL
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 devis les plus précis. Si aucun pays d'origine n'est reçu, le taux de la nation la plus favorisée (NPF, ou MFN en anglais) est appliqué.
items.description_customs OPTIONAL
La description suggérée des marchandises pour la facture commerciale. Cette description diffère généralement d'une description de vente au détail et inclut typiquement 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'expédition. Ce champ est recommandé pour obtenir les devis les plus précis vers les pays où les droits de douane dépendent des dimensions de l'article. hash
items.dimensions.height OPTIONAL
Une valeur décimale pour la hauteur de l'article.
items.dimensions.length OPTIONAL
Une valeur décimale pour la longueur de l'article.
items.dimensions.unit OPTIONAL
L'unité de mesure pour les dimensions de l'article. Les valeurs possibles sont inch, centimeter, millimeter et null. Lorsque la valeur est null, inch sera utilisé.
items.dimensions.width OPTIONAL
Une valeur décimale pour la largeur de l'article.
items.duty_tax_fee_free OPTIONAL
Une chaîne pour spécifier si l'article ne doit pas être inclus dans le calcul du Landed Cost. Lorsque exclude est envoyé dans la requête, l'article apparaîtra dans removed_items dans la réponse de l'API.
items.hs_code OPTIONAL
Code HS de l'article, 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 de code UPC pour l'article.
items.weight OPTIONAL
Une valeur décimale pour le poids de l'article.
items.weight_unit OPTIONAL
La chaîne d'unité de mesure pour le poids. Les valeurs possibles sont pound, ounce, kilogram et null. Lorsque la valeur est null, pound sera utilisé.
landed_cost OPTIONAL
Le type de requête pour un Landed Cost. Les valeurs possibles incluent delivery_duty_paid et delivery_duty_unpaid. Les frais d'un Landed Cost peuvent différer selon qu'il est envoyé en DDP ou DDU. Si null, une requête DDP sera supposée. Si une requête DDP est effectuée et que le DDP n'est pas disponible, une erreur 400 sera renvoyée avec un message indiquant que le DDP n'est pas disponible pour le niveau de service fourni. Le DDP et le DDU sont généralement tous deux disponibles dans chaque niveau de service ; veuillez vous assurer que cela 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 incluent not_for_resalefor_resale. Si null, une requête not_for_resale sera supposée.
Une chaîne pour la ville, la commune, le district, la banlieue ou le village 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 le compte bancaire est situé, représentée 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'expédition 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 d'expédition tels que le montant, le montant de remise et le niveau de service avec le transporteur. hash
shipping.amount REQUIRED
Une valeur décimale pour le total des frais d'expédition, en dollars et centimes.
shipping.amount_discount OPTIONAL
Une valeur décimale pour le montant de la remise applicable à l'expédition.
shipping.service_level REQUIRED
Le service_level avec le transporteur. Consultez la documentation transporteurs pour la liste complète des niveaux de service disponibles par transporteur.
*Ce champ est optionnel selon les exigences de champs d'adresse pour le 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 dans une requête Landed Cost.
Bien que Zonos Landed Cost puisse fournir un Landed Cost précis basé uniquement sur la description d'un article, plus vous fournissez d'informations, plus le devis Landed Cost sera précis. Vous trouverez ci-dessous les entrées REQUIRED et OPTIONAL, mais nous recommandons de renseigner autant de champs OPTIONAL que possible.
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. Lorsque la valeur estnull,inchsera utilisé.items.dimensions.widthOPTIONALitems.duty_tax_fee_freeOPTIONALexcludeest envoyé dans la requête, l'article apparaîtra dansremoved_itemsdans la réponse de l'API.items.hs_codeOPTIONALitems.image_urlOPTIONALitems.quantityREQUIREDitems.upc_codeOPTIONALitems.weightOPTIONALitems.weight_unitOPTIONALpound,ounce,kilogrametnull. Lorsque la valeur estnull,poundsera utilisé.landed_costOPTIONALdelivery_duty_paidetdelivery_duty_unpaid. Les frais d'un Landed Cost peuvent différer selon qu'il est envoyé en DDP ou DDU. Sinull, une requête DDP sera supposée. Si une requête DDP est effectuée et que le DDP n'est pas disponible, une erreur 400 sera renvoyée avec un message indiquant que le DDP n'est pas disponible pour le niveau de service fourni. Le DDP et le DDU sont généralement tous deux disponibles dans chaque niveau de service ; veuillez vous assurer que cela peut être configuré par niveau de service plutôt qu'au niveau du compte.sale_typeOPTIONALnot_for_resalefor_resale. Sinull, une requêtenot_for_resalesera supposé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 a-t-elle été utile?