# Create

## Criar Produto

## Cria um novo produto.

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

#### Request Body

| Name                                          | Type    | Description                                                                                                                                                |
| --------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code                                          | string  | Código do Cliente. Valor Único                                                                                                                             |
| description<mark style="color:red;">\*</mark> | string  | Descrição do Produto                                                                                                                                       |
| short\_description                            | string  | Descrição Curta                                                                                                                                            |
| family\_id<mark style="color:red;">\*</mark>  | integer | <p>Família<br>Consulte a tabela <a href="../familias/list">Famílias</a> para saber mais.</p>                                                               |
| long\_description                             | string  | <p>Descrição Longa.</p><p></p><p>A utilização deste campo está dependente da configuração 'use\_long\_description'</p>                                     |
| sub\_family\_id                               | integer | <p>Sub-Família<br>Consulte a tabela <a href="../sub-familias/list">Sub-Famíílias</a>  para saber mais.</p>                                                 |
| use\_sizes\_colors                            | boolean | <p>Usar Cores e Tamanhos.</p><p>A utilização deste campo está dependente da configuração 'use\_sizes\_colors'</p>                                          |
| product\_type\_id                             | integer | <p>Tipo de Produto<br>Consulte a tabela <a href="../../apendice#tipos-de-produtos-campo-product_type">Apêndice</a> para saber mais.</p>                    |
| measure\_unit\_id                             | integer | <p>Unidade de Medida<br>Consulte a tabela <a href="../unidades-de-medida/list">Unidades de Medida</a> para saber mais.</p>                                 |
| vat\_tax\_id                                  | integer | <p>Taxa de IVA<br>Consulte a tabela <a href="../taxas/list">Taxas</a> para saber mais.</p>                                                                 |
| bar\_code                                     | string  | <p>Código de Barras<br>Editável apenas se <code>bar\_code\_type\_id</code> estiver preenchido</p>                                                          |
| bar\_code\_type\_id                           | integer | <p>Tipo do Código de Barras<br>Consulte a tabela <a href="../../apendice#tipos-de-codigos-de-barras-campo-bar_code_type">Apêndice</a> para saber mais.</p> |
| product\_category\_id                         | integer | <p>Tipo de Produto<br>Consulte a tabela <a href="../../apendice#categorias-de-produtos-campo-product_category">Apêndice</a> para saber mais.</p>           |
| do\_stock\_management                         | boolean | Movimenta Stock                                                                                                                                            |
| can\_have\_negative\_stock                    | boolean | Pode ter stock negativo                                                                                                                                    |
| use\_internal\_serial\_number                 | boolean | <p>Usar Nº de Série Interno.<br>Editável apenas se <code>use\_serial\_number</code> estiver activo</p>                                                     |
| use\_serial\_number                           | boolean | <p>Usar Nº de Série.</p><p></p><p>A utilização deste campo está dependente da configuração 'use\_serial\_numbers'</p>                                      |
| has\_lots                                     | boolean | <p>Usar Lotes.</p><p>A utilização deste campo está dependente da configuração 'use\_lots'</p>                                                              |

{% tabs %}
{% tab title="Exemplo de Pedido" %}

```shell
curl -X POST https://api.cloudinvoice.net/products/new/
    -d '{
        "code": "PROD1",
        "description": "Produto 1"
    }'
```

{% endtab %}

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

```json
{
    "id": 1,
    "code": "PROD1",
    "description": "Produto Standard 1",
    "short_description": "Produto Standard 1",
    "family_id": 1,
    "family": {
        "code": "FAM1",
        "description": "Família 1"
    },
    "sub_family_id": null,
    "sub_family": null,
    "product_type_id": 131,
    "product_type": {
        "code": "01",
        "description": "Produto"
    },
    "product_category_id": 211,
    "product_category": {
        "code": "M",
        "description": "Mercadorias"
    },
    "product_type_saft_id": 3271,
    "product_type_saft": {
        "code": "P",
        "description": "Produtos"
    },
    "vat_tax_id": 1,
    "vat_tax": {
        "code": 1,
        "description": "Taxa Normal"
    },
    "vat_tax_rate": 23.0,
    "bar_code": "2000000000015",
    "bar_code_type_id": 153,
    "bar_code_type": {
        "code": "I",
        "description": "Interno EAN13"
    },
    "do_stock_management": true,
    "can_have_negative_stock": true,
    "physical_qty": 10.0,
    "measure_unit_id": 1,
    "measure_unit": {
        "code": "UNI",
        "description": "Unidade"
    },
    "use_serial_number": false,
    "use_internal_serial_number": false,
    "has_lots": false,
    "use_sizes_colors": false,
    "last_cost_price": 0.0,
    "average_cost_price": 0.0,
    "profit_margin": 0.0,
    "unit_price": 100.0,
    "unit_price_tax_inc": 123.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)