flatin.pt

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 is a lead-generation platform for property in Portugal. It is not
a real-estate agency and holds no AMI licence; the service itself is
provided by licensed agencies. 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/