# Código Alternativo - Update

## Actualiza Código Alternativo do Produto

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

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

A utilização de Códigos Alternativos requer a activação da opção de configuração `use_altern_codes`.

#### Path Parameters

| Name                                   | Type    | Description        |
| -------------------------------------- | ------- | ------------------ |
| id<mark style="color:red;">\*</mark>   | integer | ID do Produto      |
| code<mark style="color:red;">\*</mark> | 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="../../apendice#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](https://apidocs.cloudinvoice.net/documentacao-api/unidades-de-medida/list) 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/
    -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.](https://apidocs.cloudinvoice.net/introducao/exemplos-de-pedidos)