> 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/update.md).

# Update

## Alterar Linha de Documento

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

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

#### Path Parameters

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

#### Request Body

<table data-search="true"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>description</td><td>string</td><td>Descrição</td></tr><tr><td>short_description</td><td>string</td><td>Descrição Curta</td></tr><tr><td>long_description</td><td>string</td><td>Descrição Alargada<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/1/update/
    -d '{
        "description": "Descrição Personalizada"
    }'
```

{% endtab %}

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

<pre class="language-json"><code class="lang-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,
<strong>    "description": "Descrição Personalizada",
</strong>    "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
}
</code></pre>

{% endtab %}
{% endtabs %}

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