Create

Criar Produto

Cria um novo produto.

POST https://api.cloudinvoice.net/products/new/

Request Body

Name	Type	Description
code	string	Código do Cliente. Valor Único
description*	string	Descrição do Produto
short_description	string	Descrição Curta
family_id*	integer	Família Consulte a tabela Famílias para saber mais.
long_description	string	Descrição Longa. A utilização deste campo está dependente da configuração 'use_long_description'
sub_family_id	integer	Sub-Família Consulte a tabela Sub-Famíílias para saber mais.
use_sizes_colors	boolean	Usar Cores e Tamanhos. A utilização deste campo está dependente da configuração 'use_sizes_colors'
product_type_id	integer	Tipo de Produto Consulte a tabela Apêndice para saber mais.
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.
product_category_id	integer	Tipo de Produto Consulte a tabela Apêndice para saber mais.
do_stock_management	boolean	Movimenta Stock
can_have_negative_stock	boolean	Pode ter stock negativo
use_internal_serial_number	boolean	Usar Nº de Série Interno. Editável apenas se use_serial_number estiver activo
use_serial_number	boolean	Usar Nº de Série. A utilização deste campo está dependente da configuração 'use_serial_numbers'
has_lots	boolean	Usar Lotes. A utilização deste campo está dependente da configuração 'use_lots'

201: Created Devolve ficha completa do novo produto

400: Bad Request Lista de erros detectados

401 (Sem Resposta)

{
    // Response
}

403: Forbidden (Sem Resposta)

{
    // Response
}

Exemplo de Pedido

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

Exemplo de Resposta

{
    "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
}

Para ver exemplos de pedidos nas várias linguagens, consulte a página Exemplos de Pedidos.