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 Series Entry 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
import SpaceInvoices from '@spaceinvoices/js-sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.ptAtcudSeries.create({
  document_type: "invoice",
  series_code: "FT 2026/A",
  validation_code: "AB12CD34EF",
  first_number: "FT FT2026A/00001",
  start_date: "2026-01-01",
  is_manual: false,
  initial_sequence: 1
});

console.log(response);
Example:
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"

import SpaceInvoices from '@spaceinvoices/js-sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.ptAtcudSeries.getActive();

console.log(response);
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_manualbooleanoptionalnullable
import SpaceInvoices from '@spaceinvoices/js-sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.ptAtcudSeries.list();

console.log(response);
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})

import SpaceInvoices from '@spaceinvoices/js-sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.ptAtcudSeries.get("inv_6595a27b5d35015c3ef0c3fd");

console.log(response);
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
}