---
title: "Create Sequence"
method: POST
path: "/sequences.json"
tags: ["Sequences"]
---

# Create Sequence

`POST /sequences.json`

Creates and registers a new sequence. 
For portuguese accounts, it’s necessary to have AT credentials configured.

## Query parameters

- `api_key` string, required

## Request body

- SequenceCreateRequest
  - `sequence` object, required
    - `serie` string, required — Series name
    - `default_sequence` string — If "1", this sequence is chosen as the default sequence. Other values are ignored.

## Response `201`

SUCCESS. Created.

<br>

**Possible values for fields `current_<document type>_validation_code`:**

| Value | Description |
| :--- | :--- |
| **ABCD1234** | Validation code for each sequence that is registered in the Tax Authority. |
| **N/D** | The sequence is relevant for ATCUD but is not registered in the Tax Authority. |
| **N/A** | The sequence is not relevant for ATCUD and is not registered in the Tax Authority. |

- SequenceGetResponse
  - `sequences` object
    - `id` integer
    - `serie` string
    - `default_sequence` integer
    - `current_invoice_number` integer
    - `current_invoice_sequence_id` integer
    - `current_invoice_validation_code` string
    - `current_invoice_receipt_number` integer
    - `current_invoice_receipt_sequence_id` integer
    - `current_invoice_receipt_validation_code` string
    - `current_simplified_invoice_number` integer
    - `current_simplified_invoice_sequence_id` integer
    - `current_simplified_invoice_validation_code` string
    - `current_credit_note_number` integer
    - `current_credit_note_sequence_id` integer
    - `current_credit_note_validation_code` string
    - `current_debit_note_number` integer
    - `current_debit_note_sequence_id` integer
    - `current_debit_note_validation_code` string
    - `current_receipt_number` integer
    - `current_receipt_sequence_id` integer
    - `current_receipt_validation_code` string
    - `current_shipping_number` integer
    - `current_shipping_sequence_id` integer
    - `current_shipping_validation_code` string
    - `current_transport_number` integer
    - `current_transport_sequence_id` integer
    - `current_transport_validation_code` string
    - `current_devolution_number` integer
    - `current_devolution_sequence_id` integer
    - `current_devolution_validation_code` string
    - `current_proforma_number` integer
    - `current_proforma_sequence_id` integer
    - `current_proforma_validation_code` string
    - `current_quote_number` integer
    - `current_quote_sequence_id` integer
    - `current_quote_validation_code` string
    - `current_fees_note_number` integer
    - `current_fees_note_sequence_id` integer
    - `current_fees_note_validation_code` string
    - `current_vat_moss_invoice_number` integer
    - `current_vat_moss_invoice_sequence_id` integer
    - `current_vat_moss_invoice_validation_code` string
    - `current_vat_moss_credit_note_number` integer
    - `current_vat_moss_credit_note_sequence_id` integer
    - `current_vat_moss_credit_note_validation_code` string
    - `current_vat_moss_receipt_number` integer
    - `current_vat_moss_receipt_sequence_id` integer
    - `current_vat_moss_receipt_validation_code` string

## Other responses

- `401` — ACCESS DENIED
- `409` — CONFLICT **Available codes:** | Code | Description | | :--- | :--- | | **006** | The sequence is already being registered. |
- `422` — UNPROCESSABLE ENTITY **Available codes:** | Code | Description | | :--- | :--- | | **001** | Sequence name not allowed. | | **002** | Sequence already exists. | | **003** | Invalid sequence. | | **004** | Invalid Tax Authority credentials. | | **005** | Account fiscal ID doesn’t have open activity in Tax Authority. | | **000** | Unknown error. |

---

[API](https://skmtc.net/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.net/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/versions/5cea7e1d8f41/schema)