Skip to content

Portugal (PT)

Use PT_AT for receipt, invoice, and credit-note variants carrying evidence produced by the merchant's applicable certified invoicing software.

Before Cheqi

  • Use the registered document series in the merchant's invoicing software.
  • Select receipt, invoice, or credit note and obtain that document's sequence and ATCUD.
  • Complete the applicable hash/signature and authority operation.
  • Obtain the certified-software ID and exact QR payload.
  • For a credit note, retain the original-document reference while allocating a new ATCUD and sequence.

In the Cheqi request

ValueRequest location
External regimejurisdictionalData.regime = PT_AT
Regime contract versionjurisdictionalData.regimeVersion
Document typeField PT:DOCUMENT_TYPE
SeriesField PT:SERIES
AT series-validation codeField PT:AT_SERIES_VALIDATION_CODE
ATCUDField PT:ATCUD
Certified-software IDfiscalization.softwareId
Document hashFiscal field PT:DOCUMENT_HASH
Authority referencefiscalization.authorityReference
Original referenceidentifiers[] for a receipt or originatorDocumentReference for a credit note
Authority-defined QRTop-level barcodes[]
NIF/VAT identitySupplier context resolved by Cheqi

Invoice example

{
  "barcodes": [
    {
      "type": "QR_CODE",
      "data": "exact-at-qr-payload",
      "label": "AT QR"
    }
  ],
  "jurisdictionalData": {
    "countryCode": "PT",
    "regime": "PT_AT",
    "regimeVersion": "2026-07",
    "fiscalization": {
      "system": "PT_AT_CERTIFIED_SOFTWARE",
      "status": "FISCALIZED",
      "fiscalDocumentNumber": "FT F2026/42",
      "sequenceNumber": "42",
      "authorityReference": "PT-AT-REFERENCE-001",
      "softwareId": "PT-SOFTWARE-001",
      "signature": "opaque-document-signature",
      "timestamp": "2026-07-29T08:15:30Z",
      "additionalFields": [
        {
          "code": "PT:DOCUMENT_HASH",
          "value": "opaque-document-hash"
        }
      ]
    },
    "additionalFields": [
      {
        "code": "PT:DOCUMENT_TYPE",
        "value": "INVOICE"
      },
      {
        "code": "PT:SERIES",
        "value": "F2026"
      },
      {
        "code": "PT:AT_SERIES_VALIDATION_CODE",
        "value": "opaque-series-validation-code"
      },
      {
        "code": "PT:ATCUD",
        "value": "ATCUD-INVOICE-001"
      }
    ]
  }
}

Cheqi does not register the series, obtain AT codes, certify software, calculate the document hash, report to AT, or construct the QR payload.