Skip to content
Space Invoices Documentation

PT ATCUD Series

PT ATCUD Series

Manage Portugal ATCUD series registrations used for PT numbering and SAF-T exports.

Endpoints
IntroductionPOST/fiscalization/pt/atcud-seriesPOST/fiscalization/pt/atcud-series/activeGET/fiscalization/pt/atcud-seriesGET/fiscalization/pt/atcud-series/{id}

The PT ATCUD Serie object

object

Attributes

idstring
Other attributes
entity_idstring
document_typestring
series_codestring
validation_codestring
first_numberstring
start_datestring<date>
is_manualboolean
initial_sequenceinteger

Create PT ATCUD series

POST/fiscalization/pt/atcud-series

Create a Portugal ATCUD series registration for one PT document type.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

document_typestringrequired

Portugal fiscal document type tracked for ATCUD series numbering.

Possible values: "invoice", "advance_invoice", "credit_note", "estimate"

series_codestringrequired

AT-communicated series code used in the PT document number.

validation_codestringrequired

Validation code assigned by AT for the communicated series.

start_datestring<date>required

First date for which the communicated series is valid.

Other parameters
first_numberstringoptional
is_manualbooleanoptional
initial_sequenceintegeroptional
curl -X POST "https://eu.spaceinvoices.com/fiscalization/pt/atcud-series" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "invoice",
    "series_code": "string",
    "validation_code": "string",
    "first_number": "string",
    "start_date": "2025-01-15",
    "is_manual": true,
    "initial_sequence": 0
  }'
Response

Returns

idstring
Other parameters
entity_idstring
document_typestring
series_codestring
validation_codestring
first_numberstring
start_datestring<date>
is_manualboolean
initial_sequenceinteger
json
{
  "id": "string",
  "entity_id": "string",
  "document_type": "invoice",
  "series_code": "string",
  "validation_code": "string",
  "first_number": "string",
  "start_date": "2025-01-15",
  "is_manual": true,
  "initial_sequence": 0
}

Get active PT ATCUD series

POST/fiscalization/pt/atcud-series/active

Return the current non-manual PT ATCUD series by document type, matching the legacy active-series lookup.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Query parameters

document_typestringoptional

Possible values: "invoice", "advance_invoice", "credit_note", "estimate"

curl -X POST "https://eu.spaceinvoices.com/fiscalization/pt/atcud-series/active" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response
json
[
  {
    "id": "string",
    "entity_id": "string",
    "document_type": "invoice",
    "series_code": "string",
    "validation_code": "string",
    "first_number": "string",
    "start_date": "2025-01-15",
    "is_manual": true,
    "initial_sequence": 0
  }
]

List PT ATCUD series

GET/fiscalization/pt/atcud-series

List PT ATCUD series registered on the selected PT entity.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Query parameters

document_typestringoptional

Possible values: "invoice", "advance_invoice", "credit_note", "estimate"

is_manualbooleanoptional
curl "https://eu.spaceinvoices.com/fiscalization/pt/atcud-series" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response
json
[
  {
    "id": "string",
    "entity_id": "string",
    "document_type": "invoice",
    "series_code": "string",
    "validation_code": "string",
    "first_number": "string",
    "start_date": "2025-01-15",
    "is_manual": true,
    "initial_sequence": 0
  }
]

Get PT ATCUD series

GET/fiscalization/pt/atcud-series/{id}

Get one PT ATCUD series by ID.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Path parameters

idstring<resource-id>required

Space Invoices resource identifier (format: {prefix}_{hex24})

curl "https://eu.spaceinvoices.com/fiscalization/pt/atcud-series/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

idstring
Other parameters
entity_idstring
document_typestring
series_codestring
validation_codestring
first_numberstring
start_datestring<date>
is_manualboolean
initial_sequenceinteger
json
{
  "id": "string",
  "entity_id": "string",
  "document_type": "invoice",
  "series_code": "string",
  "validation_code": "string",
  "first_number": "string",
  "start_date": "2025-01-15",
  "is_manual": true,
  "initial_sequence": 0
}