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

# Update

## Actualiza Código Alternativo do Produto

{% hint style="info" %}
A utilização de Códigos Alternativos requer a activação da opção de configuração `use_altern_codes`.
{% endhint %}

## Criar um Código Alternativo para um Produto.

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

#### Path Parameters

| Name | Type    | Description        |
| ---- | ------- | ------------------ |
| id   | integer | ID do Produto      |
| code | string  | Código Alternativo |

#### Request Body

| Name                     | Type    | Description                                                                                                                                                                                                                                                    |
| ------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| description              | string  | Descrição                                                                                                                                                                                                                                                      |
| bar\_code\_type\_id      | integer | <p>Tipo de Código<br></p><p>Consulte a tabela <a href="/pages/Le16rQ3NG33zktn1PTI4#tipos-de-codigos-de-barras-campo-bar_code_type">Apêndice</a> para saber mais.</p>                                                                                           |
| quantity                 | float   | Quantidade                                                                                                                                                                                                                                                     |
| measure\_unit\_id        | integer | Consulte a tabela [Unidades de Medida](/documentacao-api/unidades-de-medida/list.md) para saber mais.                                                                                                                                                          |
| use\_altern\_code\_price | boolean | <p>Usar Preço do Código Alternativo<br>Se <code>true</code>, possibilitará a utilização dos campos de preços <code>unit\_price</code> e <code>unit\_price\_tax\_inc</code>.</p>                                                                                |
| 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></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/altern_codes/ALT1/update/
    -d '{
        "use_altern_code_price": true,
        "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"
    },
    "code": "ALT1",
    "bar_code_type_id": 152,
    "bar_code_type": {
        "code": "F",
        "description": "Fornecedor"
    },
    "description": "",
    "quantity": 1.0,
    "measure_unit_id": null,
    "measure_unit": null,
    "use_altern_code_price": false,
    "unit_price": 0.0,
    "unit_price_tax_inc": 0.0,
    "use_price_tax_inc": false,
    "tax_rate": 0.0
}
```

{% endtab %}
{% endtabs %}

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