---
title: "POST /apps/at-pt/v1/entry/{silo_entry_id}/series"
method: POST
path: "/apps/at-pt/v1/entry/{silo_entry_id}/series"
---

# POST /apps/at-pt/v1/entry/{silo_entry_id}/series

`POST /apps/at-pt/v1/entry/{silo_entry_id}/series`

## Request

- Base URL: `https://api.invopop.com`
- URL: `https://api.invopop.com/apps/at-pt/v1/entry/{silo_entry_id}/series`
- Auth: none required
- TypeScript: <https://skmtc.dev/invopop/apis/access-service-api/docs/apps/at-pt/v1/entry/:silo_entry_id/series/post.ts> (a function with typed inputs; its response is checked against the schema)

Register a new series with the AT for the supplier.

## Path parameters

- `silo_entry_id` string, required: Silo entry ID of the supplier to register the series for.

## Request body

- object
  - `base` string, required: Base code for the series (without the document type prefix).
  - `document_type` 'FT' | 'FS' | 'FR' | 'ND' | 'NC' | 'RG' | 'GR' | 'GT', required: Document type for the series: - `FT`: Invoice (Fatura) - `FS`: Simplified Invoice (Fatura Simplificada) - `FR`: Invoice-Receipt (Fatura-Recibo) - `ND`: Debit Note (Nota de Débito) - `NC`: Credit Note (Nota de Crédito) - `RG`: Receipt (Recibo) - `GR`: Delivery Note (Guia de Remessa) - `GT`: Waybill (Guia de Transporte)
  - `type` 'N' | 'F' | 'R', required: Type of the series: - `N`: Normal - `F`: Training (Formação) - `R`: Recovery (Recuperação)

## Response `200`

Series registered successfully.

- Series
  - `id` string: Series ID.
  - `code` string: Full series code (document type + base code).
  - `base` string: Base code for the series.
  - `document_type` string: Document type for the series.
  - `type` string: Type of the series.
  - `validation_code` string: AT validation code for the series used to generate ATCUD codes.

## Other responses

- `400`: Invalid parameters.
- `404`: Supplier not found.
- `422`: Validation error (e.g., supplier without AT credentials, invalid series type for current mode).
- `500`: Internal server error.

---

[API](https://skmtc.dev/invopop/apis/access-service-api.md) - [All operations](https://skmtc.dev/invopop/apis/access-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/invopop/apis/access-service-api/revisions/fc954f96ea62?raw)