> For the complete documentation index, see [llms.txt](https://apidocs.cloudinvoice.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.cloudinvoice.net/documentacao-api/series-de-documentos/create.md).

# Create

## Criar Série de Documentos

## Cria uma nova série de documentos.

{% hint style="danger" %}
As Série de Documentos precisam, desde dia 1 de Janeiro de 2023, ser comunicadas à Autoridade Tributária de modo a lhes serem atribuídos códigos ATCUD.\
\
Certifique-se que já obteve as suas credenciais WSE no portal dao Autoridade Tributária e as inseriu no BackOffice CloudInvoice em:\
             **Configurações → Autoridade Tributária → Comunicação de Séries ATCUD**\
antes de tentar criar uma Série de Documentos
{% endhint %}

<mark style="color:green;">`POST`</mark> `https://api.cloudinvoice.net/series/new/`

#### Request Body

<table><thead><tr><th>Name</th><th width="249">Type</th><th>Description</th></tr></thead><tbody><tr><td>code<mark style="color:red;">*</mark></td><td>string<br><sub><mark style="color:$info;">Valor Único</mark></sub></td><td>Código da Série<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> Códigos começados por <code>AT</code> não são permitidos pela Autoridade Tributária.</td></tr><tr><td>description<mark style="color:red;">*</mark></td><td>string</td><td>Descrição</td></tr><tr><td>document_serie_type_id</td><td>integer</td><td>Tipo de Série<br><br>Consulte a tabela <a href="/pages/Le16rQ3NG33zktn1PTI4#tipos-de-series-de-documentos-campo-document_serie_type">Apêndice</a> para saber mais.</td></tr><tr><td>initial_date</td><td>date<br><sub><mark style="color:$info;">Format: yyyy-mm-dd</mark></sub></td><td>Data de Início<br><br>Quando não fornecido, assume a data atual.</td></tr><tr><td>expiration_date</td><td>date<br><sub><mark style="color:$info;">Format: yyyy-mm-dd</mark></sub></td><td>Data de Expiração</td></tr><tr><td>config_document</td><td>list</td><td>Lista de Documentos<br><br>IDs dos Tipos de Documentos para os quais serão criadas numerações na Série.<br><br>Consulte a tabela <a href="/pages/EaY0MXjOezp048Ht7eKP">Tipos de Documentos</a> para saber mais.</td></tr><tr><td>is_cash_vat_scheme</td><td>boolean</td><td>Regime de IVA de Caixa<br><br>Série para usar em Documentos ao abrigo do Regime de IVA de Caixa.</td></tr><tr><td>is_eu_sales_serie</td><td>boolean</td><td>Regime de Vendas à Distância<br><br>Série para usar em Documentos ao abrigo do Regime de Vendas à Distância.<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização destes séries requer o módulo de Vendas à Distância.</td></tr><tr><td>is_oss_serie</td><td>boolean</td><td>Série OSS (One-Stop-Shop)<br><br>Série para usar em Documentos ao abrigo do Regime de Vendas à Distância, com OSS.<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização destes séries requer o módulo de Vendas à Distância.</td></tr><tr><td>is_offline_serie</td><td>boolean</td><td>Série Offline<br><br>Série para usar em Documentos  gerados no módulo offline do POS CloudInvoice.<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização destes séries requer o módulo Offline.</td></tr></tbody></table>

{% tabs %}
{% tab title="Exemplo de Pedido" %}

```shell
curl -X POST https://api.cloudinvoice.net/series/new/
    -d '{
        "code": "A01",
        "description": "Serie API",
        "config_document": [1, 2, 3]
    }'
```

{% endtab %}

{% tab title="Exemplo de Resposta" %}

```json
{
    "id": 3,
    "code": "A01",
    "description": "Serie API",
    "document_serie_type_id": 901,
    "document_serie_type": {
        "code": "P",
        "description": "Documentos Produzidos na Aplicação"
    },
    "is_at_cud_serie": true,
    "initial_date": "2026-05-19 10:46:38",
    "expiration_date": null,
    "is_closed": false,
    "closed_user_id": null,
    "closed_date": null,
    "closed_reason": "",
    "location_id": 1,
    "location": {
        "code": 1,
        "description": "Localização 1"
    },
    "is_cash_vat_scheme": false
}
```

{% endtab %}
{% endtabs %}

Para ver exemplos de pedidos nas várias linguagens, consulte a página[ Exemplos de Pedidos.](/introducao/exemplos-de-pedidos.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://apidocs.cloudinvoice.net/documentacao-api/series-de-documentos/create.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.