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

eeziYou
Register each series with ATYes
Assign each document its number in the seriesYes
Generate the ATCUD and QR codeYes
Submit documents in order of issue dateYes
Wait for each document to be accepted before sending the next one in the same seriesYes

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 sequence

eezi 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 issued date.
  • 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[].itemCode is required
  • lines[].unit is required
  • customInfo.prt.goodsServiceAvailableDate is required
  • recipient.address.line1 is required.
  • recipient.address.city is required.
  • recipient.address.country is required.
  • Recipients that don't have Tax IDs will need to be assigned a tax ID of PT999999990 in the recipient.taxId field.
  • 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

NameTypeRequiredDescription
lines[].itemCodestringYesAn identifier for the item.
lines[].unitstringYesA value from an enumerated list as outlined on Units of Measure
lines[].vat.codestringYesA value from an enumerated list of types:
  • "PRT-NOR": Standard rate
  • "PRT-ISE": Exempt from Tax
  • "PRT-NS": Tax-exempt/Out of scope services
  • "PRT-RED": Reduced or lower rate
  • "PRT-INT": Intermediate rate is a special VAT rate applied to certain goods and services that do not fall under the standard or reduced rates
lines[].vat.exemptReasonstringConditionalIf the line VAT amount is 0, an exemption reason is required.
lines[].vat.exemptReasonCodestringConditionalIf the line VAT amount is 0, a value from an enumerated list outlined on Portugal exempt reason codes is required.
customInfo.prt.goodsServiceAvailableDatestring (ISO 8601 date)NoThe date that the goods or services are available. Defaults to issued date.
recipient.address.line1stringYesAddress line 1 (Street address/PO Box/Company name)
recipient.address.citystringYesCity/District/Suburb/Town/Village.
recipient.address.countrystringYesThree-letter country code (ISO 3166-1 alpha-3 )

Example CSV file

Invoice - Portugal.csv


Did this page help you?