# Create Sequence

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

Endpoint: POST /sequences.json
Version: 2.0.0
Security: apiKeyAuth

## Query parameters:

  - `api_key` (string, required)
    Your API Key.
    Example: "YOUR_API_KEY"

## Request fields (application/json):

  - `sequence` (object, required)

  - `sequence.serie` (string, required)
    Series name. ASCII letters, digits and the separators ., -, _ only. It cannot start with at (any case), cannot be trial or INVOICEXPRESSDEMO, cannot start or end with a separator, and cannot have two separators in a row. Otherwise the request fails with 422 code 001.
    Example: "2023"

  - `sequence.default_sequence` (string)
    If "1" or "true", this sequence is chosen as the default sequence. Other values are ignored.
    Example: "1"

## Response 201 fields (application/json):

  - `sequence` (object)

  - `sequence.id` (integer)
    Example: 146090

  - `sequence.serie` (string)
    Example: "2022"

  - `sequence.default_sequence` (integer)
    Example: 1

  - `sequence.current_invoice_number` (integer)

  - `sequence.current_invoice_sequence_id` (integer)
    Example: 146090

  - `sequence.current_invoice_validation_code` (string)
    Example: "ABCD1230"

  - `sequence.current_invoice_receipt_number` (integer)

  - `sequence.current_invoice_receipt_sequence_id` (integer)
    Example: 146092

  - `sequence.current_invoice_receipt_validation_code` (string)
    Example: "ABCD1231"

  - `sequence.current_simplified_invoice_number` (integer)

  - `sequence.current_simplified_invoice_sequence_id` (integer)
    Example: 146091

  - `sequence.current_simplified_invoice_validation_code` (string)
    Example: "ABCD1232"

  - `sequence.current_credit_note_number` (integer)

  - `sequence.current_credit_note_sequence_id` (integer)
    Example: 146095

  - `sequence.current_credit_note_validation_code` (string)
    Example: "ABCD1233"

  - `sequence.current_debit_note_number` (integer)

  - `sequence.current_debit_note_sequence_id` (integer)
    Example: 146094

  - `sequence.current_debit_note_validation_code` (string)
    Example: "ABCD1234"

  - `sequence.current_receipt_number` (integer)

  - `sequence.current_receipt_sequence_id` (integer)
    Example: 146093

  - `sequence.current_receipt_validation_code` (string)
    Example: "ABCD1235"

  - `sequence.current_shipping_number` (integer)

  - `sequence.current_shipping_sequence_id` (integer)
    Example: 146104

  - `sequence.current_shipping_validation_code` (string)
    Example: "ABCD1236"

  - `sequence.current_transport_number` (integer)

  - `sequence.current_transport_sequence_id` (integer)
    Example: 146106

  - `sequence.current_transport_validation_code` (string)
    Example: "ABCD1237"

  - `sequence.current_devolution_number` (integer)

  - `sequence.current_devolution_sequence_id` (integer)
    Example: 146105

  - `sequence.current_devolution_validation_code` (string)
    Example: "ABCD1238"

  - `sequence.current_proforma_number` (integer)

  - `sequence.current_proforma_sequence_id` (integer)
    Example: 146102

  - `sequence.current_proforma_validation_code` (string)
    Example: "ABCD1239"

  - `sequence.current_quote_number` (integer)

  - `sequence.current_quote_sequence_id` (integer)
    Example: 146101

  - `sequence.current_quote_validation_code` (string)
    Example: "ABCD1240"

  - `sequence.current_fees_note_number` (integer)

  - `sequence.current_fees_note_sequence_id` (integer)
    Example: 146103

  - `sequence.current_fees_note_validation_code` (string)
    Example: "N/D"

  - `sequence.current_vat_moss_invoice_number` (integer)

  - `sequence.current_vat_moss_invoice_sequence_id` (integer)
    Example: 146097

  - `sequence.current_vat_moss_invoice_validation_code` (string)
    Example: "N/A"

  - `sequence.current_vat_moss_credit_note_number` (integer)

  - `sequence.current_vat_moss_credit_note_sequence_id` (integer)
    Example: 146098

  - `sequence.current_vat_moss_credit_note_validation_code` (string)
    Example: "N/A"

  - `sequence.current_vat_moss_receipt_number` (integer)

  - `sequence.current_vat_moss_receipt_sequence_id` (integer)
    Example: 146099

  - `sequence.current_vat_moss_receipt_validation_code` (string)
    Example: "N/A"

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.error` (string)
    Example: "Authentication Error"

## Response 422 fields (application/json):

  - `errors` (object)

  - `errors.code` (string)
    Example: "001"

  - `errors.message` (string)
    Example: "Sequence name not allowed."