> 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

{% 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)