Filing the IVA Periódica on the AT portal

You locked your quarterly VAT draft in Descodify and now you need to file it with the tax authority (AT). Two ways to fill the AT form:

1. Upload the XML. Descodify generated a dpiva-*.xml file when you locked. If the AT form accepts a file upload, use it and skip the typing.
2. Type each campo into the AT form. Fall back to this when the upload is not available or you want to eyeball each value first.

Before you start

• Your VAT draft is locked in Descodify. Locked means the snapshot is frozen: the numbers AT will receive match exactly what's on screen, even if you record a new invoice tomorrow.
• You can log in to the Portal das Finanças.

If you're still in draft, go back and click Lock report first.

Open the AT form

The periodic VAT return (Declaração Periódica) is filed on the Portal das Finanças. The AT's Declaração Periódica page is the place to start. Log in and select the period you are filing, the same one as your Descodify draft.

Descodify's report uses the same quadro and campo numbers as the declaration, so you can work through both side by side.

Path A: upload the XML

Click Download XML in Descodify. A file named dpiva-{YYQ}T-{NIF}.xml lands on your machine. Upload it on the AT form.

If AT rejects the upload, fall back to the manual path below.

Path B: copy each campo manually

For every row with a value in your Descodify report:

1. Find the campo with the same number on the AT form.
2. Back in Descodify, click the small copy icon next to the value. It puts the value on your clipboard with a comma as the decimal separator and no thousand separators.
3. Paste it into the AT field.
4. Move to the next row.

Rows showing — Add value are values Descodify cannot derive from your invoices and expenses, and you haven't supplied one yet.

A few rows need care:

• Campos 20 to 24 (deductible VAT). These take the VAT amount you can deduct, never the invoice total and never the taxable base.
• Totals. Descodify shows the totals so you can check that your inputs add up before you submit.

Campo 94: carry forward or refund

If campo 94 is positive (AT owes you), you split it across two fields: campo 95 is a refund request, and campo 96 is the amount carried forward to the next period. The two must add up to campo 94. Descodify checks the same rule before letting you lock.

A refund is not available every period. In the usual cases the law allows it once the credit has persisted for 12 months and still exceeds €250, or at any time once it exceeds €3,000. Other routes exist, for example when you close your activity. When no route applies, put the whole credit in campo 96: nothing is lost, it is deducted in the following periods.

Submit and keep the proof

Whichever path you used, check any message the AT portal shows before you submit. Keep any proof of submission (comprovativo) AT offers.

Back in Descodify

Click Mark as submitted on the report. Upload the comprovativo PDF in the box that appears. The report is now sealed: the snapshot, the submission timestamp, and the proof are all stored together.

If you find a mistake after submitting, the correction on the AT side is a substitute declaration (declaração de substituição) for that period. In Descodify, Reopen the report, fix whatever needs fixing and Lock it again; the audit trail keeps both versions.