# 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

| Value | Request location |
|  --- | --- |
| External regime | `jurisdictionalData.regime = PT_AT` |
| Regime contract version | `jurisdictionalData.regimeVersion` |
| Document type | Field `PT:DOCUMENT_TYPE` |
| Series | Field `PT:SERIES` |
| AT series-validation code | Field `PT:AT_SERIES_VALIDATION_CODE` |
| ATCUD | Field `PT:ATCUD` |
| Certified-software ID | `fiscalization.softwareId` |
| Document hash | Fiscal field `PT:DOCUMENT_HASH` |
| Authority reference | `fiscalization.authorityReference` |
| Original reference | `identifiers[]` for a receipt or `originatorDocumentReference` for a credit note |
| Authority-defined QR | Top-level `barcodes[]` |
| NIF/VAT identity | Supplier context resolved by Cheqi |


## Invoice example

```json
{
  "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.

## Related

- [Supplying jurisdiction data](/countries/jurisdictional-data)
- [Credit notes](/creditnote/credit-notes)