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

# Create

Cria componente de um Produto.

## Criar Componente

{% hint style="warning" %}
Os Componentes estão disponíveis apenas para certos tipos de Produtos (Compostos, Pack, Fabricados, Transformados).
{% endhint %}

<mark style="color:green;">`POST`</mark> `https://api.cloudinvoice.net/products/:prod_id/components/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>product_component_id<mark style="color:red;">*</mark></td><td>integer</td><td>ID do Produto Componente<br><br>Consulte a tabela <a href="/documentacao-api/produtos/list.md">Produtos</a> para saber mais.</td></tr><tr><td>description</td><td>string</td><td>Descrição<br><br>Descrição personalizada que se sobrepõe à da ficha do Produto.</td></tr><tr><td>quantity</td><td>float</td><td>Quantidade</td></tr><tr><td>use_comp_code_price</td><td>boolean</td><td>Usar Preço do Componente<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/6/components/new/
    -d '{
        "product_component_id": 1,
        "quantity": 1,
        "description": "Descrição do Componente"
    }'
```

{% endtab %}

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

```json
{
    "id": 1,
    "product_id": 6,
    "product": {
        "code": "COMP",
        "description": "Produto Composto"
    },
    "product_component_id": 1,
    "product_component": {
        "code": "001",
        "description": "Produto 1"
    },
    "description": "Descrição do Componente",
    "quantity": 1.0,
    "sequence_number": 1,
    "use_comp_code_price": false,
    "unit_price": 0.0,
    "unit_price_tax_inc": 0.0,
    "use_price_tax_inc": false
}
```

{% endtab %}
{% endtabs %}

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