Atualiza os detalhes de um artigo.
O campo type aceita três valores, com o seguinte significado:
- 1: Produto;
- 2: Serviço;
- 3: Outros;
- 4: Impostos, taxas e encargos parafiscais.
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.
