{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Portugal ( PT )","description":"Complete documentation for integrating Cheqi's digital receipt platform","keywords":["cheqi","digital receipts","api","sdk","java","javascript"]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"portugal--pt-","__idx":0},"children":["Portugal (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT_AT"]}," for receipt, invoice, and credit-note variants carrying evidence"," ","produced by the merchant's applicable certified invoicing software."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-cheqi","__idx":1},"children":["Before Cheqi"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the registered document series in the merchant's invoicing software."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select receipt, invoice, or credit note and obtain that document's sequence"," ","and ATCUD."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete the applicable hash/signature and authority operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain the certified-software ID and exact QR payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For a credit note, retain the original-document reference while allocating a"," ","new ATCUD and sequence."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"in-the-cheqi-request","__idx":2},"children":["In the Cheqi request"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Request location"},"children":["Request location"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["External regime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.regime = PT_AT"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Regime contract version"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.regimeVersion"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Document type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT:DOCUMENT_TYPE"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Series"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT:SERIES"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AT series-validation code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT:AT_SERIES_VALIDATION_CODE"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ATCUD"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT:ATCUD"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certified-software ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.softwareId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Document hash"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT:DOCUMENT_HASH"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authority reference"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.authorityReference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Original reference"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identifiers[]"]}," for a receipt or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["originatorDocumentReference"]}," for a credit note"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authority-defined QR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["barcodes[]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["NIF/VAT identity"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supplier context resolved by Cheqi"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"invoice-example","__idx":3},"children":["Invoice example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"barcodes\": [\n    {\n      \"type\": \"QR_CODE\",\n      \"data\": \"exact-at-qr-payload\",\n      \"label\": \"AT QR\"\n    }\n  ],\n  \"jurisdictionalData\": {\n    \"countryCode\": \"PT\",\n    \"regime\": \"PT_AT\",\n    \"regimeVersion\": \"2026-07\",\n    \"fiscalization\": {\n      \"system\": \"PT_AT_CERTIFIED_SOFTWARE\",\n      \"status\": \"FISCALIZED\",\n      \"fiscalDocumentNumber\": \"FT F2026/42\",\n      \"sequenceNumber\": \"42\",\n      \"authorityReference\": \"PT-AT-REFERENCE-001\",\n      \"softwareId\": \"PT-SOFTWARE-001\",\n      \"signature\": \"opaque-document-signature\",\n      \"timestamp\": \"2026-07-29T08:15:30Z\",\n      \"additionalFields\": [\n        {\n          \"code\": \"PT:DOCUMENT_HASH\",\n          \"value\": \"opaque-document-hash\"\n        }\n      ]\n    },\n    \"additionalFields\": [\n      {\n        \"code\": \"PT:DOCUMENT_TYPE\",\n        \"value\": \"INVOICE\"\n      },\n      {\n        \"code\": \"PT:SERIES\",\n        \"value\": \"F2026\"\n      },\n      {\n        \"code\": \"PT:AT_SERIES_VALIDATION_CODE\",\n        \"value\": \"opaque-series-validation-code\"\n      },\n      {\n        \"code\": \"PT:ATCUD\",\n        \"value\": \"ATCUD-INVOICE-001\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cheqi does not register the series, obtain AT codes, certify software,"," ","calculate the document hash, report to AT, or construct the QR payload."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":4},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/jurisdictional-data"},"children":["Supplying jurisdiction data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/creditnote/credit-notes"},"children":["Credit notes"]}]}]}]},"headings":[{"value":"Portugal ( PT )","id":"portugal--pt-","depth":1},{"value":"Before Cheqi","id":"before-cheqi","depth":2},{"value":"In the Cheqi request","id":"in-the-cheqi-request","depth":2},{"value":"Invoice example","id":"invoice-example","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Portugal","description":"Create Portuguese receipt, invoice, and credit-note variants with AT evidence","seo":{"title":"Portugal ( PT )"}},"lastModified":"2026-07-29T20:49:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/countries/pt","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}