外掛標籤
開發者團隊
原文外掛簡介
Two shortcodes for sites that write about buying property in Portugal.
[flatin_imt value="250000"] — what a purchase costs on top of the price:
IMT, stamp duty and the price of registering the purchase.
[flatin_imi concelho="porto"] — the yearly property tax (IMI) rate for a
municipality, with the tax year next to it.
Rendered on your server, into your page. No iframes and no client-side
drawing: the output is part of your HTML, so it is styled by your theme,
readable without JavaScript, and visible to search engines.
Where the numbers come from. IMT is calculated from the official 2026
tables. IMI rates were harvested from the Autoridade Tributária portal and
then verified line by line against that same source — all 308 municipalities.
Where a municipality sets no single rate (it sets one per freguesia instead),
the plugin says so rather than printing a zero. The registration line is not a
guess either: it is the published price of the Casa Pronta counter of the
Ministério da Justiça for one registration act. It does not cover the purchase
contract at a notary or a solicitador, and the shortcode says so under the
table.
Shortcode options
[flatin_imt value="250000" territory="regioes_autonomas"] — the Azores
or Madeira scale (default: continente, mainland Portugal).
[flatin_imt value="250000" primary="no"] — not the buyer’s own permanent
home (default: yes).
[flatin_imt value="250000" young="yes"] — the reduced IMT table and the
stamp duty deduction for buyers aged 35 or under buying their first own
permanent home (default: no).
[flatin_imt value="250000" vpt="180000"] — the VPT (valor patrimonial
tributário) from the caderneta predial, if known. IMT and stamp duty are
charged on the higher of the contract price and the VPT, and the answer
says which one it used.
[flatin_imi concelho="porto" vpt="180000"] — also shows the yearly IMI for
that taxable value (VPT). concelho takes a name or the four-digit code.
Credit link
The credit link is off by default. If you would like to credit the source,
switch it on in Settings → flatin.pt: results then show a small
“Calculated by flatin.pt” line with a link. While it is off, the plugin adds
no link to flatin.pt anywhere in your pages — not even when the service is
unreachable — and the calculators work exactly the same either way.
Who we are
flatin.pt publishes open data and calculators on property in Portugal and is
a licensed estate agency (AMI licence no. 28163) that answers buyers’ requests
itself. The results are estimates from official tables, not tax advice. This plugin sells nothing and collects nothing.
External services
This plugin connects to the flatin.pt API (https://flatin.pt/api/v1), run
by flatin.pt, to calculate taxes and look up IMI rates. The calculations are
done there so that one maintained tax table serves every site. Without this
service the shortcodes cannot show results.
When. Only when a page containing a shortcode is rendered and the answer
for that exact input is not already cached in your site’s database. Answers
are stored as transients: IMI rates for one day, IMT calculations for one
hour, invalid input (for example a misspelt municipality) for one hour. No
request is made on activation, from the settings screen, or on pages without
a shortcode.
What is sent.
[flatin_imt]: an HTTPS POST to https://flatin.pt/api/v1/imt/calculate
with the price, the VPT if the shortcode gives one, the territory, and the
two yes/no options from the shortcode.
[flatin_imi]: an HTTPS GET to https://flatin.pt/api/v1/imi/rates/{municipality}
with the municipality name or code from the shortcode. The taxable value
(vpt) is not sent: the yearly amount is calculated on your server.
Each request identifies the plugin with the User-Agent
flatin-pt-wordpress/1.0.3 (+https://flatin.pt/). Nothing about your
visitors is sent: no visitor IP address, page URL, referrer, cookies or
identifiers. As with any HTTPS request, the flatin.pt server sees the IP
address of your web server; it is kept in server logs as described in the
privacy policy.
Terms of use: https://flatin.pt/en/legal/termos-utilizacao/
Privacy policy: https://flatin.pt/en/legal/privacidade/
API documentation: https://flatin.pt/en/tools/api-and-data/
