Attributs
| Champ | Notes |
|---|---|
id STRING | L'identifiant unique de l'objet. L'id pour l'objet Landed Cost sera toujours préfixé par ldct. |
amount_subtotal HASH | Total du Landed cost. Si utilisé pour un checkout ecommerce, nous recommandons d'utiliser ces totaux pour les afficher à l'utilisateur final. Ces totaux permettent une intégration plus facile sans avoir besoin de sommer les droits, taxes ou frais par article et niveau d'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 des droits. 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, voir le document sur les droits d'importation. |
amount_subtotal.fees DECIMAL | Somme des divers frais dans le tableau des frais. 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, voir le document sur les frais d'importation. |
amount_subtotal.taxes DECIMAL | Somme de toutes les taxes dans le tableau des 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, voir le document sur les taxes d'importation. |
currency HASH | Hash fournissant des informations sur la devise de base envoyée dans la demande et d'autres devises avec le rate de change utilisé au moment de la réponse. Ceci est utile si vous souhaitez convertir en devise du pays d'importation ou en d'autres devises utilisées dans le calcul du landed cost. Voir les attributs enfants ci-dessous. |
currency.id STRING | L'identifiant unique de lobjet devise. |
currency.base STRING | La devise de base telle qu'envoyée dans la demande de landed cost, représentée par un code ISO à trois lettres. Tous les montants dans l'objet landed cost sont listés dans la devise de base. |
currency.date TIMESTAMP | La date à laquelle le rate 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 les taux de change nécessaires pour la conversion à partir de la devise de base. |
currency.rates.currency STRING | Une devise de rate de change utilisée dans le calcul du landed cost. |
currency.rates.rate DECIMAL | Le rate de change au moment de la demande de landed cost pour la devise spécifiée. |
customs HASH | Hash contenant des informations utilisées pour déterminer le landed cost ainsi que des informations nécessaires pour la documentation douanière et le dédouanement. Voir les attributs enfants ci-dessous. |
customs.delivery_duty_paid STRING | La capacité de facturer les droits et taxes à quelqu'un d'autre que le destinataire (DDP - livraison droits acquittés) varie en fonction du transporteur, du service d'expédition ou du pays de destination. Les valeurs possibles sont disponible, non disponible et inconnu. Si le landed cost est utilisé pour un checkout en ligne, vous ne devriez autoriser le paiement des droits et taxes que si le résultat est disponible. Si le résultat est inconnu, vous pouvez soit présenter au client un montant estimé des 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 non disponible, votre compte a été configuré dans le tableau de bord de Zonos 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 demande. Voir les attributs enfants ci-dessous. |
customs.items.id STRING | L'identifiant unique envoyé dans la demande. |
customs.items.amount DECIMAL | Le montant de l'article dans la devise de base. C'est le montant envoyé dans la demande 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 le document sur les droits d'importation pour comprendre comment le pays d'origine impacte le calcul du landed cost. |
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érera généralement de la description au détail et inclura généralement une description générale de ce que c'est, de quoi c'est fait, et à quoi ça sert. |
customs.items.description_retail STRING | La description au détail de l'article. |
customs.items.detail STRING | Caractéristiques supplémentaires, attributs ou descriptions de l'article. |
customs.items.dimensions LIST | La taille de l'envoi. 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 pouce, centimètre, millimètre, et null. Quand null, pouce 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 rate dans le calcul du landed cost. |
customs.items.hs_code_source STRING | La source du code tarifaire harmonisé utilisé, qui peut être définie 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 Conformément aux directives d'importation de l'Inde pour les envois personnels, votre code HS a été corrigé en 9804.90.00. |
customs.items.quantity INTEGER | La quantité de l'article telle qu'envoyée dans la demande. |
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 livre, once, kilogramme, et null. Quand null, livre 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 être indiqué sur la documentation douanière. |
de_minimis HASH | Informations sur le seuil spécifique à chaque pays qui détermine quand les droits et taxes s'appliquent. Le tableau des taux de change contiendra la conversion du rate utilisée 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 seuil de minimis, comme fournir des informations si un article n'était pas éligible pour être considéré dans le cadre du seuil de minimis, comme le vin. |
de_minimis.threshold STRING | Si la taxe est inférieure ou supérieure au seuil de taxe. Les valeurs possibles incluent au-dessus ou en dessous. |
de_minimis.type STRING | Le seuil de minimis appliqué au type. Les valeurs possibles incluent taxe et droit. |
duties HASH | Un tableau de droits appliqués à l'importation. La somme des montants des droits est égale à amount_subtotal.duties. Voir les attributs enfants ci-dessous. |
duties.amount DECIMAL | Le montant des droits sur l'article, l'expédition ou les frais. |
duties.description STRING | Descriptions variées des droits tels que droit, droit antidumping, et plus encore. |
duties.formula STRING | La formule utilisée pour calculer le montant des droits. Pour les droits, il s'agit généralement du tarif douanier du pays importateur et peut être ad valorem ou un rate spécifique. |
duties.item_id STRING | L'identifiant unique envoyé dans la demande. L'identifiant n'est fourni que lorsque le type est article. |
duties.note STRING | Détails supplémentaires sur les droits, y compris les accords de libre-échange, les taux de droits réduits, les droits antidumping, et plus encore. |
duties.type STRING | Les droits sont appliqués au type. Les valeurs possibles incluent article, expédition et frais. |
fees HASH | Un tableau de frais appliqués à l'importation. La somme des montants des frais est égale à amount_subtotal.fees. Voir les attributs enfants ci-dessous. |
fees.amount DECIMAL | Le montant des frais appliqué à l'article, à l'expédition, aux droits, au niveau de service, au transporteur ou au pays. Ce montant est dans la devise de base et peut avoir été converti de la devise respective du pays importateur à la devise de base envoyée dans la demande. |
fees.description STRING | Descriptions variées des frais tels que Frais de déboursement UPS, Frais d'avance FedEx, et Frais de dédouanement An Post. |
fees.formula STRING | La formule utilisée pour calculer les 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 demande de landed cost. L'identifiant n'est fourni que lorsque le type est article. |
fees.note STRING | Détails supplémentaires sur les frais, si nécessaire. |
fees.type STRING | Les frais sont appliqués au type. Les valeurs possibles incluent avance, lignes tarifaires supplémentaires, frais de service DDP, courtage, cod, pays, et autre. |
messages HASH | Une liste de messages non critiques, par exemple "Le montant d'expédition dans la demande était nul, cela pourrait affecter le calcul." |
messages.message STRING | Un message utile lié à votre demande de Landed Cost et aux informations non critiques manquantes. |
messages.type STRING | Le type de message. Les valeurs possibles incluent ajustement de prix, valeur par défaut utilisée, expédition manquante, et poids de l'article manquant |
remittance HASH | Un tableau contenant le montant et les détails de ce qui doit être remis à un pays spécifique (par exemple, l'Australie, la Nouvelle-Zélande, la Norvège ou le Royaume-Uni). |
remittance.amount DECIMAL | Le montant d'argent qui doit être remis à un pays spécifique. |
remittance.description STRING | Une description de ce pour quoi la remise est faite (par exemple, TVA au Royaume-Uni). |
remittance.note STRING | Une note sur la manière dont la taxe doit être remise (par exemple, remit à HMRC trimestriellement). |
removed_items LIST | La liste des articles retirés de la demande pour le calcul du landed cost. Voir les attributs enfants ci-dessous. |
removed_items.id STRING | L'identifiant unique envoyé dans la demande. |
removed_items.amount DECIMAL | Le montant de l'article dans la devise de base. C'est le montant envoyé dans la demande 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 le document sur les droits d'importation pour comprendre comment le pays d'origine impacte le calcul du landed cost. |
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érera généralement de la description au détail et inclura généralement une description générale de ce que c'est, de quoi c'est fait, et à quoi ça sert. |
removed_items.description_retail STRING | La description au détail de l'article. |
removed_items.hs_code STRING | Le code tarifaire harmonisé utilisé pour déterminer le taux de rate dans le calcul du landed cost. |
removed_items.hs_code_source STRING | La source du code tarifaire harmonisé utilisé, qui peut être définie 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 Conformément aux directives d'importation de l'Inde pour les envois personnels, votre code HS a été corrigé en 9804.90.00. |
removed_items.quantity INTEGER | La quantité de l'article telle qu'envoyée dans la demande. |
taxes HASH | Un tableau des taxes appliquées à l'importation. La somme des montants de taxe est égale aux amount_subtotal.taxes. Voir les attributs enfants ci-dessous. |
taxes.amount DECIMAL | Le montant de la taxe sur l'article, l'expédition, les droits ou les frais. |
taxes.description STRING | Descriptions variées de la taxe appliquée telles que taxe, TVA, GST, PST, HST, et plus encore. |
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 également s'agir d'une taxe d'État (ou provinciale) ou d'une taxe réduite (ou ajoutée). |
taxes.item_id STRING | L'identifiant unique envoyé dans la demande de landed cost. L'identifiant est fourni uniquement 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. |
Exemple de demande
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
{
"id": "ldct_1Ce6vt2eZvKYlo2CrgzPqxaz",
"amount_subtotal": {
"duties": 0,
"fees": 15,
"taxes": 12.25
},
"currency": {
"id": "b5f06418-3",
"base": "USD",
"date": "2021-01-07T00:34:03.471+0000",
"rates": [
{
"currency": "GBP",
"rate": 0.8117
}
]
},
"customs": {
"delivery_duty_paid": "available",
"items": [
{
"id": "294395",
"amount": 39.17,
"country_of_origin": "FR",
"country_of_origin_source": null,
"description_customs": "Hoka One Running Shoe - Women's",
"description_retail": "Hoka One Running Shoe - Women's",
"hs_code": "6116.10",
"hs_code_source": "api_request",
"note": "Item was discounted by 47.78% from 75.00 USD to 39.17 USD",
"quantity": 1
},
{
"id": "294396",
"amount": 7.83,
"country_of_origin": "CN",
"country_of_origin_source": "account_default",
"description_customs": "Galaxy Quest Men's Tee Blue",
"description_retail": "Galaxy Quest Men's Tee Blue",
"hs_code": "6217.10",
"hs_code_source": "api_request",
"note": "Item was discounted by 47.78% from 15.00 USD to 7.83 USD",
"quantity": 1
}
],
"shipping_amount": 14.23,
"ship_to_country": "GB"
},
"de_minimis": [
{
"formula": "(cost {'<='} 135 gbp and hs_code not_starts_with \"2203,2204,2205,2206,2208,24,3303\")",
"method": "FOB",
"note": "Items value less than 135 GBP and not containing alcohol, tobacco, or other excluded items",
"threshold": "below",
"type": "duty"
},
{
"formula": "(cost {'<='} 0 gbp)",
"method": "FOB",
"note": "Tax applies to all shipments",
"threshold": "above",
"type": "tax"
}
],
"duties": [],
"fees": [
{
"amount": 15,
"description": "UPS United States Duty and Tax Forwarding Charge",
"item_id": null,
"formula": "15 USD",
"note": null,
"type": "ddp_service_fee"
}
],
"remittance": [
{
"amount": 12.25,
"description": "UK VAT",
"note": "remit to HMRC quarterly"
}
],
"removed_items": [],
"taxes": [
{
"amount": 7.83,
"description": "VAT (Value-added tax)",
"item_id": "294395",
"formula": "20%",
"note": null,
"type": "item"
},
{
"amount": 2.3719,
"description": "VAT (Value-added tax)",
"item_id": "294395",
"formula": "20%",
"note": null,
"type": "shipping"
},
{
"amount": 1.57,
"description": "VAT (Value-added tax)",
"item_id": "294396",
"formula": "20%",
"note": null,
"type": "item"
},
{
"amount": 0.4741,
"description": "VAT (Value-added tax)",
"item_id": "294396",
"formula": "20%",
"note": null,
"type": "shipping"
}
]
}
Objet Landed Cost
Explorez les capacités et les fonctions de l'objet Landed Cost.
L'objet Landed Cost fournit un détail et un total des droits d'importation, des taxes et des frais.