no one likes customs, and predicting their amount is even harder. With fuckCustoms, estimate how many customs will be due to pay, depending of your country and the item you’re getting!
this project has been made in an attempt to get more clearer data and more insights about paying custom fees when you order stuff from HackClub or recieve mailpieces! i'm always wondering and kind of afraid at the idea of having to pay customs, especially because it changes so much due to national service fees, and the different rules. thanks to this tool tho, hopefully this nightmare might be way easier starting now!
please note however that this project only gives an ESTIMATION, and should not be used as a reliable source, but only as a suggestion!!
well this project is quite single-headed. yeah. it calculates custom fees! but it does have some extra stuff under the hood that still deserve recognition.
- customs database: i was required to build a global worldwide database of each country's regulations for customs, so if any open source dev wants it well here it is
- calculation breakdown: you can actually see what is charging you more, and if you're getting fucked by national courier fees!
- contributions in mind: anyone can go ahead and contribute to their own country's (or others!) if the stat is wrong...
your contribution is insanely welcome as i'm able to give a baseline for every single country of the world, but the data can quite obviously be quite off!
if you notice a huge gap in the actual estimate, it's very most likely because the service fee of your national courier i entered is false, or the VAT percentages are false aswell! if so, it would be very appreciable if you could go to the database here, and edit your country's data, with the correct ones!
after that's done, make a simple pull request, and i'll merge it, and thank you for your contrib! :D
as an example, here's a more in depth analysis of a line in the JSON:
"FR": {
"name": "France", // name of the country
"vatRate": 0.20, // vat percentage to be charged. e.g: 20%
"dutyThreshold": 160, // amount when exceeded where duties will start being charged
"avgDutyRate": 0.04, // duties rate, as to put in the form of an average as it varies alot
"handlingFee": 8.50, // national courier fee (check the country's national courier)
"vatThreshold": 0, // amount when exceeded where VAT will start being charged
"currency": "EUR" // local currency of the country for the frontend
}}this is a community project, and your help is very much appreciated! if you notice anything wrong during your usage of this project, please report it on the GitHub issues tracker!
this project uses only two actual APIs! first, it uses the ExchangeRate API to calculate conversion rates, but it most importantly uses a JSON database of all the countries's custom's policies, with their VAT rules, duty fees, thresholds, and service fees by the national local couriers. this database has been tailored by me and Gemini to go a bit faster on the research, and is publicly avalaible on github here!!
this project is licensed under the MIT license. you can check it here.
if you have any questions about this project, please reach me at [email protected].