> 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/documentos/linhas/create.md).

# Create

## Criar Linha de Documento

{% hint style="warning" %}
Atenção! Esta ação apenas pode ser executada nos documentos em preparação.
{% endhint %}

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

#### Path Parameters

| Name    | Type    | Description     |
| ------- | ------- | --------------- |
| doc\_id | integer | ID do Documento |

#### Request Body

<table data-search="true"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>line_number</td><td>integer</td><td>Número da Linha Principal<br><br>Usado para a criação de sub-linhas, em casos em que tal é permitido (ex: produtos compostos)<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> Não surte efeito se não existir já uma linha com o número fornecido.</td></tr><tr><td>code<mark style="color:red;">*</mark></td><td>string</td><td>Código do Produto<br><br>Pode referir-se tanto ao 'código' como ao 'código de barras' de um produto, ou ainda a um 'código alternativo' por este usado.</td></tr><tr><td>description</td><td>string</td><td>Descrição<br><br>Este valor, se preenchido, vai sobrepor-se à descrição na ficha do produto apenas na presente linha.</td></tr><tr><td>short_description</td><td>string</td><td>Descrição Curta<br><br>Este valor, se preenchido, vai sobrepor-se à descrição curta na ficha do produto apenas na presente linha.</td></tr><tr><td>long_description</td><td>string</td><td>Descrição Alargada<br><br>Este valor, se preenchido, vai sobrepor-se à descrição alargada na ficha do produto apenas na presente linha.<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização deste campo está dependente da configuração <code>use_long_description</code></td></tr><tr><td>base_qty</td><td>float<br><sub><mark style="color:$info;">Default: 1</mark></sub></td><td>Quantidade</td></tr><tr><td>line_unit_value</td><td>float</td><td>Preço Unitário<br><br>O valor fornecido deverá ser o Preço Unitário sem IVA se o documento estiver definido como contendo valores sem IVA. Deverá já incluir IVA caso contrário.</td></tr><tr><td>line_discount1</td><td>float</td><td>Desconto de Linha #1</td></tr><tr><td>line_discount2</td><td>float</td><td>Desconto de Linha #2</td></tr><tr><td>lot_number</td><td>string</td><td>Número do Lote<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização deste campo é condicionada pela utilização de lotes no produto e no tipo de documento usados. </td></tr><tr><td>serial_number</td><td>array</td><td>Números de Série<br><br>Lista de IDs dos números de série a usar na linha<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização deste campo é condicionada pela utilização de números de série no produto e no tipo de documento usados. </td></tr><tr><td>size_id</td><td>integer</td><td>Tamanho<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização deste campo é condicionada pela utilização de cores e tamanhos no produto e no tipo de documento usados.</td></tr><tr><td>color_id</td><td>integer</td><td>Cor<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização deste campo é condicionada pela utilização de cores e tamanhos no produto e no tipo de documento usados.</td></tr><tr><td>vat_tax_id</td><td>integer</td><td><p>Taxa de IVA</p><p><br>Consulte a tabela <a href="/pages/MnQEzHg9hHBIujlC0gqe#lista-de-tabelas-de-impostos">Tabelas de Impostos</a>.<br><br><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> A utilização deste campo está dependente da configuração <code>allow_tax_code_change_documents</code></p></td></tr></tbody></table>

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

```shell
curl -X POST https://api.cloudinvoice.net/documents/1/details/new/
    -d '{
        "code": "001",
        "base_qty": 2.0,
        "line_unit_value": 25.0
    }'
```

{% endtab %}

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

```json
{
    "id": 1,
    "line_number": 1,
    "line_subitem": 0,
    "document_header_id": 1,
    "document_header": {
        "doc_key": "FSI A01/1",
        "document_name": "Factura Simplificada"
    },
    "code": "001",
    "product_id": 1,
    "description": "Produto 1",
    "short_description": "Produto 1",
    "has_lots": false,
    "use_serial_number": false,
    "use_sizes_colors": false,
    "base_qty": 2.0,
    "base_measure_unit_id": 1,
    "base_measure_unit":{
        "code": "UNI",
        "description": "Unidade"
    },
    "quantity": 1.0,
    "measure_unit_id": 1,
    "measure_unit": {
        "code": "UNI",
        "description": "Unidade"
    },
    "line_unit_value": 25.0,
    "global_discount1": 0.0,
    "line_discount1": 0.0,
    "line_discount2": 0.0,
    "line_discount3": 0.0,
    "vat_tax_id": 3,
    "vat_tax": {
        "description": "Taxa Reduzida",
        "tax_rate": 6.0
    },
    "tax_exemption_id": null,
    "tax_exemption": null,
    "total_gross_amount": 50.0,
    "total_discount_amount": 0.0,
    "total_net_amount": 47.1698113208,
    "total_taxes_amount": 2.8301886792,
    "line_total_value": 50.0
}
```

{% endtab %}
{% endtabs %}

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