Estimate import duties and taxes
calculate_import_chargesEstimates the charges on importing goods into Spain (mainland and Balearic Islands) under a 10-digit code: customs duty, anti-dumping and countervailing duties, the Union handling fee, excise duties and import VAT, line by line with the legal basis of each. It says which data are missing (for example the manufacturer's additional code or the supplementary units) and what documents each measure asks for. The result is an indicative calculation, not an assessment: the debt is determined by customs on the declaration lodged. Covers the EU customs tariff (TARIC) as applied in Spain (mainland and Balearic Islands). Not valid for the Canary Islands, Ceuta or Melilla. For guidance only, not binding.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"code": "<code>",
"origin": "<origin>",
"customs_value_eur": "<customs_value_eur>"
},
"name": "calculate_import_charges"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | Declarable 10-digit code. | |
| date | No | Reference date as YYYY-MM-DD. Defaults to today. From the first date available in the data up to one year ahead. | |
| origin | Yes | Two-letter country of origin. | |
| language | No | Language of the texts returned: Spanish (es), Catalan (ca) or English (en). Official EU texts not published in Catalan are returned in Spanish. | es |
| documents | No | Document codes held, for example Y160 or N954. | |
| quantities | No | Quantities by TARIC unit, for example {"LTR": 700, "KGM": 950}. | |
| net_mass_kg | No | ||
| product_data | No | Product data the calculation asks for in missing_data, by its id (for example alcohol_vol or plastic_kg). | |
| preference_code | No | Preference code of box 36, for example 100, 200 or 300. | |
| additional_codes | No | TARIC additional codes of 4 characters, for example the manufacturer's anti-dumping code. | |
| vat_rate_percent | No | Only when the sheet says the VAT rate depends on the article. | |
| customs_value_eur | Yes | Customs value in EUR. | |
| supplementary_units | No | Quantity in the supplementary unit of the code. | |
| equivalence_surcharge | No | The importer is a retailer under the equivalence surcharge scheme. | |
| costs_to_destination_eur | No | Transport and insurance to the first destination, in EUR, if not already in the customs value. It enters the VAT base. |