> 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/create.md).
# Create
## Criar Produto
## Cria um novo produto.
`POST` `https://api.cloudinvoice.net/products/new/`
#### Request Body
| Name | Type | Description |
| --------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| code | string
Valor Único
| Código do Produto
Gerado automaticamente quando não fornecido.
|
| family\_id\* | integer | Família
Consulte a tabela Famílias para saber mais.
|
| sub\_family\_id | integer | Sub-Família
Consulte a tabela Sub-Famíílias para saber mais.
|
| product\_type\_id | integer | Tipo de Produto
Consulte a tabela Apêndice para saber mais.
|
| product\_category\_id | integer | Categoria de Produto
Consulte a tabela Apêndice para saber mais.
|
| description\* | string | Descrição do Produto |
| short\_description | string | Descrição Curta |
| long\_description | string | Descrição Longa.
⚠️ A utilização deste campo está dependente da configuração use\_long\_description
|
| measure\_unit\_id | integer | Unidade de Medida
Consulte a tabela Unidades de Medida para saber mais.
|
| vat\_tax\_id | integer | Taxa de IVA
Consulte a tabela Taxas para saber mais.
|
| bar\_code | string | Código de Barras
⚠️ Editável apenas se bar\_code\_type\_id estiver preenchido
|
| bar\_code\_type\_id | integer | Tipo do Código de Barras
Consulte a tabela Apêndice para saber mais.
|
| do\_stock\_management | boolean | Movimenta Stock |
| can\_have\_negative\_stock | boolean | Pode ter stock negativo |
| use\_serial\_number | boolean | Usar Nº de Série
⚠️ A utilização deste campo está dependente da configuração use\_serial\_numbers
|
| use\_internal\_serial\_number | boolean | Usar Nº de Série Interno
⚠️ Editável apenas se use\_serial\_number estiver activo
|
| has\_lots | boolean | Usar Lotes
⚠️ A utilização deste campo está dependente da configuração use\_lots
|
| use\_sizes\_colors | boolean | Usar Cores e Tamanhos
⚠️ A utilização deste campo está dependente da configuração use\_sizes\_colors
|
{% 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.](/introducao/exemplos-de-pedidos.md)