Calcul des taxes douanières¶
L’api SMC_TAXO V2 permet d’avoir l'estimation des taxes douanières.
Base URL = https://taxo.imxpostal.fr/api
Description de l'api¶
Méthode : POST
Headers : * x-api-key : Code secret fourni par IMX
Url : https://taxo.imxpostal.fr/api/v1.1/duty_calculation
Paramètres :
Les champs noté en gras sont obligatoires. Les champs suffixés par un point sont des membres de dictionnaires (exemple : identification
). Les champs suffixés par [] sont des listes (exemple : products
).
Nom | Description |
---|---|
Liste de dictionnaire décrivant le contenu du colis à l'usage des douanes. Pour chaque item, on définit les champs suivants : | |
Dictionnaire contenant la description d'un article du colis. Le champs obligatoire est: | |
Exemple payload python :
payload = {
'currency_global_ship_price': 'EUR',
'from_country': 'FR',
'global_insurance_price': 5,
'global_ship_price': 15,
'lang': 'fr',
'products': [
{
'currency_unit_price': 'EUR',
'identification': {
'hsocde': '33049900',
'description': "Creme de peau'
},
'origin_country': 'CN',
'quantity': 1,
'unit_price': 48.39,
'weight': 365,
}
],
'to_country': 'GP'
}
Résultat au format python dictionnaire :
{'global': {'amount': 18.8,
'amount_duty_and_tax': 18.81,
'amount_ecoTax': 0,
'amount_exclusive': 68.39,
'amount_inclusive_vat': 75.22,
'amount_total': 87.19999999999999,
'percentage_duty_and_tax': 27.51},
'incoterm': 'CIF',
'insurance_global': {'amount_duty_and_tax': 1.38,
'amount_exclusive': 5,
'amount_inclusive_vat': 5.5,
'amount_total': 6.38,
'duty': {'amount': 0, 'label': 'duty', 'vat_amount': 0},
'percentage_duty_and_tax': 27.6,
'special_taxes': [{'amount': 0.75,
'label': 'OM',
'percentage': 15,
'vat_amount': 0.06},
{'amount': 0.13,
'label': 'OMR',
'percentage': 2.5,
'vat_amount': 0.01}],
'vat': [{'amount': 0.43,
'label': 'VAT',
'percentage': 8.5,
'vat_amount': None}]},
'packaging_global': {'amount_duty_and_tax': 0,
'amount_exclusive': 0,
'amount_inclusive_vat': 0,
'amount_total': 0,
'duty': None,
'percentage_duty_and_tax': None,
'special_taxes': None,
'vat': None},
'products': [{'amount_duty_and_tax': 13.3,
'amount_ecoTax': 0,
'amount_exclusive': 48.39,
'amount_inclusive_vat': 53.22,
'amount_total': 61.69,
'duty': {'agreement': 'MFN duties (Applied)',
'insurance_taxes_amount': 0,
'label': 'duty',
'message': 'Your goods are not subjected to custom '
'duties because total amount is below 150 '
'EUR',
'packaging_taxes_amount': 0,
'percentage': 0,
'product_taxes_amount': 0,
'shipping_taxes_amount': 0,
'vat_insurance_taxes_amount': 0,
'vat_packaging_taxes_amount': 0,
'vat_product_taxes_amount': 0,
'vat_shipping_taxes_amount': 0,
'vat_taxes_amount': 0},
'identification': {'type': 'HSCODE', 'value': '3304990000'},
'percentage_duty_and_tax': 27.49,
'product_statut': 'Authorized for importation into this country',
'special_taxes': [{'insurance_taxes_amount': 0,
'label': 'OM',
'packaging_taxes_amount': 0,
'percentage': 15,
'product_taxes_amount': 7.26,
'shipping_taxes_amount': 0,
'vat_insurance_taxes_amount': 0,
'vat_packaging_taxes_amount': 0,
'vat_product_taxes_amount': 0.6171,
'vat_shipping_taxes_amount': 0,
'vat_taxes_amount': 0.6171},
{'insurance_taxes_amount': 0,
'label': 'OMR',
'packaging_taxes_amount': 0,
'percentage': 2.5,
'product_taxes_amount': 1.21,
'shipping_taxes_amount': 0,
'vat_insurance_taxes_amount': 0,
'vat_packaging_taxes_amount': 0,
'vat_product_taxes_amount': 0.10285000000000001,
'vat_shipping_taxes_amount': 0,
'vat_taxes_amount': 0.10285000000000001}],
'vat': [{'insurance_taxes_amount': 0,
'label': 'VAT',
'message': None,
'packaging_taxes_amount': 0,
'percentage': 8.5,
'product_taxes_amount': 4.11,
'shipping_taxes_amount': 0}]}],
'shipping_global': {'amount_duty_and_tax': 4.13,
'amount_exclusive': 15,
'amount_inclusive_vat': 16.5,
'amount_total': 19.13,
'duty': {'amount': 0, 'label': 'duty', 'vat_amount': 0},
'percentage_duty_and_tax': 27.54,
'special_taxes': [{'amount': 2.25,
'label': 'OM',
'percentage': 15,
'vat_amount': 0.19},
{'amount': 0.38,
'label': 'OMR',
'percentage': 2.5,
'vat_amount': 0.03}],
'vat': [{'amount': 1.28,
'label': 'VAT',
'percentage': 8.5,
'vat_amount': None}]},
'timestamp': 1648543778113,
'transit_fees_global': None}
Description réponse
Voir la documentation en anglais pour plus de détail.