Portugal
Document series and ATCUD
In Portugal, every invoice and credit note belongs to a series: a named sequence of documents, numbered consecutively without gaps (for example FT2026A/1, FT2026A/2, FT2026A/3).
Each series is registered with the Tax and Customs Authority (AT) before it is used, and AT returns a validation code for it.
What eezi does and what you do
| eezi | You | |
|---|---|---|
| Register each series with AT | Yes | |
| Assign each document its number in the series | Yes | |
| Generate the ATCUD and QR code | Yes | |
| Submit documents in order of issue date | Yes | |
| Wait for each document to be accepted before sending the next one in the same series | Yes |
eezi keeps separate series for normal invoices, simplified invoices and credit notes, and decides which one a document belongs to. Invoices under 1000 EUR are treated as simplified invoices automatically.
Keep each series in sequenceeezi numbers documents in the order it receives them. Because the number and the issue date must both increase together within a series, a document sent late, or out of order, can be rejected or numbered after a document with a later date.
- Send documents in order of
issueddate.- Send them one after another, not in parallel. Wait for each response before sending the next document.
- Do not backdate a document to a date earlier than one already submitted.
Invoice
Changes to generic fields
lines[].itemCodeis requiredlines[].unitis requiredcustomInfo.prt.goodsServiceAvailableDateis requiredrecipient.address.line1is required.recipient.address.cityis required.recipient.address.countryis required.- Recipients that don't have Tax IDs will need to be assigned a tax ID of
PT999999990in therecipient.taxIdfield. - Invoices under 1000 EUR are considered simplified invoices. The eezi platform automatically addresses this, and no additional actions are required.
- Documents must be submitted one at a time, in order of issue date. See Document series and ATCUD.
type Invoice {
// ...all generic invoice fields
lines: [
{
// ...other line item fields
itemCode: string;
unit: UnitsOfMeasure;
vat: {
// ...other line item vat fields
exemptReason?: string;
exemptReasonCode?: PortugalExemptionReasonCodes;
}
}
];
customInfo: {
prt: {
goodsServiceAvailableDate?: string; // ISO date
};
};
};Field information
| Name | Type | Required | Description |
|---|---|---|---|
lines[].itemCode | string | Yes | An identifier for the item. |
lines[].unit | string | Yes | A value from an enumerated list as outlined on Units of Measure |
lines[].vat.code | string | Yes | A value from an enumerated list of types:
|
lines[].vat.exemptReason | string | Conditional | If the line VAT amount is 0, an exemption reason is required. |
lines[].vat.exemptReasonCode | string | Conditional | If the line VAT amount is 0, a value from an enumerated list outlined on Portugal exempt reason codes is required. |
customInfo.prt.goodsServiceAvailableDate | string (ISO 8601 date) | No | The date that the goods or services are available. Defaults to issued date. |
recipient.address.line1 | string | Yes | Address line 1 (Street address/PO Box/Company name) |
recipient.address.city | string | Yes | City/District/Suburb/Town/Village. |
recipient.address.country | string | Yes | Three-letter country code (ISO 3166-1 alpha-3 ) |
Example CSV file
Updated 7 days ago