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

# Create

Cria um código alternativo para um produto.

## Criar Código Alternativo

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

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

#### Path Parameters

| Name     | Type    | Description   |
| -------- | ------- | ------------- |
| prod\_id | integer | ID do Produto |

#### Request Body

<table data-search="false"><thead><tr><th>Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>code<mark style="color:red;">*</mark></td><td>string</td><td>Código</td></tr><tr><td>description</td><td>string</td><td>Descrição<br><br>Descrição aplicada nas Linhas de Documentos quando lançadas com o Código Alternativo.</td></tr><tr><td>bar_code_type_id</td><td>integer</td><td><p>Tipo de Código<br></p><p>Consulte a tabela <a href="/documentacao-api/apendice.md#tipos-de-codigos-de-barras-campo-bar_code_type">Apêndice</a> para saber mais.</p></td></tr><tr><td>quantity</td><td>float</td><td>Quantidade</td></tr><tr><td>measure_unit_id</td><td>integer</td><td>Unidade de Medida<br><br>Consulte a tabela <a href="/documentacao-api/unidades-de-medida/list.md">Unidades de Medida</a> para saber mais.</td></tr><tr><td>use_altern_code_price</td><td>boolean</td><td>Usar Preço do Código Alternativo<br><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>.</td></tr><tr><td>unit_price</td><td>float</td><td>Preço Unitário</td></tr><tr><td>unit_price_tax_inc</td><td>float</td><td>Preço Unitário com IVA</td></tr><tr><td>use_price_tax_inc</td><td>boolean</td><td><p>Calcular Preço com IVA<br><br>Indica qual dos preços unitários (com ou sem IVA) está a actualizar. </p><p></p><p><span data-gb-custom-inline data-tag="emoji" data-code="26a0">⚠️</span> É recomendável que, ao definir um preço, envie sempre este campo para garantir que está a actualizar o valor pretendido.</p></td></tr></tbody></table>

{% 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.](/introducao/exemplos-de-pedidos.md)