Attributs
| Field↕ | Notes↕ |
|---|---|
id STRING | L'identifiant unique de l'objet. L'identifiant de l'objet Landed Cost est toujours préfixé par ldct. |
amount_subtotal HASH | Total du coût rendu. Si vous l'utilisez pour un checkout e-commerce, nous recommandons d'utiliser ces totaux pour les afficher à l'utilisateur final. Ces totaux permettent une intégration plus simple sans avoir à additionner les droits, taxes ou frais au niveau de l'article et de l'expédition. Des détails supplémentaires sont disponibles dans l'objet landed cost. Voir les attributs enfants ci-dessous. |
amount_subtotal.duties DECIMAL | Somme de tous les droits dans le tableau duties. Inclut les droits perçus sur les articles, l'expédition ou tout droit supplémentaire appliqué à l'importation. Pour comprendre comment les droits sont calculés, consultez la documentation sur les droits d'importation. |
amount_subtotal.fees DECIMAL | Somme des différents frais dans le tableau fees. Inclut les frais de dédouanement, les frais d'importation du pays ou d'autres frais appliqués à l'importation. Pour en savoir plus sur les frais d'importation, consultez la documentation sur les frais d'importation. |
amount_subtotal.taxes DECIMAL | Somme de toutes les taxes dans le tableau taxes. Inclut les taxes appliquées aux articles, aux droits, à l'expédition ou aux frais. Pour en savoir plus sur les taxes d'importation, consultez la documentation sur les taxes d'importation. |
currency HASH | Hash fournissant des informations sur la devise de base envoyée dans la requête et d'autres devises avec le taux de change utilisé au moment de la réponse. Ceci est utile si vous souhaitez convertir vers la devise du pays d'importation ou vers d'autres devises utilisées dans le calcul du coût rendu. Voir les attributs enfants ci-dessous. |
currency.id STRING | L'identifiant unique de l'objet currency. |
currency.base STRING | La devise de base telle qu'envoyée dans la requête de coût rendu, représentée par un code ISO à trois lettres. Tous les montants dans l'objet landed cost sont indiqués dans la devise de base. |
currency.date TIMESTAMP | La date à laquelle le taux de change a été récupéré, au format ISO 8601 : YYYY-MM-DDTHH:mm:ss.sssZ |
currency.rates HASH | Hash contenant les devises et taux de change nécessaires à la conversion depuis la devise de base. |
currency.rates.currency STRING | Une devise de taux de change utilisée dans le calcul du coût rendu. |
currency.rates.rate DECIMAL | Le taux de change au moment de la requête de coût rendu pour la devise spécifiée. |
customs HASH | Hash contenant les informations utilisées pour déterminer le coût rendu ainsi que les informations nécessaires pour la documentation douanière et le dédouanement. Voir les attributs enfants ci-dessous. |
customs.delivery_duty_paid STRING | La possibilité de facturer les droits et taxes à une personne autre que le destinataire (DDP - delivery duty paid) varie selon le transporteur, le service d'expédition ou le pays de destination. Les valeurs possibles sont available, unavailable et unknown. Si le coût rendu est utilisé pour un checkout e-commerce, vous ne devez autoriser l'acheteur à payer les droits et taxes que si le résultat est available. Si le résultat est unknown, vous pouvez soit présenter à l'acheteur un montant estimé de droits et taxes qu'il devra payer à la livraison, soit ne pas afficher du tout les droits et taxes pour ce niveau de service du transporteur. Si le résultat est unavailable, votre compte a été configuré dans le Zonos Dashboard pour ne pas autoriser le DDP, même si c'est un service autorisé par le transporteur sélectionné. |
customs.items LIST | La liste des articles envoyés dans la requête. Voir les attributs enfants ci-dessous. |
customs.items.id STRING | L'identifiant unique envoyé dans la requête. |
customs.items.amount DECIMAL | Le montant de l'article dans la devise de base. Il s'agit du montant envoyé dans la requête pour cet article. |
customs.items.country_of_origin STRING | Le pays de fabrication où l'article a été produit. Représenté par un code ISO à deux lettres. Consultez la documentation sur les droits d'importation pour comprendre comment le pays d'origine impacte le calcul du coût rendu. |
customs.items.country_of_origin_source STRING | La source du pays d'origine. Les valeurs possibles sont zonos_catalog, api_request et account_default platform. |
customs.items.description_customs STRING | 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 ce que c'est, de quoi c'est fait et à quoi cela sert. |
customs.items.description_retail STRING | La description de vente au détail de l'article. |
customs.items.detail STRING | Caractéristiques, attributs ou descriptions supplémentaires de l'article. |
customs.items.dimensions LIST | La taille de l'expédition. hash |
customs.items.dimensions.height DECIMAL | La hauteur de l'article. |
customs.items.dimensions.length DECIMAL | La longueur de l'article. |
customs.items.dimensions.unit STRING | 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é. |
customs.items.dimensions.width DECIMAL | La largeur de l'article. |
customs.items.hs_code STRING | Le code tarifaire harmonisé utilisé pour déterminer le taux tarifaire dans le calcul du coût rendu. |
customs.items.hs_code_source STRING | La source du code tarifaire harmonisé utilisé, qui peut être défini par Zonos. Les valeurs possibles sont zonos_catalog, api_request, zonos_classified, account_default et hs_correction. |
customs.items.image_url STRING | L'URL de l'image. |
customs.items.note STRING | Détails supplémentaires sur le dédouanement de l'article ou le code HS, le cas échéant. Un exemple pour l'Inde est As per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00. |
customs.items.quantity INTEGER | La quantité de l'article telle qu'envoyée dans la requête. |
customs.items.upc_code STRING | Le code UPC de l'article. |
customs.items.weight DECIMAL | Le poids de l'article. |
customs.items.weight_unit STRING | L'unité de mesure pour le poids. Les valeurs possibles sont pound, ounce, kilogram et null. Lorsque la valeur est null, pound sera utilisé. |
customs.ship_to_country STRING | Le pays d'importation où les droits et taxes sont appliqués. |
customs.shipping_amount DECIMAL | Le montant d'expédition qui doit figurer sur la documentation douanière. |
de_minimis HASH | Informations sur le seuil spécifique au pays qui détermine quand les droits et taxes s'appliquent. Le tableau des taux de change contiendra le taux de conversion utilisé pour déterminer si l'importation était au-dessus ou en dessous des seuils de droits et taxes. Voir les attributs enfants ci-dessous. |
de_minimis.formula STRING | La formule utilisée pour calculer l'éligibilité au seuil de minimis. |
de_minimis.method STRING | Il s'agit de la méthode de calcul, telle que cif, cifd, cifdt, fob ou fobd. |
de_minimis.note STRING | Détails supplémentaires sur le de minimis, par ex. en indiquant si un article n'était pas éligible à la prise en compte du de minimis, comme le vin. |
de_minimis.threshold STRING | Indique si la taxe est en dessous ou au-dessus du seuil fiscal. Les valeurs possibles incluent above ou below. |
de_minimis.type STRING | Le de minimis appliqué au type. Les valeurs possibles incluent tax et duty. |
duties HASH | Un tableau de droits appliqués à l'importation. La somme des montants de droits est égale à amount_subtotal.duties. Voir les attributs enfants ci-dessous. |
duties.amount DECIMAL | Le montant de droit sur l'item, l'shipping ou le fee. |
duties.description STRING | Descriptions variées du droit telles que duty, anti_dumping_duty, et autres. |
duties.formula STRING | La formule utilisée pour calculer le montant du droit. Pour les droits, il s'agit généralement du tarif pour le pays d'importation et peut être ad valorem ou un taux de droit spécifique. |
duties.item_id STRING | L'identifiant unique envoyé dans la requête. L'identifiant n'est fourni que lorsque le type est item. |
duties.note STRING | Détails supplémentaires sur le droit, y compris les accords de libre-échange, les taux de droits réduits, les droits antidumping, et autres. |
duties.type STRING | Le droit est appliqué au type. Les valeurs possibles incluent item, shipping et fee. |
fees HASH | Un tableau de frais appliqués à l'importation. La somme des montants de frais est égale à amount_subtotal.fees. Voir les attributs enfants ci-dessous. |
fees.amount DECIMAL | Le montant de frais appliqué à l'article, à l'expédition, au droit, au niveau de service, au transporteur ou au pays. Ce montant est dans la devise de base et peut avoir été converti depuis la devise respective du pays d'importation vers la devise de base envoyée dans la requête. |
fees.description STRING | Descriptions variées du droit telles que UPS Disbursement Fee, FedEx Advancement Fee et An Post Clearance Fee. |
fees.formula STRING | La formule utilisée pour calculer le frais. Pour les frais, il s'agit généralement d'un montant fixe, d'un pourcentage des droits et taxes, ou d'une autre formule. |
fees.item_id STRING | Votre identifiant unique envoyé dans la requête de coût rendu. L'identifiant n'est fourni que lorsque le type est item. |
fees.note STRING | Détails supplémentaires sur le frais, si nécessaire. |
fees.type STRING | Le frais est appliqué au type. Les valeurs possibles incluent advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country et other. |
messages HASH | Une liste de messages non critiques, par ex. The shipping amount in the request was null, this could impact the calculation. |
messages.message STRING | Un message utile relatif à votre requête Landed Cost et aux informations non critiques manquantes. |
messages.type STRING | Le type de message. Les valeurs possibles incluent price_adjustment, default_value_used, shipping_missing et item_weight_missing |
remittance HASH | Un tableau contenant le montant et les détails de ce qui doit être remis à un pays spécifique, par ex. Australia, New Zealand, Norway, ou United Kingdom. |
remittance.amount DECIMAL | Le montant d'argent qui doit être remis à un pays spécifique. |
remittance.description STRING | Une description de l'objet de la remittance, par ex. UK VAT. |
remittance.note STRING | Une note sur la façon dont la taxe doit être remise, par ex. remit to HMRC quarterly. |
removed_items LIST | La liste des articles retirés de la requête pour le calcul du coût rendu. Voir les attributs enfants ci-dessous. |
removed_items.id STRING | L'identifiant unique envoyé dans la requête. |
removed_items.amount DECIMAL | Le montant de l'article dans la devise de base. Il s'agit du montant envoyé dans la requête pour cet article. |
removed_items.country_of_origin STRING | Le pays de fabrication où l'article a été produit. Représenté par un code ISO à deux lettres. Consultez la documentation sur les droits d'importation pour comprendre comment le pays d'origine impacte le calcul du coût rendu. |
removed_items.country_or_origin_source STRING | La source du pays d'origine. Les valeurs possibles sont zonos_catalog, api_request et account_default platform. |
removed_items.description_customs STRING | 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 ce que c'est, de quoi c'est fait et à quoi cela sert. |
removed_items.description_retail STRING | La description de vente au détail de l'article. |
removed_items.hs_code STRING | Le code tarifaire harmonisé utilisé pour déterminer le taux tarifaire dans le calcul du coût rendu. |
removed_items.hs_code_source STRING | La source du code tarifaire harmonisé utilisé, qui peut être défini par Zonos. Les valeurs possibles sont zonos_catalog, api_request, platform, zonos_classified, account_default et hs_correction. |
removed_items.note STRING | Détails supplémentaires sur le dédouanement de l'article ou le code HS, le cas échéant. Un exemple pour l'Inde est As per India's import guidelines for personal shipments, your HS code was corrected to 9804.90.00. |
removed_items.quantity INTEGER | La quantité de l'article telle qu'envoyée dans la requête. |
taxes HASH | Un tableau de taxes appliquées à l'importation. La somme des montants de taxes est égale à amount_subtotal.taxes. Voir les attributs enfants ci-dessous. |
taxes.amount DECIMAL | Le montant de taxe sur l'article, l'expédition, le droit ou le frais. |
taxes.description STRING | Descriptions variées de la taxe appliquée telles que tax, VAT, GST, PST, HST, et autres. |
taxes.formula STRING | La formule utilisée pour calculer le montant de la taxe inclut généralement la taxe du pays d'importation ; cependant, il peut s'agir également d'une taxe d'État (ou provinciale) ou d'une taxe réduite (ou additionnelle). |
taxes.item_id STRING | L'identifiant unique envoyé dans la requête de coût rendu. L'identifiant n'est fourni que lorsque le type est item. |
taxes.note STRING | Détails supplémentaires sur la taxe, y compris les taux de taxe réduits ou d'autres informations applicables sur la taxe appliquée. |
taxes.type STRING | La taxe est appliquée au type. Les valeurs possibles incluent item duty et shipping, ainsi que les types de frais advancement, additional_tariff_lines, ddp_service_fee, brokerage, cod, country et other. |
1
{2
"id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",3
"amount_subtotal": {4
"duties": 0,5
"fees": 15,6
"taxes": 12.257
},8
"currency": {9
"id": "b5f06418-3",10
"base": "USD",11
"date": "2021-01-07T00:34:03.471+0000",12
"rates": [13
{14
"currency": "GBP",15
"rate": 0.811716
}17
]18
},19
"customs": {20
"delivery_duty_paid": "available",21
"items": [22
{23
"id": "294395",24
"amount": 39.17,25
"country_of_origin": "FR",26
"country_of_origin_source": null,27
"description_customs": "Hoka One Running Shoe - Women's",28
"description_retail": "Hoka One Running Shoe - Women's",29
"hs_code": "6116.10",30
"hs_code_source": "api_request",31
"note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",32
"quantity": 133
},34
{35
"id": "294396",36
"amount": 7.83,37
"country_of_origin": "CN",38
"country_of_origin_source": "account_default",39
"description_customs": "Galaxy Quest Men's Tee Blue",40
"description_retail": "Galaxy Quest Men's Tee Blue",41
"hs_code": "6217.10",42
"hs_code_source": "api_request",43
"note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",44
"quantity": 145
}46
],47
"shipping_amount": 14.23,48
"ship_to_country": "GB"49
},50
"de_minimis": [51
{52
"formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",53
"method": "FOB",54
"note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",55
"threshold": "below",56
"type": "duty"57
},58
{59
"formula": "(cost {'<='} 0 gbp)",60
"method": "FOB",61
"note": "Tax applies to all shipments",62
"threshold": "above",63
"type": "tax"64
}65
],66
"duties": [],67
"fees": [68
{69
"amount": 15,70
"description": "UPS United States Duty and Tax Forwarding Charge",71
"item_id": null,72
"formula": "15 USD",73
"note": null,74
"type": "ddp_service_fee"75
}76
],77
"remittance": [78
{79
"amount": 12.25,80
"description": "UK VAT",81
"note": "remit to HMRC quarterly"82
}83
],84
"removed_items": [],85
"taxes": [86
{87
"amount": 7.83,88
"description": "VAT (Value-added tax)",89
"item_id": "294395",90
"formula": "20%",91
"note": null,92
"type": "item"93
},94
{95
"amount": 2.3719,96
"description": "VAT (Value-added tax)",97
"item_id": "294395",98
"formula": "20%",99
"note": null,100
"type": "shipping"101
},102
{103
"amount": 1.57,104
"description": "VAT (Value-added tax)",105
"item_id": "294396",106
"formula": "20%",107
"note": null,108
"type": "item"109
},110
{111
"amount": 0.4741,112
"description": "VAT (Value-added tax)",113
"item_id": "294396",114
"formula": "20%",115
"note": null,116
"type": "shipping"117
}118
]119
}
Objet Landed Cost
Découvrez les capacités et les fonctions de l'objet Landed Cost.
L'objet Landed Cost fournit une ventilation et le total des droits d'importation, taxes et frais.