> 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/produtos/precos-de-venda/update.md).

# Update

## Actualiza Preço de Venda do Produto

## Alterar o Preço de Venda de um Produto para uma dada Linha de Preços.

<mark style="color:green;">`POST`</mark> `https://api.cloudinvoice.net/products/:id/prices/:price_line/update/`

#### Path Parameters

| Name                                          | Type    | Description           |
| --------------------------------------------- | ------- | --------------------- |
| id<mark style="color:red;">\*</mark>          | integer | ID do Produto         |
| price\_line<mark style="color:red;">\*</mark> | integer | ID da Linha de Preços |

#### Request Body

| Name                  | Type    | Description                                                                                                                                                                                                                                             |
| --------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| unit\_price           | float   | Preço Unitário                                                                                                                                                                                                                                          |
| unit\_price\_tax\_inc | float   | Preço Unitário com IVA                                                                                                                                                                                                                                  |
| use\_price\_tax\_inc  | boolean | <p>Calcular Preço com IVA Indica qual dos preços unitários (com ou sem IVA) está a actualizar. </p><p>Apesar de não ser obrigatório, é recomendável que envie sempre este campo para garantir que está realmente a actualizar o Preço que pretende.</p> |

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

```shell
curl -X POST https://api.cloudinvoice.net/products/1/prices/1/update/
    -d '{
        "unit_price_tax_inc": "100",
        "use_price_tax_inc": true,
    }'
```

{% endtab %}

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

```json
{
    "product_id": 1,
    "product": {
        "code": "PROD1",
        "description": "Produto Standard 1"
    },
    "price_line_id": 1,
    "price_line": {
        "code": 1,
        "description": "Preço de Venda 1"
    },
    "unit_price": 100.0,
    "unit_price_tax_inc": 123.0,
    "use_price_tax_inc": true,
    "tax_rate": 23.0
}
```

{% endtab %}
{% endtabs %}

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