Developers
Products > Products > update
update
Disponível na versão: 1.0+

Atualiza os detalhes de um artigo.

O campo type aceita três valores, com o seguinte significado:

  • 1: Produto;
  • 2: Serviço;
  • 3: Outros.

O campo reference deve ser único.

Pode definir um conjunto de fornecedores e impostos, embora eles não sejam obrigatórios.
Tenha em consideração de que os parâmetros inválidos nos fornecedores ou impostos, irá fazer com que a inserção ou a atualização do produto falhe.

Como sempre, você irá receber uma série de erros, em que o índice do array mais alto estará no formato suppliers[i] ou taxes[i], sendo o índice i do item com o erro vem devolvido pela ordem enviada.
No entanto, só vai ver esses erros se o produto em si for válido, ou seja, se não falhar logo nos campos do próprio produto.

Os erros de envio são devolvidos em duas etapas:

  • Primeiro, se a sua informação de produto é inválida;
  • Se o produto for válido e, alguns dos itens mencionados nas matrizes forem inválidos também.

Os ids dos fornecedores e impostos devem ser válidos.
Você pode obter esses dados a partir de outras classes e métodos da API.

O campo value dos itens fiscais será anulado com o valor do imposto correspondente, se o imposto não for do tipo 3 (Ver Impostos e Taxas para mais informações).
Lembre-se que a ordem dos impostos é importante, e se houver mais de um imposto, e se alguns forem cumulativos, tomar cuidado extra com a ordem dos mesmos.

Se não houver nenhum imposto, ou se nenhum deles for do saft_type igual a 1 (IVA), ou se aqueles que tiverem valor zero, o exemption_reason do produto é obrigatório.

Pedido

https://api.moloni.com/v1/products/update/?access_token=[current_access_token]

Parâmetros
company_id int

Obrigatório

product_id int

Obrigatório

category_id int

Obrigatório

type int

Obrigatório

name string

Obrigatório

summary string

Facultativo

reference string

Obrigatório

ean string

Facultativo

price float

Obrigatório

unit_id int

Obrigatório

has_stock int

Obrigatório

stock float

Obrigatório

pos_favorite int

Facultativo

at_product_category string

Facultativo

exemption_reason string

Facultativo

taxes array

Facultativo

tax_id int

Obrigatório

value float

Obrigatório

order int

Obrigatório

cumulative int

Obrigatório

suppliers array

Facultativo

supplier_id int

Obrigatório

cost_price float

Obrigatório

properties array

Facultativo

property_id int

Obrigatório

value string

Obrigatório

Nota
- O parâmetro qty tem como default 50 e o offset 0, sendo que o máximo qty é 50;
- Campos de preenchimento facultativo, significa que podem ser uma string vazia ou zero, dependendo do respectivo tipo.
{
    valid: 1,
    product_id: int
}
Sempre que existir um erro no preenchimento dos campos, será devolvido via JSON o objeto com os erros indexado pela ordem dos campos.
As mensagens de erro, são devolvidas sob a forma de códigos, e para perceber quais os erros disponíveis e como interpretar as mensagens recebidas, consulte esta ligação.
© 2017 Moloni. Termos de Utilização