# Código Alternativo - Create

## Cria 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/new/`

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 |

#### Request Body

| Name                                   | Type    | Description                                                                                                                                                                                                                                                    |
| -------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code<mark style="color:red;">\*</mark> | string  | Código                                                                                                                                                                                                                                                         |
| 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/new/
    -d '{
        "product_id": 1,
        "code": "ALT1"
    }'
```

{% 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)